plainCanvas: A JavaScript repository from ten-A

#plainCanvas

Adobe Illustrator (CC 2014, 2015) add-on with following functions.

loads and executes a script file written for [paper.js]. (at the initial state, a simple drawing tool is implemented.)
exports the image created on the panel onto the artboard.
imports selected paths on the artboard onto the panel. [paper.js]:http://paperjs.org

###Installation Because of the character of this add-on that loads external script files, it is released with an assumtion of doing debugs. Installation steps are as follows.

Setting the debug mode flag refer to Adobe's document CC14_Extension_SDK.pdf at page 10.
Put the folder "com.shspage.csxs.plaincanvas" in the right folder refer to the page 5 of above document ("Extension management" section).

###buttons on the panel

in : imports selected paths on the artboard onto the panel
out : exports the image created on the panel onto the artboard
opt : shows/hides the form for optional values
< : undo
> : redo
CL : clears the panel
DB : opens the debug tool with a default browser.
RL : reloads the panel
select : selects a script file to load

###script files that can be loaded

Written in JavaScript (not paperscript). For details, see "Using JavaScript Directly" in http://paperjs.org.
ex: new Path() -> new paper.Path()
ex: point1 + point2 -> point1.add(point2)
ex: function onMouseDown(event) -> tool.onMouseDown = function(event)
Set the character encoding to UTF-8.
You can use the UIs for optional values with simple methods. see "js/optionManager.js".
You can set a drawn object as a target for undo/redo by calling the method like this.

undoManager.keep(object);

Note that undoed objects are just hidden, and still exists in the current paper.project.

###colors

Since html5 canvas uses RGB color, imported CMYK and GRAY colors may look different from they look on the artboard.
If ALWAYS_EXPORT_RGB (js/main.js) is set false, the original CMYK colors are kept in memory and are applied when they are exported. (When DefaultColorSpace of the artboard is CMYK.)
If ALWAYS_EXPORT_RGB is true, GRAY colors are exported in RGB.
Gradient color and spot color are not supported for now.

###exports to an artboard

Following attributes of paper.Path instance on the canvas are exported.
segments, strokeWidth, strokeColor, fillColor, opacity

###imports from an artboard

Following attributes of selected PathItems are imported.
pathPoints, strokeWidth, strokeColor, fillColor.
Grouped paths and compoundpaths are imported in released condition.

###License

When you distribute a modified version, make sure changing the bundle ID. It is represented as "com.shspage.csxs.plaincanvas" in CSXS/manifest.xml and .debug.
Copyright (c) 2015 Hiroyuki Sato. All rights reserved.
http://shspage.com/
This software is distributed under the MIT License.
See the LICENSE.txt for details.
This software uses the following libraries that may have licenses differing from that of the software itself. You can find the libraries and their respective licenses below.
Paper.js v0.9.23 - The Swiss Army Knife of Vector Graphics Scripting.
http://paperjs.org/
Copyright (c) 2011 - 2014, Juerg Lehni & Jonathan Puckey
http://scratchdisk.com/ & http://jonathanpuckey.com/
All rights reserved.

ten-A/plainCanvas