fabianmoronzirfas
9/15/2016 - 11:52 AM
basil1.0.10-with-binary-image.js
/* Basil.js v1.0.10 2016.09.15-13:45:02 */
/*
..- --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-.-..-.-.... .- .--
B A S I L . J S
Bringing the spirit of the Processing visualization language to Adobe Indesign.
License - MIT
Core
- Ted Davis http://teddavis.org
- Benedikt Groß http://benedikt-gross.de
- Ludwig Zeller http://ludwigzeller.de
Members
- Philipp Adrian http://www.philippadrian.com/
- be:screen GmbH http://bescreen.de
- Stefan Landsbek http://47nord.de
- Ken Frederick http://kennethfrederick.de/
Web Site - http://basiljs.ch
Github Repo. - https://github.com/basiljs/basil.js
Processing - http://processing.org
Processing.js - http://processingjs.org
basil.js was conceived and is generously supported by
The Visual Communication Institute / The Basel School of Design
Department of the Academy of Art and Design Basel (HGK FHNW)
http://thebaselschoolofdesign.ch
Please note: Big general parts e.g. random() of the basil.js source code are copied
from processing.js by the Processing.js team. We would have had a hard time
to figure all of that out on our own!
Supported Adobe Indesign versions: CS 5, CS 5.5 and CS 6
.--.--.- .-.-......-....--.-- -.... -..---.-.... .-- . .---.- -... -.-..---.-. ..--.-- -.. -
*/
#target "InDesign";
(function(glob, app, undef) {
/**
* @class b
* @static
*/
var pub = {};
/**
* The basil version
* @property VERSION {String}
* @cat Environment
*/
pub.VERSION = "1.0.10";
/**
* Used with b.units() to set the coordinate system to points.
* @property PT {String}
* @cat Document
* @subcat Units
*/
pub.PT = "pt";
/**
* Used with b.units() to set the coordinate system to pixels.
* @property PX {String}
* @cat Document
* @subcat Units
*/
pub.PX = "px";
/**
* Used with b.units() to set the coordinate system to centimeters.
* @property CM {String}
* @cat Document
* @subcat Units
*/
pub.CM = "cm";
/**
* Used with b.units() to set the coordinate system to millimeters.
* @property MM {String}
* @cat Document
* @subcat Units
*/
pub.MM = "mm";
/**
* Used with b.units() to set the coordinate system to inches.
* @property IN {String}
* @cat Document
* @subcat Units
*/
pub.IN = "inch";
/**
* Used with b.colorMode() to set the color space.
* @property RGB {String}
* @cat Color
*/
pub.RGB = "rgb";
/**
* Used with b.colorMode() to set the color space.
* @property CMYK {String}
* @cat Color
*/
pub.CMYK = "cmyk";
/**
* Used with b.gradientMode() to set the gradient mode.
* @property LINEAR {String}
* @cat Color
*/
pub.LINEAR = "linear";
/**
* Used with b.gradientMode() to set the gradient mode.
* @property RADIAL {String}
* @cat Color
*/
pub.RADIAL = "radial";
/**
* Corner, used for drawing modes.
* @property CORNER {String}
* @cat Document
* @subcat Primitives
*/
pub.CORNER = "corner";
/**
* Corners, used for drawing modes.
* @property CORNERS {String}
* @cat Document
* @subcat Primitives
*/
pub.CORNERS = "corners";
/**
* Center, used for drawing modes.
* @property CENTER {String}
* @cat Document
* @subcat Primitives
*/
pub.CENTER = "center";
/**
* Radius, used for drawing modes.
* @property RADIUS {String}
* @cat Document
* @subcat Primitives
*/
pub.RADIUS = "radius";
/**
* Close, used for endShape() modes.
* @property CLOSE {String}
* @cat Document
* @subcat Primitives
*/
pub.CLOSE = "close";
/**
* Open, used for arc() modes.
* @property OPEN {String}
* @cat Document
* @subcat Primitives
*/
pub.OPEN = "open";
/**
* Chord, used for arc() modes.
* @property CHORD {String}
* @cat Document
* @subcat Primitives
*/
pub.CHORD = "chord";
/**
* Pie, used for arc() modes.
* @property PIE {String}
* @cat Document
* @subcat Primitives
*/
pub.PIE = "pie";
/**
* Two Pi
* @property TWO_PI {Number}
* @cat Math
* @subcat Constants
*/
pub.TWO_PI = Math.PI*2;
/**
* Pi
* @property PI {Number}
* @cat Math
* @subcat Constants
*/
pub.PI = Math.PI;
/**
* Half Pi
* @property HALF_PI {Number}
* @cat Math
* @subcat Constants
*/
pub.HALF_PI = Math.PI/2;
/**
* Quarter Pi
* @property QUARTER_PI {Number}
* @cat Math
* @subcat Constants
*/
pub.QUARTER_PI = Math.PI/4;
/**
* Sin Cos Length
* @property SINCOS_LENGTH {Number}
* @cat Math
* @subcat Constants
*/
pub.SINCOS_LENGTH = 720;
/**
* Epsilon
* @property EPSILON {Number}
* @cat Math
* @subcat Constants
*/
pub.EPSILON = 10e-12;
/**
* Kappa
* @property KAPPA {Number}
* @cat Math
* @subcat Constants
*/
// Kappa, see: http://www.whizkidtech.redprince.net/bezier/circle/kappa/
pub.KAPPA = (4.0 * (Math.sqrt(2.0) - 1.0) / 3.0);
/**
* Used with b.canvasMode() to set the canvas to the full current page.
* @property PAGE {String}
* @cat Document
* @subcat Page
*/
pub.PAGE = "page";
/**
* Used with b.canvasMode() to set the canvas to the full current page minus the margins.
* @property MARGIN {String}
* @cat Document
* @subcat Page
*/
pub.MARGIN = "margin";
/**
* Used with b.canvasMode() to set the canvas to the full current page plus the bleed.
* @property BLEED {String}
* @cat Document
* @subcat Page
*/
pub.BLEED = "bleed";
/**
* Used with b.canvasMode() to set the canvas to use the current facing pages.
* @property FACING_PAGES {String}
* @cat Document
* @subcat Page
*/
pub.FACING_PAGES = "facing_pages";
/**
* Used with b.canvasMode() to set the canvas to use the current facing pages plus bleeds.
* @property FACING_BLEEDS {String}
* @cat Document
* @subcat Page
*/
pub.FACING_BLEEDS = "facing_bleeds";
/**
* Used with b.canvasMode() to set the canvas to use the current facing pages minus margins.
* @property FACING_MARGINS {String}
* @cat Document
* @subcat Page
*/
pub.FACING_MARGINS = "facing_margins";
/**
* Used with b.addPage() to set the position of the new page in the book.
* @property AT_BEGINNING {String}
* @cat Document
* @subcat Page
*/
pub.AT_BEGINNING = LocationOptions.AT_BEGINNING;
/**
* Used with b.addPage() to set the position of the new page in the book.
* @property AT_END {String}
* @cat Document
* @subcat Page
*/
pub.AT_END = LocationOptions.AT_END;
/**
* Used with b.addPage() to set the position of the new page in the book.
* @property BEFORE {String}
* @cat Document
* @subcat Page
*/
pub.BEFORE = LocationOptions.BEFORE;
/**
* Used with b.addPage() to set the position of the new page in the book.
* @property AFTER {String}
* @cat Document
* @subcat Page
*/
pub.AFTER = LocationOptions.AFTER;
/**
* Used with b.go() to set Performance Mode. Disables ScreenRedraw during processing.
* @property MODESILENT {String}
* @cat Environment
* @subcat modes
*/
pub.MODESILENT = "ModeSilent";
/**
* Used with b.go() to set Performance Mode. Processes Document in background mode. Document will not be visible until the script is done. If you are firing on a open document you'll need to save it before calling b.go(). The document will be removed from the display list and added again after the script is done. In this mode you will likely look at indesign with no open document for quite some time - do not work in indesign during this time. You may want to use b.println("yourMessage") in your script and look at the Console in estk to get information about the process.
* @property MODEHIDDEN {String}
* @cat Environment
* @subcat modes
*/
pub.MODEHIDDEN = "ModeHidden";
/**
* Default mode. Used with b.go() to set Performance Mode. Processes Document with Screen redraw, use this option to see direct results during the process. This will slow down the process in terms of processing time. This mode was also the default in Versions prior to 0.22
* @property MODEVISIBLE {String}
* @cat Environment
* @subcat modes
*/
pub.MODEVISIBLE = "ModeVisible";
pub.DEFAULTMODE = pub.MODEVISIBLE; // FIXME, DEFAULTMODE shouldn't be public, move init to init()
var ERROR_PREFIX = "\nBasil.js Error -> ",
WARNING_PREFIX = "### Basil Warning -> ";
// ----------------------------------------
// public vars
/**
* System variable which stores the width of the current page.
* @property width {Number}
* @cat Environment
*/
pub.width = null;
/**
* System variable which stores the height of the current page.
* @property height {Number}
* @cat Environment
*/
pub.height = null;
// ----------------------------------------
// private vars
var currDoc = null,
currPage = null,
currLayer = null,
currUnits = null,
currMatrix = null,
matrixStack = null,
currColorMode = null,
currGradientMode = null,
currFillColor = null,
currStrokeColor = null,
currStrokeTint = null,
currFillTint = null,
currStrokeWeight = null,
currRectMode = null,
currEllipseMode = null,
noneSwatchColor = null,
startTime = null,
currFont = null,
currFontSize = null,
currAlign = null,
currYAlign = null,
currLeading = null,
currKerning = null,
currTracking = null,
currImageMode = null,
currCanvasMode = null,
currVertexPoints = null,
currPathPointer = null,
currPolygon = null,
currShapeMode = null,
// tmp cache, see addToStroy(), via indesign external library file
addToStoryCache = null;
// ----------------------------------------
// global functions
/* todo */
// https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/filter
if (!Array.prototype.filter) {
Array.prototype.filter = function(fun) {
if (this === null) throw new TypeError();
var t = Object(this);
var len = t.length >>> 0;
if (typeof fun != "function") throw new TypeError();
var res = [];
var thisp = arguments[1];
for (var i = 0; i < len; i++) {
if (i in t) {
var val = t[i]; // in case fun mutates this
if (fun.call(thisp, val, i, t)) res.push(val);
}
}
return res;
};
}
/* todo */
// https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Array/map
if (!Array.prototype.map) {
Array.prototype.map = function(callback, thisArg) {
var T, A, k;
if (this == null) {
throw new TypeError(" this is null or not defined");
}
var O = Object(this);
var len = O.length >>> 0;
if (typeof callback !== "function") {
throw new TypeError(callback + " is not a function");
}
if (thisArg) {
T = thisArg;
}
A = new Array(len);
k = 0;
while(k < len) {
var kValue, mappedValue;
if (k in O) {
kValue = O[ k ];
mappedValue = callback.call(T, kValue, k, O);
A[ k ] = mappedValue;
}
k++;
}
return A;
};
}
/**
* Used to run a function on all elements of an array. Please note the existance of the convenience methods b.stories(), b.paragraphs(), b.lines(), b.words() and b.characters() that are used to iterate through all instances of the given type in the given document.
*
* @cat Data
* @subcat Array Functions
* @method forEach
* @param {Array} collection The array to be processed.
* @param {Function} cb The function that will be called on each element. The call will be like function(item,i) where i is the current index of the item within the array.
*/
if (!glob.forEach) {
glob.forEach = function(collection, cb) {
for (var i = 0, len = collection.length; i < len; i++) {
if(!isValid(collection[i])) {
warning("forEach(), invalid object processed.");
continue;
}
if(cb(collection[i],i) === false) {
return false;
}
}
return true;
};
}
pub.forEach = glob.forEach;
/**
* HashList is a data container that allows you to store information as key -> value pairs. As usual in JavaScript mixed types of keys and values are accepted in one HashList instance.
*
* @constructor
* @cat Data
* @subcat HashList
* @method HashList
*/
// taken from http://pbrajkumar.wordpress.com/2011/01/17/hashmap-in-javascript/
glob.HashList = function () {
var that = {};
that.length = 0;
that.items = {};
// TODO: initial function removal in items?
for ( var key in that.items ) {
b.println(key);
}
// Please note: this is removing Object fields, but has to be done to have an empty "bucket"
function checkKey(key) {
if(that.items[key] instanceof Function) {
that.items[key] = undefined;
};
}
/**
*
* This removes a key -> value pair by its key.
*
* @cat Data
* @subcat HashList
* @method HashList.remove
* @param {any} key The key to delete
* @return {any} The value before deletion
*/
that.remove = function(key) {
var tmp_previous;
if (typeof that.items[key] != 'undefined') {
var tmp_previous = that.items[key];
delete that.items[key];
that.length--;
}
return tmp_previous;
}
/**
* This gets a value by its key.
*
* @cat Data
* @subcat HashList
* @method HashList.get
* @param {any} key The key to look for
* @return {any} The value
*/
that.get = function(key) {
return that.items[key];
}
/**
* This sets a key -> value pair. If a key is already existing, the value will be updated. Please note that Functions are currently not supported as values.
*
* @cat Data
* @subcat HashList
* @method HashList.set
* @param {any} key The key to use
* @param {any} value The value to set
* @return {any} The value after setting
*/
that.set = function(key, value) {
if( value instanceof Function ) error("HashList does not support storing Functions as values.");
checkKey(key);
if (typeof value != 'undefined') {
if (typeof that.items[key] === 'undefined') {
that.length++;
}
that.items[key] = value;
}
return that.items[key];
}
/**
* Checks for the existence of a given key.
*
* @cat Data
* @subcat HashList
* @method HashList.hasKey
* @param {any} key The key to check
* @return {boolean}
*/
that.hasKey = function(key) {
checkKey(key);
return typeof that.items[key] != 'undefined';
}
/**
* Checks if a certain value exists at least once in all of the key -> value pairs.
*
* @cat Data
* @subcat HashList
* @method HashList.hasValue
* @param {any} value
* @return {boolean}
*/
that.hasValue = function(value) {
var obj = that.items;
var found = false;
for(var key in obj) {
if (obj[key] === value) {
found = true;
break;
};
}
return found;
}
/**
* Returns an array of all keys that are sorted by their values from highest to lowest. Please note that this only works if you have conistently used Numbers for values.
*
* @cat Data
* @subcat HashList
* @method HashList.getKeysByValues
* @return {Array} An array with all the keys
*/
that.getKeysByValues = function() {
var obj = that.items;
var keys = [];
for(var key in obj)
{
if( typeof obj[key] != 'number' ) error("HashList.getKeysByValues(), only works with Numbers as values. ");
keys.push(key);
}
return keys.sort(function(a,b){return obj[b]-obj[a]});
}
/**
* Returns an array with all keys in a sorted order from higher to lower magnitude.
*
* @cat Data
* @subcat HashList
* @method HashList.getSortedKeys
* @return {Array} An array with all the keys
*/
that.getSortedKeys = function () {
return that.getKeys().sort(); // ["a", "b", "z"]
}
/**
* Returns an array with all keys.
*
* @cat Data
* @subcat HashList
* @method HashList.getKeys
* @return {Array} An array with all the keys
*/
that.getKeys = function () {
var keys = [];
for(var key in that.items)
{
if(that.items.hasOwnProperty(key))
{
keys.push(key);
}
}
return keys;
}
/**
* Returns an array with all keys.
*
* @cat Data
* @subcat HashList
* @method HashList.getKeys
* @return {Array} An array with all the keys
*/
that.getValues = function () {
var obj = that.items;
var values = [];
for(var key in obj) {
values.push(obj[key]);
}
return values;
}
/**
* Deletes all the key -> value pairs in this HashList.
*
* @cat Data
* @subcat HashList
* @method HashList.clear
*/
that.clear = function() {
for (var i in that.items) {
delete that.items[i];
}
that.length = 0;
}
return that;
}
/* eslint-disable */
var basil_logo_simple_binary = "\u0089PNG\r\n\x1A\n\x00\x00\x00\rIHDR\x00\x00\x00r\x00\x00\x00r\b\x03\x00\x00\x00\u00B8\x03uO\x00\x00\x00'PLTE\u00FF\u00FF\u00FF\u00FD\u00FD\u00FD\u00FB\u00FB\u00FB\u00F5\u00F5\u00F5\u00F0\u00F0\u00F0\u00EB\u00EB\u00EB\u00E8\u00E8\u00E8\u00DB\u00DB\u00DB\u00B8\u00B8\u00B8www000\r\r\r\u00FF\u00FF\u00FFf~ew\x00\x00\x00\rtRNS\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\u00FF\x00=\u00E8\"\u0086\x00\x00\x03\x19IDATx\u00DA\u00ED\u0099\u00E1\u00AE\u00EC&\f\u0084m\u0093,x&\u00EF\u00FF\u00BC-8\x04m\u00A3\u00EA\u009C\u00CD\u00D5\"Ue~!B\u00F84\u008C\x1D-Z9\u00A6k!\x17r!\x17r!\x17r!\x17r!\x17r!\x17\u00F2?\u008C,$\x1F\"\u00F9\u0094\u00E8\u009B\u00A3m\x00\x00\u00C4\u00F7\u0091t\x11\u00C9\x15\u00E4\u00C9\u00CC^\u00FC\x04\u0099\u00F6G\u00C8M\u00FE\x16\u00EAH\u00AA>r)\u008F\u0098\u00AE\"\u0092\x1A\u00B2\u008E\u0094\x1F!e{b\x13\u009E\u00C4\u0087\u00CB\u008F\u0090*\u00F6\u00C4&H\u00F2\u00E8.\r\u009F -l>\x16\u00ED\u0081\u00CBn\u00F3\u00EE\u0082\x04F|\f\u00DD\u0090\u009F\u0097\u008F\u00C8\u00AD\u0082*\u00CB7\u0095\u00E2 Ko}\u00AFU\u00BA9\u00D9\u0097\u0090\u00CF\u00B2\u0094\u00AA\u0086\u00DC7\u00CD\u0088\u00C9\u00AC\u00A6\u00D2d\u00CE z\u0092Pj3.\u00A2\x12\x15\u00FB1\u00D2N\u009B\u00FB^\u00F7\u00CC\u00ED]\u00C8\u00D0\u00D6l\u00D2M\u00FB\u008C#\u0090\"xv\u00B0\x1A\x1B\x1F\u00F5\u00D4:\x13Y\u0086\u009A)\u00EEc\x02~C\u00EA\u00E7\x07\u009BA\u0080\u00E5*wd'\x00\u00BE\u00EA\f\u00DF|k\u00F1r\"\x15\x7F\u0090eM*y\x1B\u00A31\u0089\u00E3U{\u00BD{\u0081^H\u00F7c \u009F\u00F6\u00A5\b\x02\u00DC^f<\u00D8w\u0091m M\u00BA0\u00BExx\u00D4\u0097\x11E \x11o7\u00DE\u00BE\u00D5y\u00ED\f\u00E6\u00D3\"\u00E9\u0081\u00BC\u009E\u00E8\u00A3\u00BE\f\u0097\u0086\x1E\x0B\u00EB\u00E8\u00CD\u0096\u00B7\u00A0\u00A3/\u00D1\u0091\u00F60K\u00BD\u0090\u008A\u00B3\u00C5\x00W\x19\n\x04N\u00A6f\u00F8\u00AD|\x1Eg\t\x0B\x02\u00FC\u00F5\u00EE\u00B2\th\u00B3\u00A6\u008E\u009E\u00E5\x1F\u00BBL<\x01\u00C8zC\x06\u0094ngc\u00BA<G\u008E,\u009D\u00F12]\u00E5\u0086\f9\u00B7\u00B6\u00F0\u00ADI\x1E!\r\u00B9n\u00E4'\u00B2\u00D8\x1DI\x1F\u00CB\u00B7\u008E\x1C\u00B5|>\x06\t\u00FF\x052\f\x02.\u00E1\x00\u0090\x1B\u0092b\x04\u0080r\u00AE\x19YzI\"\u00F2\"\u008E\u00C6/\u00CE\u00F2\x1B\u00E4.]F?\n\u00DE\x0EV\x11\u00AB\u00D4\u00CEF5V\u00D2\u00A8\u00E5t}\u0089\u00E1\"\u0096\u00F9\x0B\u00A42K\x17c\u00EE\u00DD\u00E5\u0098\x19\u00BB_\tb\u00BC\b\x13Q\u00C3\x0F\u00C8F#N\u00A62rK\u00B5J\u00EA!\u00F1:\u00D8.s\u0096^5}\u00F5y\x16\u00DE\u008E\u00FDG\u0097\x07\x00\u00F0 \u00E9\x1B\x189\x14\x12I\nH'\u0080\u00D8\u0098\u0080\u008A\x00\u008C\x1D\u0089>,\u00A0\u00A7\x00\x11\u009Bd\u00FC\u0094\u00E5\x10\u00C8\x7F\u00FC\u00CE\u00B9/\u00F8\x17\x03$\u00E9\u00D1\u00B8\u00A0\u00FF\u00BF.{\u00AC\u00FA6\u0092D\u00CF\u00BE\u0090\u00BE\u00ABd\u0080\u00C47\u0091W\u00D5\u00A3\x01C\u0085\u00DFFFk\u00BB\u00C9\u00A5\u00AF\u00BA\u00D4\x0B\x19\x1E\x1D\u009E4\x7F\u00D5\u00A5\u00BD}\u00C02Y\u0080\u00C2\u00AF##K\u00AD\u00ECH\u0095\u0093\u00B2\u008C\u00ABD\u00AF\u00D6)Y\u00E6\u00FE\u00E3\u00CCAbF\u0096\u00CEWc\u00AA\u0088\u0099q\u0086\u00CB\x02d\u00B9\u00C4\x19Y\u00A2\u00F8\u00B8\x1E\u00CA\x14\u0097^R&\u0081\u00FC*\x04\u00E6d\u0099D\u00D5\u00CC\x11\u00BC\x19.\x0F\u00FA\u00DE\x7F\u00B4|\x179\u0092s\u00D27\x07\u00CA$d\u0088\u008C\u00D1,dh\x12R\u00A7\"\u00E3\u009A:\u00D7\u00A5Nw\x19\u00B7\u00C5yH\x12\u00D9*\u00F2\u0098\u0085\x04$\u00C5\u00C7g\x16\u00B2_\u0084\u00D5'\"s1\u0091\f\x1C\u00F3\u0090D\u00D9\x1Ce\u00EA\x05\x01\u0095\u00BA\u00FE\u00F3Z\u00C8\u0085\\\u00C8\u0085\\\u00C8\u0085\\\u00C8\u0085\\\u00C8\u0085\\\u00C8_\u00E9/9a-\u00A2\nN\u00B1\u00D9\x00\x00\x00\x00IEND\u00AEB`\u0082";
var basil_logo_binary = "\u0089PNG\r\n\x1A\n\x00\x00\x00\rIHDR\x00\x00\x00\u00B4\x00\x00\x00\u0082\b\x00\x00\x00\x00\u00CA\u0085\u00BD^\x00\x00%.IDATx\x01\u00ED\u00D9\t\u00B8S\u00E5\u00BD\u00F8{\x07\u0086Sg&\u00E7\x01\u00EA\u008C(\u00B3\u00C0\u00DE\u0088\n\u0082\u00E3V\u00A0\u0080A\x02\x04\bD\t\u00BA \u00F0\u0082\u00A1\u00AB\x105\u00BA\u00B4QR\u00BB4\u00B6\u00A9F\u00D3\u009A\u00F6\u00C4\u00C66=\u00CD5\u00B6iM\r\u009E\u00D8\u00C6\u00E7Y\u00BD\u00F1>io\u00EEY\u00A7\u00AE\u00FF\u00D3\u00F5<\u00EF\u00FD\u00DFo\u00E7\u0089\u00FF\u00B9\u00DE6w\u00AF\u00B5\x12\u00D8\u00D63\u00B0\u00E9x\u0087o\u00A7\u00CD\u00C2\u00EAg\u00BF\u00CF\u00EF}\u00D7\u00BB\u00C3q\u00FC?\u00B0\u00FF\x1F\u00FD\x17\u00EF\u00AD\u00B3\u00E7\u008D\u0093\u00FF\x0FC\u00BF1\u00E9\u009F\u00E3\u00C1\u00C2_\x1Amk\u00E3\u00AC\x0F\u00FEzLl\u00C8\u0083Rp*\x1F\u00AE\u00B4y\u009A=\u00B3\u00BFo\\\u00A0(9\u009C\u00BD{l\u00FF\u00D4S\u00BE\x1B\u00B7J\u0081\u00BF(\u00DA.\u0086\u00C7\u00C4n\u008Cu%\u00A1\u00B1\u00FD\u00FD\u00FDc\u00EE}H\u009B`X\u0095\u0094\u00B2d\\\x7F\u00FF\x19\u0081Uo\x01\u00D87\x19\x00\u008D\u00E4\u00F2\t\u00FD\u00FD}c\x06\u009F\u0086\u00EAhVq\u00FD\u00B8\u0085\u0091l\u00D3v\u00FE\u009F\u0093O\u00E9ke\u00FA\u00AD\u0094M\u00E3\u008C\u00BF\x1C\u00DAL\r\u00CC\n>\u00A3\u00B2c|\x7F\u00FF,\u0098\x16x>\x02VD1s\u009F\x1C\u00BF$\u009C(\u00BF\u0096 Q\u00CC\u00E4\\s\u00FC\u00ED\u00B3\x07\u00B1\u00E3\x06\x1EY\u00D3\u0086P3VL\x15\u00D1\u00DB\u00B4\u00E2v;\x1F\u00BDv\u00F4\u009D\u00A6\x11^\u00FC)\u00F6\rX\u00BAM18\u00F7/\u0084\u00AE\u00C5\u00FA\u00FBc5\u00886\x11\x02[\u00A5\x11#Y\u0083\u00C2Ka\u0082\u00CD\b\u0080b\u009A\u00A1\u00BA\x02 \u00E3\u00B6fb\u00C7-3\u00D4\x06\u00B5\u009C\u00CB\x14cd\x1A\u00B45\t\u00EF\u00F6\u00CD\x7F\u00C7\u008A\u00AE]_&\u00F0\x00Z\u009Bh\\\u00F6\u00FF9\u00D1\u00A5\u00D0\u0084\"N\u00C5s\x07\u00F4\x16NAZ\tA=M\u00BCNX\u0082x\u00AE\\\u00D5\u0092e\u00C0\x0E\x13~;`\x03f\u00DCJ7\x1C\u00B9\x19hC*WS\u008D \u00D9<F\n\u00D8q\u00C5KdWf\x03m9\u00F0\u00AC\u008C\u00B7\u00ADp\u0099\u00D2\u00D8?\x17\u00DA\x19\u00D9@\u00E1\u00FE`\u00D0\u00C2\n\u0086\u00B6\u00E3UMS\u00CB\bt\u0083\x10\u00B6\x00\"~\x14\u00E9\u00E8\u00C9\u0096\u00AB\u00C9@\x1305\u0099\u00ABb\u00C7M\u00D3\u00DF\u0086R\u00CC\nZ!\u00BB\u009C\u00A2\u00AA\u00C1+\u0097\u00A8\u00D4\u0097\x1521\u00D9\u00BE\u00F6s\u00A8\u00ED\u009A\u00CF0\u00C3Z\u00DF\u009F\t]\u0099\x10(D@P\u00BC\u008E\u00EB\n\u00AD\x04^\u00C2\u00A6X\x14\bZq\nE\u00B06'*I[\x01\bI\u00DF\u00939\u00CF\\*#5\u00DB57\u00A2v\u00B0-\u00EA\u0086N!M{\u00DEM\u00EDf f\u0085\u00F3\x18}\u00DFFk\u00E7T;\x1Fl\u00F2g\x1A\x0Fm`\x1B\b\x1C\u00ACp\u00E4E\u00BC\u0082\u0090\u00FEz\x02A\u00C2@\u00B1!\u00F713d\x16\u00F2@5\x11\x7FF\x05ZIY\u00CFak\u00DE:\u009B>;TOW\u009A\x1A\u00B9\x02\u00A1\u00A9E;\u00A64\u009B\u00CB\x1A\u00BCz\u00DB\u00BB\u0083\u00E6H\u00DA\be\u00E1\u00CF\u0083\u00B6\u0096\u00C5\u00A4\x00A9\u00EF\u00A1\x13-\u00DCJi\u00D0\u00DE\u00D0\u00AD\u0098\u00A3\x0F\x02\u00F7\u00AFmD\u0089\u00D8\u0080b\u00AC\u00F1\u00D9`$e3\x05\u00DDu\u0096\u0081v\u00B2\\\u00D0\u00EC\u0098\u00CCT\u00BEt\u00F1.r\u0081\ny\u00C5\u00E6\u00B3K,\u00B4w\u00C2\u00D5X\u00C4\x04;;\u00FDOE\u00B7\x0B\u00EA\u00C0\u0099ep\u00D1\u00E9:\b[E\u00E0\x15\u00B6A\u0094\u00F3\u0085\u0092\x11\u00A3\u00A6\x037\u00E4C&~@\x06\u0083\u00CB\u009B`\u00E8XId\u00BC\u00ED\u009AQ\x1A\u00C5T+,#f\u00AA\u00B2d~\u00BB\u00E1OID\x1A6-1I\u0094\u0082Y_\x05\u00A4\x16\u00C8\u00CB?\r]\x19\u00BF@\u00C9\x18q\u00C7\u008A\x15Cu\u0090\u0086\u00DEC\u00CB0 r\x15\u00AD\x1D7P\u009BP\u00EBk\x04\u00A9\u00A9@V\u00BB\u00B3\x04u\x1D\x19\u0097\u00C4-\u00CF\u00AC\u0096\x1AQ\x19\u00B2D+\u00BAv\u00D6\u00AB\u00A6\x12\u00B5h\u0086kXwo\u00B2\u0089\u00C7\u00F7mOJL5\\\x01\u00FE$\u00B46\u00F0\u00BC\x0E44\x10xXge{\u00E8l\x11\x10\u00BA!\b\u0082\x02\u00EC\x16j\x13\u00CD\x006/z\x02\u00AA\x19\u0088\u009Bvo\u009D\u00B3\u00BA\x15\u00B2\u00D5f\u00F4\u00E0\u00EDW\u00C4e,\u00D4\u0082j\u00C8\u00A4}\u00EB\x0E\u00C9\u00C3k\u00A2J\u009BF8d`Dgx\u00E8c\x1Fe\u0082\x16\x10\x00A-\u0083\u00F0V\u00B6wx(\x12\x10Z[\x18\x1A\u00A6\n\u00F4\x7F7\x02\x01\u00C0\u00B8\u00ED\x16I5\x0B\u0089v\u00EF\u00DC\u00A0\u009A\u0090a3]Nd\u00CEYd\u00A5\u0097\u00D5\u0080TBR[\u009C\u0084\x07o\u00F1\x17\u00A9\x04\u00A3f-\u00E6\u008F\x19\u00FD\u00C7\u008E\u009E5s\u00C2W\u0081Z\x1C\u00885\u0089Y\u00C5\"\u00C2[\u00D9B\t'K\x00\b\u00D1JhMRU\u0090S\u0084\u0081\x19\x06\x1E\u00BC\u00D4\u00A4\u0092\u0085L\u00BDw>c(2R\u00AF$\n\u008B\u00CF\u00FDB=\u00A0K\u00B0\u0095\x02\x14\u00EF{\x0EBW'dYI\x1DT\u00C3Z\x13\u00F8\x13\u00D02\u00F8BP\x02\u00D1&\x18qt#W\u00F1\u00D0\u00AA\u00AD9\b\\\u00A7\u0083.\u0094\u00C2\u00A0\x00\u008Fn\\\t\u00B9\x12p\u00F6K\u0094\nP(\u00CBxw\u009D\u00AD\u0095V\"c*\x0F\\|K+\x12\u00B3\u0080\u0086h\u0081\x1A*\u00C0\u00FC+\u00DE\u00CC\u0085\u00F7\u00EDT\u00F4&N\u00D6\u00F8cC\x1BbF\x05b{\x14\u00C0T\x00?\u00BA\u00A1\x1B\u00AD\u0084\u008B\u00EC\u008Dt\x18\x0F\x1Dm\u00A9H\x05\u0098\u00B3\u00AF\x02!\x1B\u00B6\u00CEt\u008F\u00F2r\u00DE\u00B9o\x04\x1C\u00B3\f\u00B5\u008AI\u00B9z\u00DA%\u00FB\x1F\u008D\u00B8\u00B6\\D\"CJ\u0099\u00F6\u00A5\u00AB\x0F\u00F8V\u0085\u00D3&^\u00F6\u00FA\u00B5\u00C7\u0080\u0096\u00D9%\u00D7\u00A7-5&I\u00AFx\x18\u0088V@\u00B435\u00AD]\u00CE\x0FE\u009BQ\x003.\u0084f\u0090+B}v\b\u00F0Cs\u00C2\x0FJEhd\u009Du\u00F69f\u0094z#b\u00CD\u009Cu\u00C3\u009A@\x19\u00A7x\x06\u00CC\u00D0\u00BD\u0086|\u00F8\u00EC\u00B9\u00B3WfLz\u0099\u0089`a\u00F8hk\u00C2\u00BA:@\u00C5W\u00A5\u00B6\u00F8\u00D3`\u00FB\u00A0\x1Ew\u00DE\u00D6\u00A9\u00C6Pt\u00B2\x06`\u00E8B\u0084!b\u00C3\u00F6\u00F9y\u00A8\u00A5\u00B0\x17\u00AF\u00C8\x15\u00C1L\u00CA\u00DEY\u0087\u009A\u00B7\u0082\u008F\\\u00BC\u00FD\u00FA9\u00BAteJ\r\u008C`\u00B8\u00F1\u00AD\u00E9\u00A7L~\u00C1\u00E6H\u00ADH{\u00BC\x1C>z\u00E5\u00D7\u00BA\u008BaGc\u00D2\u009C~\x00\u00F4\x02\x04\x1DtT\u00BA\u00E8fr\u00C8t\u0094\n\x1B\u00921w:\u00E4\u009D\u00F3\u0080H\u0093\u00F5\u00B3\u009F\u00AD\u0082\u00A5Y\u0087\u00CD\u0099\u00A4\u00BCc\u00FA-{/\u00BB\u00D9\u00C4\u00A9\x12\u00B5\u00A0\u00A0n|j\u00EE\u00F8\x0B\u00BE\u00CC\u00D0Zq\u0099\u0098\u00C7\u00B0\u00D1Z\f\u00A2:ne_\u00D5\u00BEZC\u00DE&Q\u008BYA\u00F7\u00B4\u00C8U\x00\u009A\x1AN\u00D9\u00EA\u00A2\u00DDm*\x19\u00C8/\u00F8\x02\u00B0\u0092\u00F4\u00F2\x1B\u00AB 5\u00AB\u00B7\x07)\u00C7\u008C\u00CB\u00FA\u00F27\u009C\u00BD\x1F\u00B7d\\\u00C2s\u00AB\x17\u00CC\u009Fq\u00C3\u00BDy\u0086VOZQ\u00AB\x7F\u00D8\u00E8\u00CA\u0080\x042B\u00E2$\u00A3\u00AAu\u00EDn*)*\u009F\u00D4\x05a\x0F\x1D7\x01bmO\u00D0\u00EC\x0B{\u00BF\bL\x03\u009A\u00F1\u00D6\u00E6\x05\u008F\x00Z+nv\u00E7\u00D9\b<6\u00F9\u00DEW/\u0099\u0095\u00C4\u00C9\u008E\u00D6\u00B0\u00F5\u00F9w\u00CC\u00EB\u00FF\u00F8\u00DDO\x16\x18\u009A\x11'\u00DAf\u00D8h\u00EB\u00EC\u00CF\u00E3T\u00F5\u009B\u00B8\u00D5|\u00DF\u009A\u00B7E\u0086L6%\u00BB\u00E8{\u0093\x02'\x05\u00B7\u00A8\u009C\x1D\u008704\u0097\u00DD\f\u00C4\u00FE)4g\u009D\u0084\u00D4;\u009Aw\u00E7\x07k\u00F1\u00CDK\u00EF\x0F,\u00EC\u00F7\u00CC\u0086\u00F2\u0086.\u00F6l\u00DCx\u00E9\u009A\u0097\u00C4\u00B3\x1F4WT\u00A9\u00B5\x19>:X\u0088Gm\u0080\u0096\u00AFAw\u00B1\u00B7\u00DD\u00B4\u00FA\u00CD\x18\u00D1\x07\u00BA\u00E8\u00F5Y\x17]\u00D3q\x13oMm\u00D0\u008AC\u00AC\u00FFy\u00C0\u00B7y\u00F5\u00C3*d\u00DF\u00EA\u00DEE\u00A1u\u00E5|}\u00DE\u00F6\u00E7\x16\u00EC\u00C5)\u00B9\u00F0\u00BE\u00A4a\u00CC\u00ED\u00EFo\u00A8\u00D9\u00F4\x07\u00CD\x19\u00D5Yg\u00EC\u00F1\u00C3D\x17\u0083P_Yp\u00B1\u00A1\x02^\u0095;V\u00FA7\u00B6+w\u0089f\x1C`i\u00D5E\u00ABf\x17\u009D\u0099\t\u00E9\x1A\u00ACX\u00DD\x06\u00FB\u00F6\u008D+\u0092\x06\u00A5J\u00EF\u00DD-\u00D5\u008Bv\u00EC\u00BF\u00EC\u009D\u00AF]\u00B7\x15h>\u00BCp]\u0093\u00C6\u00C6yw\u00ED0C\u0095L\u009E\u00A1\u00E5\u0092\u0088&\u00B0y\u00ED\u00F0\u00D0\u00E6Y\u00CFI )l\u0080X\x02/{\u00ED\u0092MK\u00E4\x1CQ\u00CC\x02\u00DC\u00FAJ\u00C6\u00C5\u00E2%\u00D6\u00AC\x05\x01\u00F9\u009Bv\x02\u00FB\u00AE\x0E5\x05\u00D5\u00CF\u00F7\u00EEH\u0099\u00BEY\u00E1\x01_\u00ABu\u00B5OVb\u0091\u00F8\u00AA:\u00E5\u00C8\u00B6\u00DBo\u00CF\u00D4\x15\u00B3\u0098ch\u00E9\u0094T\x1B\u0080\u00BA\u00BE0<\u00F4m\u0095\\P\u0093P\u00F7\u00E5\x00\u00F2a\x1B\u00AF\u00C7\u00AE_\u00A0\u00CC\u00DB\u00AE\u00D7\x00\u00E6?W\x07\u00CA\u00F9\x1Ez\u00D6K\u00C8(,\u00DB\u00A5\u0081uV.V\u00CB42\u00DD\u00B3\u00AE\u00BA~\u00D1\u00EEy\u00FA\u00A3\u00D5\x1FL\u00BBSQ2\u00EDj\u00C4*\u008B\u00F4\u00CE%K\u00CB\u00E9\u0098\u00FC#s<K\u00D81\u00C7\u008DqrXh%\x05T\u0095\u00B8\t\u00A9\u00B0\x05\u00D4\u00BD\u00A9\x04\x1E^7\u00E9\u00F2\x15\u00C2\x02\u00E8\u008BJ *{\u00E8K\x1B\u00E4\u00CB\u00B4\u00A7?W\u00E3\u00E0\t\u00A3\u00CF\u00FAR\u00ACu\u00C0[\u00E7\u00F6\u00F6\u00A5{W\u00DFd\u00E6\u00F5\u0097\u00CE\u00BD\u00FCy\t\u00FAS\u009F\x17\u00F9\x1F/\f\u00EC\u00AC\u00AAiR\x19\u0086\u0096H!\f i<t\x0B\u00C3A\u00A7\u00C3\u00B8\x19\u00A1\x13L\f_\x160\u00FD5\u00BC\u0094\x07\u00CE\u009A\u00B0\t\x17-\x00\x19\u00A5[\u00E0j\u008B\u00A8\u00E4\u0081HT\x1E<9\u0086~\u00F9\u00F2\u0087\x1F\u00B1O\u00BC\u00E4\u00D2K/\u009Dp\u00DB\u00DE\u0095K\u00CC\u00C4\rkf\u00DEa\u0081\u00F5\u0080\"*|\u00B5\u00EF\u008B+\u00BF\x19\u00A9\u0092\u00FE\u00A09\u0096'\u00D2p\u00EC\u00D5\u00F8~m8\u00E8\u00DA\x12I\u00B7\u00E3#\u00A1&\u0099\u00A0\t2\u009C\u00C3M\x06&]:\u00E1\u00F5\u00C3\u00E8|\x1E\u00AF\u00F6\u009CU\x10F^\u00D2\f3zO\u00A7\u00D3y\u00EF\u00E2\u0098i>\u00DCq\u00BE\x1A\u00FF\u00A9Y\u009B\u00B6\u00AD~m`I\x13\u00CAs\u00EEm\u00D0\u008E\u00DC\u00FA\u00CF\u00E1\u00AFG\u00DA\u00E4S\fM\u00E4\bW\u0080T)Y[Y\x1B\x06\u00DA<\u00EF\u00FB\u00F4:\u00E1\u00F7\u00FF\u00AA\u0086+M\x7F\x1AH\u00C4p\u00B3\u00CE]<\u00EF\u00AA\x180/\n(\x12\u00AF\u00FA%;)\u00A7yz\u0089\u00A1\u0099#\x7F\u00E5X\u00FBl\u00D3?\u00A6\u00E3t\u00FE\u00E4/\u00C8\u00D0\u00CB\u00DB\u00FA\u00AA\u00D4\u0096\u00DE\u00D6\u0086\u00D4\u00DA\x1D\u00DF\b|:&\u00C9\u00EB\f-T\u00E8\u009As\u0085\u00B25F\x0E\x03}\u00DB\u00FF\x14\u00B7\u00F1\u00D2Fw~\u0083\u00D4C\u00C5\x17\u009D\u0099.\u0086,\u00EF/\u00B8d\u009A\x1C\u00B8\u00C9dj\x16l\u0095n/L\x13\u00A86W\u00FF@\x7F'\x14q\u00A4\u0087.3\u00D7$\u008E\u00F7\u00D0\u009F&\u00F2\u00D9'n\u00FA\u00A7\u0092r\u00E7\u00ABPW>\u00AE\u0097b;\u00F3\u00FC\u00D1:K\u00A5B\u00B0\u00EC\u0098S\u00A5\x1C\u00FD\u00DB8z\u00B4\u0092\u00C2\u008E{\u00BAdkt\u00E7\x0F?\x03\u0099\r}&\u00A8\u0083\u00E1k\x01\u00DC\u00FA\u00F8i6O_\u00FA\u008D\u00CB\u00EB\u0090\u00AE\u00D3m\u00CDZ\u0081\u00C0\u0098\u0086\x10U\u00F1\u00D1G~\u00DBy\u00EA\u009A\u0085\u00A1\r]\u00B4\u00AE\t\u00FD\u00F6\u00AD\u00A1d\u00D0\u00C0\x12\u009A\u00C8\x17\x1E\x15\u008D?6\u00DB+\u00EB\u0084\u00F2@!UM\x10\x1Fc\x1D5\u00DA\u00DB\u0084\u00D2]\u00EBT\u0083\u00D1\u009D\u00CE\u00BF\u00E1\x1Dz\x0F\u00DC\u00DD\u00C2\u00F2W\u0080\x1B^\u00BEz9\x18W\u008E\u00B1@\u00D0k\u00FE\x13\u00C2\u00D0\u00B9\u00F9K\u00F8R\fL\x1C3\u00FE\u00CC\x11\u00E3\u00D6)\u00AD\u0091.\u00FA\u0082U\u00EB\u009E_<5\u00FB\u00AA\u00B0\u00C9\x05\u00DF\x0E\u00D5\u00F5\u0090\u00B0 \u009F\u00FC\u0080\u00D9_!Zq\u00CD\u00CD8\u00E9\u00BB\u00E6\u00D3C\x1F\u00ED&\u00B4\u00E36\u0099:\x0E\u00BA\u00F3\x0B\u00DC\u00AA[o|\x18\"i\u00E8K|\u00E7\x12\x1D^;uq\u00DD\u008C\u00D3\u00ADyMC$\u009A\u00E6\u00E5|\u00F3&i_3\u008D\u00CF\u00DEs\u00E1\u00E2*t\u00D1\x13W-^@2I;\u009E\x7F7hhJ\u00D6\u00C1E\x19\u0092\u00E97P\u00F3@5\u00D2Vd\u00E1\u00E6L\u00E4\u00E8\u00D1\u00FD\u00CFJ<\u00F5\u00CB\x15<\u00F4\u00FFI\u00B7\u00DA\u009A\u0099\u00DF&\u00A5\u00D2\u00A7\u00D8\u00B3\u008F?\u00F1\u00E4S\u00CF\x1E\u00B7\u00F0\u0096\x06\u00DD\u0094\u00E3G\u009C|\u00FA\u00E9'\u009C\u00F8\u00E5\u00B9\u00DFd\u00E7\u00C0@\u00FA\u00AA\u00A9K\x0F\u00D2C\u009F?\u00EF\u00C0TS\u00D4H\u00C6\u00ACj\u00D0~\u00D0\x1D\u00DCj\u00EC\x03\u00E6\u0081\x16\"\x07T\u00C3V\u00C4n\u00CCiE3G\u008F&\u00E7K\u00B9\u00EC\u00AFl\u00B6\u00BB\u00E8\u00CE\u00AF\u00F1\u00FA\u00C9\u0096\u00D7\u00FB\u0096\x18\u00A5\u00C0\u0084\u00E3N\u009F\u00F4\u00D0\u00AF;\u009D\u00EA\u00B6K\u00C7\x1C\u00F7\"N\x07?r\u00B6\u00FAkg\u00F3=8~\u00F4\u00AB\u00C6\u00BA\x05\u00E3\u00CE<o\u00E2\x05\u00A7\x1CA\u00FF\u00E3\u00C4\u0082\u00D2*\u0087\u00EA\x14\u00A3r\u00F7\u00DD\u0086\u0083\u008B3\u00A4\u0096\u00BFM,\r4\x03V\u00C84g\u00BF\u00C5@s\x18h(\u00F8\x136\u0095\u00BC\u00BB\x1BGu\x06\u00FB\u00C3Oq\u00FA\u00E5\u00EF\u00DF\u009B\u00F8\u00C2k\u00B36\u00BDz\u00D2\x0F;\u0087\x0B\u009D\u00E0\u009AG\u00ECv\u00C8N\u0087\u00D4\x13\x02\u00C5[\u00A2\u0083_\u00ED\u009F|\x18=\u00EE\u00A3\u00D7)-%!I\u00A5\u00AD\u0081\u00FBm\u00C7\u00AC3$3`y\u00B3a\u0086\u00EDPC^\u00F7\x06\u00E6\x18\u0086\u0085\u0086\u008A\u00FF\u00BE\u00E7\u00BCO\u00EDG{\x10g\u0099\x0F\r~\u00F1\u00A3\x0B_`\u00FBG\u00FB;G:t\u00CE\u008B\u00C0G6\x1Dy\u00A2/\u00D6\u00D3+w\u00F5\u00D0'z3}\u00C1\u00D2L\u00C0@*E\u00EB\u00C68\u008E9\u00F9\x01s\u00B0MT\u00F7\u00CCj\u008D\u0085\u00AF\u00D0\u00F0_;\\4\u00C6\u00BE`\u00B4\u008D\u00BD\u00D4\u00F0\u00D0\u009D\u009F\u00F1\u00AB?t\u009C~4\u008A\u0098z\u00E5{C\u00D4O\u009D\x0E\u009C\u00F1\u00CB#\x0F\x16\u00AD\u0091k?\u00BD\u00B3\u008B\u008Ew\u00C7c\u00E9\u009C\u00ACc\u00AB\u00BF;\u00EB5\u00D7\u00AC1\u00A4f\u00D0&\u0091\x00,\x7F;\u0091'\u00F0$\u00E5py\u00FCQ\u00A2\u00EDex\u00B5\u0093\u00D0\n+\u008F\u00BC\x15\u00F7\u00D0\u00FFm\u00DA\u00C4)\x13\u00C7\x7F\u00CF\u00F9\u00F2\u00A3%5\u00B4g\u00C1\x0F\x1F?c\u00E2\u00AC\u00C9'\u00FF\u00EF\u0083\x0F~;\x1E\u00B8\u00F4\u0088\u00B9pO\u009D9\u008D.:\u00AF\u008E\u00F0\u00D0\u00CBbE\x1A+\u00DB_\u00B9\u00D6\u00F8\u00B0\u00D9\bI\n\x1A \x03\u00EDt\u008A\x1D\u009F \x15OO{\u00F9(\u00D1Z\u00EF=\u00ADI\u0080\u00E4\u00A6\u00F0wOt\u0086\u00A2s\u00F2\u00E3\u00BF\u00EE\x1C\u00FA\u00B8\u00FB\u009E\u0098r\u00EB\u00A7\u00F2\u008B\u0092\u00A3.\u00FF\u0081\u00F6\u00BB\u00CE\u00FE;\u00DC'\u00C0\u00D4\u00C3\u00E6\u0083;\u00F6 \x17\u00BE\u00E9\u00A1k\u0081\u00FA\u0089\x1E\u00DA\u00DE\u00A4\x15\u0082\u00F6\u00FE[\u00EC\x0F\u009Bk\u00C2\u00A6\u0090\x02\b\u00B7\u008A:{\x03D5\u00FFCA\u008E\x0EmO\u00B3\u00E8\u009D\u00D1@\u00BE\u0082)N\u00D8\u00E5l\u00B0\u00CB:N\u00A7\r\u00FE\u00E7\u00FD\u00F9\x13t\u00E6.{\u00A7\u00F3\x1C\u009D\u00CEO\u00CEw\x1EO\u0087Fo\u00A5\x7F\u00FF\u00EDo\u00CD\u00B2\u00C8\u00AFR\x07\u00D1?ONV\u00F2\u00FA\bo\u00A6\t\x0E\u00A8r\u00FDR\u009C\u008C\x18C\u00AAF$y\r@\u00A9W\u00A3$\u00EE\u0090\"\u00A9<7\u00DE:Jto\u00A1=s\u00A9\x040\u00F2\u00A9\u00EB\u00DE\x1Ctu\u009C.rV\u00EF\u00B5\x11\u00B25i\u00E7\x7FO\u00FC\u00BC\u00D3k.DO\u00FF\u00DF<\u00F3C\u00FFp\u00FC=\x10\u00DE\u00A9\f\u00A2\u00DF{q\u00F2\u0097s\u00B1S\u00BA\u00E8\u0085\u00B7\u009Aw\x1E\u00C0\u00C9\u00D4$G*\x0B\u00C8\u00AB\x00\u00F1\u008A\x11\u0096\u00CF\u00DE\u00F6\u00AF\u009B\u00EF\u00D9\u00BEf\u00DB\u00FD\x1C%z\u00AE\"T=_WM\u0080J\x1E\x17\u00DD\u00F9\u00F5\u00CA\r_\u009F\u00D9q\u00BA\u00BC\u00D3y\u00B1\u00B0k\x1C\u00CFL\u00FC\u00E8n:\u0087\u00EB\u0083\u00C0}\u00E7\x1E\u00EC\x1E&\x0F\u009E\u00BAT\x0E\u00ACI\x0F\u00A2\x0FV&\x7F-\u009D;\u00D9C\x07_\x1E\u00B8\u00F6\u00F3\u00FF\u008E\u00B9\x10\u0095\x14\x12\x00z\u00D9\fZ\u00D9\u009B\u00DFX\x7F\u00E3=)\u00B9\u00B0~\u00B4h\u00C06\u00CA\u00EB>.\x06\u00DBtW2[lH{\u00E4\u00A0#\u00F9E\x0F=\u00A5s0\u00B9\u00FD\x7F>\u00AD\u00B1\u00E4,]\u00F6\x0E<\u00CBA\x17\u00F3<>\u00A9\u00AB\u00EE\u0098\u00E7?\u00AE\u00CD\u00B1\x07\u00D1_\u00FD\u00FE\u00E4WT\u00E9\u00A1\u00CF?\u0098\u009D\x14\u00F9\u00F7\u00CCZ\u00EFm\u009E\u00C8\u00D8!\u00BBp\u00D7\u00CB\u00D7.\u00F8\u0094\u00C4\u00B8\u009Ea\u00A0!\u00D5\x000R4\u00AB\u00C5\u00D4\u009E\u0085'\u00EE\x1Fl\u00B5\u0087\u00BE\u00E2\u00D7\u0081O\u00BC\u00A3_\x1B\u00BEbw\u00EF\u00C8\u00FB\u00F9#\u00FF\u00C3AG$\u00BF|\u00EF\u00CAe?\u00EAt\u00BE\u00FB\u00E2\u00FB\x1D}\u00EE\u00DB\x0B\x18D'\x7F>y\u0085\u00DC\u00EB\u00A1\u00CF[\u00BDf\u00E3\u00CE\x0F\u009BS)(G\x00\u00F4\u008C\f6\u00F3\u009Bv\u009C\u00BB\u00A2\t\u0088\u00CC\u00B0\u00D0\u0099z\u00EF\u00C8sw\u00A45\u00DA\u00D9|\u00FF\u00AB\u008B>4v[\u00E6K\u009D9\u00C1\u00AFL\u00FA\u0097\u009E9y\u00C8\x19\x0FK\u0081_u\x0E\u00E93\u00AE\x1A\u00BD.1\u00F8\u00D7M\u00D9\u00B4\u00C9A\u00EF\u00EFL~+\u00BE\u00C1\u009B\u00E9\u00D3\u00A77\u00F3\u00AB>d\u00D6u\u00A8*\x12\u00C8\u00EB(\u00F5\u00CA\u0096)\x17\u00BE\x01\u00C8\u00F4\x18{8\u00E8|\u00A5w\u00E4uO\u0091\u00F1\x1D'\x17\u00FD\u00E4i\u00FF\u00B8\x7Fp\u00CD\u008C\x13\u00B6\u00F4\u00CC\u0089\u00F7\u00DD\u0099N\u0095\u00C1{\u00B9<>\u00C9\u00D9\u009FO\u009F \\\u00F4\u00A1\u00AB\u00F6l\u00CF}\u00E4\u00F7\u00CEo\u009C\u00B2\u00C9\u0092\x0B\u00DB\u0098b\u00A8&\u0096\u0082jL\x02e\u009DT\u00FE\u00F5\u00EB\u00C7\x06\u0081\u00B2\x12xa\u0080a\u00A0K\u00A5\x1E\u00B6w\u00A7\u00F6\u00D0\x13\u00DF\x1B\\\u00C81\u00AA\u00EFP\u00E7\u00C08\u00FD\u00B8f\u00D7\u00AC\x1D\u00EA8M\x0B\x02#\u00B6:G\u00E3\x0F\u00C7\u00BB\u00BFq\u009C\u0087\u00FE\u00E1U\u00AB\u0092\u009C\u00DDr\x1E]\u00B83\u0081?c\u00DEy\u00FCi\u00D3\x15!b\u00BA\u009E/V\u00F6~JR\rK\u00A0.\u00C8\x17\u009F\u00B8f\u00ECg\u00B0S\u00E1\u00B4MR\x1B\x06\u00BA\u0092\u00EF\x1Dy\u00DEl\u00D0C?r\u00C1\u00FB\u00B3g)\x0F\u00D2\u00A9\u00AC\u00BC\u00F03\u008B\u00AEr\u009F\u00A1\u00BF\u00EF\u00E1/\u008Aq\u00F0\u009C\u00ED\u00D3N\u00BDj\u00C1\r\u0093_q\x1E<:\u00CAC\x7F\u00ED\u00AA\u00CB%[?\u00E7\u00BE\u00FD\u00C7.c\u00EF\u00F6=g\u0099\u00D5\r\x13^\u00C02\u008CrqcD\u008F\u00AE\u009F\u00B9S\b\x11Z\u00B8\u00D3\u00B7`\u00F6Ec\x1E\u00FE\u00F4\u0096\u00AD\u00DF\x00XY;J\u00F42\u00A8gp\u00D2\u00CC\u00DEr\u00F7\u00D08\u00D7\u00D3\u00C0\u00C7\u00FF\u00A5\u00F3\u00DE\u00AE\u00B3\u009E\t\u00BD4\u00C5}\u00A6u\u00CD\u009D\u00BE\x16\x13\u00F6\u00AA\u00CF\u00DE\u00F2~g\u00E7\u00F5\u00EE\u00EC\u009F\u00F7y\u00CDEkW\u00CE\x016v\u00BC\u00D9*~\u00FF\u00CA\u00A9\u009Ft~2?\x03\u00EFT\u0086\u00BAO\x02\u00CD\u00A8|y\u00D1\u00EEK/\u00F5\u00FBv\x1D\u00D0U!\u00C4\u008E\u00B1\u00F2\u00E8\u00D0\u00ED\u0085\x18)\u009C\u0092\u00AD\u00C3\u00B3\u00D1C\x1F7xZ\u00DC\u00FBl\u00B9\u00F3\u00EB\u00E0\u00EA\u00B3\x1B{\u00C4\u00D8\u00C1G\u00F2\u00B9\u00F7;\x7F\u00E8\u00A2a\u00E4\u00C3\u008D\u00BB\u00AA\x1D9\u00ED\u008B\u00EE`\u008F1t\u00AE\u00EC\u00BC\u00FF\u00C8\u00FE\u008Bn\u00C9\u00C3\u00AA\u008E\u00B7\u008B7\u00A4\u00FAf\u00BB\u00D7\u00D7K\x01\u00B4\n\x18\x11\x1Bh\x05\u009A\u00DB\u00D7>6\u00E9\u00C2-\u00CD\u00A1/\u00B9\u00A3B\u00E7#\u00EDd\u00EF\u00C8\u00EB\u00CD\u0086\u00D3i\u00EF9{\u00FF\u0092\u00F7\u00B4l\u00A2\u00D3\u00F9\u00F8\u009D'\u00BE\x19\u00DAU?n\u00D5\u00AF\x7F\u00FE\u00B9\u00F7;\u00FF\u00CB\u00C1\u00C7&\u009C;\u00F8\u00BB\u00F3`\u00D6?\u00CC\u00F5w:\u00BB\u00AE94\u00A8{x\u00D4W+9.\x18|!\u00EE\x1F\u00BB\u00D4\x0F\u00A3T\u0097z\u00F9\u008C\x1F\u00AC*\u00BB\u009F\u0081\u009C)\u0084X\u00B0I\u0088{\u00E78\u00B3\u00B1\u00FD\u00EA\u00F97\u00CE8\u00FB\u00B4\u008Bn\x15\u0087\x1Bg\x1D%:\u009A\u00D2d\u00EF\u00C8\u00F3f\u00C3k\u00DDe3/\u009Ey\u00E2\u00BD']p\u00EE\x13\u00DCv\u00D2\u00C9\u00AF\x1B;\u00C2|{\u00E4\u00D8%?\u00EF|\u00EF\u0096\u0093O\u00DA\u00FC\u0091\u00993g\u008C\u0083\u00CD\u009BF\u009C1\u00E5\u00D2\u00EB\u0097\u00E8\u00D3\u00A7\u009Du\u00D2W)\x16\x199\u00E3\u00F2K\u00CF\x195Ui\u00F2\u00BD\u00F3.z\u00E4\u00D7\u009D\x1F\u009D\u00BF2\u00F9\u00EC\u00C8\u0081\u00FF\u00A3\u00F3\u00DE\u00B5\u00DF\u0080\u00A8\x01\u00CD\u0080\r\u00FC\u00EB\u0092\u00C8\u00F3S\u00E6\u00CD\u00DA\u00BC\u0093#\u00F5s\u0094\u00E8\u00DBw\u00F7.ICf\x032\u00A1\u00C7\u0084\u00E4\u00ED\u00D3\u00EF\n|\u00E7\u008A\x13F>\x04\u00EA>\x0BZ\u00DBO<n\u00D4\u0089'\u00BD\u009Eh\u00D3\u00FC\u00D4}\u00C0\u00F5\u00B7m@^:r\u00D4\x19w\"\u0080L\u008D>\u00F3\u00D1\u00FB\u00C5\u0096I\u008D(\u00F0\u00BD\u00D3G\u008D>\u00EE1u\u009D\u009Cq\u00F5\x19\x17\u009F\x13\x10b~H\u0088\u00AD\x0B\x0E\u00E8\u00FA\u0081\u00E0\u00C5K\u0096_\u00B1\u00E9\u00EA\u00FD\u00EB\u00CCcA\u008F\u00EF]\u0092\u0086\u00CE\u0086\x1DJ\u00C5\u00B3P=\x7F\u00EE>\u0083\u00EA\u00CA\x14\u0098\x1B\x13PW\u00E5U\u00EB\u00F6$\x184Wr\u00B9\"X\u00B3\u0096\u0095\u00D1\u00D6\\\u00D0\u00B4\u0084\u00A1\x03\u00BA\u00C1\u00AA\\r\u00B9H\\h\x04$\u00DD\u009A\x03\u00D59\u00B8%\u009A`*m\u00C3x\u00A8\u00FF\u00A3\x01\u00FD\u008A\u00E8y\u00FE\x05\x07b\u00E2p[&\x1C-\u00BA\u00BFw\u00E4\r\u0099\u008D\u0086\u00DF\b\x17\u00A08\u00B5\u00FF@\u0091\u00E6\u00AAg\x00u\u008B\u00C4\u0088\u00C9\u00D8\u00E5\u00FBT\x193(\x15Ql\u0088\x0F\u00CC\u00C4T\u0096L#W\u00CA\u0097\u0081\u0098\u00C5\u00F6Ht\u00DF\u00B6\u00C2\u0095j*K\u00AF\u00E0\x03\u00AB\u00CB\u0080\u009D\u00B0\x1C\u00B3up\u00E4\u0088\u0093\u00C7\u009E\u00B2\u00F6\u0086\u00AF\\]\u008C\u00B49\u0092\u00D1o\f\x07]\u00CF|`64\u00F1\u00AE\u00BF\x06\u00E9k\u00FA\x1EK \x17%\x01km\u00DAY\u00E7\u00FA\u0085\u00AB\u00EA\u009AVA\u00AF\u00D0V\u0081\u00A9\x0F\u00AEG\u00B4'\x05\x11\u00B6j\x03\x02DX4\x175.\r\u00DBAz\u00D5o\u009A0~\u00E6\u00CC\u0099\u0093O\x04S}\u00F5\u00C41\u00CA\u00E0\x06}o\u00D6\u00F4\u00F3O\u00B8\u00B6\u00CE\u0091\u00BE;\u00DE`\x18h#5t6\u00AC`\u00A1\u00E5oA\u00EE\u008E\x05O\u00A9\u00B0z'\u0080\u00BEB\u00D6\u0093X\u00F3'\u00CA\u00E0\u0093u)J\u0090h@\u00F6zE\u0094\u00E3\u00AD\u00B3r(\b\u00BA\u00E8\u00E86\u00E6\u00B4'%\u009Aj\u0093^w\u008C^\u00D4\x19l\x02\u00ED;o>\u00E1\u00FEA\u00B2W\u00FD\x14\u008E\x14_\u00B0\u0097a\u00A0\u00DB\u00C9\u00A1\u00B3Q\u00F27J\u00FE6\u00A46\u00CE\\\x1F\u00B4\u00D9\x11\x01\u0090\u00B7d\u00AAq\u00B8~A\u00B2\x1A\u00AA\u00D8A\x03\b\x03W\u00C7\f\u00E1\u0093\u00FB.\u0094m\u00F5\b\u00BAx\x177\u00B4/h%\x1AQz\u0095\u008E_\u00E4\u00BC\u00F8\u00C7\u00EE\u009Dr\u00CB\u00C8p\u00E7H\u0093\u00E8\u00D5\u00F2%O\u00B7\u0086\u0081\u00B649d6\u00D4\u00B8\u00CC\x0B\t\u00C9\u00F8\u008C\u00D5\x1B\u009A<\u00B2\x0E\u00A7d\u00B8\u00AA\u00C1\u00BA\u009DS\x19\u00F8\u00BC\x19n\x015\x1D^Z\x12\u00E5\u00D62wL%S\u00B1b=\u00B4=\u009B\r\u00FA\x05\b\u00FC\u0092^\u00C7\x0F|\u00E3\u00D0Ww\u009D<[\u0098\u00A7\u00BB\u00EB|H\u00BF\"\u00F1\u00EBNk\u0094\u0081Wr\u00F3\u00B6\u00A9\u00FB8z\u00F4<G\u00DB\u009B\u008D\u0096\u00BFD\"!\u0091\u00DA\u00CB\u00D7\u00DD\u00AA\u0094\u00C8.\u00C4I.z9\x0E\u00FB\u00D7l\u00DD\u00B5\u00FB\u00C1f\u00C4\x06\u0088\u00B5\u00B1\u0097lj\u0098\u00F3\u00AD\u00DC\u008A\u0085Dd-3\x04-\u0094\x0BH6\u00B3Ez\u008D\u0098}\u00D5\u00AE7\u0093#\u00BE\x0F\x17\u00BA\u00AF\u0099\u00B1g>\u00BB\u00E2\u00D2\u00D7\u00CF<9\u0082S;\u00B0\u00DF\u00FF\u00DC\x14{\x18\u00E8\t\u00F6\u0091\u00D9\u00C8\u0086\u00DB2\u0092\x01K}c\u00C1\u00C6h\u009E\u00AF\u00CF\u00FB1N\u009F[\x12\u0087\u0087\x16\u00B6o\u00C8/\u00ADG%N\x11Po\u00D9\u0089\u00F8tm\u00F7\u00EA\u00F5(\u0083\u00C6\x1E\u00DA\u00B8\u00B5-\u00E2\u00E7\u00CAV\u00C2\u00F6\u00D1\u00ED\u00A7#&\u00F6\u00E9\u00EA\u00BF\u008C\x05.s\u00D0'\u009D\u009A\u00AD\u00D4\u00AF>\u00EE\u00CC3C6\u0090^\u00BF5!\u00A7\x15a83\u00DD\u009B\r)td\u00A8\x06\u00A6\u00F2\u00CD\u00EB\u0094m*\u008D\x19&nS\x1E\x06\u00ED\u008Ef\u00D4\u00B7:\x1E\u00F3\u00CC\u00E5<\u008D\u00AD7\x18\u0095x\u00F5q\u00C5/j:\u0082\x1E\u00BA\u00FCXF\u00D4\u00CEj\u00A0\u00A04\u00F1\u00FA\u00C5\u00A85\u00A7\u00FFS\u00A73\x1E\u008A\x13\u00DD\u00E9\x10\u00C7\u009F\u00B68<\u00F9\u0082s\u00BE\u0090\u00C4\n\u00EE\u00F6UI\u00ACd\u0098ho6j\u00BE*-_\x1D\u009AJk\u00D9\u00EE\r{dc\u00FAA\u00DC>>\x17\u00E2\u0091R\u00ED\u00FA\u00CD\u00B7\u00A4\u00F0\u008AJ\x02[\u00EF'$\u00CD%;w\u008AX{\b:}0\"8\u00EBe\u0092F3\u008A\u00D7\u00EFFd\u00CEO\x0E\u009E\x1E2\u00B1\u00F7\u0094\x1Fu\u009C~\u00B7\u00FD$1\u00F1\u00D4\x11\u0093&/\u009D6e\u00E1N!\u00A64\u0087\u0089\u00F6f#\x1D\u00B1\u00A9\u00FB-\u00A8\u00AA?\u00BE{\u00CB\x1D+\u00DA\u00CD\u00FE\u00AF\u00E0V\u00BA\u00D4$\u009CL\u00B0\u00BA\u00EF\u008Eg\u00F0\u00B2U\u00F2_\u009C\u00D7H\u00960\u00AF\x0F\u00E4D\x04D\u00F71\"\u00D1R\x04\u0097\b\u009A\u00C9\u00C3[\u00F1\u00DFFuf-\u00EDt\u00C6\x05\u00CB\u00B15\x17u\x7F\u00CC\u00FC\r\u00ABV\u00DF1v\u00DC\u00C4\u00BEw\u00F0\x1A\x16\u00DA\u009D\r+\u0094\u0086r\u00D8\u0086bJ\u00AE\u00B9m\u00CD\u00AErs\u00E9gp\u00AB\u00DC\x1B\u00B2\u00FD\u00AF\u00F8\u00E5\u0081\u00C5K\u0096\u00D3-S\u0093\u00FEO\u00DDmF \u00BE(d\u00EE\u008C:B\u00C0\u00D0A\bb\u00DB\u00B8\u00F9:\x10\u00A4\u00F3\u00B8\u00FD_\u00A3:\u00DF9\u00EB\u00D0\u00E7NzW\u0093\u00A5\u0085\u0097\u00FC\u00A8\u008B\u00BE=\u00B8\u00FC\u00E4\u00EB.|%\x12\u00D4Z\u00C3E\u00CF\u008B[P\t4!)$\u00E4\u00F2l\u00BF\u00E7\u00FE]ysY\f\u00B7|z\u0081\x19h\x04L\u00E3\u00F2\u00D9\u00C1\x16\u00DD\u00C22\u00DE\u0098n(-\u0088\u00CC\u00D9\u00C9\u00DA\x1C\u00B9\n@=\u00ED\u00A2+w\u00B1\u00F5\"H6\u00A5\x1F\u00A7\u009FtFu\x0E\u008D\u00BF\u00ED\u00E0\u0084\u00B8\u00CC\u00DE]\u00D8|R\u00F8\u00D7\x0EZ.\u009E}\u00E5\u00A9\u00EF*+\n\u00D4\u00B6\u00CF\u00C6k8\x17\u00A6\u0084\u00C3\u008Dg\u0081\\\u0096\u0098\u00EF\u0099\u008D\u00F1\u00D6\u00DD[\u00A4gN}N\x04\u008CH\u00A9\u00D5w\u00DD\u00C6\x18\u00DD\u009A1#\u00F2\u00ED\u00FE\u00B2\x06\u0085\u0097\u00E6&Xh\u00E2\u009D)\u00C5\u00A2\u008B\u0096\u00F3\x10\x13-g\u00F5\u00A3M\u0080\u009FuFv:\u00FDS\x07g:\x1E]\u00F7\u00CF\u009D\x1F\u009E1\u00EA\u00B2)\u00EF\u00F1\u00D2\u00D9\u0097-\u009F\u00FCz+\u00A2)o\u00F5\x1B\u00C3C7\x06h\u00F9\n@\u00B8\x00\u00E8\x05\x12k>\u00BBt\u00B3\x19\f\u009A8e\u00B3\u00CCYgd5k\u00D9%O\u00AE5\u00E9\x167#v\u00DFk\x01\x1B\"\u00AF^\u00F7\x1A} pJ\u00D7]4\u00F3l1#\x05\x02o+\u00FE\u00CAAk\u00E7\x1D\u009A\x10:\u00B0*\u00F9\u008B\u008E\u00D3g\u00FB\u00A6\u00CE\u00B9\"\"\u0096\u0086\t\u00D9_;\u00D3`x\u00E8\u00A4V\n\u00B6{\x7F\u0096\u009C\u00AC\u00A2)\t\u00DF\u0086w\u00C3\u00DB\f\u009C\n\x19\u00E2S\u008Cf\u00D8\u00BA\u00E3\u009A\u00EF\u00AC\u008F\u00D3K\x14u\u00E3\u00DAd\x19\u009A\u00C9\u00E8\u00ED\u00DF\u00B2\u00E7\u00F5\u00D0\u00BA\u00E1\u00A1\u0097\u0097D\u009Fp\u00E6\u00C3\u00DB\u008A\u00BF\u00ED\u008C\u00EEt\u00AA\u008B\u0095\u008F\u00BC\u00F2@\u008A\x13\u00EFu\u00FF\u00B0C=n\u00CB\x16!\u009E\u0099G\u00F9\x13\u00FD\x06\u00C3D\x7FlCL\u0082{C\u0092\u009AAv[l\u00D9\u00867\u00FDZ\x11\u00A7\u00BC\u00CE\u008F'\u00BCeG\u00AC%\u00BE\u00FBk\x0B,\u00BA\u0095\u00BF\x18\u0092\u00CB\u00B5\x00\x10o\u00EF\tf\u00D2k0\u00E38\u00A9\u00B6\u0087~@U\u00E7\u00AA\u00B63\x1F\u00F9<\u00F0?:\x13:\x1D\u00A9\u008C\x1D\x17x\x18\u009E\x1AsJ\u00E8\u00BF\u00EB\u00B3\u00EEz3\u00BASD\x7F0\t{\u00BC\u00C1p\u00D1c\u00AB\u0080{C\u00B2c&\u0085=\u0081}\u00FE\u0097\x03\u009FO\u00E1\u0094\u00CEcN\u00BF\u009F\u00901\x7F\u0087\u00BF\u00B5\u00E6Iz\u00A9\u00D1Jc\u00DE\u00BD\x06\u00C8h1\u00FE\u008F1\x11\u0095\u00D5l\u00EF\u0098fk\x02\u0084\u00A2\u00F7\x17\u00B3 \u0090A\u00E7\u00F0p\u00D0\u009D\u00EB\u00AE8}\x1F\x14\u00E3|\u00FF\u00DC\u00E3\u00C6\u00BC\tB\u0088D\u00EB\u00A3--\u00C6\u00B0\u00D1\u00FD\u0080{C2U\u009B\u00DA\u00DE\u0095\u00F9\u00CD\x07\x02\u00AF\u00C6p\u00CA\x141W]/\u00D3\u00F9y;\u00EB\ts\u0086\u00A4\u009B|@!x\u009B\u00E6\u00CE\u00B0\u00FA\u00A0-\u0084n\u00E8\u00C6a\u00F4\u009A\u00BC\u00E39\u00B0\u00A8\u00AE\u00B8\u00F3\x11k\u00C0\x1F\\\u00F4\u009EO\u008E\x00C\u00C5\u00CBEgj3\u009E\u009Bf\x1D\x13:\u0091\u0090\u00DEO\u00F5\u00CD\u00FB\u00D7\u00BD\u00B1!\x1C\u00FCN\u00D8\u00F5\u00A5\u008B\u00B4\u00FD;\u00F6\u00B5\u00F6\u00CEy\u0084\u0080\x1D\u00D4\u00E9\u0095\u00FF\u0098Y\u00BFe\u0085\u00ED\"\u0085`\u008B\u00AE\x1BQy\x18\u00BD\u00A2\f\"\u00B7{ \x1Fu\u00E7\u00A3\x19\u00E1g\u009D\u00CEy\u0083\u00E8\x17\u00BF3\u00A2\u00D9\x0E\u00CA\u00A1\u00E8Ra\u00E9\u00DC\x18\u00C7\u0080voH\u00D4\x12\u0092\u00A6\bV\u0097oYm\u0084L\u0080T\x19\u00D3\u00FF\u00E6\u009D\u00EFn\u009E\u00F9$\u00F9439\u00DC\u009A$\u00CA5U\u00F7X\u00AE?\u00ABr\u00AB\u00A1\x1B\u0082\u00C3\u00E8[\r\x10V\u00E0\u00AE\u0084{hCX\x0E~\u00DAw~\u00C7\u00F9\u00A8}\u00D4V\u00BFE/+&D#u\u00E0$\u00EB\x18\u00D0}\u00A1\u009AwJ`\u00FA\x1E\u00CCD\u00EE\u00B9\u00A7.\f\u0080d\x01#\u00D8\u00BE7\u00B6\u00FE\u009AO\"\u00C3<\u00B8\u0093^\u00EDY\u00B2\u00B2\u00E5f\u0080\u00A8T\u009F\u00AD\u00D3\u00C7\x07\u00D0\x0Bl\x10\u00F8\u00D6\u00EE\u00C0;?\u008A\u00E9\u00DFu\u00F4\u00B3:\u0083m\x19y\u00FE\u00D79\\\u00ED\u00B3\u00AA0\u00E3\u00CD\u00B1\x1C\x03zF\x1D\u00C8\x17\u00C0\u00F6?\u009FH\u00AD_\u00DB\u00D0\u00F3x\u0087\u009F\x11\u00B0\u00AB\u00AB\u00F6M\u00D6 Q\u00B2\u00AE\u0091\u00F4Z\u00F9\x02\u00E1\u00E9\x06`\u00AA\b\x01\u008B\u00DAz%q\x04\u00DD\x07\b\u00D6n\u00DD\u0082w~\x10\u00FA\u00D5\u00AE\u00E4\u00C9\x0Ez\u00F9\u00D97\u00EC\u00E5p\u00B9\u0097u\u0081\u00E0#\u00C3G{\x15\u00CA\u0080\u00F2\u00AAZ^y{\u00BD\u00A8\x03$*\u00D4\u00C36\u0089;&\x1D\x00+L\u00F4>z\u0099\u00B3)\u00DEw\x03@\u00B2a\u00E8\x02#T\u00D1\u009F\u00AA\u00FE1\u00FA\u00E9\u0081M\u0094\u00F3 @\u00FC\u00C3\u00B9\x17\x1A\x0E\u00FA\u00F2][\x06$\u00BD\u00B4\u00AFg\x04\u00C2\u0098p\u008C\u00E8t\x1D\u0088\x14}F\u00FF\u00CD\x15C\u00B8O\u00AA\u00D4\u0084$\u00BD\u00E4\u00AC=\u0080\u00DA4\x176\u00E8u\u00CF\x13\u00AC\u0099_\x02\b\x11\x7FS'\u00FE\u00CD\u00B4\u00BE\u00DD\u00FAc\u00F4[\u00F3}t\u00E7\u00E3\u00AA\u00EB;^\x17\x14\u0095Miz\u0089bQ\x10\u00EA7\u008E\r\u009Dt\u00CC\u00F1\u00AF.\u00FB\u00C1\u00F2Y\u00AF\u00DB!\thU\u00AAQ\u0089\u00BC\u00EE,\u009F\u0084\u00A6@\x04\u00E9U\u00BE\u00DD.\u00DE\u00E9Nt1\u008F\u00885\x11\u00B6\u009A\u00DE\u00D4\u00BB\u00B0\x1EF\x1B\u00F3\x07@Hg>N\u00DA\u00FD\u00BE{\u00F1\x7Fj\u0084\u0088=\u00B3\u00E6\b:S\x13\u00D6\u00B9\x06\u00C7\u0082\u0096\u00F1\x16\u00A0\x7F\u00CD\u00D7T\u00A6\u00BD\u008A\u00D2\x06\x12U\u00EF#\u00EF\x1B\u00AFX$\u0081\u0090\u00D9\u00D8\u0092\u00A6\u00D7\u00C6=|\u00CC\u00AF\x02Dd3)\x1C\u00A8(\u00FAp3\u00F4\u00C3h{\u00EE\u008A\x16\u00A5\x1C\b.x\u00FBK\u00CE\u00D91}\u00FE;\u00BEVly\u00F90Z7D\u00B0\u00C01\u00A1\u00FB,\u0087\u0099\x0EUr\u0097%Pk\u0080V\u00A3\u00A2J\u00EC\u00E5s.\u0097@5Nh\u0087\u00A4\u009B\u00BE\u00BF\\\u00BCm\u0083\t4c\u00E8o\u00AB\x14\u008B\u0088W\u00D6B\u00EFf\u00DAZ\u00EC\u00A2Y\u00B9\u00A8\u00DC\u009D\u008F\x13/\u009B\\\u00FDUrb\x1E\x02\u00B6\"\u00B6\x1EF\u00AB\u00B6/\u0088\u00D31\u00BE\x11\u00E31\u00DD\u00B8$\u0082\u009E\x07\x07\u009EW\u00C1\n\u00DC3\u00F1 \u0080\u00DF\u00AA\u00A9*\u00DDLE\u00C8\u00DB\x0F\x04\x00T\u00D3\x19KT\x1B\x11\u008FC\u00EFfZ\x1F\u00F0\u00D0\u0091Yi\u0088\u00BA\u00F3\u00C1\u00943F\\\u00F6\x0E\u00A0\x17#\u00DF\u00DAT\u00C3\u00AD\u00AD\r\x0E\u0087u\u00EC\u00E8j\"\u00A3\u00B5f\u00F9)\u00EA@\u00ACB^\x03c\u00D9\x17\u00CF\u00DC\u00E6\u00DD\u00A7\u00F1\x7F\u00A6N7\u00E5\u00ED\u00F8\u00D3\u008B?\u0093\x07d\x04[\r\u00D9\b\x10\u00F7\u00BE\u0088[\u00BE\f\u00F95\x1EZ\\\u00ABA\u00D1\u009D\x0FL\x157#Q(\u00DE\u00D7=\u0087*9g8\u008E\x19m\u00A8\u00D5\u0090\u009Cs\u00A3l)\u0080Z\u00A7\u0090\u0082\u00AA\u00EF\u009D\u00B3?Q\x04lAQ\x17t\u00AB%\u0093\u00C6\u008C\u009A_\x02\u00E92\u00E9\u00BA\u0082\u00ADBbi\u0091\u00C37S}K\x17}\u00C3\x03 \x05\u00C4MPl\u00DC\x02V$s\u009F\u00D1\u00FD\u0081\u00CD\x17\u00E4\u0098\u00D1\u00A60V\u00DA+f\u009A\u00B6b\u0083^#\u0093\u0081R\u00F0\u00DDYk]j\u00B4\u0086\u00FF`\u009AnA)\x1E\u00FDX#\n\u00A0\u00800tw\"\u00F27u\u00D1\u00AA\r\u00EA\u008E.\u00DA\u00E7\x03\u0084\u00C4\u00D0\u00A1\u009C\u00C6\u00CDG\u00D8\u00DC\u00A2\u00E2\x14{\u00EB\x1C\u00EB\u0098\u00D1s\u00D5\u0096\u00CF\u00DC1\u00CB \u00D2\u0082D\u008BL\x1E\u008A\u00AA\u00B5\u00F6\u00EAW\x1CI+H:\u00EFX\u00DC\u00D2E\u00E3\u00E9+\u00CCH\x13(\u00EB\u00D8\u00AAn\x10\u0095P\u009F\u00D7E\x0B@\u0088.:\u00B2\x00\u00C8\u0095\u00BC\u00A7\nn\u00C2\u00D0k\"l\x02\u00DE\t}\u008Ch{\u0082\u00F4\u00B5\x0E\u00CC\u00CA\u00BB\x07G\u00D2 \u009B\u0081T\u009A\u00E0\u00DC\u00AC\x00\b7\u00A5\u00DFV\u00F12C\u00C4\u00C3a\u00E9\x07\b\u00D9\u00E4\u00CB\x01O\u00F4v\u00DF\u00BF\u0087\x16s\x00;\u00EA\u00CD\u0087^\u00C7\u00A9\u00A8\x1B1c\u008F\nT\u00CE58f\u00B4\x16S\u00CA\u00B9\u00C9\x07H\u00E7 \u00DA\"U\u0080X\u0086\u00E8\u0096@=\r4\x14\u00F4b\u00BA\u008E\u0097\u00DAb\u00C7%2\u009F\x06L\u0087e\x07\u00BC\u00939}\u00DB\u00BF\u008B^h\x02\u008A7\x1F\u00DDo\u00DCV\b\x13\nH\u00B4\u00816\u00C7\u008C\u00B6\u00A7\u00ED\u00CBVg\u00AC\u00A5\u009A\u0080\u00B8\u0081VA\u0086\u00CB(\u008F\u00DF\u00E7\u00BC\x11\u00C1o\u009A!\x04^\u008D\x18\u00E5\x1B\u009E\u00C6\u00DD\u0086\u00B1\x062Z\u00CC\u00A3\x1B\u0080\x1AH\u00FF{hE\u00F7\u00F6+\u0082\u00C3[\u00D1G\u00AC\u00A9?\u0099\\\x16\u0093\x1C;Z\u00F3\u00AB\u00D5\u00DBW\u00D9-\x05\u00B4\u00B6c\u00B6\u00C3\r\u00B4\u0097\u00F7\u0088F\n(\u00C5\u00896\u00EA]\x11a\u00C9\u00B6\u00B94#\u0080\fB\u00B1\u00E8\x1C\u00D1\u00AEu\u008B\u00FE\u00EF\u00A0\x13/\u00FA\x00\x19\u00F1\u00E6\u00A3\u00FBw\t\u00D8\u0095\u0094\x1D\u009AP\u0086cG\u00DBW\u00AC\u00A9\u0087\x16\u00B4l\u00C5v\u00CC\u00A9:f\u00B0A\u00EA\u00CB\u00CBv7\u00DD\u0085\x0EXf\b\u00D5\u00EE\u00EDB\u00EC\u008B\u00BF\u008DZ\x07\u00F2yP\u00ED\x00\x1FF\u00DBj\x0F\u009D\u00FE\u00CAb\u008E\u00CCG\u00EF\u00C7\u00F5\u00A2T\u0088\u00CC\u00E3OA?x\u00DD\u00B7\"\u00D3^Gi\u00B9\u00EBl\u00D0\u008C\u009Ads\u00E17\u00A2\u00EEB\u00E7\u008A(\u00AD\u00DE6\u00B4\x05\u00ECY\x00>\u00C0\x1D\x11a\b\u008Fc\u00AB{\x1F=\u008C6\u00F4\x1E\u00BA\u00F8\u008F\u00B7\u00B4\u0086\u009C\x1F\u00DE\u00CEh\u00C5\tS\u00BA\u00E4\u00D8\u00D1\u008D\u00E4\u00CA\u00B1\u00DF\u008C\u00DE\u009E ^Am\x13oR\u008BI2\u00F9T6\u00DA\u008AJ\u0090a\x1AQz\u00DB0\u00DEB\u009E\u00F36E\x1D\u009C\u00C7\u00D4\u00D3z\u00D9\x1B\u00E9b\u00F1\u0099\u00C8at\u00A9\u00D0C\u0097\u00F3\u009B\u0093\u0080\u00D5=?l\x05'?\u00A9\u00B21n\u00D8\u00E8\x1Ex\u00DA\u0080Vk\u0088\u00B5\x11\u00F2i\u00994\u0089\u00B5)f!\u009Fi\u0088z\u00C2\u008C\x03\u00C9\n!\x13\u00D1{\x03\u00C3\u00AE\u00A9\x10\u00B0\u0081H\x13T\u00DB\u0091\x01$Z\u00AF\x06p\u0092Q\u00C8\u00D4zhC\x17\u0091\u00A1\u00F3\u00A1\u00DA\x1E\u00DA\n\u00F6\x1B\u00C3F\u00F7\u00C0\x12Z\u00E2\u00A1\x01Y\u008F\u00DB\u00D1\u00B6\u00D4\f2)\u00A8\u00A4\u00CD\u0090Td\u00DC\u0084V\u0080Z\u00AC\u00B7\u0081\bJ\u00CC\x0B\u00BF\u008D\x19\x02l\u00C7(\u00EC\x10\u00DE\u00E8\b\u00DE\x1E\u00C0\u00A9\u0099\u0084D\u00AB\u0087\u00B6U\x11\u0096\u0080^\x03\x01\u00B8\x13\u0087\u00D6\u00B6\u00CE6\x18\x1E\u00FA\b\x180\u00F5\u00E7\u00E7\u00B7[\u008A%,g<Re\u00A8&\u00F0\u00B7\u008A\x19w\u00A1C\x06~\u00E9\u00AD\u008F\u00B7\u00F3\u00EE\u00BD\x06\x12ew7\u0081\u00A1\x17\u00BDw8\b\u008C[9\u00FC\u0099)\x1E\u00DA\u00D1\u008BT\r0\u00BD\u00FB\u0087'\u00A7\u0096\n\x16\x18\x1EzD\x0F\u00EC\u009A\u00B5\u00B7\u00A7\u00EF^9n\u00EE\u00B8\u00DD\u00EDx\u009BL\x03\u00EA1\u0092e\u0082\u00D2=\u00A3\u00C2\x14uo-\u00BD\u0083\u00AB|\u00FDg\u00BB\u00DB\u00D0\u0087\u00C3\x10\u0086\u00F7\x1D\u00D9j\x0F],\x0EA\u00EB\u0086\u0088\x7FW\x03\b\u0081\u00A1\u00F7\u00B6\u00A2\u00E5\x0B2L\u00B4W\u00CFl\u009E2\u00D3\u00F9\x1Elm\u00BCji\rhFe!F\u00A6\u00E4J\u0083&A\u00D9\u00DB\u0086\u00F1\x06\u00AC]$)'\u00C0\u00FB/\u0081\x02\u00C2[\u00DF\x1E:[\u00FD :]\x0F\x03\u00A4\u00DC\u00C7`G\u0080\u00CA9\u00D6\u009F\u00806\u00E3rE\x00/[;\u00C7\x00S\u0097-\u009F\u00B4C\u00A4\x1APJ\u00BBS \x0E\u00EF\u00C2D`\x17\x04\u00DB@\u00C8t\u00C6\u00B7\x19\u00C5V\u00F1\x16\u00B0\u00B5\x18p\u009CC\u00D0\u00E9\u00BA(\u00E7#\x12\u00B0T\u00887\x01az\u00AF\u00EFcF\u00CB\u0098\u00F5\u00E2TI\u00AFb\x10S\u0093r\u0099I\u00BC!\u00A3@@J\x7Fo\u00F3\x10\u0091\u0098\x1BV\u00D5\u00B1C\u0080\x19r}z\u00B1;\u00D2\u00AA\r\u008B[\u00DE12\x04],\nCO\u00D5\u00BB\u009B\u00B8\u00AD\x01\u00F5\u00C7\u00BD\u00D7\u00F7\u00F0\u00D1\u00A5\u00D0\u0085\u00FD\u0083M\u0098\u00DB?\u00BE\u00C5\u0091\u0082_\u00D2$\u00F1\n\u00CD\u00B0\u00BB\u00D0\u00D9\x02z\u00D1\x03A1\x0F\u00CA\u0083\x0F\u00E0\f<\u00C4\u00AB\u00AE*`\u00A3\u00DAC?\u00BF\x03\u00C1\x07\u00D1\u00B6\u00DA\u008C\x01\u00E8UP\u00DC\u009B]\x19\u0086\u008Bv\u00C4S\x02\x05\u009B\x7F'\u00EB\u00FC\u00EF\u0092NC\u00A4-\u00A3 \u0083\u00EE\u0082:_z\u00FF]~L$\u00BD\x17!>w?\x10\x00A\u008F\u00BA)\u00DD\u00FD\u00AA\u0099\u00EC\u00A1\u00CBy\u00C7\x1F\x01p\u00E8j\u00DB\x1B\u008D\u00E1\u00A3\u0097y\u00E2\x7F7\u00A3\u00BF\x14\u0084F\u00DC]h\u00ADB\u00B4\u00E1\u00CCeo\x17\x06\u00F7\u00AA&\u00B5\x18PL\u00BB[\u00AE\u00AC{G\x02\u00AD\x04\x10Q\u00E9Q{hCw\u00D1\x12 \b\u008DG\u009D\u00D1\x186\u00FA\u00BF\u00CA\u0098m\u0081\u00DFr\u00D7+\u00ECM\u00AE\u00E8\u00A9\x12\u00CFE#\x10l\x02>\t(\b\x03\u00DD\u00E8\u009Ds\b\u00D1E\u00E7*G\u00D0\u00CE{&S\x02\u00D0\f\u008A\u00E7\u0094\u00E1\u00CF\u008Fv\u00EA\u00BE0\u00FC\r\u0094Vo\x1BF%fH|3\u0085\u00F4\x03\u0086\u00F0\u008Ef_o:T{(Z7\x10\u00BDA\u00D1\r\u0081%\x00\u008C\u009D\u00C1\u0090\u00C5_\n\u00DD\u00F7\x0E\x02\u00AA1\x1A\u00D1\u009E\u00A7\\\x00\u00A5\u009C\x12\u0092t\x16\u0088\x1A@\u00B6l\u0086\u008E\u008C\u00F4PtT\u00F6\u00D0\u0088|9\u00D1\"\x04P;\u00B3\x00\x7F1\u00B4\u00D1\u009F\u00CEA\u00D0&dv\u00B7\u00A1\fC-\x16\u00B5\x04\u00F8m\u0090\u008A\u00AB\u0093\u00F9\x1C\u008D\u00D4\u00BF\u0083\x16\x1CA\u0097\u00F3\u0099\x1A\u00C2\u0084\u00F4\u0092&\x7FA4\u00C6\u00B8u\u00C5\u00BCN9\t\u00A4j\u0080\u00DE\u0080\u00E0\u00DB\u00A9\\\x193\nd\u008A\u00DE7\x12\u00B4\u00DDS\u0099\u00DE\u009D)\u00D1\u00FA0\u00DA\u00D0+9\nY\"a\u009B\u00BF(\x1A\u008A\u00C1\u00F1\u00EFxg\u009B\x02\u0098q\u00D0\u008BQ;\f\u00A2\x01,\u0093@\u00AE\u00CC2\u0088\u00F4.I\u00DE(|\x18\u00DD\u00D6\u009AI\u00AC\u00F0m)\u00F8\x0B\u00A3\u00BD\x19\u00D1\u0080F\x12PM\u00CCP#\u00D1VA\x01\u00CAq\x00E\u00D6T\u00A4\u0087\u00F6\u008E\x10\u00E1\u00D8\u009B\u00C9\x0F\u00A2\x11\u0088\u00DE\u00A9\u00F1\x17Gc\u009C\u00F55@muwa+j'\u00EB\u00E43@\u00B8\t\x0E7Q\u00A1\u0096>2\u00D2\b[\u0085F\u00EAC\u00E8\u00ED\u00BDS\u00E3/\u008F\u00C6Z\x16\u0093V\x18P\u00A0\x12\u00AB'\bCX\u00D2=\u00C0*\x19|\x10\u00B5\u0086\u00A2\u00BD\x177V\u00EC\x03h\u00E3\u00EC\x02\u00FC\u00B5\u00D0\u00A0\r\x1C(C\u00BA\n~;l7\u0092\u00DE6L\u00D6]\u00A1I\x10\x14\u00FE\x1Dt5;\x14\x1D\u00EA7\u00F8k\u00A2\u00A9\u009CmbF Q\u00A8'\x10m\u00D4\n\u00C8\u00958\u0085)\u00A5{\u009F\u00DE\x1A\u00FA\x11t\u00AAA\u00A1t\x18]9\u00AB\u00FFL\u0083\u00BF.\u009Ab\u00D0\u00B1ZaB\u00B6\f\u0081\x1F\u00C8f\x00\u00AA:\u00C2$W\u00EE}\"\u00ED\u00A1\u00A3\u0092d\x13\u00DD\u00E8\u00A1\u00BD\u00DB\u00D1_\x1BM\u00F0\u0089\x04(\u00CDB\u0096l\u0081R\x02\bH\x17\u00D8\u00C6\x07\x11\u00FB\u00C8K\x1C\u0084\u00C3\x15\u00DE/\x05\u00B0\u00DD\u00B9\x1D\u00FD-\u00D0\u00D6\u00F8u\u00C5o%\u00F0\u00D9\u0084%a\x0B\u009A\u00D1\u00EEt\u00B4c\x10\x1E:\u00D2\bJ\u0085\u00A1'\u00C7\u00C22\u00FCM\u00D0\u00CE\u0084\u009C\u00B1\u00EF\u00E5,f\x04[\x01bM\u0080z\u0082T\u0089V\u00EC\u0083\u00E8\u00EEEZ4\u0092+\u00AF\u00C5\u00E9o\u0086\x06[\x1B\u00B3\u00B6\u00F8D\u008DD\x05\u00AC\x10\u00DD\u00E9\bI4\u00E3\u008F\u00D0\bD)4\u00D6\u00F9i\u00FFo\u008C\u00F6\u0096{\u009A\u00C4\u00F9\u00AC\u00E4\u00E9\nN!\u00A4\u00EF\u00F0t\u00D42\u0087\u00D1\x11m\\\u00EFG\u008C\u00BF=\u00FA\u00F0\u0087<c\x02E\t5\u008Dj\x1A\x19b\u00C8K\x1Cw\u0091c\x16\u00F0w\u0085\u00F6\u00D6|J\u00A0\u00B8\u00AF\u0085\u00DAt\u00DCnQ\u00D9*\u00A7\u00D5\u00C0\u00C2\u00F1\u00DE\"\u00FF\u00FD\u00A1=\u00F7\u00D8\u00FE\u00FEi\u00A06=\u00EC\u0084\u00FEeJ\"_\u00F7\u00C0\x7F\u00AF\u00E8^\u00B3\u00FE\u00B2\u00D8^\u00FF7\u00A7\u00D7\u00B7\u00A8\u00D2a\x1D\x7F\x00\x00\x00\x00IEND\u00AEB`\u0082";
/* eslint-enable */
// all initialisations should go here
var init = function() {
glob.b = pub;
welcome();
// -- init internal state vars --
startTime = Date.now();
currStrokeWeight = 1;
currStrokeTint = 100;
currFillTint = 100;
currCanvasMode = pub.PAGE;
currColorMode = pub.RGB;
currGradientMode = pub.LINEAR;
};
// ----------------------------------------
// execution
/**
* Run the sketch! Has to be called in every sketch a the very end of the code.
* You may add performance setting options when calling b.go():<br /><br />
*
* b.go(b.MODEVISIBLE) or alternatively: b.go()<br />
* b.go(b.MODESILENT) <br />
* b.go(b.MODEHIDDEN)<br /><br />
*
* Currently there is no performance optimization in b.loop()<br />
* @cat Environment
* @method go
* @param {MODESILENT|MODEHIDDEN|MODEVISIBLE} [modes] Optional: Switch performanceMode
*/
pub.go = function (mode) {
if (!mode) {
mode = pub.DEFAULTMODE;
}
app.scriptPreferences.enableRedraw = (mode == pub.MODEVISIBLE || mode == pub.MODEHIDDEN);
app.preflightOptions.preflightOff = true;
currentDoc(mode);
if (mode == pub.MODEHIDDEN || mode == pub.MODESILENT) {
progressPanel = new Progress();
}
try {
if (typeof glob.setup === 'function') {
runSetup();
};
if (typeof glob.draw === 'function') {
runDrawOnce();
};
} catch (e) {
alert(e);
exit();
}
var executionDuration = pub.millis();
if (executionDuration < 1000) {
println("[Finished in " + executionDuration + "ms]");
} else {
println("[Finished in " + (executionDuration/1000).toPrecision(3) + "s]");
}
if(currDoc && !currDoc.windows.length) {
currDoc.windows.add(); //open the hidden doc
}
closeHiddenDocs();
if (progressPanel) {
progressPanel.closePanel();
}
if (addToStoryCache) {
addToStoryCache.close();
}
app.scriptPreferences.enableRedraw = true;
app.preflightOptions.preflightOff = false;
exit(); // quit program execution
};
/**
* EXPERIMENTAL!
*
* Causes basil to continuously execute the code within draw() when InDesign is idle.
* #targetengine "loop"; must be at the very top in the script file.
* If noLoop() is called, the code in draw() stops executing.
* It is essential to call noLoop() or execute the script lib/stop.jsx when the script is finished!
* The framerate property determines how often draw() is called per second, e.g. a framerate of 20 will 20times call draw() per second.
*
* @cat Environment
* @method loop
* @param {Number} framerate The framerate per second, determines how often draw() is called per second.
*/
pub.loop = function(framerate) {
// before running the loop we need to check if
// the stop script exists
// the Script looks for the lib folder next to itself
var currentBasilFolderPath = File($.fileName).parent.fsName;
var scriptPath = currentBasilFolderPath + "/lib/stop.jsx";
if(File(scriptPath).exists !== true) {
// the script is not there. lets create it
var scriptContent = [
"//@targetengine \"loop\"",
"//@include \"../basil.js\";",
"b.noLoop();",
"if (typeof cleanUp === \"function\") {",
"cleanUp();",
"}",
"cleanUp = null;"
];
if(Folder(currentBasilFolderPath + "/lib").exists !== true) {
// the lib folder also does not exist
var res = Folder(currentBasilFolderPath + "/lib").create();
if(res === false) {
error("An error occurred while creating the \"/lib\" folder. Please report this issue");
return;
}else{
// the folder is there
}
var libFolder = Folder(currentBasilFolderPath + "/lib");
var stopScript = new File(libFolder.fsName + "/stop.jsx");
stopScript.open("w", undef, undef);
// set encoding and linefeeds
stopScript.lineFeed = Folder.fs === "Macintosh" ? "Unix" : "Windows";
stopScript.encoding = "UTF-8";
stopScript.write(scriptContent.join("\n"));
stopScript.close();
}
}else{
// the script is there
// awesome
}
var sleep = null;
if (arguments.length === 0) sleep = Math.round(1000/25);
else sleep = Math.round(1000/framerate);
if ($.engineName !== 'loop') {
error('b.loop(), Add #targetengine "loop"; at the very top of your script.');
}
currentDoc();
runSetup();
var idleTask = app.idleTasks.add({name: "basil_idle_task", sleep: sleep});
idleTask.addEventListener(IdleEvent.ON_IDLE, function() {
runDrawLoop();
}, false);
println("Run the script lib/stop.jsx to end the draw loop and clean up!");
// println("loop()");
};
/**
* EXPERIMENTAL!
*
* Stops basil from continuously executing the code within draw().
*
* @cat Environment
* @method noLoop
*/
pub.noLoop = function() {
var allIdleTasks = app.idleTasks;
for (var i = app.idleTasks.length - 1; i >= 0; i--) {
allIdleTasks[i].remove();
}
println("noLoop()");
};
// ----------------------------------------
// all private from here
var runSetup = function() {
app.doScript(function() {
if (typeof glob.setup === 'function') {
glob.setup();
}
}, ScriptLanguage.javascript, undef, UndoModes.ENTIRE_SCRIPT);
};
var runDrawOnce = function() {
app.doScript(function() {
if (typeof glob.draw === 'function') {
glob.draw();
}
}, ScriptLanguage.javascript, undef, UndoModes.ENTIRE_SCRIPT);
};
var runDrawLoop = function() {
app.doScript(function() {
if (typeof glob.draw === 'function') {
glob.draw();
}
}, ScriptLanguage.javascript, undef, UndoModes.ENTIRE_SCRIPT);
};
var welcome = function() {
clearConsole();
println("Using basil.js "
+ pub.VERSION
+ " ...");
};
var currentDoc = function (mode) {
if (!currDoc) {
var stack = $.stack;
if (!(stack.match(/go\(.*\)/)||stack.match(/loop\(.*\)/))) {
warning("Do not initialize Variables with dependency to b outside the setup() or the draw() function. If you do so, basil will not be able to run in performance optimized Modes! If you really need them globally we recommend to only declare them gobally but initialize them in setup()! Current Stack is " + stack);
}
var doc = null;
if (app.documents.length) {
doc = app.activeDocument;
if (mode == b.MODEHIDDEN) {
if (doc.modified) {
doc.save();
warning("Document was unsaved and has now been saved to your hard drive in order to enter MODEHIDDEN.");
}
var docPath = doc.fullName;
doc.close(); // Close the doc and reopen it without adding to the display list
doc = app.open(File(docPath), false);
}
}
else {
// println("new doc");
doc = app.documents.add(mode != b.MODEHIDDEN);
}
setCurrDoc(doc);
}
return currDoc;
};
var closeHiddenDocs = function () {
//in Case we break the Script during execution in MODEHIDDEN we might have documents open that are not on the display list. Close them.
for (var i = app.documents.length - 1; i >= 0; i -= 1) {
var d = app.documents[i];
if (!d.windows.length) {
d.close(SaveOptions.NO);
}
}
};
var setCurrDoc = function(doc) {
resetCurrDoc();
currDoc = doc;
// -- setup document --
currDoc.viewPreferences.rulerOrigin = RulerOrigin.PAGE_ORIGIN;
// currDoc.viewPreferences.horizontalMeasurementUnits = MeasurementUnits.millimeters;
// currDoc.viewPreferences.verticalMeasurementUnits = MeasurementUnits.millimeters;
currFont = currDoc.textDefaults.appliedFont.name;
currFontSize = currDoc.textDefaults.pointSize;
currAlign = currDoc.textDefaults.justification;
currLeading = currDoc.textDefaults.leading;
currKerning = 0;
currTracking = currDoc.textDefaults.tracking;
pub.units(pub.PT);
updatePublicPageSizeVars();
};
var progressPanel = null;
var Progress = function () {
this.init = function () {
this.panel = Window.find("palette", "processing...");
if (this.panel === null) {
this.panel = new Window('palette', "processing...");
var currentBasilFolderPath = File($.fileName).parent.fsName;
var logo = File(currentBasilFolderPath + "/lib/basil.png");
// var logo = (Folder.fs == "Macintosh" ) ? new File("~/Documents/basiljs/bundle/lib/basil.png") : new File("%USERPROFILE%Documents/basiljs/bundle/lib/basil.png");
if (logo.exists === true) {
this.panel.add("image", undefined, logo);
} else {
// lets create the logo from the binary data
if(Folder(currentBasilFolderPath + "/lib").exists !== true) {
Folder(currentBasilFolderPath + "/lib").create();
}
var logo_file = new File(currentBasilFolderPath + "/lib/basil.png");
logo_file.encoding = "BINARY";
logo_file.open("w");
logo_file.write(basil_logo_binary);
logo_file.close();
this.panel.add("image", undefined, logo_file);
}
this.panel.statusbar = this.panel.add("edittext", [0, 0, 400, 300], "", {multiline: true, scrolling: false, readonly: true});
}
this.panel.statusbar.text = "Using basil.js " + pub.VERSION + " ... \nEntering background render mode ...";
this.panel.show();
};
this.closePanel = function () {
if (this.panel) {
this.panel.hide();
this.panel.close();
}
};
this.writeMessage = function (msg) {
if (Folder.fs == "Macintosh") { //Indesign Bug on Mac: Need to set app.scriptPreferences.enableRedraw = true to redraw window....
var rd = app.scriptPreferences.enableRedraw;
app.scriptPreferences.enableRedraw = true;
}
var lines = this.panel.statusbar.text.split(/\n/);
if (lines.length > 17)
lines.shift();
lines.push(msg);
this.panel.statusbar.text = lines.join("\n");
this.panel.layout.layout();
if (Folder.fs == "Macintosh") {
app.scriptPreferences.enableRedraw = rd;
}
};
this.init();
};
var resetCurrDoc = function() {
// resets doc and doc specific vars
currDoc = null;
currPage = null;
currLayer = null;
currFillColor = "Black";
noneSwatchColor = "None";
currStrokeColor = "Black";
currRectMode = pub.CORNER;
currEllipseMode = pub.CENTER;
currYAlign = VerticalJustification.TOP_ALIGN;
currFont = null;
currImageMode = pub.CORNER;
pub.resetMatrix();
};
var currentLayer = function() {
if (!currLayer) {
currentDoc();
if (currDoc.windows.length)
currLayer = app.activeDocument.activeLayer;
else
currLayer = currDoc.layers[0];
}
return currLayer;
};
var currentPage = function() {
if (!currPage) {
currentDoc();
if (currDoc.windows.length)
currPage = app.activeWindow.activePage;
else
currPage = currDoc.pages[0];
}
return currPage;
};
var updatePublicPageSizeVars = function () {
var pageBounds = currentPage().bounds; // [y1, x1, y2, x2]
var facingPages = currDoc.documentPreferences.facingPages;
var singlePageMode = false;
var widthOffset = heightOffset = 0;
switch(pub.canvasMode()) {
case pub.PAGE:
widthOffset = 0;
heightOffset = 0;
b.resetMatrix();
singlePageMode = true;
break;
case pub.MARGIN:
widthOffset = - currentPage().marginPreferences.left - currentPage().marginPreferences.right;
heightOffset = - currentPage().marginPreferences.top - currentPage().marginPreferences.bottom;
b.resetMatrix();
b.translate(currentPage().marginPreferences.left, currentPage().marginPreferences.top);
singlePageMode = true;
break;
case pub.BLEED:
widthOffset = b.doc().documentPreferences.documentBleedInsideOrLeftOffset + b.doc().documentPreferences.documentBleedOutsideOrRightOffset;
if(facingPages){
widthOffset = b.doc().documentPreferences.documentBleedInsideOrLeftOffset;
}
heightOffset = b.doc().documentPreferences.documentBleedBottomOffset + b.doc().documentPreferences.documentBleedTopOffset;
b.resetMatrix();
b.translate( -b.doc().documentPreferences.documentBleedInsideOrLeftOffset, -b.doc().documentPreferences.documentBleedTopOffset );
if(facingPages && currentPage().side === PageSideOptions.RIGHT_HAND){
b.resetMatrix();
b.translate( 0, -b.doc().documentPreferences.documentBleedTopOffset );
}
singlePageMode = true;
break;
case pub.FACING_PAGES:
widthOffset = 0;
heightOffset = 0;
b.resetMatrix();
var w = pageBounds[3] - pageBounds[1] + widthOffset;
var h = pageBounds[2] - pageBounds[0] + heightOffset;
pub.width = w * 2;
if(currentPage().name === '1') {
pub.width = w;
} else if (currentPage().side === PageSideOptions.RIGHT_HAND){
pub.translate(-w,0);
}
pub.height = h;
break;
case pub.FACING_BLEEDS:
widthOffset = b.doc().documentPreferences.documentBleedInsideOrLeftOffset + b.doc().documentPreferences.documentBleedOutsideOrRightOffset;
heightOffset = b.doc().documentPreferences.documentBleedBottomOffset + b.doc().documentPreferences.documentBleedTopOffset;
b.resetMatrix();
b.translate( -b.doc().documentPreferences.documentBleedInsideOrLeftOffset, -b.doc().documentPreferences.documentBleedTopOffset );
var w = pageBounds[3] - pageBounds[1] + widthOffset / 2;
var h = pageBounds[2] - pageBounds[0] + heightOffset;
pub.width = w * 2;
pub.height = h;
if(currentPage().side === PageSideOptions.RIGHT_HAND){
pub.translate(-w+widthOffset/2,0);
}
break;
case pub.FACING_MARGINS:
widthOffset = currentPage().marginPreferences.left + currentPage().marginPreferences.right;
heightOffset = currentPage().marginPreferences.top + currentPage().marginPreferences.bottom;
b.resetMatrix();
b.translate( currentPage().marginPreferences.left, currentPage().marginPreferences.top );
var w = pageBounds[3] - pageBounds[1] - widthOffset / 2;
var h = pageBounds[2] - pageBounds[0] - heightOffset;
pub.width = w * 2;
pub.height = h;
if(currentPage().side === PageSideOptions.RIGHT_HAND){
pub.translate(-w-widthOffset/2,0);
}
return; // early exit
default:
b.error("b.canvasMode(), basil.js canvasMode seems to be messed up, please use one of the following modes: b.PAGE, b.MARGIN, b.BLEED, b.FACING_PAGES, b.FACING_MARGINS, b.FACING_BLEEDS");
break;
}
if(singlePageMode){
var w = pageBounds[3] - pageBounds[1] + widthOffset;
var h = pageBounds[2] - pageBounds[0] + heightOffset;
pub.width = w;
pub.height = h;
}
};
// internal helper to get around try/catch for finding eg. a color in the swatches
var findInCollectionByName = function(collection, name) {
/* var found = collection.itemByName(name);
if (!found || !found.isValid) return null;
return found;*/
var found = null;
for (var i = 0; i < collection.length; i++) {
if (collection[i].name === name) return collection[i];
};
return found;
};
var checkNull = pub.checkNull = function (obj) {
if(obj === null || typeof obj === undefined) error("Received null object.");
}
var isNull = checkNull; // legacy
var error = pub.error = function(msg) {
println(ERROR_PREFIX + msg);
throw new Error(ERROR_PREFIX + msg);
};
var warning = pub.warning = function(msg) {
println(WARNING_PREFIX + msg);
};
var clearConsole = function() {
var bt = new BridgeTalk();
bt.target = "estoolkit";
bt.body = "app.clc()"; // works just with cs6
bt.onError = function(errObj) {};
bt.onResult = function(resObj) {};
bt.send();
};
// ----------------------------------------
// Structure
/**
* Suspends the calling thread for a number of milliseconds.
* During a sleep period, checks at 100 millisecond intervals to see whether the sleep should be terminated.
*
* @cat Environment
* @method delay
* @param {Number} milliseconds The delay time in milliseconds
*/
pub.delay = function (milliseconds) {
$.sleep(milliseconds);
};
/**
* If no callback function is given it returns a Collection of items otherwise calls the given callback function with each story of the given document.
*
* @cat Document
* @subcat Multi-Getters
* @method stories
* @param {Document} doc The document instance to iterate the stories in
* @param {Function} [cb] Optional: The callback function to call with each story. When this function returns false the loop stops. Passed arguments: story, loopCount;
* @return {Stories[]} Array of Stories.
*/
pub.stories = function(doc, cb) {
checkNull(doc);
if(arguments.length === 1 && doc instanceof Document) {
return doc.stories;
} else if (cb instanceof Function) {
return forEach(doc.stories, cb);
} else {
error("b.stories(), incorrect call. Wrong parameters!");
}
};
/**
* If no callback function is given it returns a Collection of items otherwise calls the given callback function with each paragraph of the given document, story or text frame.
*
* @cat Document
* @subcat Multi-Getters
* @method paragraphs
* @param {Document|Story|TextFrame} item The story or text frame instance to iterate the paragraphs in
* @param {Function} [cb] Optional: The callback function to call with each paragraph. When this function returns false the loop stops. Passed arguments: para, loopCount
* @return {Paragraphs[]} Array of Paragraphs.
*/
pub.paragraphs = function(item, cb) {
checkNull(item);
if(!item.hasOwnProperty('contents')) error("b.paragraphs(), Wrong object type.");
if(arguments.length === 1) {
return item.paragraphs;
} else if (cb instanceof Function) {
if (item instanceof Document) {
return forEachStoryProperty(item, 'paragraphs', cb);
} else {
return forEach(item.paragraphs, cb);
}
}
};
// /**
// * If no callback function is given it returns a Collection of strings otherwise calls the given callback function with each sentences of the given document, story or text frame.
// *
// * cat Document
// * subcat Multi-Getters
// * method sentences
// * param {Document|Story|TextFrame} item The story or text frame instance to iterate the sentences in
// * param {Function} cb Optional: The callback function to call with each sentence. When this function returns false the loop stops. Passed arguments: sentence, loopCount
// * return {Array} An array of strings
// *
// */
// // FIXME
// pub.sentences = function(item, cb) {
// checkNull(item);
// var err = false;
// try{
// item[0]; // check if list
// err = true; // access ok -> error
// } catch (expected) {};
// if(err) error("b.sentences(), Array/Collection has been passed to b.sentences(). Single object expected.");
// if(arguments.length >= 1 ) {
// var arr;
// try{
// str = item.contents;
// arr = str.match( /[^\.!\?]+[\.!\?]+/g );
// } catch (e){
// error("b.sentences(), Object passed to b.sentences() does not have text or is incompatible.");
// }
// if(arguments.length === 1) {
// return arr;
// } else if (cb instanceof Function) {
// forEach(arr,cb);
// } else {
// error("b.sentences(), the callback parameter is not a Function.");
// }
// }
// };
/**
* If no callback function is given it returns a Collection of items otherwise calls the given callback function with each line of the given document, story, text frame or paragraph.
*
* @cat Document
* @subcat Multi-Getters
* @method lines
* @param {Document|Story|TextFrame|Paragraph} item The document, story, text frame or paragraph instance to
* iterate the lines in
* @param {Function} [cb] Optional: The callback function to call with each line. When this function returns false the loop stops. Passed arguments: line, loopCount
* @return {Lines[]} Array of lines.
*/
pub.lines = function(item, cb) {
checkNull(item);
if(!item.hasOwnProperty('contents')) error("b.lines(), Wrong object type.");
if(arguments.length === 1) {
return item.lines;
} else if (cb instanceof Function) {
if (item instanceof Document) {
return forEachStoryProperty(item, 'lines', cb);
} else {
return forEach(item.lines, cb);
}
}
};
/**
* If no callback function is given it returns a Collection of items otherwise calls the given callback function with each word of the given document, story, text frame, paragraph or line.
*
* @cat Document
* @subcat Multi-Getters
* @method words
* @param {Document|Story|TextFrame|Paragraph|Line} item The document, story, text frame, paragraph or line instance
* to iterate the words in
* @param {Function} [cb] Optional: The callback function to call with each word. When this function returns false the loop stops. Passed arguments: word, loopCount
* @return {Words[]} Array of Words.
*/
pub.words = function(item, cb) {
checkNull(item);
if(!item.hasOwnProperty('contents')) error("b.words(), Wrong object type.");
if(arguments.length === 1){
return item.words;
} else if (cb instanceof Function) {
if (item instanceof Document) {
return forEachStoryProperty(item, 'words', cb);
} else {
return forEach(item.words, cb);
}
}
};
/**
* If no callback function is given it returns a Collection of items otherwise calls the given callback function with each character of the given document, story, text frame, paragraph, line or word.
*
* @cat Document
* @subcat Multi-Getters
* @method characters
* @param {Document|Story|TextFrame|Paragraph|Line|Word} item The document, story, text frame, paragraph, line or word instance to
* iterate the characters in
* @param {Function} [cb] Optional: The callback function to call with each character. When this function returns false the loop stops. Passed arguments: character, loopCount
* @return {Characters} You can use it like an array.
*/
pub.characters = function(item, cb) {
checkNull(item);
if(!item.hasOwnProperty('contents')) error("b.characters(), Wrong object type.");
if(arguments.length === 1) {
return item.characters;
} else if ( cb instanceof Function) {
if (item instanceof Document) {
return forEachStoryProperty(item, 'characters', cb);
} else {
return forEach(item.characters, cb);
}
}
};
var forEachStoryProperty = function(doc, property, cb) {
var loopCount = 0;
pub.stories(doc, function(story) {
var properties = story[property];
for (var i = 0, len = properties.length; i < len; i++) {
if(cb(properties[i], loopCount++) === false) {
return false;
}
}
return true;
});
};
/**
* If no callback function is given it returns a Collection of items otherwise calls the given callback function for each of the PageItems in the given Document, Page, Layer or Group.
*
* @cat Document
* @subcat Multi-Getters
* @method items
* @param {Document|Page|Layer|Group} container The container where the PageItems sit in
* @param {Function|Boolean} [cb] Optional: The callback function to call for each PageItem. When this function returns false the loop stops. Passed arguments: item, loopCount.
* @return {PageItems[]} array or PageItems.
*/
pub.items = function(container, cb) {
if (container instanceof Document
|| container instanceof Page
|| container instanceof Layer
|| container instanceof Group) {
if(arguments.length === 1 || cb === false){
return container.allPageItems;
} else if(cb instanceof Function ) {
return forEach(container.allPageItems, cb);
}
} else {
error("b.items(), Not a valid PageItem container, should be Document, Page, Layer or Group");
}
};
/**
* Removes all PageItems in the given Document, Page, Layer or Group.
*
* @cat Document
* @method clear
* @param {Document|Page|Layer|Group} container The container where the PageItems sit in
*/
pub.clear = function(container) {
if (container instanceof Document
|| container instanceof Page
|| container instanceof Layer
|| container instanceof Group) {
return forEach(container.allPageItems, function(item,n){
// Groups have to be avoided for deletion
// otherwise deletion process is confused
if(item !== null && ! (item instanceof Group) ) {
if(item.locked) error("b.clear(), some items are locked. Please unlock them first and sue then b.clear().");
item.remove();
}
});
} else {
return false;
}
};
/**
* Removes the provided Page, Layer, PageItem, Swatch, etc.
*
* @cat Document
* @method remove
* @param {PageItem} obj The object to be removed
*/
pub.remove = function(obj) {
if(obj.hasOwnProperty("remove")) {
obj.remove();
} else {
throw new Error("Provided object cannot be removed in b.remove().");
}
}
// ----------------------------------------
// Environment
/**
* Sets or possibly creates the current document and returns it.
* If the param doc is not given the current document gets set to the active document
* in the application. If no document at all is open, a new document gets created.
*
* @cat Document
* @method doc
* @param {Document} [doc] The document to set the current document to
* @return {Document} The current document instance
*/
pub.doc = function(doc) {
if (doc instanceof Document) {
setCurrDoc(doc);
}
return currentDoc();
};
/**
* Sets the size of the current document, if arguments are given.
* If only one argument is given, both the width and the height are set to this value.
* If no argument is given, an object containing the current document's width and height is returned.
*
* @cat Document
* @method size
* @param {Number} width The desired width of the current document
* @param {Number} [height] optional the desired height of the current document. If not provided the width will be used as the height.
* @return {Object} if no argument is given it returns an object containing the current width and height of the document.
*
*/
pub.size = function(width, height){
if(app.documents.length === 0){
// there are no documents
warning('b.size(width, height)', 'You have no open document.');
return;
} else {
if (arguments.length === 0){
// no arguments given
// return the curent values
// warning('b.size(width, height)', 'no arguments given');
return {width: pub.width, height: pub.height};
}
if(arguments.length === 1){
// only one argument set the first to the secound
height = width;
}
var doc = app.documents[0];
// set the documents pageHeiht and pageWidth
doc.properties = {
documentPreferences:{
pageHeight: height,
pageWidth: width
}
};
// set height and width
pub.height = height;
pub.width = width;
}
}
/**
* Closes the current document.
*
* @cat Document
* @method close
* @param {SaveOptions|Boolean} [saveOptions] The indesign SaveOptions constant or either true for triggering saving before closing or false for closing without saving.
* @param {File} [file] Optional: The indesign file instance to save the document to
*/
pub.close = function(saveOptions, file) {
var doc = currentDoc();
if (doc) {
if( typeof saveOptions === 'boolean' && saveOptions === false ) saveOptions = SaveOptions.no;
if( typeof saveOptions === 'boolean' && saveOptions === true ) saveOptions = SaveOptions.yes;
doc.close(saveOptions, file);
resetCurrDoc();
}
};
/**
* Use this to set the dimensions of the canvas. Choose between b.PAGE (default), b.MARGIN, b.BLEED resp. b.FACING_PAGES, b.FACING_MARGINS and b.FACING_BLEEDS for book setups with facing page. Please note: Setups with more than two facing pages are not yet supported.
* Please note that you will loose your current MatrixTransformation. You should set the canvasMode before you attempt to use b.translate(), b.rotate() and b.scale();
* @method canvasMode
* @cat Document
* @subcat Page
*/
pub.canvasMode = function ( m ) {
if(arguments.length == 0) {
return currCanvasMode;
} else if ( typeof m === "string" ) {
if ( (m === b.FACING_PAGES || m === b.FACING_MARGINS || m === b.FACING_BLEEDS) && !b.doc().documentPreferences.facingPages ) b.error("b.canvasMode(), cannot set a facing pages mode to a single page document");
currCanvasMode = m;
updatePublicPageSizeVars();
} else {
error("b.canvasMode(), there is a problem setting the canvasMode. Please check the reference for details.");
}
};
/**
* Returns the current horizontal and vertical pasteboard margins and sets them if both arguements are given.
*
* @cat Document
* @subcat Page
* @method pasteboard
* @param {Number} The desired horizontal pasteboard margin.
* @param {Number} The desired vertical pasteboard margin.
* @return {array} The current horizontal, vertical pasteboard margins.
*/
pub.pasteboard = function ( h, v ) {
if(arguments.length == 0) {
return currDoc.pasteboardPreferences.pasteboardMargins;
} else if(arguments.length == 1){
error("b.pasteboard() requires both a horizontal and vertical value. Please check the reference for details.");
}else if ( typeof h === "number" && typeof v === "number" ) {
currDoc.pasteboardPreferences.pasteboardMargins = [h, v];
return currDoc.pasteboardPreferences.pasteboardMargins;
}else {
error("b.pasteboard(), there is a problem setting the pasteboard. Please check the reference for details.");
}
};
/**
* Returns the current page and sets it if argument page is given. Numbering starts with 1.
*
* @cat Document
* @subcat Page
* @method page
* @param {Page|Number|PageItem} [page] The page object or page number to set the current page to. If you pass a PageItem the current page will be set to it's containing page.
* @return {Page} The current page instance
*/
pub.page = function(page) {
if (page instanceof Page) {
currPage = page;
} else if ( typeof page !== 'undefined' && page.hasOwnProperty("parentPage") ) {
currPage = page.parentPage; // page is actually a PageItem
} else if (typeof page === 'number') {
if( page < 1 ) {
p = 0;
} else {
p = page - 1;
}
var tempPage = currentDoc().pages[p];
try {
tempPage.id;
} catch (e) {
error('b.page(), ' + page + ' does not exist.');
}
currPage = tempPage;
} else if (typeof page !== 'undefined') {
error("b.page(), bad type for b.page().");
}
updatePublicPageSizeVars();
if (currDoc.windows.length)
app.activeWindow.activePage = currPage; // focus in GUI if not in MODEHIDDEN
return currentPage();
};
/**
* Adds a new page to the document. Set the optional location parameter to either b.AT_END (default), b.AT_BEGINNING, b.AFTER or b.BEFORE. b.AFTER and b.BEFORE will use the current page as insertion point.
*
* @cat Document
* @subcat Page
* @method addPage
* @param {String} [location] The location placement mode
* @return {Page} The new page
*/
pub.addPage = function(location) {
checkNull(location);
if(arguments.length === 0) location = b.AT_END; // default
var nP;
try {
switch ( location ) {
case b.AT_END:
nP = currentDoc().pages.add(location);
break;
case b.AT_BEGINNING:
nP = currentDoc().pages.add(location);
break;
case b.AFTER:
nP = currentDoc().pages.add(location, pub.page() );
break;
case b.BEFORE:
nP = currentDoc().pages.add(location, pub.page() );
break;
default:
throw new Error();
break;
};
pub.page( nP );
return nP;
} catch (e) {
error("b.addPage(), invalid location argument passed to addPage()");
}
};
/**
* Removes a page from the current document. This will either be the current Page if the parameter page is left empty, or the given Page object or page number.
*
* @cat Document
* @subcat Page
* @method removePage
* @param {Page|Number} [page] Optional: The page to be removed as Page object or page number.
*/
pub.removePage = function (page) {
checkNull(page);
if( typeof page === 'number' || arguments.length === 0 || page instanceof Page ){
var p = pub.page(page); // get the page object, todo: add an internal method of page retrieval without setting it to current
p.remove();
currPage = null; // reset!
currentPage();
} else {
error("b.removePage(), invalid call. Wrong parameter!");
}
};
/**
* Returns the current page number of either the current page or the given Page object.
*
* @cat Document
* @subcat Page
* @method pageNumber
* @param {Page} [pageObj] Optional: The page you want to know the number of.
* @return {Number} The page number within the document.
*/
pub.pageNumber = function (pageObj) {
checkNull(pageObj);
if (typeof pageObj === 'number') error("b.pageNumber(), cannot be called with a Number argument.");
if (pageObj instanceof Page) {
return parseInt(pageObj.name); // current number of given page
} else {
return parseInt(pub.page().name); // number of current page
}
};
// TODO: does not work?
pub.nextPage = function () {
var p = pub.doc().pages.nextItem(currentPage());
return pub.page(p);
};
// TODO: does not work?
pub.previousPage = function () {
var p = pub.doc().pages.previousItem(currentPage());
return pub.page(p);
};
/**
* The number of all pages in the current document.
*
* @cat Document
* @subcat Page
* @method pageCount
* @return The amount of pages.
*/
pub.pageCount = function() {
return currentDoc().pages.count();
};
/**
* The number of all stories in the current document.
*
* @cat Story
* @method storyCount
* @return {Number} count The amount of stories.
*/
pub.storyCount = function() {
return currentDoc().stories.count();
};
/**
* Adds a page item or a string to an existing story. You can control the position of the insert via the last parameter. It accepts either an InsertionPoint or one the following constants: b.AT_BEGINNING and b.AT_END.
*
* @cat Story
* @method addToStory
* @param {Story} story The story
* @param {PageItem|String} itemOrString The itemOrString either a PageItem, a String or one the following constants: b.AT_BEGINNING and b.AT_END.
* @param {InsertionPoint|String} insertionPointOrMode InsertionPoint or one the following constants: b.AT_BEGINNING and b.AT_END.
*/
pub.addToStory = function(story, itemOrString, insertionPointorMode) {
checkNull(story);
checkNull(itemOrString);
// init
var libFileName = "addToStoryLib.indl";
var libFile = new File(Folder.temp+"/"+libFileName);
addToStoryCache = findInCollectionByName(app.libraries, libFileName);
// if and a cache is existing from previous executions, remove it
if (addToStoryCache) {
addToStoryCache.close();
libFile.remove();
}
//create an indesign library for caching the page items
addToStoryCache = app.libraries.add(libFile);
// self-overwrite, see self-defining-functions pattern
pub.addToStory = function(story, itemOrString, insertionPointorMode) {
if (story instanceof Story && arguments.length >= 2) {
// add string
if (isString(itemOrString)) {
if (insertionPointorMode instanceof InsertionPoint) {
insertionPointorMode.contents = itemOrString;
} else if (insertionPointorMode === pub.AT_BEGINNING) {
story.insertionPoints.firstItem().contents = itemOrString;
} else {
story.insertionPoints.lastItem().contents = itemOrString;
}
}
// add other stuff
else {
// store the item as first asset in cache
addToStoryCache.store(itemOrString);
var insertionPoint = null;
if (insertionPointorMode instanceof InsertionPoint) {
insertionPoint = insertionPointorMode;
} else if (insertionPointorMode === pub.AT_BEGINNING) {
insertionPoint = story.insertionPoints.firstItem();
} else {
insertionPoint = story.insertionPoints.lastItem();
}
// place & remove from cache
addToStoryCache.assets.firstItem().placeAsset(insertionPoint);
addToStoryCache.assets.firstItem().remove();
}
} else {
error("b.addToStory(), wrong arguments! Please use: b.addToStory(story, itemOrString, insertionPointorMode). Parameter insertionPointorMode is optional.")
}
};
};
/**
* Returns the current layer if no argument is given. Sets active layer if layer object or name of existing layer is given. Newly creates layer and sets it to active if new name is given.
*
* @cat Document
* @subcat Page
* @method layer
* @param {Layer|String} [layer] The layer or layer name to set the current layer to
* @return {Layer} The current layer instance
*/
pub.layer = function(layer) {
checkNull(layer);
if (layer instanceof Layer) {
currLayer = layer;
currentDoc().activeLayer = currLayer;
} else if (typeof layer === 'string') {
var layers = currentDoc().layers;
currLayer = layers.item(layer);
if (!currLayer.isValid) {
currLayer = layers.add({name: layer});
} else {
currentDoc().activeLayer = currLayer;
}
} else if (arguments.length > 0) {
error("b.layer(), wrong arguments. Use layer object or string instead.")
}
return currentLayer();
};
/**
* Returns the Group instance and sets it if argument Group is given.
*
* @cat Document
* @subCat Page
* @method Group
* @param {Array} [pItem] The PageItems array (must be at least 2) or name of Group name instance
* @param {String} name (optional) The name of the Group, only when creating a Group from Page Item(s)
* @return {Group} the current Group instance
*/
pub.group = function (pItem, name) {
checkNull(pItem);
var group = null;
if( pItem instanceof Array) {
if(pItem.length < 2) error("There must be at least two PageItems passed to b.group().");
// creates a group from Page Items
group = currentDoc().groups.add(pItem);
if(typeof name != 'undefined') group.name = name;
}
else if( typeof pItem === 'string' ) {
// get the Group of the given name
group = currentDoc().groups.item(pItem);
}
else {
error("b.group(), not a valid argument.")
}
return group;
};
/**
* Returns an array of the items that were within the Group before b.ungroup() was called
*
* @cat Document
* @subCat Page
* @method Group
* @param {Object|String} [pItem] The Group or name of Group name instance
* @param {String} name The name of the Group, only when creating a Group from Page Item(s)
* @return {Group} the Page Item(s) that were grouped
*/
pub.ungroup = function(pItem) {
checkNull(pItem);
var ungroupedItems = null;
if( pItem instanceof Group) {
ungroupedItems = b.items( pItem );
pItem.ungroup();
}
else if( typeof pItem === 'string' ) {
// get the Group of the given name
var group = currentDoc().groups.item(pItem);
ungroupedItems = b.items( group );
group.ungroup();
}
else {
error("b.ungroup(), not a valid Group. Please select a valid Group.");
}
return ungroupedItems;
};
/**
* Returns items tagged with the given label in the InDesign Script Label pane (Window -> Utilities -> Script Label).
*
* @cat Document
* @subcat Multi-Getters
* @method labels
* @param {String} label The label identifier
* @param {Function} [cb] Optional: The callback function to call with each item in the search result. When this function returns false the loop stops. Passed arguments: item, loopCount
* @return {PageItem[]} Array of concrete PageItem instances, e.g. TextFrame or SplineItem.
*/
pub.labels = function(label, cb) {
checkNull(label);
var result = [];
var doc = currentDoc();
for (var i = 0, len = doc.pageItems.length; i < len; i++) {
var pageItem = doc.pageItems[i];
if (pageItem.label === label) {
// push pageItem's 1st element to get the concrete PageItem instance, e.g. a TextFrame
result.push(pageItem.getElements()[0]);
}
}
if (arguments.length === 2 && cb instanceof Function) {
return forEach(result, cb);
}
if(result.length === 0) b.error("b.labels(), no item found with the given label '" + label + "'. Check for line breaks and whitespaces in the script label panel.");
return result;
};
/**
* Returns the first item that is tagged with the given label in the InDesign Script Label pane (Window -> Utilities -> Script Label). Use this instead of b.labels, when you know you just have one thing with that label and don't want to deal with a single-element array.
*
* @cat Document
* @subcat Multi-Getters
* @method label
* @param {String} label The label identifier
* @return {PageItem} The first PageItem of all the hits
*/
pub.label = function(label) {
checkNull(label);
var doc = currentDoc();
for (var i = 0, len = doc.pageItems.length; i < len; i++) {
var pageItem = doc.pageItems[i];
if (pageItem.label === label) {
return pageItem;
}
}
b.error("b.label(), no item found with the given label '" + label + "'. Check for line breaks and whitespaces in the script label panel.");
}
/**
* Returns the first currently selected object. Use this if you know you only have one selected item and don't want to deal with an array.
*
* @cat Document
* @subcat Multi-Getters
* @method selection
* @return {Object} The first selected object
*/
pub.selection = function() {
if(app.selection.length === 0) error("b.selection(), selection is empty. Please select something.");
return app.selection[0];
};
/**
* Returns the currently selected object(s)
*
* @cat Document
* @subcat Multi-Getters
* @method selections
* @param {Function} [cb] Optional: The callback function to call with each item in the selection. When this function returns false the loop stops. Passed arguments: item, loopCount
* @return {Object[]} Array of selected object(s).
*/
pub.selections = function(cb) {
if(app.selection.length === 0) error("b.selections(), selection is empty. Please select something.");
if (arguments.length === 1 && cb instanceof Function) {
return forEach(app.selection, cb);
}
return app.selection;
};
/**
* Returns the first item on the active page that is named by the given name in the Layers pane (Window -> Layer).
*
* @cat Document
* @subcat Multi-Getters
* @method nameOnPage
* @return {Object} The first object on the active page with the given name
*/
pub.nameOnPage = function(name) {
checkNull(name);
var result = null;
var page = currentPage();
for (var i = 0, len = page.allPageItems.length; i < len; i++) {
var pageItem = page.allPageItems[i];
if (pageItem.name === name) {
result = pageItem.getElements()[0];
break;
}
}
if(result === null) b.error("b.nameOnPage(), no item found with the name '" + name + "' on page "+pub.pageNumber());
return result;
};
/**
* Sets the units of the document (like right clicking the rulers). The default units of basil.js are PT.
*
* @cat Document
* @method units
* @param {Constant} [units] Supported units: PT, PX, CM, MM or IN
* @return {Constant} Current unit setting
*/
var unitsCalledCounter = 0;
pub.units = function (units) {
checkNull(units);
if (arguments.length === 0) return currUnits;
if (units === pub.CM ||
units === pub.MM ||
units === pub.PT ||
units === pub.PX ||
units === pub.IN) {
var unitType = null;
if (units === pub.CM) unitType = MeasurementUnits.centimeters;
else if (units === pub.MM) unitType = MeasurementUnits.millimeters;
else if (units === pub.PT) unitType = MeasurementUnits.points;
else if (units === pub.PX) unitType = MeasurementUnits.pixels;
else if (units === pub.IN) unitType = MeasurementUnits.inches;
var doc = currentDoc();
with (doc.viewPreferences){
//* MeasurementUnits.agates
//* MeasurementUnits.picas
//* MeasurementUnits.points
//* MeasurementUnits.inches
//* MeasurementUnits.inchesDecimal
//* MeasurementUnits.millimeters
//* MeasurementUnits.centimeters
//* MeasurementUnits.ciceros
horizontalMeasurementUnits = unitType;
verticalMeasurementUnits = unitType;
}
currUnits = units;
updatePublicPageSizeVars();
} else {
error("b.unit(), not supported unit");
}
if (unitsCalledCounter === 1) {
warning("Please note that b.units() will reset the current transformation matrix.");
}
unitsCalledCounter++;
return currUnits;
};
/**
* Creates a vertical guide line at the current spread and current layer.
*
* @cat Document
* @method guideX
* @param {Number} x Position of the new guide
* @return {Guide} New guide
*/
pub.guideX = function (x) {
checkNull(x);
var guides = currentPage().guides;
var guide = guides.add( currentLayer() );
with (guide) {
fitToPage = true;
orientation = HorizontalOrVertical.VERTICAL;
location = x;
}
return guide;
};
/**
* Creates a horizontal guide line at the current spread and current layer.
*
* @cat Document
* @method guideY
* @param {Number} y Position of the new guide
* @return {Guide} New guide
*/
pub.guideY = function (y) {
checkNull(y);
var guides = currentPage().guides;
var guide = guides.add( currentLayer() );
with (guide) {
fitToPage = true;
orientation = HorizontalOrVertical.HORIZONTAL;
location = y;
}
return guide;
};
/**
* Sets the margins of a given page. If 1 value is given, all 4 sides are set equally. If 4 values are given, the current page will be adjusted. Adding a 5th value will set the margin of a given page. Calling the function without any values, will return the margins for the current page.
*
* @cat Document
* @subcat Page
* @method margins
* @param {Number} [top] Top margin or all if only one
* @param {Number} [right] Right margin
* @param {Number} [bottom] Bottom margin
* @param {Number} [left] Left margin
* @param {Number} [pageNumber] Sets margins to selected page, currentPage() if left blank
* @return {Object} Current page margins with these properties: top, right, bottom, left
*/
pub.margins = function(top, right, bottom, left, pageNumber) {
if (arguments.length === 0){
return {'top':pub.page(pageNumber).marginPreferences.top,
'right':pub.page(pageNumber).marginPreferences.right,
'bottom':pub.page(pageNumber).marginPreferences.bottom,
'left':pub.page(pageNumber).marginPreferences.left
};
} else if (arguments.length === 1) {
right = bottom = left = top;
}
if(pageNumber != undefined){
pub.page(pageNumber).marginPreferences.top = top;
pub.page(pageNumber).marginPreferences.right = right;
pub.page(pageNumber).marginPreferences.bottom = bottom;
pub.page(pageNumber).marginPreferences.left = left;
}else{
currentPage().marginPreferences.top = top;
currentPage().marginPreferences.right = right;
currentPage().marginPreferences.bottom = bottom;
currentPage().marginPreferences.left = left;
}
};
/**
* Sets the document bleeds. If one value is given, all 4 are set equally. If 4 values are given, the top/right/bottom/left document bleeds will be adjusted. Calling the function without any values, will return the document bleed settings.
*
* @cat Document
* @subcat Page
* @method bleeds
* @param {Number} [top] Top bleed or all if only one
* @param {Number} [right] Right bleed
* @param {Number} [bottom] Bottom bleed
* @param {Number} [left] Left bleed
*/
pub.bleeds = function(top, right, bottom, left) {
if (arguments.length === 0){
return {'top':currentDoc().documentPreferences.documentBleedTopOffset,
'right':currentDoc().documentPreferences.documentBleedOutsideOrRightOffset,
'bottom':currentDoc().documentPreferences.documentBleedBottomOffset,
'left':currentDoc().documentPreferences.documentBleedInsideOrLeftOffset
};
} else if (arguments.length === 1) {
right = bottom = left = top;
}else{
currentDoc().documentPreferences.documentBleedUniformSize = false;
}
currentDoc().documentPreferences.documentBleedTopOffset = top;
currentDoc().documentPreferences.documentBleedOutsideOrRightOffset = right;
currentDoc().documentPreferences.documentBleedBottomOffset = bottom;
currentDoc().documentPreferences.documentBleedInsideOrLeftOffset = left;
};
/**
* Prints out all properties and values off an object in a recursive manner to the console. Useful for inspecting (or debugging) nested variable. the default value for the recursion is maxlevel = 2.
*
* @cat Output
* @method inspect
* @param {Object} obj : the Object to inspect
* @param {Number} maxlevel Optional: recursion limit, default maxlevel = 2
*/
pub.inspect = function(obj, maxlevel, level, propname) {
checkNull(obj);
if (!level) level = 0;
if (!maxlevel) maxlevel = 2;
if (level > maxlevel) return;
var constructorName = obj.constructor.name;
var indent = "";
for (var i = 0; i < level; i++) indent = indent + "\t";
if (level === 0) {
println(obj);
} else {
if (constructorName === "Boolean" ||
constructorName === "Number" ||
constructorName === "String") {
println(indent+propname+": "+obj);
}
else if (constructorName === "Array") {
println(indent+propname+": "+constructorName+"("+obj.length+")");
}
else if (constructorName === "Color") {
println(indent+propname+": ["+obj.colorValue+"] "+constructorName);
}
else {
println(indent+propname+": "+constructorName);
}
}
if ( constructorName === 'Array' ) {
for (var i = 0, len = obj.length; i < len; i++) {
pub.inspect(obj[i], maxlevel, level+1, i);
};
} else if (typeof obj === 'object') {
try {
for (var i in obj){
if (obj.hasOwnProperty(i)) {
pub.inspect(obj[i], maxlevel, level+1, i);
}
}
}
catch(e) {
println(indent+"--> "+propname+" "+e);
}
}
};
// ----------------------------------------
// Date
/**
* The year() function returns the current year as an integer (2012, 2013 etc).
*
* @cat Environment
* @subcat Date
* @method year
* @return {Number}
*/
pub.year = function() {
return (new Date()).getFullYear();
};
/**
* The month() function returns the current month as a value from 1 - 12.
*
* @cat Environment
* @subcat Date
* @method month
* @return {Number}
*/
pub.month = function() {
return (new Date()).getMonth() + 1;
};
/**
* The day() function returns the current day as a value from 1 - 31.
*
* @cat Environment
* @subcat Date
* @method day
* @return {Number}
*/
pub.day = function() {
return (new Date()).getDate();
};
/**
* The weekday() function returns the current weekday as a string from Sunday, Monday, Tuesday...
*
* @cat Environment
* @subcat Date
* @method weekday
* @return {String}
*/
pub.weekday = function() {
var weekdays = new Array('Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday');
return weekdays[(new Date()).getDay()];
};
/**
* The hour() function returns the current hour as a value from 0 - 23.
*
* @cat Environment
* @subcat Date
* @method hour
* @return {Number}
*/
pub.hour = function() {
return (new Date()).getHours();
};
/**
* The minute() function returns the current minute as a value from 0 - 59.
*
* @cat Environment
* @subcat Date
* @method minute
* @return {Number}
*/
pub.minute = function() {
return (new Date()).getMinutes();
};
/**
* The second() function returns the current second as a value from 0 - 59.
*
* @cat Environment
* @subcat Date
* @method second
* @return {Number}
*/
pub.second = function() {
return (new Date()).getSeconds();
};
/**
* Returns the number of milliseconds (thousandths of a second) since starting an applet.
*
* @cat Environment
* @subcat Date
* @method millis
* @return {Number}
*/
pub.millis = function() {
return Date.now() - startTime;
};
/**
* The millisecond() function differs from millis(), in that it returns the exact millisecond (thousandths of a second) of the current time.
*
* @cat Environment
* @subcat Date
* @method millisecond
* @return {Number}
*/
pub.millisecond = function() {
return (new Date()).getMilliseconds();
};
/**
* The timestamp() function returns the current date formatted as YYYYMMDD_HHMMSS for useful unique filenaming.
*
* @cat Environment
* @subcat Date
* @method timestamp
* @return {String}
*/
pub.timestamp = function() {
var dt = new Date();
var dtf = dt.getFullYear();
dtf += pub.nf(dt.getMonth()+1,2);
dtf += pub.nf(dt.getDate(),2);
dtf += "_";
dtf += pub.nf(dt.getHours(),2);
dtf += pub.nf(dt.getMinutes(),2);
dtf += pub.nf(dt.getSeconds(),2);
return dtf;
};
// ----------------------------------------
// Data
pub.JSON = {
/**
* Function parses and validates a string as JSON-object. Usage:
* var obj = b.JSON.decode(str);
* var str = b.JSON.encode(obj);
*
* @cat Data
* @subcat JSON
* @method JSON.decode
* @param {String} String to be parsed as JSON-object.
* @return {Object} Returns JSON-object or throws an error if invalid JSON has been provided.
*/
// From: jQuery JavaScript Library v1.7.1 http://jquery.com/
decode: function(data) {
if ( typeof data !== "string" || !data ) {
return null;
}
var rvalidchars = /^[\],:{}\s]*$/,
rvalidescape = /\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,
rvalidtokens = /"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,
rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g;
// Make sure the incoming data is actual JSON
// Logic borrowed from http://json.org/json2.js
if ( rvalidchars.test( data.replace( rvalidescape, "@" )
.replace( rvalidtokens, "]" )
.replace( rvalidbraces, "")) ) {
return ( new Function( "return " + data ) )();
}
error( "b.JSON.decode(), invalid JSON: " + data );
},
/**
* Function convert an javascript object to a JSON-string. Usage:
* var str = b.JSON.encode(obj);
* var obj = b.JSON.decode(str);
*
* @cat Data
* @subcat JSON
* @method JSON.encode
* @param {Object} Object to be converted to a JSON-string
* @return {String} Returns JSON-string
*/
// From: https://gist.github.com/754454
encode: function(obj) {
var t = typeof (obj);
if (t !== "object" || obj === null) {
// simple data type
if (t === "string") obj = '"' + obj + '"';
return String(obj);
} else {
// recurse array or object
var n, v, json = [], arr = (obj && obj.constructor === Array);
for (n in obj) {
v = obj[n];
t = typeof(v);
if (obj.hasOwnProperty(n)) {
if (t === "string") v = '"' + v + '"'; else if (t === "object" && v !== null) v = pub.JSON.encode(v);
json.push((arr ? "" : '"' + n + '":') + String(v));
}
}
return (arr ? "[" : "{") + String(json) + (arr ? "]" : "}");
}
}
};
// Taken and hijacked from d3.js robust csv parser. Hopefully Michael Bostock won't mind.
// https://github.com/mbostock/d3/tree/master/src/dsv
pub.CSV = new CSV();
function CSV() {
var reParse = null,
reFormat = null,
delimiterStr = null,
delimiterCode = null;
initDelimiter(',');
function initDelimiter(delimiter) {
reParse = new RegExp("\r\n|[" + delimiter + "\r\n]", "g"), // field separator regex
reFormat = new RegExp("[\"" + delimiter + "\n]"),
delimiterCode = delimiter.charCodeAt(0);
delimiterStr = delimiter;
};
/**
* Sets the delimiter of the CSV decode and encode function.
*
* @cat Data
* @subcat CSV
* @method CSV.delimiter
* @param {String} [delimiter] Optional Sets the delimiter for CSV parsing
* @return {String} Returns the current delimiter if called without argument
*/
this.delimiter = function(delimiter) {
if (arguments.length === 0) return delimiterStr;
if (typeof delimiter === 'string') {
initDelimiter(delimiter);
} else {
error("b.CSV.delimiter, separator has to be a character or string");
}
};
/**
* Function parses a string as CSV-object Array. Usage:
* var arr = b.CSV.decode(str);
* var str = b.CSV.encode(arr);
*
* @cat Data
* @subcat CSV
* @method CSV.decode
* @param {String} String to be parsed as CSV-object.
* @return {Array} Returns CSV-object Array
*/
this.decode = function(text) {
var header;
return parseRows(text, function(row, i) {
if (i) {
var o = {}, j = -1, m = header.length;
while (++j < m) o[header[j]] = row[j];
return o;
} else {
header = row;
return null;
}
});
};
/**
* Function convert an javascript array of objects to a CSV-string. Usage:
* var str = b.CSV.encode(arr);
* var arr = b.CSV.decode(str);
*
* @cat Data
* @subcat CSV
* @method CSV.encode
* @param {Array} Array to be converted to a CSV-string
* @return {String} Returns CSV-string
*/
this.encode = function(rows) {
var csvStrings = [];
var header = [];
var firstRow = rows[0]; // all rows have to have the same properties keys
// gather infos for the header
for (var propname in firstRow) {
if (firstRow.hasOwnProperty(propname)) {
header.push(propname);
};
};
csvStrings.push( formatRow(header) );
for (var i = 0; i < rows.length; i++) {
var row = rows[i];
var tokens = [];
for (var ii = 0; ii < header.length; ii++) {
tokens.push(row[header[ii]]);
};
csvStrings.push( formatRow(tokens) );
};
return csvStrings.join("\n");
};
function formatRow(row) {
return row.map(formatValue).join(delimiterStr);
}
function formatValue(text) {
return reFormat.test(text) ? "\"" + text.replace(/\"/g, "\"\"") + "\"" : text;
}
function parseRows(text, f) {
var EOL = {}, // sentinel value for end-of-line
EOF = {}, // sentinel value for end-of-file
rows = [], // output rows
n = 0, // the current line number
t, // the current token
eol; // is the current token followed by EOL?
reParse.lastIndex = 0; // work-around bug in FF 3.6
function token() {
if (reParse.lastIndex >= text.length) return EOF; // special case: end of file
if (eol) { eol = false; return EOL; } // special case: end of line
// special case: quotes
var j = reParse.lastIndex;
if (text.charCodeAt(j) === 34) {
var i = j;
while (i++ < text.length) {
if (text.charCodeAt(i) === 34) {
if (text.charCodeAt(i + 1) !== 34) break;
i++;
}
}
reParse.lastIndex = i + 2;
var c = text.charCodeAt(i + 1);
if (c === 13) {
eol = true;
if (text.charCodeAt(i + 2) === 10) reParse.lastIndex++;
} else if (c === 10) {
eol = true;
}
return text.substring(j + 1, i).replace(/""/g, "\"");
}
// common case
var m = reParse.exec(text);
if (m) {
eol = m[0].charCodeAt(0) !== delimiterCode;
return text.substring(j, m.index);
}
reParse.lastIndex = text.length;
return text.substring(j);
}
while ((t = token()) !== EOF) {
var a = [];
while (t !== EOL && t !== EOF) {
a.push(t);
t = token();
}
if (f && !(a = f(a, n++))) continue;
rows.push(a);
}
return rows;
};
};
// -- Conversion --
/** @class b */
/**
* Converts a byte, char, int, or color to a String containing the
* equivalent binary notation. For example color(0, 102, 153, 255)
* will convert to the String "11111111000000000110011010011001". This
* function can help make your geeky debugging sessions much happier.
*
* @cat Data
* @subcat Conversion
* @method binary
* @param {Number} num value to convert
* @param {Number} [numBits] number of digits to return
* @return {String} A formatted string
*/
// From: http://processingjs.org/reference/binary_/
pub.binary = function(num, numBits) {
var bit;
if (numBits > 0) bit = numBits;
else if (num instanceof Char) {
bit = 16;
num |= 0;
} else {
bit = 32;
while (bit > 1 && !(num >>> bit - 1 & 1)) bit--;
}
var result = "";
while (bit > 0) result += num >>> --bit & 1 ? "1" : "0";
return result;
};
/**
* Converts a String representation of a binary number to its
* equivalent integer value. For example, unbinary("00001000") will
* return 8.
*
* @cat Data
* @subcat Conversion
* @method unbinary
* @param {String} binaryString value to convert
* @return {Number} The integer representation
*/
// From: http://processingjs.org/reference/unbinary_/
pub.unbinary = function(binaryString) {
var i = binaryString.length - 1,
mask = 1,
result = 0;
while (i >= 0) {
var ch = binaryString[i--];
if (ch !== "0" && ch !== "1") throw "the value passed into unbinary was not an 8 bit binary number";
if (ch === "1") result += mask;
mask <<= 1;
}
return result;
};
var decimalToHex = function(d, padding) {
padding = padding === undef || padding === null ? padding = 8 : padding;
if (d < 0) d = 4294967295 + d + 1;
var hex = Number(d).toString(16).toUpperCase();
while (hex.length < padding) hex = "0" + hex;
if (hex.length >= padding) hex = hex.substring(hex.length - padding, hex.length);
return hex;
};
/**
* Convert a number to a hex representation.
*
* @cat Data
* @subcat Conversion
* @method hex
* @param {Number} value The number to convert
* @param {Number} [len] The length of the hex number to be created, default: 8
* @return {String} The hex representation as a string
*/
pub.hex = function(value, len) {
if (arguments.length === 1) len = 8;
return decimalToHex(value, len);
};
var unhexScalar = function(hex) {
var value = parseInt("0x" + hex, 16);
if (value > 2147483647) value -= 4294967296;
return value;
}
/**
* Convert a hex representation to a number.
*
* @cat Data
* @subcat Conversion
* @method unhex
* @param {String} hex The hex representation
* @return {Number} The number
*/
pub.unhex = function(hex) {
if (hex instanceof Array) {
var arr = [];
for (var i = 0; i < hex.length; i++) arr.push(unhexScalar(hex[i]));
return arr;
}
return unhexScalar(hex);
};
// -- String Functions --
/**
* Removes multiple, leading or trailing spaces and punctuation from "words". E.g. converts "word!" to "word". Especially useful together with b.words();
*
* @method trimWord
* @cat Data
* @subcat String Functions
* @param {String} s The String to trim
* @param
*/
// from: http://www.qodo.co.uk/blog/javascript-trim-leading-and-trailing-spaces/
pub.trimWord = function(s) {
s = s.replace(/(^[,.!?-]*)|([-,.!?]*$)/gi,"");
s = s.replace(/\s*/gi,"");
// s = s.replace(/[ ]{2,}/gi," ");
s = s.replace(/\n*/,"");
return s;
};
/**
* Combines an array of Strings into one String, each separated by
* the character(s) used for the separator parameter. To join arrays
* of ints or floats, it's necessary to first convert them to strings
* using nf() or nfs().
*
* @method join
* @cat Data
* @subcat String Functions
* @param {Array} array A string array
* @param {String} separator The separator to be inserted
* @return {String} The joined string
*/
// http://processingjs.org/reference/join_/
pub.join = function(array, separator) {
return array.join(separator);
};
/**
* The split() function breaks a string into pieces using a
* character or string as the divider. The delim parameter specifies the
* character or characters that mark the boundaries between each piece. A
* String[] array is returned that contains each of the pieces.
*
* If the result is a set of numbers, you can convert the String[] array
* to to a float[] or int[] array using the datatype conversion functions
* int() and float() (see example above).
*
* The splitTokens() function works in a similar fashion, except that it
* splits using a range of characters instead of a specific character or
* sequence.
*
* @cat Data
* @subcat String Functions
* @method split
* @param {String} str the String to be split
* @param {String} [delim] The string used to separate the data
* @return {Array} Array of strings
*/
// http://processingjs.org/reference/split_/
pub.split = function(str, delim) {
return str.split(delim);
};
/**
* The splitTokens() function splits a String at one or many character
* "tokens." The tokens parameter specifies the character or characters
* to be used as a boundary.
*
* If no tokens character is specified, any whitespace character is used
* to split. Whitespace characters include tab (\t), line feed (\n),
* carriage return (\r), form feed (\f), and space. To convert a String
* to an array of integers or floats, use the datatype conversion functions
* int() and float() to convert the array of Strings.
*
* @cat Data
* @subcat String Functions
* @method splitTokens
* @param {String} str the String to be split
* @param {String} [tokens] list of individual characters that will be used as separators
* @return {Array} Array of strings
*/
// From: http://processingjs.org/reference/splitTokens_/
pub.splitTokens = function(str, tokens) {
if (arguments.length === 1) tokens = "\n\t\r\u000c ";
tokens = "[" + tokens + "]";
var ary = [];
var index = 0;
var pos = str.search(tokens);
while (pos >= 0) {
if (pos === 0) str = str.substring(1);
else {
ary[index] = str.substring(0, pos);
index++;
str = str.substring(pos);
}
pos = str.search(tokens);
}
if (str.length > 0) ary[index] = str;
if (ary.length === 0) ary = undef;
return ary;
};
/* todo */
pub.match = function(str, regexp) {
return str.match(regexp);
};
/* todo */
pub.matchAll = function(aString, aRegExp) {
var results = [],
latest;
var regexp = new RegExp(aRegExp, "g");
while ((latest = regexp.exec(aString)) !== null) {
results.push(latest);
if (latest[0].length === 0)++regexp.lastIndex;
}
return results.length > 0 ? results : null;
};
function nfCoreScalar(value, plus, minus, leftDigits, rightDigits, group) {
var sign = value < 0 ? minus : plus;
var autoDetectDecimals = rightDigits === 0;
var rightDigitsOfDefault = rightDigits === undef || rightDigits < 0 ? 0 : rightDigits;
var absValue = Math.abs(value);
if (autoDetectDecimals) {
rightDigitsOfDefault = 1;
absValue *= 10;
while (Math.abs(Math.round(absValue) - absValue) > 1.0E-6 && rightDigitsOfDefault < 7) {
++rightDigitsOfDefault;
absValue *= 10;
}
} else if (rightDigitsOfDefault !== 0) absValue *= Math.pow(10, rightDigitsOfDefault);
var number, doubled = absValue * 2;
if (Math.floor(absValue) === absValue) number = absValue;
else if (Math.floor(doubled) === doubled) {
var floored = Math.floor(absValue);
number = floored + floored % 2;
} else number = Math.round(absValue);
var buffer = "";
var totalDigits = leftDigits + rightDigitsOfDefault;
while (totalDigits > 0 || number > 0) {
totalDigits--;
buffer = "" + number % 10 + buffer;
number = Math.floor(number / 10);
}
if (group !== undef) {
var i = buffer.length - 3 - rightDigitsOfDefault;
while (i > 0) {
buffer = buffer.substring(0, i) + group + buffer.substring(i);
i -= 3;
}
}
if (rightDigitsOfDefault > 0) return sign + buffer.substring(0, buffer.length - rightDigitsOfDefault) + "." + buffer.substring(buffer.length - rightDigitsOfDefault, buffer.length);
return sign + buffer;
}
function nfCore(value, plus, minus, leftDigits, rightDigits, group) {
if (value instanceof Array) {
var arr = [];
for (var i = 0, len = value.length; i < len; i++) arr.push(nfCoreScalar(value[i], plus, minus, leftDigits, rightDigits, group));
return arr;
}
return nfCoreScalar(value, plus, minus, leftDigits, rightDigits, group);
}
/**
* Utility function for formatting numbers into strings. There
* are two versions, one for formatting floats and one for formatting
* ints. The values for the digits, left, and right parameters should
* always be positive integers.
* As shown in the above example, nf() is used to add zeros to the
* left and/or right of a number. This is typically for aligning a list
* of numbers. To remove digits from a floating-point number, use the
* int(), ceil(), floor(), or round() functions.
*
* @cat Data
* @subcat String Functions
* @method nf
* @param {Number} value The Number to convert
* @param {Number} leftDigits
* @param {Number} rightDigits
* @return {String} The formatted string
*/
// From: http://processingjs.org/reference/nf_/
pub.nf = function(value, leftDigits, rightDigits) {
return nfCore(value, "", "-", leftDigits, rightDigits);
};
/**
* Utility function for formatting numbers into strings. Similar to nf()
* but leaves a blank space in front of positive numbers so they align
* with negative numbers in spite of the minus symbol. There are two
* versions, one for formatting floats and one for formatting ints. The
* values for the digits, left, and right parameters should always be
* positive integers.
*
* @cat Data
* @subcat String Functions
* @method nfs
* @param {Number} value The Number to convert
* @param {Number} leftDigits
* @param {Number} rightDigits
* @return {String} The formatted string
*/
// From: http://processingjs.org/reference/nfs_/
pub.nfs = function(value, leftDigits, rightDigits) {
return nfCore(value, " ", "-", leftDigits, rightDigits);
};
/**
* Utility function for formatting numbers into strings. Similar to nf()
* but puts a "+" in front of positive numbers and a "-" in front of
* negative numbers. There are two versions, one for formatting floats
* and one for formatting ints. The values for the digits, left, and right
* parameters should always be positive integers.
*
* @cat Data
* @subcat String Functions
* @method nfp
* @param {Number} value The Number to convert
* @param {Number} leftDigits
* @param {Number} rightDigits
* @return {String} The formatted string
*/
// From: http://processingjs.org/reference/nfp_/
pub.nfp = function(value, leftDigits, rightDigits) {
return nfCore(value, "+", "-", leftDigits, rightDigits);
};
/**
* Utility function for formatting numbers into strings and placing
* appropriate commas to mark units of 1000. There are two versions, one
* for formatting ints and one for formatting an array of ints. The value
* for the digits parameter should always be a positive integer.
*
* @cat Data
* @subcat String Functions
* @method nfc
* @param {Number} value The Number to convert
* @param {Number} leftDigits
* @param {Number} rightDigits
* @return {String} The formatted string
*/
// From: http://processingjs.org/reference/nfc_/
pub.nfc = function(value, leftDigits, rightDigits) {
return nfCore(value, "", "-", leftDigits, rightDigits, ",");
};
/**
* Removes whitespace characters from the beginning and end of a String.
* In addition to standard whitespace characters such as space, carriage
* return, and tab, this function also removes the Unicode "nbsp" character.
*
* @cat Data
* @subcat String Functions
* @method trim
* @param {String|Array} str A string or an array of strings to be trimmed
* @return {String|Array} Returns the input in a trimmed way
*/
// From: http://processingjs.org/reference/trim_/
pub.trim = function(str) {
if (str instanceof Array) {
var arr = [];
for (var i = 0; i < str.length; i++) arr.push(str[i].replace(/^\s*/, "").replace(/\s*$/, "").replace(/\r*$/, ""));
return arr;
}
return str.replace(/^\s*/, "").replace(/\s*$/, "").replace(/\r*$/, "");
};
/**
* Checks whether an URL string is valid.
*
* @cat Data
* @subcat String Functions
* @method isURL
* @param {String} url An url string to be checked
* @return {Boolean} Returns either true or false
*/
var isURL = pub.isURL = function(url) {
var pattern = /(ftp|http|https):\/\/(\w+:{0,1}\w*@)?(\S+)(:[0-9]+)?(\/|\/([\w#!:.?+=&%@!\-\/]))?/;
return pattern.test(url);
};
/**
* Checks whether a string ends with a specific character or string.
*
* @cat Data
* @subcat String Functions
* @method endsWith
* @param {String} str A string to be checked
* @param {String} suffix The string to look for
* @return {Boolean} Returns either true or false
*/
var endsWith = pub.endsWith = function(str, suffix) {
return str.indexOf(suffix, str.length - suffix.length) !== -1;
};
/**
* Checks whether a string starts with a specific character or string.
*
* @cat Data
* @subcat String Functions
* @method startsWith
* @param {String} str A string to be checked
* @param {String} prefix The string to look for
* @return {Boolean} Returns either true or false
*/
var startsWith = pub.startsWith = function(str, prefix) {
return str.indexOf(prefix) === 0;
};
/**
* Checks whether a var is an Array, returns true if this is the case
*
* @cat Data
* @subcat Type-Check
* @method isArray
* @param {Object|String|Number|Boolean} obj The object to check
* @return {Boolean} returns true if this is the case
*/
var isArray = pub.isArray = function(obj) {
return Object.prototype.toString.call(obj) === '[object Array]';
};
/**
* Checks whether a var is a number, returns true if this is the case
*
* @cat Data
* @subcat Type-Check
* @method isNumber
* @param {Object|String|Number|Boolean} num The number to check
* @return {Boolean} returns true if this is the case
*/
var isNumber = pub.isNumber = function(num) {
return !isNaN(parseFloat(num)) && isFinite(num);
};
/**
* Checks whether a var is a string, returns true if this is the case
*
* @cat Data
* @subcat Type-Check
* @method isString
* @param {Object|String|Number|Boolean} str The string to check
* @return {Boolean} returns true if this is the case
*/
var isString = pub.isString = function(str) {
return Object.prototype.toString.call(str) === '[object String]';
};
/**
* Checks whether a var is an indesign text object, returns true if this is the case
* NB: a indesign TextFrame will return false as it is just a container holding text.
* So you could say that isText() refers to all the things inside a TextFrame.
*
* @cat Document
* @subcat Type-Check
* @method isText
* @param {Character|InsertionPoint|Line|Paragraph|TextColumn|TextStyleRange|Word} obj The object to check
* @return {Boolean} returns true if this is the case
*/
var isText = pub.isText = function(obj) {
return obj instanceof Character ||
obj instanceof InsertionPoint ||
obj instanceof Line ||
obj instanceof Paragraph ||
obj instanceof TextColumn ||
obj instanceof TextStyleRange ||
obj instanceof Text ||
obj instanceof Word;
};
var initDataFile = function(file, mustExist) {
var result = null;
if (file instanceof File) {
result = file;
} else {
var folder = new Folder(projectFolder().absoluteURI + '/data');
folder.create(); // creates data folder if not existing, otherwise it just skips
result = new File(folder.absoluteURI + '/' + file);
}
if (mustExist && !result.exists) {
error('The file "' + result + '" does not exist.');
}
return result;
};
var initExportFile = function(file, mustExist) {
var result = null;
if (file instanceof File) {
result = file;
} else {
// get rid of some special cases the user might specify
var pathNormalized = file.split("/");
for (var i = 0; i < pathNormalized.length; i++) {
if (pathNormalized[i] === "" || pathNormalized[i] === ".") {
pathNormalized.splice(i,1);
};
};
var tmpPath = projectFolder().absoluteURI;
var fileName = pathNormalized[pathNormalized.length-1];
// contains the path folders? if so create them ...
if (pathNormalized.length > 1) {
var folders = pathNormalized.slice(0,-1);
for (var i = 0; i < folders.length; i++) {
tmpPath += "/"+folders[i]
var f = new Folder(tmpPath);
if (!f.exists) f.create();
};
}
// result = new File(projectFolder().absoluteURI + '/' + file);
result = new File(tmpPath + '/' + fileName);
}
if (mustExist && !result.exists) {
error('The file "' + result + '" does not exist.');
}
return result;
};
/**
* Get the folder of the active document as a Folder object. Use .absoluteURI to access a string representation of the folder path.
*
* @cat Document
* @subcat Misc
* @method projectFolder
* @return {Folder} The folder of the the active document
*/
var projectFolder = pub.projectFolder = function() {
var docPath = null;
try {
docPath = currentDoc().filePath;
} catch (e) {
error("The current document must be saved before its project directory can be accessed.");
}
return docPath;
};
/**
* Executes a shell command and returns the result, currently Mac only.
*
* BE CAREFUL!
*
* @cat Data
* @subcat Input
* @method shellExecute
* @param {String} cmd The shell command to execute
* @return {String}
*/
pub.shellExecute = function(cmd) {
if (Folder.fs === "Macintosh") {
try {
return app.doScript("return do shell script item 1 of arguments", ScriptLanguage.applescriptLanguage, [cmd]);
} catch (e) {
error("b.shellExecute(): "+e);
}
} else {
error("b.shellExecute() is a Mac only feature at the moment. Sorry!")
}
};
/**
* Reads the contents of a file or loads an URL into a String.
* If the file is specified by name as String, it must be located in the document's data directory.
*
* @cat Data
* @subcat Input
* @method loadString
* @param {String|File} fileOrString The text file name in the document's data directory or a File instance or an URL
* @return {String} String file or URL content.
*/
pub.loadString = function(fileOrString) {
if (isURL(fileOrString)) {
return getURL(fileOrString);
} else {
var inputFile = initDataFile(fileOrString, true),
data = null;
inputFile.open('r');
data = inputFile.read();
inputFile.close();
return data;
}
};
var getURL = function(url) {
if (isURL(url)) {
if (Folder.fs === "Macintosh") {
return pub.shellExecute("curl -m 15 -L '"+url+"'");
} else {
error("Loading of strings via an URL is a Mac only feature at the moment. Sorry!")
}
} else {
error("The url "+url+" is not a valid one. Please double check!")
}
};
/**
* Reads the contents of a file or loads an URL and creates a String array of its individual lines.
* If the file is specified by name as String, it must be located in the document's data directory.
*
* @cat Data
* @subcat Input
* @method loadStrings
* @param {String|File} file The text file name in the document's data directory or a File instance or an URL
* @return {String[]} Array of the individual lines in the given File or URL
*/
pub.loadStrings = function(file) {
if (isURL(file)) {
var result = getURL(file);
return result.match(/[^\r\n]+/g);
} else {
var inputFile = initDataFile(file, true),
result = [];
inputFile.open('r');
while (!inputFile.eof) {
result.push(inputFile.readln());
}
inputFile.close();
return result;
}
};
// ----------------------------------------
// Output
/**
* Prints a message line to the console output in the ExtendScript editor.
*
* @cat Output
* @method println
* @param {String} msg The message to print
*/
var println = pub.println = function(msg) {
$.writeln(msg);
if (progressPanel)
progressPanel.writeMessage(msg + "\n");
};
/**
* Prints a message to the console output in the ExtendScript editor, but unlike b.println() it doesn't return the carriage to a new line at the end.
*
* @cat Output
* @method print
* @param {String} msg The message to print
*/
pub.print = function(msg) {
$.write(msg);
if (progressPanel)
progressPanel.writeMessage(msg);
};
/**
* Print numerous information about the current environment to the console
*
* @cat Output
* @method printInfo
*/
pub.printInfo = function() {
pub.println("###");
pub.println("OS: " + $.os);
pub.println("ExtendScript Build: " + $.build);
pub.println("ExtendScript Version:" + $.version);
pub.println("Engine: " + $.engineName);
pub.println("memCache: " + $.memCache + " bytes");
pub.println("###");
};
/**
* Writes an array of strings to a file, one line per string.
* If the given file exists it gets overridden.
*
* @cat Output
* @method saveStrings
* @param {String|File} file The file name or a File instance
* @param {String[]} strings The string array to be written
*/
pub.saveStrings = function(file, strings) {
var outputFile = initDataFile(file);
outputFile.open('w');
forEach(strings, function(s) {
outputFile.writeln(s);
});
outputFile.close();
};
/**
* Writes a string to a file.
* If the given file exists it gets overridden.
*
* @cat Output
* @method saveString
* @param {String|File} file The file name or a File instance
* @param {String} string The string to be written
*/
pub.saveString = function(file, string) {
var outputFile = initDataFile(file);
outputFile.open('w');
outputFile.write(string);
outputFile.close();
};
// TODO: make savePDF and savePNG D.R.Y.
/**
* Exports the current document as PDF to the documents folder. Please note, that export options default to the last used export settings.
*
* @cat Output
* @method savePDF
* @param {String|File} file The file name or a File instance
* @param {Boolean} [showOptions] Whether to show the export dialog
*/
pub.savePDF = function(file, showOptions){
var outputFile = initExportFile(file);
if (typeof showOptions !== "boolean") showOptions = false;
currentDoc().exportFile(ExportFormat.PDF_TYPE, outputFile, showOptions);
};
/**
* Exports the current document as PNG (or sequence of PNG files) to the documents folder. Please note, that export options default to the last used export settings.
*
* @cat Output
* @method savePNG
* @param {String|File} file The file name or a File instance
* @param {Boolean} [showOptions] Whether to show the export dialog
*/
pub.savePNG = function(file, showOptions){
var outputFile = initExportFile(file);
if (typeof showOptions !== "boolean") showOptions = false;
currentDoc().exportFile(ExportFormat.PNG_FORMAT, outputFile, showOptions);
};
/**
* Downloads an URL to a file, currently Mac only.
*
* @cat Output
* @method download
* @param {String} url The download url
* @param {String|File} [file] A relative file path in the project folder or a File instance
*/
pub.download = function(url, file) {
var projPath = projectFolder().fsName.replace(" ", "\\ ");
// var scriptPath = "~/Documents/basiljs/bundle/lib/download.sh";
// This is more portable then a fixed location
// the Script looks for the lib folder next to itself
var currentBasilFolderPath = File($.fileName).parent.fsName;
var scriptPath = currentBasilFolderPath + "/lib/download.sh";
if(File(scriptPath).exists === true) {
// the script is there. Great
scriptPath = File(scriptPath).fsName;
} else {
// if not lets create it on the fly
var scriptContent = [
"#!/bin/bash",
"mkdir -p \"$1\"",
"cd \"$1\"",
"if [ -z \"$3\" ]",
" then",
" # echo \"-O\"",
" curl -L -O $2",
" else",
" # echo \"-o\"",
" curl -L -o \"$3\" $2",
"fi"];
// check if the lib folder is there.
if(Folder(currentBasilFolderPath + "/lib").exists !== true) {
// no its not lets create ot
// should be functionalized
// will be needed for loop and stop.jsx as well
var res = Folder(currentBasilFolderPath + "/lib").create();
if(res === false) {
// ! Error creating folder :-(
// uh this should never happen
error("An error occurred while creating the \"/lib\" folder. Please report this issue");
return;
}
} // end of lib folder check
// the folder should be there.
// lets get it
var libFolder = Folder(currentBasilFolderPath + "/lib");
// now create the script file
var downloadScript = new File(libFolder.fsName + "/download.sh");
downloadScript.open("w", undef, undef);
// set encoding and linefeeds
downloadScript.lineFeed = "Unix";
downloadScript.encoding = "UTF-8";
downloadScript.write(scriptContent.join("\n"));
downloadScript.close();
} // end of file and folder creation
if (isURL(url)) {
var cmd = null;
if (file) {
if (file instanceof File) {
var downloadFolder = file.parent.fsName;
var fileName = file.displayName;
downloadFolder = downloadFolder.replace(" ","\\ ");
fileName = fileName.replace(" ","\\ ");
cmd = ["sh",scriptPath,downloadFolder,url,fileName].join(" ");
} else {
var downloadFolder = file.substr(0,file.lastIndexOf("/"));
var fileName = file.substr(file.lastIndexOf("/")+1);
// get rif of some special cases
if(startsWith(downloadFolder,"./")) downloadFolder.substr(2);
if(startsWith(downloadFolder,"/")) downloadFolder.substr(1);
downloadFolder = downloadFolder.replace(" ","\\ ");
fileName = fileName.replace(" ","\\ ");
downloadFolder = projPath + "/data/"+ downloadFolder;
cmd = ["sh",scriptPath,downloadFolder,url,fileName].join(" ");
}
} else {
var downloadFolder = projPath + "/data/download";
var cmd = ["sh",scriptPath,downloadFolder,url].join(" ");
}
println(cmd);
pub.shellExecute(cmd);
} else {
error("The url "+url+" is not a valid one. Please double check!")
}
};
// ----------------------------------------
// Shape
/**
* Draws an ellipse (oval) in the display window. An ellipse with an equal <b>width</b> and <b>height</b> is a circle.
* The first two parameters set the location, the third sets the width, and the fourth sets the height.
*
* @cat Document
* @subcat Primitives
* @method ellipse
* @param {Number} x Location X
* @param {Number} y Location Y
* @param {Number} w Width
* @param {Number} h Height
* @return {Oval} New oval (n.b. in Adobe Scripting the corresponding type is Oval, not Ellipse)
*/
pub.ellipse = function(x, y, w, h){
if (arguments.length !== 4) error("b.ellipse(), not enough parameters to draw an ellipse! Use: x, y, w, h");
var ellipseBounds = [];
if (currEllipseMode === pub.CORNER) {
ellipseBounds[0] = y;
ellipseBounds[1] = x;
ellipseBounds[2] = (y+h);
ellipseBounds[3] = (x+w);
} else if (currEllipseMode === pub.CORNERS) {
ellipseBounds[0] = y;
ellipseBounds[1] = x;
ellipseBounds[2] = h;
ellipseBounds[3] = w;
} else if (currEllipseMode === pub.CENTER) {
ellipseBounds[0] = y-(h/2);
ellipseBounds[1] = x-(w/2);
ellipseBounds[2] = (y+h)-(h/2);
ellipseBounds[3] = (x+w)-(w/2);
} else if (currEllipseMode === pub.RADIUS) {
ellipseBounds[0] = y-(h);
ellipseBounds[1] = x-(w);
ellipseBounds[2] = y+(h);
ellipseBounds[3] = x+(w);
}
if(w === 0 || h === 0)
return false;
var ovals = currentPage().ovals;
var newOval = ovals.add( currentLayer() );
with (newOval) {
strokeWeight = currStrokeWeight;
strokeTint = currStrokeTint;
fillColor = currFillColor;
fillTint = currFillTint;
strokeColor = currStrokeColor;
geometricBounds = ellipseBounds;
}
if (currEllipseMode === pub.CENTER || currEllipseMode === pub.RADIUS) {
newOval.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.CENTER_ANCHOR,
currMatrix.adobeMatrix() );
} else {
newOval.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
currMatrix.adobeMatrix() );
}
return newOval;
};
/**
* Draws a line (a direct path between two points) to the page.
*
* @cat Document
* @subcat Primitives
* @method line
* @param {Number} x1 Point A x-value
* @param {Number} y1 Point A y-value
* @param {Number} x2 Point B x-value
* @param {Number} y2 Point B y-value
* @return {GraphicLine} New GraphicLine
*/
/*
* TODO: Vectors as arguments
* @example
* var vec1 = new b.Vector( x1, y1 );
* var vec2 = new b.Vector( x2, y2 );
* b.line( vec1, vec2 );
*/
pub.line = function(x1, y1, x2, y2) {
if (arguments.length !== 4) error("b.line(), not enough parameters to draw a line! Use: x1, y1, x2, y2");
var lines = currentPage().graphicLines;
var newLine = lines.add( currentLayer() );
with (newLine) {
strokeWeight = currStrokeWeight;
strokeTint = currStrokeTint;
fillColor = currFillColor;
fillTint = currFillTint;
strokeColor = currStrokeColor;
}
newLine.paths.item(0).entirePath = [[x1, y1], [x2, y2]];
newLine.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.CENTER_ANCHOR,
currMatrix.adobeMatrix() );
return newLine;
};
/**
* Using the beginShape() and endShape() functions allow creating more complex forms.
* beginShape() begins recording vertices for a shape and endShape() stops recording.
* After calling the beginShape() function, a series of vertex() commands must follow.
* To stop drawing the shape, call endShape(). The value of the parameter tells whether the paths to
* create from the provided vertices have to be closed or not (to connect the beginning and the end).
*
* @cat Document
* @subcat Primitives
* @method beginShape
* @param shapeMode Set b.CLOSE if the new Path should be auto-closed.
*/
pub.beginShape = function(shapeMode) {
currVertexPoints = [];
currPathPointer = 0;
currPolygon = null;
if( typeof shapeMode != null) {
currShapeMode = shapeMode;
} else {
currShapeMode = null;
}
};
/**
* Shapes are constructed by connecting a series of vertices. vertex() is used to
* specify the vertex coordinates lines and polygons. It is used exclusively within
* the beginShape() and endShape() functions.
*
* Please use either vertex(x, y) or
* for drawing bezier shapes vertex(x, y, xAnchorLeft, yAnchorLeft, xAnchorRight, yAnchorRight).
* You can also mix the two approaches.
*
* @cat Document
* @subcat Primitives
* @method vertex
* @param {Number} x position x-value
* @param {Number} y position y-value
* @param {Number} [xAnchorLeft] position xAnchorLeft-value
* @param {Number} [yAnchorLeft] position yAnchorLeft-value
* @param {Number} [xAnchorRight] position xAnchorRight-value
* @param {Number} [yAnchorRight] position yAnchorRight-value
*/
pub.vertex = function() {
if (isArray(currVertexPoints)) {
if (arguments.length === 2) {
currVertexPoints.push([arguments[0], arguments[1]]);
} else if (arguments.length === 6) {
// [[xL1, YL1], [x1, y1], [xR1, yR1]]
currVertexPoints.push([ [arguments[2], arguments[3]],
[arguments[0], arguments[1]],
[arguments[4], arguments[5]] ]);
} else {
error("b.vertex(), wrong argument count: Please use either vertex(x, y) or vertex(x, y, xAnchorLeft, yAnchorLeft, xAnchorRight, yAnchorRight)!" );
}
} else {
notCalledBeginShapeError();
}
};
/**
* The arc() function draws an arc in the display window.
* Arcs are drawn along the outer edge of an ellipse defined by the
* <b>x</b>, <b>y</b>, <b>width</b> and <b>height</b> parameters.
* The origin or the arc's ellipse may be changed with the
* <b>ellipseMode()</b> function.
* The <b>start</b> and <b>stop</b> parameters specify the angles
* at which to draw the arc.
*
* @cat Document
* @subcat Primitives
* @method arc
* @param {Number} cx x-coordinate of the arc's center
* @param {Number} cy y-coordinate of the arc's center
* @param {Number} w width of the arc's ellipse
* @param {Number} h height of the arc's ellipse
* @param {Number} startAngle starting angle of the arc (radians)
* @param {Number} endAngle ending angle of the arc (radians)
* @param {String} mode optional property defines rendering technique of arc, b.OPEN (default), b.CHORD, or b.PIE
*
* @return {GraphicLine|Polygon} newShape (n.b. in Adobe Scripting the corresponding type is a Path Item)
*
* TODO(S)
* - fix overlapping points bug
*/
pub.arc = function(cx, cy, w, h, startAngle, endAngle, mode) {
if (w <= 0 || endAngle < startAngle) {
return false;
}
if (arguments.length < 6) error("b.arc(), not enough parameters to draw an arc! Use: x, y, w, h, startAngle, endAngle");
var o = b.radians(1); // add 1 degree to ensure angles of 360 degrees are drawn
startAngle %= pub.TWO_PI+o;
endAngle %= pub.TWO_PI+o;
w /= 2;
h /= 2;
if (currEllipseMode === pub.CORNER) {
cx = (cx-w);
cy = (cy+h);
}
else if (currEllipseMode === pub.CORNERS) {
// cx = (cx-w);
// cy = (cy-h);
// w -= cx;
// h -= cy;
}
else if (currEllipseMode === pub.RADIUS) {
w *= 2;
h *= 2;
}
var delta = pub.abs(endAngle - startAngle);
var direction = (startAngle < endAngle) ? 1 : -1;
var thetaStart = startAngle;
if( mode == pub.CHORD ) {
pub.beginShape(pub.CLOSE);
}
else if( mode == pub.PIE ) {
pub.beginShape(pub.CLOSE);
pub.vertex( cx, cy );
}
else {
pub.beginShape();
}
for (var theta = pub.min(pub.TWO_PI, delta); theta > pub.EPSILON; ) {
var thetaEnd = thetaStart + direction * pub.min(theta, pub.HALF_PI);
var points = calculateEllipticalArc(w, h, thetaEnd, thetaStart);
pub.vertex(
cx + points.startx,
cy + points.starty,
cx + points.startx,
cy + points.starty,
cx + points.handle1x,
cy + points.handle1y
);
pub.vertex(
cx + points.endx,
cy + points.endy,
cx + points.handle2x,
cy + points.handle2y,
cx + points.endx,
cy + points.endy
);
theta -= pub.abs(thetaEnd - thetaStart);
thetaStart = thetaEnd;
}
return pub.endShape();
};
/*
* Cubic bezier approximation of a eliptical arc
*
* intial source code:
* Golan Levin
* golan@flong.com
* http://www.flong.com/blog/2009/bezier-approximation-of-a-circular-arc-in-processing/
*
* The solution is taken from this PDF by Richard DeVeneza:
* http://www.tinaja.com/glib/bezcirc2.pdf
* linked from this excellent site by Don Lancaster:
* http://www.tinaja.com/cubic01.asp
*
*/
function calculateEllipticalArc(w, h, startAngle, endAngle) {
var theta = (endAngle - startAngle);
var x0 = pub.cos(theta/2.0);
var y0 = pub.sin(theta/2.0);
var x3 = x0;
var y3 = 0-y0;
var x1 = (4.0-x0)/3.0;
var y1 = ((1.0-x0)*(3.0-x0))/(3.0*y0);
var x2 = x1;
var y2 = 0-y1;
var bezAng = startAngle + theta/2.0;
var cBezAng = pub.cos(bezAng);
var sBezAng = pub.sin(bezAng);
return {
startx: w*(cBezAng * x0 - sBezAng * y0),
starty: h*(sBezAng * x0 + cBezAng * y0),
handle1x: w*(cBezAng * x1 - sBezAng * y1),
handle1y: h*(sBezAng * x1 + cBezAng * y1),
handle2x: w*(cBezAng * x2 - sBezAng * y2),
handle2y: h*(sBezAng * x2 + cBezAng * y2),
endx: w*(cBezAng * x3 - sBezAng * y3),
endy: h*(sBezAng * x3 + cBezAng * y3)
};
};
/**
* addPath() is used to create multi component paths. Call addPath() to add the so far drawn vertices to a single path.
* New vertices will then end up in a new path. endShape() will then return a multi path object. All component paths will account for
* the setting (see b.CLOSE) given in beginShape(shapeMode).
*
* @cat Document
* @subcat Primitives
* @method addPath
*/
pub.addPath = function() {
doAddPath();
currPathPointer++;
};
/**
* The endShape() function is the companion to beginShape() and may only be called
* after beginShape().
*
* @cat Document
* @subcat Primitives
* @method endShape
* @return {GraphicLine|Polygon} newShape
*/
pub.endShape = function() {
doAddPath();
currPolygon.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
currMatrix.adobeMatrix() );
return currPolygon;
};
function doAddPath() {
if (isArray(currVertexPoints)) {
if (currVertexPoints.length > 0) {
if(currPolygon === null) {
addPolygon();
} else {
currPolygon.paths.add();
}
currPolygon.paths.item(currPathPointer).entirePath = currVertexPoints;
currVertexPoints = [];
}
} else {
notCalledBeginShapeError();
}
};
function addPolygon() {
if (currShapeMode === pub.CLOSE) {
currPolygon = currentPage().polygons.add( currentLayer() );
} else {
currPolygon = currentPage().graphicLines.add( currentLayer() );
}
with (currPolygon) {
strokeWeight = currStrokeWeight;
strokeTint = currStrokeTint;
fillColor = currFillColor;
fillTint = currFillTint;
strokeColor = currStrokeColor;
}
};
function notCalledBeginShapeError () {
error("b.endShape(), you have to call first beginShape(), before calling vertex() and endShape()");
};
/**
* Draws a rectangle on the page.
*
* @cat Document
* @subcat Primitives
* @method rect
* @param {Number} x Position X
* @param {Number} y Position Y
* @param {Number} w Width
* @param {Number} h Height
* @return {Rectangle} New rectangle
*/
pub.rect = function(x, y, w, h){
if (w === 0 || h === 0) {
// indesign doesn't draw a rectangle if width or height are set to 0
return false;
}
if (arguments.length !== 4) error("b.rect(), not enough parameters to draw a rect! Use: x, y, w, h");
var rectBounds = [];
if (currRectMode === pub.CORNER) {
rectBounds[0] = y;
rectBounds[1] = x;
rectBounds[2] = (y+h);
rectBounds[3] = (x+w);
} else if (currRectMode === pub.CORNERS) {
rectBounds[0] = y;
rectBounds[1] = x;
rectBounds[2] = h;
rectBounds[3] = w;
} else if (currRectMode === pub.CENTER) {
rectBounds[0] = y-(h/2);
rectBounds[1] = x-(w/2);
rectBounds[2] = (y+h)-(h/2);
rectBounds[3] = (x+w)-(w/2);
}
var newRect = currentPage().rectangles.add( currentLayer() );
with (newRect) {
geometricBounds = rectBounds;
strokeWeight = currStrokeWeight;
strokeTint = currStrokeTint;
fillColor = currFillColor;
fillTint = currFillTint;
strokeColor = currStrokeColor;
}
if (currRectMode === pub.CENTER) {
newRect.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.CENTER_ANCHOR,
currMatrix.adobeMatrix() );
} else {
newRect.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
currMatrix.adobeMatrix() );
}
return newRect;
};
// -- Attributes --
/**
* Modifies the location from which rectangles draw. The default mode is
* rectMode(CORNER), which specifies the location to be the upper left
* corner of the shape and uses the third and fourth parameters of rect()
* to specify the width and height. The syntax rectMode(CORNERS) uses the
* first and second parameters of rect() to set the location of one corner
* and uses the third and fourth parameters to set the opposite corner.
* The syntax rectMode(CENTER) draws the image from its center point and
* uses the third and forth parameters of rect() to specify the image's
* width and height. The syntax rectMode(RADIUS) draws the image from its
* center point and uses the third and forth parameters of rect() to specify
* half of the image's width and height. The parameter must be written in
* "ALL CAPS".
*
* @cat Document
* @subcat Attributes
* @method rectMode
* @param {String} mode Either b.CORNER, b.CORNERS, b.CENTER, or b.RADIUS
*
*/
pub.rectMode = function (mode) {
if (arguments.length === 0) return currRectMode;
if (mode === pub.CORNER || mode === pub.CORNERS || mode === pub.CENTER ) {
currRectMode = mode;
return currRectMode;
} else {
error("b.rectMode(), unsupported rectMode. Use: CORNER, CORNERS, CENTER.");
}
};
/**
* The origin of the ellipse is modified by the ellipseMode() function.
* The default configuration is ellipseMode(CENTER), which specifies the
* location of the ellipse as the center of the shape. The RADIUS mode is
* the same, but the width and height parameters to ellipse() specify the
* radius of the ellipse, rather than the diameter. The CORNER mode draws
* the shape from the upper-left corner of its bounding box. The CORNERS
* mode uses the four parameters to ellipse() to set two opposing corners
* of the ellipse's bounding box. The parameter must be written in "ALL CAPS".
*
* @cat Document
* @subcat Attributes
* @method ellipseMode
* @param {String} mode Either b.CENTER, b.RADIUS, b.CORNER, or b.CORNERS
*/
pub.ellipseMode = function (mode) {
if (arguments.length === 0) return currEllipseMode;
if (mode === pub.CORNER || mode === pub.CORNERS || mode === pub.CENTER || mode === pub.RADIUS ) {
currEllipseMode = mode;
return currEllipseMode;
} else {
error("b.ellipseMode(), Unsupported ellipseMode. Use: CENTER, RADIUS, CORNER, CORNERS.");
}
};
/**
* Sets the width of the stroke used for lines and the border
* around shapes.
*
* @cat Document
* @subcat Attributes
* @method strokeWeight
* @param {Number} weight The width of the stroke
*/
pub.strokeWeight = function (weight) {
if (typeof weight === 'string' || typeof weight === 'number') {
currStrokeWeight = weight;
} else {
error("b.strokeWeight, not supported type. Please make sure the strokeweight is a number or string");
}
};
/**
* Returns the object style with the given name. If the style does not exist it gets created.
*
* @cat Typography
* @method objectStyle
* @param {String} name The name of the object style to return.
* @return {ObjectStyle} The object style instance.
*/
pub.objectStyle = function(name) {
var style = null;
var style = findInCollectionByName(name);
if(typeof style === 'undefined'){
style = currentDoc().objectStyles.add({name: name});
}
return style;
};
/**
* Duplicates the given page after the current page or the given pageitem to the current page and layer. Use b.rectMode() to set center point.
*
* @cat Document
* @subcat Transformation
* @method duplicate
* @param {PageItem|Page} item The item to duplicate
* @returns {Object} Returns the new item
*/
pub.duplicate = function(item){
if( !(item instanceof Page) && typeof(item) !== "undefined" && item.hasOwnProperty("duplicate") ) {
var newItem = item.duplicate(currentPage());
newItem.move(currentLayer());
if (currRectMode === pub.CENTER) {
newItem.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.CENTER_ANCHOR,
currMatrix.adobeMatrix() );
} else {
newItem.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
currMatrix.adobeMatrix() );
}
return newItem;
} else if(item instanceof Page) {
var newPage = item.duplicate(LocationOptions.AFTER, pub.page());
return newPage;
} else {
error("Please provide a valid Page or PageItem as parameter for duplicate().");
}
};
// ----------------------------------------
// Color
/**
* Sets the color or gradient used to fill shapes.
* @cat Color
* @method fill
* @param {Color|Gradient|Swatch|Numbers} fillColor Accepts a color/gradient/swatch or a string with the name of a color. Or values: C,M,Y,K / R,G,B / Grey
*/
pub.fill = function (fillColor) {
checkNull(fillColor);
if (fillColor instanceof Color || fillColor instanceof Swatch || fillColor instanceof Gradient) {
currFillColor = fillColor;
} else {
if (arguments.length === 1) {
currFillColor = pub.color(arguments[0]);
} else if (arguments.length === 2) {
currFillColor = pub.color(arguments[0],arguments[1]);
} else if (arguments.length === 3) {
currFillColor = pub.color(arguments[0],arguments[1],arguments[2]);
} else if (arguments.length === 4) {
currFillColor = pub.color(arguments[0],arguments[1],arguments[2],arguments[3]);
} else if (arguments.length === 5) {
currFillColor = pub.color(arguments[0],arguments[1],arguments[2],arguments[3],arguments[4]);
} else {
error("b.fill(), wrong parameters. Use: "
+ "R,G,B,name or "
+ "C,M,Y,K,name. "
+ "Grey,name "
+ "Name is optional");
}
}
};
/**
* Disables filling geometry. If both noStroke() and noFill() are called,
* newly drawn shapes will be invisible.
*
* @cat Color
* @method noFill
*/
pub.noFill = function () {
currFillColor = noneSwatchColor;
};
/**
* Sets the color used to draw lines and borders around shapes.
* @cat Color
* @method stroke
* @param {Color|Swatch|Numbers} strokeColor Accepts a Color/swatch or a string with the name of a color. Or values: C,M,Y,K / R,G,B / Grey
*/
pub.stroke = function (strokeColor) {
checkNull(strokeColor);
if (strokeColor instanceof Color || strokeColor instanceof Swatch) {
currStrokeColor = strokeColor;
} else {
if (arguments.length === 1) {
currStrokeColor = pub.color(arguments[0]);
} else if (arguments.length === 2) {
currStrokeColor = pub.color(arguments[0],arguments[1]);
} else if (arguments.length === 3) {
currStrokeColor = pub.color(arguments[0],arguments[1],arguments[2]);
} else if (arguments.length === 4) {
currStrokeColor = pub.color(arguments[0],arguments[1],arguments[2],arguments[3]);
} else if (arguments.length === 5) {
currStrokeColor = pub.color(arguments[0],arguments[1],arguments[2],arguments[3],arguments[4]);
} else {
error("b.stroke(), too many parameters. Use: "
+ "R,G,B,name or "
+ "C,M,Y,K,name. "
+ "Grey,name ");
}
}
};
/**
* Disables drawing the stroke (outline). If both noStroke() and noFill()
* are called, nothing will be drawn to the screen.
*
* @cat Color
* @method noStroke
*/
pub.noStroke = function () {
currStrokeColor = noneSwatchColor;
};
/**
* Sets the tint of the color used to fill shapes.
*
* @cat Color
* @method fillTint
* @param {Number} tint Number from 0 to 100
*/
pub.fillTint = function (tint) {
checkNull(tint);
if (typeof tint === 'string' || typeof tint === 'number') {
currFillTint = tint;
} else {
error("b.fillTint, not supported type. Please make sure the strokeweight is a number or string");
}
};
/**
* Sets the tint of the color used to draw lines and borders around shapes.
*
* @cat Color
* @method strokeTint
* @param {Number} tint Number from 0 to 100
*/
pub.strokeTint = function (tint) {
checkNull(tint);
if (typeof tint === 'string' || typeof tint === 'number') {
currStrokeTint = tint;
} else {
error("strokeTint(), not supported type. Please make sure the tint parameter is a number or string");
}
};
/**
* Sets the colormode for creating new colors with b.color() to RGB or CMYK. The default color mode is RBG.
*
* @cat Color
* @method colorMode
* @param {Number} colorMode Either b.RGB or b.CMYK
*/
pub.colorMode = function(colorMode) {
checkNull(colorMode);
if (arguments.length === 0) return currColorMode;
if (colorMode === pub.RGB || colorMode === pub.CMYK) {
currColorMode = colorMode;
} else {
error("b.colorMode(), not supported colormode, use: b.RGB or b.CMYK");
}
};
/**
* Sets the gradient mode for creating new gradients with b.gradient() to LINEAR or RADIAL. The default gradient mode is LINEAR.
*
* @cat Color
* @method gradientMode
* @param {String} gradientMode Either b.LINEAR or b.RADIAL
*/
pub.gradientMode = function(gradientMode) {
checkNull(gradientMode);
if (arguments.length === 0) return currGradientMode;
if (gradientMode === pub.LINEAR || gradientMode === pub.RADIAL) {
currGradientMode = gradientMode;
} else {
error("b.gradientMode(), unsupported gradient mode, use: b.LINEAR or b.RADIAL");
}
};
/**
* Creates a new RGB or CMYK color and adds the new color to the document, or gets a color by name from the document. The default color mode is RGB.
*
* @cat Color
* @method color
* @param {String|Numbers} Get color: the color name. Create new color: R,G,B,[name] or C,M,Y,K,[name] or Grey,name. Name is always optional
* @return {Color} found or new color
*/
pub.color = function() {
var newCol;
var props = {};
var a = arguments[0],
b = arguments[1],
c = arguments[2],
d = arguments[3],
e = arguments[4];
var colorErrorMsg = "b.color(), wrong parameters. Use:\n"
+ "R,G,B,[name] in b.colorMode(b.RGB) or\n"
+ "C,M,Y,K,[name] in b.colorMode(b.CMYK) or\n"
+ "GREY,[name].\n"
+ "Name is optional.\n"
+ "NB: In InDesign colors don't have an alpha value, use b.opacity() to set alpha.";
if (arguments.length === 1) {
// get color by name
if (typeof a === 'string') {
newCol = findInCollectionByName(currentDoc().colors, a);
if (newCol) {
return newCol;
} else {
error("b.color(), a color with the provided name doesn't exist.");
}
} else if (typeof a === 'number') {
// GREY
if (currColorMode === pub.RGB) {
a = pub.constrain(a, 0, 255);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.RGB;
props.colorValue = [a,a,a];
props.name = "R="+a+" G="+a+" B="+a;
} else {
a = pub.constrain(a, 0, 100);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.CMYK;
props.colorValue = [0,0,0,a];
props.name = "C="+0+" M="+0+" Y="+0+" K="+a;
}
} else {
error("b.color(), wrong type of first parameter.");
}
} else if (arguments.length === 2) {
// GREY + name
if (currColorMode === pub.RGB) {
a = pub.constrain(a, 0, 255);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.RGB;
props.colorValue = [a,a,a];
props.name = b;
} else {
a = pub.constrain(a, 0, 100);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.CMYK;
props.colorValue = [0,0,0,a];
props.name = b;
}
} else if (arguments.length === 3) {
// R G B
if (currColorMode === pub.RGB) {
a = pub.constrain(a, 0, 255);
b = pub.constrain(b, 0, 255);
c = pub.constrain(c, 0, 255);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.RGB;
props.colorValue = [a,b,c];
props.name = "R="+a+" G="+b+" B="+c;
} else {
error(colorErrorMsg);
}
} else if (arguments.length === 4 && typeof d === 'string') {
// R G B + name
if (currColorMode === pub.RGB) {
a = pub.constrain(a, 0, 255);
b = pub.constrain(b, 0, 255);
c = pub.constrain(c, 0, 255);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.RGB;
props.colorValue = [a,b,c];
props.name = d;
} else {
error(colorErrorMsg);
}
} else if (arguments.length === 4 && typeof d === 'number'){
// C M Y K
if (currColorMode === pub.CMYK) {
a = pub.constrain(a, 0, 100);
b = pub.constrain(b, 0, 100);
c = pub.constrain(c, 0, 100);
d = pub.constrain(d, 0, 100);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.CMYK;
props.colorValue = [a,b,c,d];
props.name = "C="+a+" M="+b+" Y="+c+" K="+d;
} else {
error(colorErrorMsg);
}
} else if (arguments.length === 5 && typeof e === 'string' && currColorMode === pub.CMYK) {
// C M Y K + name
a = pub.constrain(a, 0, 100);
b = pub.constrain(b, 0, 100);
c = pub.constrain(c, 0, 100);
d = pub.constrain(d, 0, 100);
props.model = ColorModel.PROCESS;
props.space = ColorSpace.CMYK;
props.colorValue = [a,b,c,d];
props.name = e;
} else {
error(colorErrorMsg);
}
// check whether color was already created and added to colors,
// keeps the document clean ...
newCol = findInCollectionByName(currentDoc().colors, props.name);
if (newCol) {
newCol.properties = props;
return newCol;
} else {
newCol = currentDoc().colors.add();
newCol.properties = props;
return newCol;
};
};
/**
* Creates a new gradient and adds it to the document, or gets a gradient by name from the document.
* If two colors are given as the first two parameters, a gradient is created that blends between these two colors. If an array of colors is used
* as the first parameter, a gradient with the contained colors will be created. The colors will be distributed evenly. If additionally to this array
* a second array of gradient stop positions is given, the colors will be positioned at the given gradient stops. Possible gradient stop positions
* range from 0 to 100. All parameter options allow for an additional name parameter at the end to name the new gradient.
* If a string is used as the only parameter, the gradient with that name will be returned, if it exists in the document.
*
* @cat Color
* @method gradient
* @param {Color|Array|String} c1 First color of the gradient. Alternatively: Array of colors/gradients or name of gradient to get.
* @param {Color|Array|String} c2 Second color of the gradient. Alternatively: Array of gradient stop positions (if first parameter is an array of colors).
* @param {String} [name] Optional name of the gradient.
* @return {Gradient} Found or new gradient
*/
pub.gradient = function() {
var newGrad;
var props = {};
var a = arguments[0],
b = arguments[1],
c = arguments[2];
var gradientErrorMsg = "b.gradient(), wrong parameters. Use:\n"
+ "c1,c2,[name] or\n"
+ "arrayOfColors,[name] or\n"
+ "arrayOfColors,arrayOfGradientStops,[name] or\n"
+ "gradientName";
if (typeof a === 'string' && arguments.length === 1) {
// get gradient by name
newGrad = currentDoc().gradients.itemByName(a);
if (newGrad.isValid) {
return newGrad;
} else {
error("b.gradient(), a gradient with the provided name doesn't exist.");
}
} else if (a instanceof Color && b instanceof Color && (typeof c === 'string' || arguments.length === 2)) {
// c1 and c2
if (typeof c === 'string') {
if(currentDoc().colors.itemByName(c).isValid) error('b.gradient(), "' + c + '" already exists as a color. Use another name for the gradient.');
if(currentDoc().gradients.itemByName(c).isValid) {
currentDoc().gradients.itemByName(c).remove();
warning('b.gradient(), a gradient named "' + c + '" already existed. The old gradient is replaced by a new one.')
}
newGrad = currentDoc().gradients.add({name: c});
} else {
newGrad = currentDoc().gradients.add();
}
newGrad.gradientStops[0].stopColor = a;
newGrad.gradientStops[1].stopColor = b;
if(currGradientMode === pub.LINEAR) {
newGrad.type = GradientType.LINEAR;
} else {
newGrad.type = GradientType.RADIAL;
}
return newGrad;
} else if (a instanceof Array){
// array of colors
var customStopLocations = false;
if(arguments.length > 3) error(gradientErrorMsg);
if(arguments.length > 1 && !(b instanceof Array || typeof b === 'string')) error(gradientErrorMsg);
if(arguments.length === 3 && !(typeof c === 'string')) error(gradientErrorMsg);
if(arguments.length > 1 && b instanceof Array) customStopLocations = true;
if(customStopLocations && !(a.length === b.length)) error("b.gradient(), arrayOfColors and arrayOfGradientStops need to have the same length.");
var z = arguments[arguments.length - 1];
if (typeof z === 'string') {
if(currentDoc().colors.itemByName(z).isValid) error('b.gradient(), "' + z + '" already exists as a color. Use another name for the gradient.');
if(currentDoc().gradients.itemByName(z).isValid) {
currentDoc().gradients.itemByName(z).remove();
warning('b.gradient(), a gradient named "' + z + '" already existed. The old gradient is replaced by a new one.')
}
newGrad = currentDoc().gradients.add({name: z});
} else {
newGrad = currentDoc().gradients.add();
}
for (var i = 0; i < a.length; i++) {
if(! (a[i] instanceof Color || a[i] instanceof Swatch)) {
error("b.gradient(), element #" + (i+1) + " of the given arrayOfColors is not a color or swatch.");
}
if(i > newGrad.gradientStops.length - 1) newGrad.gradientStops.add();
newGrad.gradientStops[i].stopColor = a[i];
if(customStopLocations){
if(! (typeof b[i] === 'number')) error("b.gradient(), element #" + (i+1) + " of the given arrayOfGradientStops is not a number.")
newGrad.gradientStops[i].location = pub.constrain(b[i], 0, 100);
} else {
newGrad.gradientStops[i].location = pub.map(i, 0, a.length - 1, 0, 100);
}
}
if(currGradientMode === pub.LINEAR) {
newGrad.type = GradientType.LINEAR;
} else {
newGrad.type = GradientType.RADIAL;
}
return newGrad;
} else {
error(gradientErrorMsg);
}
};
/**
* Sets the opacity property of an object.
*
* @cat Color
* @method opacity
* @param {Object} obj The object to set opacity property
* @param {Number} opacity The opacity value form 0 to 100
*/
pub.opacity = function(obj, opacity){
checkNull(obj);
if (obj.hasOwnProperty("transparencySettings")) {
obj.transparencySettings.blendingSettings.opacity = opacity;
} else {
warning("b.opacity(), the object "+ obj.toString() +" doesn't have an opacity property");
}
};
/**
* Sets the Effects blendMode property of an object.
*
* @cat Color
* @method blendMode
* @param {Object} obj The object to set blendMode property
* @param {Number} blendMode The blendMode must be one of the InDesign BlendMode enum values:
* BlendMode.NORMAL <br />
* BlendMode.MULTIPLY <br />
* BlendMode.SCREEN <br />
* BlendMode.OVERLAY <br />
* BlendMode.SOFT_LIGHT <br />
* BlendMode.HARD_LIGHT <br />
* BlendMode.COLOR_DODGE <br />
* BlendMode.COLOR_BURN <br />
* BlendMode.DARKEN <br />
* BlendMode.LIGHTEN <br />
* BlendMode.DIFFERENCE <br />
* BlendMode.EXCLUSION <br />
* BlendMode.HUE <br />
* BlendMode.SATURATION <br />
* BlendMode.COLOR <br />
* BlendMode.LUMINOSITY <br />
*/
pub.blendMode = function(obj, blendMode){
checkNull(obj);
if (obj.hasOwnProperty("transparencySettings")) {
obj.transparencySettings.blendingSettings.blendMode = blendMode;
} else {
warning("b.blendMode(), the object "+ obj.toString() +" doesn't have a blendMode property");
}
};
/**
* Calculates a color or colors between two color at a specific increment.
* The amt parameter is the amount to interpolate between the two values where 0.0 equal to the first point, 0.1 is very near the first point, 0.5 is half-way in between, etc.
* N.B.: Both color must be either CMYK or RGB.
*
* @cat Color
* @method lerpColor
* @param {Color} c1 Input color 1
* @param {Color} c2 Input color 2
* @param {Number} amt The Amount to interpolate between the two colors
* @return {Color} Interpolated color
*/
pub.lerpColor = function (c1, c2, amt) {
checkNull(c1);
checkNull(c2);
if ( (c1 instanceof Color || c1 instanceof Swatch) &&
(c2 instanceof Color || c2 instanceof Swatch) &&
typeof amt === 'number') {
if (c1.space === ColorSpace.CMYK && c2.space === ColorSpace.CMYK) {
var C1 = c1.colorValue[0];
var M1 = c1.colorValue[1];
var Y1 = c1.colorValue[2];
var K1 = c1.colorValue[3];
var C2 = c2.colorValue[0];
var M2 = c2.colorValue[1];
var Y2 = c2.colorValue[2];
var K2 = c2.colorValue[3];
var COut = Math.round( pub.lerp(C1,C2,amt) );
var MOut = Math.round( pub.lerp(M1,M2,amt) );
var YOut = Math.round( pub.lerp(Y1,Y2,amt) );
var KOut = Math.round( pub.lerp(K1,K2,amt) );
return pub.color(COut,MOut,YOut,KOut);
} else if (c1.space === ColorSpace.RGB && c2.space === ColorSpace.RGB) {
var R1 = c1.colorValue[0];
var G1 = c1.colorValue[1];
var B1 = c1.colorValue[2];
var R2 = c2.colorValue[0];
var G2 = c2.colorValue[1];
var B2 = c2.colorValue[2];
var ROut = Math.round( pub.lerp(R1,R2,amt) );
var GOut = Math.round( pub.lerp(G1,G2,amt) );
var BOut = Math.round( pub.lerp(B1,B2,amt) );
return pub.color(ROut,GOut,BOut);
} else {
error("b.lerpColor(), both color must be either CMYK or RGB.");
}
} else {
error("b.lerpColor(), wrong parameters. Use: two colors (of the same type) and a number.");
}
};
// ----------------------------------------
// Typography
/**
* Creates a text frame on the current layer on the current page in the current document.
* The text frame gets created in the position specified by the x and y parameters.
* The default document font will be used unless a font is set with the textFont() function.
* The default document font size will be used unless a font size is set with the textSize() function.
* Change the color of the text with the fill() function.
* The text displays in relation to the textAlign() and textYAlign() functions.
* The width and height parameters define a rectangular area.
*
* @cat Typography
* @method text
* @param {String} txt The text content to set in the text frame.
* @param {Number} x x-coordinate of text frame
* @param {Number} y y-coordinate of text frame
* @param {Number} w width of text frame
* @param {Number} h height of text frame
* @return {TextFrame} The created text frame instance
*/
pub.text = function(txt, x, y, w, h) {
if (arguments.length !== 5) error("b.text(), not enough parameters to draw a text! Use: b.text(txt, x, y, w, h)");
if (!(isString(txt) || isNumber(txt))) warning("b.text(), the first parameter has to be a string! But is something else: "+ typeof txt +". Use: b.text(txt, x, y, w, h)");
var textFrame = currentPage().textFrames.add( currentLayer() );
with (textFrame) {
contents = txt.toString();
geometricBounds = [y, x, (y+h), (x+w)];
textFramePreferences.verticalJustification = currYAlign;
}
pub.typo(textFrame, {
'appliedFont': currFont,
'pointSize': currFontSize,
'fillColor': currFillColor,
'justification': currAlign,
'leading': currLeading,
'kerningValue': currKerning,
'tracking': currTracking
});
if (currAlign === Justification.CENTER_ALIGN || currAlign === Justification.CENTER_JUSTIFIED) {
textFrame.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.CENTER_ANCHOR,
currMatrix.adobeMatrix() );
} else {
textFrame.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
currMatrix.adobeMatrix() );
}
return textFrame;
};
/**
* Sets text properties to the given item. If the item is not an instance the text property can be set to,
* the property gets set to the direct descendants of the given item, e.g. all stories of a given document.
*
* If no value is given and the given property is a string, the function acts as a getter and returns the
* corresponding value(s) in an array. This can either be an array containing the value of the concrete item
* (e.g. character) the values of the item's descendants (e.g. paragraphs of given text frame).
*
* @cat Typography
* @method typo
* @param {Document|Spread|Page|Layer|Story|TextFrame|Text} item The object to apply the property to.
* @param {String|Object} property The text property name or an object of key/value property/value pairs.
* If property is a string and no value is given, the function acts as getter.
* @param {String|Number|Object} [value] The value to apply to the property.
* @return {String[]|Number[]|Object[]} The property value(s) if the function acts as getter or the items the property
* was assigned to.
*/
pub.typo = function(item, property, value) {
var result = [],
actsAsGetter = typeof property === 'string' && (value === undef || value === null),
getOrSetProperties = function(textItem) {
if (actsAsGetter) {
result.push(textItem[property]);
} else {
setProperties(textItem);
}
},
setProperties = function(textItem) {
if (typeof property === 'string') {
result.push(textItem);
setProperty(textItem, property, value);
} else if (typeof property === 'object') {
result.push(textItem);
for (var prop in property) {
setProperty(textItem, prop, property[prop]);
}
}
},
setProperty = function(textItem, prop, val) {
textItem[prop] = val;
};
if(typeof item === 'string') error( "b.typo() cannot work on strings. Please pass a Text object to modify." );
if(!isValid(item)){
warning("b.typo(), invalid object passed");
return;
}
if (item instanceof Document ||
item instanceof Spread ||
item instanceof Page ||
item instanceof Layer) {
forEach(item.textFrames, function(textFrame) {
pub.typo(textFrame, property, value);
});
} else if (item instanceof Story ||
item instanceof TextFrame) {
var paras = item.paragraphs;
// loop backwards to prevent invalid object reference error when
// start of para is overflown in "invisible" textFrame area after
// applying prop to previous para(s)
for (var i = paras.length - 1; i >= 0; i--) {
getOrSetProperties(paras[i]);
}
} else if (isText(item)) {
getOrSetProperties(item);
}
return result;
};
var isValid = function (item) {
checkNull(item);
if (item.hasOwnProperty("isValid")) {
if (!item.isValid) {
return false;
} else {
return true;
}
}
return true; // if does not have isValid field -> normal array element and not collection
return false;
};
/**
* Returns the current font and sets it if argument fontName is given.
*
* @cat Typography
* @method textFont
* @param {String} fontName The name of the font to set e.g. Helvetica
* @param {String} [fontStyle] The Font style e.g. Bold
* @return {String} currFont The name of the current font
*/
pub.textFont = function(fontName, fontStyle) {
if (arguments.length === 1) {
currFont = fontName;
}
if (arguments.length === 2) {
currFont = fontName+"\t"+fontStyle;
}
return currFont;
};
/**
* Returns the current font size in points and sets it if argument pointSize is given.
*
* @cat Typography
* @method textSize
* @param {Number} [pointSize] The size in points to set.
* @return {Number} The current point size.
*/
pub.textSize = function(pointSize) {
if (arguments.length === 1) {
currFontSize = pointSize;
}
return currFontSize;
};
/**
* Sets the current horizontal and vertical text alignment.
*
* @cat Typography
* @method textAlign
* @param {String} align The horizontal text alignment to set. Must be one of the InDesign Justification enum values:
* Justification.AWAY_FROM_BINDING_SIDE <br />
* Justification.CENTER_ALIGN <br />
* Justification.CENTER_JUSTIFIED <br />
* Justification.FULLY_JUSTIFIED <br />
* Justification.LEFT_ALIGN <br />
* Justification.RIGHT_ALIGN <br />
* Justification.RIGHT_JUSTIFIED <br />
* Justification.TO_BINDING_SIDE <br />
* @param {String} [yAlign] The vertical text alignment to set. Must be one of the InDesign VerticalJustification enum values:
* VerticalJustification.BOTTOM_ALIGN <br />
* VerticalJustification.CENTER_ALIGN <br />
* VerticalJustification.JUSTIFY_ALIGN <br />
* VerticalJustification.TOP_ALIGN <br />
*/
pub.textAlign = function(align, yAlign) {
currAlign = align;
if (arguments.length === 2) currYAlign = yAlign;
};
/**
* Returns the spacing between lines of text in units of points and sets it if argument leading is given.
*
* @cat Typography
* @method textLeading
* @param {Number|String} [leading] The spacing between lines of text in units of points or the default Indesign enum
* value Leading.AUTO.
* @return {Number|String} The current leading.
*/
pub.textLeading = function(leading) {
if (arguments.length === 1) {
currLeading = leading;
}
return currLeading;
};
/**
* Returns the current kerning and sets it if argument kerning is given.
*
* @cat Typography
* @method textKerning
* @param {Number} [kerning] The value to set.
* @return {Number} The current kerning.
*/
pub.textKerning = function(kerning) {
if (arguments.length === 1) {
currKerning = kerning;
}
return currKerning;
};
/**
* Returns the current tracking and sets it if argument tracking is given.
*
* @cat Typography
* @method textTracking
* @param {Number} [tracking] The value to set.
* @return {Number} The current tracking.
*/
pub.textTracking = function(tracking) {
if (arguments.length === 1) {
currTracking = tracking;
}
return currTracking;
};
/**
* Returns the character style with the given name. If the style does not exist it gets created.
*
* @cat Typography
* @method characterStyle
* @param {String} name The name of the character style to return.
* @return {CharachterStyle} The character style instance.
*/
pub.characterStyle = function(name) {
var style = null;
var style = findInCollectionByName(name);
if(typeof style === 'undefined'){
style = currentDoc().characterStyles.add({name: name});
}
return style;
};
/**
* Returns the paragraph style with the given name. If the style does not exist it gets created.
*
* @cat Typography
* @method paragraphStyle
* @param {String} name The name of the paragraph style to return.
* @return {ParagraphStyle} The paragraph style instance.
*/
pub.paragraphStyle = function(name) {
var style = null;
var style = findInCollectionByName(name);
if(typeof style === 'undefined'){
style = currentDoc().paragraphStyles.add({name: name});
}
return style;
};
/**
* Links the stories of two textframes to one story. Text of first textframe overflows to second one.
*
* @cat Story
* @method linkTextFrames
* @param {TextFrame} textFrameA
* @param {TextFrame} textFrameB
*/
pub.linkTextFrames = function (textFrameA, textFrameB) {
if (textFrameA instanceof TextFrame && textFrameB instanceof TextFrame) {
textFrameA.nextTextFrame = textFrameB;
} else {
error("linkTextFrames(), wrong type of parameter! linkTextFrames() needs two textFrame objects to link the stories. Use: textFrameA, textFrameB");
}
};
// ----------------------------------------
// Image
/**
* Adds an image to the document. If the image argument is given as a string the image file must be in the document's
* data directory which is in the same directory where the document is saved in. The image argument can also be a File
* instance which can be placed even before the document was saved.
* The second argument can either be the x position of the frame to create or an instance of a rectangle,
* oval or polygon to place the image in. If an x position is given, a y position must be given, too.
* If x and y positions are given and width and height are not given, the frame's size gets set to the original image size.
*
* @cat Document
* @subcat Image
* @method image
* @param {String|File} img The image file name in the document's data directory or a File instance
* @param {Number|Rectangle|Oval|Polygon} x The x position on the current page or the item instance to place the image in
* @param {Number} [y] The y position on the current page. Ignored if x is not a number.
* @param {Number} [w] The width of the rectangle to add the image to. Ignored if x is not a number.
* @param {Number} [h] The height of the rectangle to add the image to. Ignored if x is not a number.
* @return {Rectangle|Oval|Polygon} The item instance the image was placed in.
*/
pub.image = function(img, x, y, w, h) {
var file = initDataFile(img, true),
frame = null,
fitOptions = null,
width = null,
height = null,
imgErrorMsg = "b.image(), wrong parameters. Use:\n"
+ "b.image( {String|File}, {Rectangle|Oval|Polygon} ) or\n"
+ "b.image( {String|File}, x, y ) or\n"
+ "b.image( {String|File}, x, y, w, h )";
if(arguments.length < 2 || arguments.length === 4 || arguments.length > 5) error(imgErrorMsg);
if (x instanceof Rectangle ||
x instanceof Oval ||
x instanceof Polygon) {
frame = x;
fitOptions = FitOptions.FILL_PROPORTIONALLY;
} else if (typeof x === 'number' && typeof y === 'number') {
width = 1;
height = 1;
if (currImageMode === pub.CORNERS) {
if (typeof w === 'number' && typeof h === 'number'){
width = w - x;
height = h - y;
fitOptions = FitOptions.FILL_PROPORTIONALLY;
} else if (arguments.length === 3){
fitOptions = FitOptions.frameToContent;
} else {
error(imgErrorMsg);
}
} else {
if (typeof w === 'number' && typeof h === 'number'){
if (w <= 0 || h <= 0) error("b.image, invalid parameters. When using b.image(img, x, y, w, h) with the default imageMode b.CORNER, parameters w and h need to be greater than 0.")
width = w;
height = h;
fitOptions = FitOptions.FILL_PROPORTIONALLY;
} else if (arguments.length === 3){
fitOptions = FitOptions.frameToContent;
} else {
error(imgErrorMsg);
}
}
frame = currentPage().rectangles.add(currentLayer(),
{ geometricBounds:[y, x, y + height, x + width] }
);
} else {
error(imgErrorMsg);
}
frame.place(file);
if (fitOptions) {
frame.fit(fitOptions);
}
if (currImageMode === pub.CENTER) {
var bounds = frame.geometricBounds;
width = bounds[3] - bounds[1];
height = bounds[2] - bounds[0];
frame.move(null, [-(width / 2), -(height / 2)]);
frame.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.CENTER_ANCHOR,
currMatrix.adobeMatrix() );
} else {
frame.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
currMatrix.adobeMatrix() );
}
with (frame) {
strokeWeight = currStrokeWeight;
strokeTint = currStrokeTint;
strokeColor = currStrokeColor;
}
return frame;
};
/**
* Transforms position and size of an image.
* The image fit options are always "contentToFrame".
*
* @cat Document
* @subcat Image
* @method transformImage
* @param {Graphic} img The image to transform
* @param {Number} x New x
* @param {Number} y New y
* @param {Number} width New width
* @param {Number} height New height
*/
pub.transformImage = function(img, x, y, width, height) {
if (img.hasOwnProperty("geometricBounds") && img.hasOwnProperty("fit")) {
//[y1, x1, y2, x2]
img.geometricBounds = [y,x,y+height,x+width];
if (currImageMode === pub.CENTER) {
img.move(null, [-(width / 2), -(height / 2)]);
}
img.fit( FitOptions.CENTER_CONTENT );
img.fit( FitOptions.contentToFrame );
} else {
error("b.transformImage(), wrong type! Use: img, x, y, width, height");
}
};
/**
* Modifies the location from which images draw. The default mode is imageMode(CORNER), which specifies the location to be the upper left corner and uses the fourth and fifth parameters of image() to set the image's width and height. The syntax imageMode(CORNERS) uses the second and third parameters of image() to set the location of one corner of the image and uses the fourth and fifth parameters to set the opposite corner. Use imageMode(CENTER) to draw images centered at the given x and y position.
* If no parameter is passed the currently set mode is returned as String.
*
* @cat Document
* @subcat Image
* @method imageMode
* @param {String} [mode] Either b.CORNER, b.CORNERS, or b.CENTER
* @return {String} The current mode
*/
pub.imageMode = function(mode) {
if (arguments.length === 0) return currImageMode;
if (mode === pub.CORNER || mode === pub.CORNERS || mode === pub.CENTER ) {
currImageMode = mode;
} else {
error("b.imageMode(), unsupported imageMode. Use: CORNER, CORNERS, CENTER.");
}
return currImageMode;
};
// ----------------------------------------
// Math
var Vector = pub.Vector = function() {
/**
* A class to describe a two or three dimensional vector. This datatype stores two or three variables that are commonly used as a position, velocity, and/or acceleration. Technically, position is a point and velocity and acceleration are vectors, but this is often simplified to consider all three as vectors. For example, if you consider a rectangle moving across the screen, at any given instant it has a position (the object's location, expressed as a point.), a velocity (the rate at which the object's position changes per time unit, expressed as a vector), and acceleration (the rate at which the object's velocity changes per time unit, expressed as a vector). Since vectors represent groupings of values, we cannot simply use traditional addition/multiplication/etc. Instead, we'll need to do some "vector" math, which is made easy by the methods inside the Vector class.
*
* Constructor of Vector, can be two- or three-dimensional.
*
* @constructor
* @cat Data
* @subcat Vector
* @method Vector
* @param {Number} x
* @param {Number} y
* @param {Number} [z]
*/
function Vector(x, y, z) {
this.x = x || 0;
this.y = y || 0;
this.z = z || 0;
}
/**
* Static function. Calculates the Euclidean distance between two points (considering a point as a vector object).
* Is meant to be called "static" i.e. Vector.dist(v1, v2);
* @cat Data
* @subcat Vector
* @method Vector.dist
* @static
* @param {Vector} v1 The first vector
* @param {Vector} v2 The second vector
* @return {Number} The distance
*/
Vector.dist = function(v1, v2) {
return v1.dist(v2);
};
/**
* Static function. Calculates the dot product of two vectors.
* Is meant to be called "static" i.e. Vector.dot(v1, v2);
* @method Vector.dot
* @cat Data
* @subcat Vector
* @static
* @param {Vector} v1 The first vector
* @param {Vector} v2 The second vector
* @return {Number} The dot product
*/
Vector.dot = function(v1, v2) {
return v1.dot(v2);
};
/**
* Static function. Calculates the cross product of two vectors.
* Is meant to be called "static" i.e. Vector.cross(v1, v2);
* @method Vector.cross
* @cat Data
* @subcat Vector
* @static
* @param {Vector} v1 The first vector
* @param {Vector} v2 The second vector
* @return {Number} The cross product
*/
Vector.cross = function(v1, v2) {
return v1.cross(v2);
};
/**
* Static function. Calculates the angle between two vectors.
* Is meant to be called "static" i.e. Vector.angleBetween(v1, v2);
* @method Vector.angleBetween
* @cat Data
* @subcat Vector
* @static
* @param {Vector} v1 The first vector
* @param {Vector} v2 The second vector
* @return {Number} The angle
*/
Vector.angleBetween = function(v1, v2) {
return Math.acos(v1.dot(v2) / (v1.mag() * v2.mag()));
};
Vector.prototype = {
/**
* Sets the x, y, and z component of the vector using three separate variables, the data from a Vector, or the values from a float array.
* @method Vector.set
* @cat Data
* @subcat Vector
* @param {Number|Array|Vector} v Either a vector, array or x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
*/
set: function(v, y, z) {
if (arguments.length === 1) this.set(v.x || v[0] || 0, v.y || v[1] || 0, v.z || v[2] || 0);
else {
this.x = v;
this.y = y;
this.z = z;
}
},
/**
* Gets a copy of the vector, returns a Vector object.
* @method Vector.get
* @cat Data
* @subcat Vector
* @return {Vector} A copy of the vector
*/
get: function() {
return new Vector(this.x, this.y, this.z);
},
/**
* Calculates the magnitude (length) of the vector and returns the result as a float
* @method Vector.mag
* @cat Data
* @subcat Vector
* @return {Number} The length
*/
mag: function() {
var x = this.x,
y = this.y,
z = this.z;
return Math.sqrt(x * x + y * y + z * z);
},
/**
* Adds x, y, and z components to a vector, adds one vector to another.
* @method Vector.add
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
*/
add: function(v, y, z) {
if (arguments.length === 1) {
this.x += v.x;
this.y += v.y;
this.z += v.z;
} else {
this.x += v;
this.y += y;
this.z += z;
}
},
/**
* Substract x, y, and z components or a full vector from this vector
* @method Vector.sub
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
*/
sub: function(v, y, z) {
if (arguments.length === 1) {
this.x -= v.x;
this.y -= v.y;
this.z -= v.z;
} else {
this.x -= v;
this.y -= y;
this.z -= z;
}
},
/**
* Multiplies this vector with x, y, and z components or another vector.
* @method Vector.mult
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
*/
mult: function(v) {
if (typeof v === "number") {
this.x *= v;
this.y *= v;
this.z *= v;
} else {
this.x *= v.x;
this.y *= v.y;
this.z *= v.z;
}
},
/**
* Divides this vector through x, y, and z components or another vector.
* @method Vector.div
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
*/
div: function(v) {
if (typeof v === "number") {
this.x /= v;
this.y /= v;
this.z /= v;
} else {
this.x /= v.x;
this.y /= v.y;
this.z /= v.z;
}
},
/**
* Calculates the distance from this vector to another as x, y, and z components or full vector.
* @method Vector.dist
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
* @return {Number} The distance
*/
dist: function(v) {
var dx = this.x - v.x,
dy = this.y - v.y,
dz = this.z - v.z;
return Math.sqrt(dx * dx + dy * dy + dz * dz);
},
/**
* Calculates the dot product from this vector to another as x, y, and z components or full vector.
* @method Vector.dot
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
* @return {Number} The dot product
*/
dot: function(v, y, z) {
if (arguments.length === 1) return this.x * v.x + this.y * v.y + this.z * v.z;
return this.x * v + this.y * y + this.z * z;
},
/**
* Calculates the cross product from this vector to another as x, y, and z components or full vector.
* @method Vector.cross
* @cat Data
* @subcat Vector
* @param {Vector|Number} v Either a full vector or an x component
* @param {Number} [y] The y component
* @param {Number} [z] The z component
* @return {Number} The cross product
*/
cross: function(v) {
var x = this.x,
y = this.y,
z = this.z;
return new Vector(y * v.z - v.y * z, z * v.x - v.z * x, x * v.y - v.x * y);
},
/**
* Normalizes the length of this vector to 1.
* @cat Data
* @subcat Vector
* @method Vector.normalize
*/
normalize: function() {
var m = this.mag();
if (m > 0) this.div(m);
},
/**
* Normalizes the length of this vector to the given parameter.
* @method Vector.limit
* @cat Data
* @subcat Vector
* @param {Number} high The value to scale to.
*/
limit: function(high) {
if (this.mag() > high) {
this.normalize();
this.mult(high);
}
},
/**
* The 2D orientation (heading) of this vector in radian.
* @method Vector.heading
* @cat Data
* @subcat Vector
* @return {Number} A radian angle value
*/
heading: function() {
return -Math.atan2(-this.y, this.x);
},
/**
* Returns data about this vector as a string.
* @method Vector.toString
* @cat Data
* @subcat Vector
* @return {String} The x, y and z components as a string.
*/
toString: function() {
return "[" + this.x + ", " + this.y + ", " + this.z + "]";
},
/**
* Returns this vector as an array [x,y,z].
* @method Vector.array
* @cat Data
* @subcat Vector
* @return {Array} [x,y,z]
*/
array: function() {
return [this.x, this.y, this.z];
}
};
function createVectorMethod(method) {
return function(v1, v2) {
var v = v1.get();
v[method](v2);
return v;
};
}
for (var method in Vector.prototype) if (Vector.prototype.hasOwnProperty(method) && !Vector.hasOwnProperty(method)) Vector[method] = createVectorMethod(method);
return Vector;
}();
// -- Calculation --
/**
* Calculates the absolute value (magnitude) of a number. The absolute value of a number is always positive.
*
* @cat Math
* @subcat Calculation
* @method abs
* @param {Number} val An arbitrary number
* @return The absolute value of that number
*/
pub.abs = Math.abs;
/**
* Calculates the closest int value that is greater than or equal to the value of the parameter. For example, ceil(9.03) returns the value 10.
*
* @cat Math
* @subcat Calculation
* @method ceil
* @param {Number} val An arbitrary number
* @return The next highest integer value
*/
pub.ceil = Math.ceil;
/**
* Constrains a value to not exceed a maximum and minimum value.
*
* @cat Math
* @subcat Calculation
* @method constrain
* @param {Number} aNumber the value to constrain
* @param {Number} aMin minimum limit
* @param {Number} aMax maximum limit
* @return The constrained value
*/
pub.constrain = function(aNumber, aMin, aMax) {
if(arguments.length !== 3 ) error("b.constrain(), wrong argument count.");
if(aNumber <= aMin) return aMin;
if(aNumber >= aMax) return aMax;
return aNumber;
};
/**
* Calculates the distance between two points.
*
* @cat Math
* @subcat Calculation
* @method dist
* @param {Number} x1 the x-coordinate of the first point
* @param {Number} y1 the y-coordinate of the first point
* @param {Number} x2 the x-coordinate of the second point
* @param {Number} y2 the y-coordinate of the second point
* @return {Number} The distance
*/
pub.dist = function() {
var dx, dy, dz;
if (arguments.length === 4) {
dx = arguments[0] - arguments[2];
dy = arguments[1] - arguments[3];
return Math.sqrt(dx * dx + dy * dy);
} else {
error("b.dist(), wrong argument count.");
}
};
/**
* Returns Euler's number e (2.71828...) raised to the power of the value parameter.
*
* @cat Math
* @subcat Calculation
* @method exp
* @param {Number} a value
* @return {Number}
*/
pub.exp = Math.exp;
/**
* Calculates the closest int value that is less than or equal to the value of the parameter.
*
* @cat Math
* @subcat Calculation
* @method floor
* @param {Number} a value
* @return {Number}
*/
pub.floor = Math.floor;
/**
* Calculates a number between two numbers at a specific increment. The amt parameter is the amount to interpolate between the two values where 0.0 equal to the first point, 0.1 is very near the first point, 0.5 is half-way in between, etc. The lerp function is convenient for creating motion along a straight path and for drawing dotted lines.
*
* @cat Math
* @subcat Calculation
* @method lerp
* @param {Number} value1 first value
* @param {Number} value2 second value
* @param {Number} amt between 0.0 and 1.0
* @return {Number} The mapped value
*/
pub.lerp = function(value1, value2, amt) {
if(arguments.length !== 3 ) error("b.lerp(), wrong argument count.");
return (value2 - value1) * amt + value1;
};
/**
* Calculates the natural logarithm (the base-e logarithm) of a number. This function expects the values greater than 0.0.
*
* @cat Math
* @subcat Calculation
* @method log
* @param {Number} number must be greater then 0.0
* @return {Number}
*/
pub.log = Math.log;
/**
* Calculates the magnitude (or length) of a vector. A vector is a direction in space commonly used in computer graphics and linear algebra. Because it has no "start" position, the magnitude of a vector can be thought of as the distance from coordinate (0,0) to its (x,y) value. Therefore, mag() is a shortcut for writing "dist(0, 0, x, y)".
*
* @cat Math
* @subcat Calculation
* @method mag
* @param {Number} a x-coordinate
* @param {Number} b y-coordinate
* @param {Number} [c] z-coordinate
* @return {Number} the magnitude
*/
pub.mag = function(a, b, c) {
if( ! (arguments.length === 2 || arguments.length === 3 ) ) error("b.mag(), wrong argument count.");
if (c) return Math.sqrt(a * a + b * b + c * c);
return Math.sqrt(a * a + b * b);
};
/**
* Re-maps a number from one range to another. In the example above, the number '25' is converted from a value in the range 0..100 into a value that ranges from the left edge (0) to the right edge (width) of the screen.
*
* Numbers outside the range are not clamped to 0 and 1, because out-of-range values are often intentional and useful.
*
* @cat Math
* @subcat Calculation
* @method map
* @param {Number} value the value to be mapped
* @param {Number} istart start of the input range
* @param {Number} istop end of the input range
* @param {Number} ostart start of the output range
* @param {Number} ostop end of the output range
* @return {Number} the mapped value
*/
pub.map = function(value, istart, istop, ostart, ostop) {
if(arguments.length !== 5 ) error("b.map(), wrong argument count. Use: map(value, istart, istop, ostart, ostop)");
return ostart + (ostop - ostart) * ((value - istart) / (istop - istart));
};
/**
* Determines the largest value in a sequence of numbers.
*
* @cat Math
* @subcat Calculation
* @method max
* @param {Number|Array} param1 Either the first value or an array of Numbers
* @param {Number} param2 Another value to be compared
* @param {Number} param3 Another value to be compared
* @return {Number} The highest value
*/
pub.max = function() {
if (arguments.length === 2) return arguments[0] < arguments[1] ? arguments[1] : arguments[0];
var numbers = arguments.length === 1 ? arguments[0] : arguments;
if (! ("length" in numbers && numbers.length > 0)) error("b.max(), non-empty array is expected");
var max = numbers[0],
count = numbers.length;
for (var i = 1; i < count; ++i) if (max < numbers[i]) max = numbers[i];
return max;
};
/**
* Determines the smallest value in a sequence of numbers.
*
* @cat Math
* @subcat Calculation
* @method min
* @param {Number|Array} param1 Either the first value or an array of Numbers
* @param {Number} param2 Another value to be compared
* @param {Number} param3 Another value to be compared
* @return {Number} The lowest value
*/
pub.min = function() {
if (arguments.length === 2) return arguments[0] < arguments[1] ? arguments[0] : arguments[1];
var numbers = arguments.length === 1 ? arguments[0] : arguments;
if (! ("length" in numbers && numbers.length > 0)) error("b.min(), non-empty array is expected");
var min = numbers[0],
count = numbers.length;
for (var i = 1; i < count; ++i) if (min > numbers[i]) min = numbers[i];
return min;
};
/**
* Normalizes a number from another range into a value between 0 and 1.
*
* Identical to map(value, low, high, 0, 1);
*
* Numbers outside the range are not clamped to 0 and 1, because out-of-range values are often intentional and useful.
*
* @cat Math
* @subcat Calculation
* @method norm
* @param {Number} aNumber The value to be normed
* @param {Number} low The lowest value to be expected
* @param {Number} low The highest value to be expected
* @return {Number} The normalized value
*/
pub.norm = function(aNumber, low, high) {
if(arguments.length !== 3 ) error("b.norm, wrong argument count.");
return (aNumber - low) / (high - low);
};
/**
* Facilitates exponential expressions. The pow() function is an efficient way of multiplying numbers by themselves (or their reciprocal) in large quantities. For example, pow(3, 5) is equivalent to the expression 3*3*3*3*3 and pow(3, -5) is equivalent to 1 / 3*3*3*3*3
*
* @cat Math
* @subcat Calculation
* @method pow
* @param {Number} num base of the exponential expression
* @param {Number} exponent power of which to raise the base
* @return {Number} the result
*/
pub.pow = Math.pow;
/**
* Calculates the integer closest to the value parameter. For example, round(9.2) returns the value 9.
*
* @cat Math
* @subcat Calculation
* @method round
* @param {Number} value The value to be rounded
* @return {Number} The rounded value
*/
pub.round = Math.round;
/**
* Squares a number (multiplies a number by itself). The result is always a positive number, as multiplying two negative numbers always yields a positive result. For example, -1 * -1 = 1.
*
* @cat Math
* @subcat Calculation
* @method sq
* @param {Number} aNumber The value to be squared
* @return {Number}
*/
pub.sq = function(aNumber) {
if(arguments.length !== 1 ) error("b.sq(), wrong argument count.");
return aNumber * aNumber;
};
// -- Trigonometry --
/**
* Calculates the square root of a number. The square root of a number is always positive, even though there may be a valid negative root. The square root s of number a is such that s*s = a. It is the opposite of squaring.
*
* @cat Math
* @subcat Trigonometry
* @method sqrt
* @param {Number} val The value to be calculated
* @return {Number}
*/
pub.sqrt = Math.sqrt;
/**
* The inverse of cos(), returns the arc cosine of a value. This function expects the values in the range of -1 to 1 and values are returned in the range 0 to PI (3.1415927).
*
* @cat Math
* @subcat Trigonometry
* @method acos
* @param {Number} value the value whose arc cosine is to be returned
* @return {Number}
*/
pub.acos = Math.acos;
/**
* The inverse of sin(), returns the arc sine of a value. This function expects the values in the range of -1 to 1 and values are returned in the range 0 to PI (3.1415927).
*
* @cat Math
* @subcat Trigonometry
* @method asin
* @param {Number} value the value whose arc sine is to be returned
* @return {Number}
*/
pub.asin = Math.asin;
/**
* The inverse of tan(), returns the arc tangent of a value. This function expects the values in the range of -1 to 1 and values are returned in the range 0 to PI (3.1415927).
*
* @cat Math
* @subcat Trigonometry
* @method atan
* @param {Number} value the value whose arc tangent is to be returned
* @return {Number}
*/
pub.atan = Math.atan;
/**
* Calculates the angle (in radians) from a specified point to the coordinate origin as measured from the positive x-axis. Values are returned as a float in the range from PI to -PI. The atan2() function is most often used for orienting geometry to the position of the cursor. Note: The y-coordinate of the point is the first parameter and the x-coordinate is the second due the the structure of calculating the tangent.
*
* @cat Math
* @subcat Trigonometry
* @method atan2
* @param {Number} y the y coordinate
* @param {Number} x the x coordinate
* @return {Number}
*/
pub.atan2 = Math.atan2;
/**
* Calculates the cosine of an angle. This function expects the values of the angle parameter to be provided in radians (values from 0 to PI*2). Values are returned in the range -1 to 1.
*
* @cat Math
* @subcat Trigonometry
* @method cos
* @param {Number} rad a value in radians
* @return {Number}
*/
pub.cos = Math.cos;
/**
* Converts a radian measurement to its corresponding value in degrees. Radians and degrees are two ways of measuring the same thing. There are 360 degrees in a circle and 2*PI radians in a circle. For example, 90° = PI/2 = 1.5707964. All trigonometric methods in Processing require their parameters to be specified in radians.
*
* @cat Math
* @subcat Trigonometry
* @method degrees
* @param {Number} aAngle an angle in radians
* @return {Number} The given angle in degree
*/
pub.degrees = function(aAngle) {
return aAngle * 180 / Math.PI;
};
/**
* Converts a degree measurement to its corresponding value in radians. Radians and degrees are two ways of measuring the same thing. There are 360 degrees in a circle and 2*PI radians in a circle. For example, 90° = PI/2 = 1.5707964. All trigonometric methods in Processing require their parameters to be specified in radians.
*
* @cat Math
* @subcat Trigonometry
* @method radians
* @param {Number} aAngle an angle in degree
* @return {Number} The given angle in radians
*/
pub.radians = function(aAngle) {
return aAngle / 180 * Math.PI;
};
/**
* Calculates the sine of an angle. This function expects the values of the angle parameter to be provided in radians (values from 0 to 6.28). Values are returned in the range -1 to 1.
*
* @cat Math
* @subcat Trigonometry
* @method sin
* @param {Number} rad a value in radians
* @return {Number}
*/
pub.sin = Math.sin;
/**
* Calculates the ratio of the sine and cosine of an angle. This function expects the values of the angle parameter to be provided in radians (values from 0 to PI*2). Values are returned in the range infinity to -infinity.
*
* @cat Math
* @subcat Trigonometry
* @method tan
* @param {Number} rad a value in radians
* @return {Number}
*/
pub.tan = Math.tan;
// -- Random --
var currentRandom = Math.random;
/**
* Generates random numbers. Each time the random() function is called, it returns an unexpected value within the specified range. If one parameter is passed to the function it will return a float between zero and the value of the high parameter. The function call random(5) returns values between 0 and 5. If two parameters are passed, it will return a float with a value between the the parameters. The function call random(-5, 10.2) returns values between -5 and 10.2.
*
* One parameter sets the range from 0 to the given parameter, while with two parameters present you set the range from val1 - val2.
*
* @cat Math
* @subcat Random
* @method random
* @param {Number} [low] The low border of the range
* @param {Number} [high] The high border of the range
* @return {Number} A random number
*/
pub.random = function() {
if (arguments.length === 0) return currentRandom();
if (arguments.length === 1) return currentRandom() * arguments[0];
var aMin = arguments[0],
aMax = arguments[1];
return currentRandom() * (aMax - aMin) + aMin;
};
function Marsaglia(i1, i2) {
var z = i1 || 362436069,
w = i2 || 521288629;
var nextInt = function() {
z = 36969 * (z & 65535) + (z >>> 16) & 4294967295;
w = 18E3 * (w & 65535) + (w >>> 16) & 4294967295;
return ((z & 65535) << 16 | w & 65535) & 4294967295;
};
this.nextDouble = function() {
var i = nextInt() / 4294967296;
return i < 0 ? 1 + i : i;
};
this.nextInt = nextInt;
}
Marsaglia.createRandomized = function() {
var now = new Date();
return new Marsaglia(now / 6E4 & 4294967295, now & 4294967295);
};
/* todo */
pub.randomSeed = function(seed) {
currentRandom = (new Marsaglia(seed)).nextDouble;
};
/* todo */
pub.Random = function(seed) {
var haveNextNextGaussian = false,
nextNextGaussian, random;
this.nextGaussian = function() {
if (haveNextNextGaussian) {
haveNextNextGaussian = false;
return nextNextGaussian;
}
var v1, v2, s;
do {
v1 = 2 * random() - 1;
v2 = 2 * random() - 1;
s = v1 * v1 + v2 * v2;
} while (s >= 1 || s === 0);
var multiplier = Math.sqrt(-2 * Math.log(s) / s);
nextNextGaussian = v2 * multiplier;
haveNextNextGaussian = true;
return v1 * multiplier;
};
random = seed === undef ? Math.random : (new Marsaglia(seed)).nextDouble;
};
/* todo */
function PerlinNoise(seed) {
var rnd = seed !== undef ? new Marsaglia(seed) : Marsaglia.createRandomized();
var i, j;
var perm = [] ;
for (i = 0; i < 256; ++i) perm[i] = i;
for (i = 0; i < 256; ++i) {
var t = perm[j = rnd.nextInt() & 255];
perm[j] = perm[i];
perm[i] = t;
}
for (i = 0; i < 256; ++i) perm[i + 256] = perm[i];
function grad3d(i, x, y, z) {
var h = i & 15;
var u = h < 8 ? x : y,
v = h < 4 ? y : h === 12 || h === 14 ? x : z;
return ((h & 1) === 0 ? u : -u) + ((h & 2) === 0 ? v : -v);
}
function grad2d(i, x, y) {
var v = (i & 1) === 0 ? x : y;
return (i & 2) === 0 ? -v : v;
}
function grad1d(i, x) {
return (i & 1) === 0 ? -x : x;
}
function lerp(t, a, b) {
return a + t * (b - a);
}
this.noise3d = function(x, y, z) {
var X = Math.floor(x) & 255,
Y = Math.floor(y) & 255,
Z = Math.floor(z) & 255;
x -= Math.floor(x);
y -= Math.floor(y);
z -= Math.floor(z);
var fx = (3 - 2 * x) * x * x,
fy = (3 - 2 * y) * y * y,
fz = (3 - 2 * z) * z * z;
var p0 = perm[X] + Y,
p00 = perm[p0] + Z,
p01 = perm[p0 + 1] + Z,
p1 = perm[X + 1] + Y,
p10 = perm[p1] + Z,
p11 = perm[p1 + 1] + Z;
return lerp(fz, lerp(fy, lerp(fx, grad3d(perm[p00], x, y, z), grad3d(perm[p10], x - 1, y, z)), lerp(fx, grad3d(perm[p01], x, y - 1, z), grad3d(perm[p11], x - 1, y - 1, z))), lerp(fy, lerp(fx, grad3d(perm[p00 + 1], x, y, z - 1), grad3d(perm[p10 + 1], x - 1, y, z - 1)), lerp(fx, grad3d(perm[p01 + 1], x, y - 1, z - 1), grad3d(perm[p11 + 1], x - 1, y - 1, z - 1))));
};
this.noise2d = function(x, y) {
var X = Math.floor(x) & 255,
Y = Math.floor(y) & 255;
x -= Math.floor(x);
y -= Math.floor(y);
var fx = (3 - 2 * x) * x * x,
fy = (3 - 2 * y) * y * y;
var p0 = perm[X] + Y,
p1 = perm[X + 1] + Y;
return lerp(fy, lerp(fx, grad2d(perm[p0], x, y), grad2d(perm[p1], x - 1, y)), lerp(fx, grad2d(perm[p0 + 1], x, y - 1), grad2d(perm[p1 + 1], x - 1, y - 1)));
};
this.noise1d = function(x) {
var X = Math.floor(x) & 255;
x -= Math.floor(x);
var fx = (3 - 2 * x) * x * x;
return lerp(fx, grad1d(perm[X], x), grad1d(perm[X + 1], x - 1));
};
}
var noiseProfile = {
generator: undef,
octaves: 4,
fallout: 0.5,
seed: undef
};
/**
* Returns the Perlin noise value at specified coordinates. Perlin noise is a random sequence generator producing a more natural ordered, harmonic succession of numbers compared to the standard random() function. It was invented by Ken Perlin in the 1980s and been used since in graphical applications to produce procedural textures, natural motion, shapes, terrains etc.
*
* The main difference to the random() function is that Perlin noise is defined in an infinite n-dimensional space where each pair of coordinates corresponds to a fixed semi-random value (fixed only for the lifespan of the program). The resulting value will always be between 0.0 and 1.0. basil.js can compute 1D, 2D and 3D noise, depending on the number of coordinates given. The noise value can be animated by moving through the noise space. The 2nd and 3rd dimension can also be interpreted as time.
*
* The actual noise is structured similar to an audio signal, in respect to the function's use of frequencies. Similar to the concept of harmonics in physics, perlin noise is computed over several octaves which are added together for the final result.
*
* Another way to adjust the character of the resulting sequence is the scale of the input coordinates. As the function works within an infinite space the value of the coordinates doesn't matter as such, only the distance between successive coordinates does (eg. when using noise() within a loop). As a general rule the smaller the difference between coordinates, the smoother the resulting noise sequence will be. Steps of 0.005-0.03 work best for most applications, but this will differ depending on use.
*
* @cat Math
* @subcat Random
* @method noise
* @param {Number} x Coordinate in x space
* @param {Number} [y] Coordinate in y space
* @param {Number} [z] Coordinate in z space
* @return {Number} the noise value
*/
pub.noise = function(x, y, z) {
if (noiseProfile.generator === undef) noiseProfile.generator = new PerlinNoise(noiseProfile.seed);
var generator = noiseProfile.generator;
var effect = 1,
k = 1,
sum = 0;
for (var i = 0; i < noiseProfile.octaves; ++i) {
effect *= noiseProfile.fallout;
switch (arguments.length) {
case 1:
sum += effect * (1 + generator.noise1d(k * x)) / 2;
break;
case 2:
sum += effect * (1 + generator.noise2d(k * x, k * y)) / 2;
break;
case 3:
sum += effect * (1 + generator.noise3d(k * x, k * y, k * z)) / 2;
break;
}
k *= 2;
}
return sum;
};
/**
* Adjusts the character and level of detail produced by the Perlin noise function. Similar to harmonics in physics, noise is computed over several octaves. Lower octaves contribute more to the output signal and as such define the overal intensity of the noise, whereas higher octaves create finer grained details in the noise sequence. By default, noise is computed over 4 octaves with each octave contributing exactly half than its predecessor, starting at 50% strength for the 1st octave. This falloff amount can be changed by adding an additional function parameter. Eg. a falloff factor of 0.75 means each octave will now have 75% impact (25% less) of the previous lower octave. Any value between 0.0 and 1.0 is valid, however note that values greater than 0.5 might result in greater than 1.0 values returned by noise().
*
* By changing these parameters, the signal created by the noise() function can be adapted to fit very specific needs and characteristics.
*
* @cat Math
* @subcat Random
* @method noiseDetail
* @param {Number} octaves number of octaves to be used by the noise() function
* @param {Number} fallout falloff factor for each octave
*/
pub.noiseDetail = function(octaves, fallout) {
noiseProfile.octaves = octaves;
if (fallout !== undef) noiseProfile.fallout = fallout;
};
/**
* Sets the seed value for noise(). By default, noise() produces different results each time the program is run. Set the value parameter to a constant to return the same pseudo-random numbers each time the software is run.
*
* @cat Math
* @subcat Random
* @method noiseSeed
* @param {Number} seed
*/
pub.noiseSeed = function(seed) {
noiseProfile.seed = seed;
noiseProfile.generator = undef;
};
// ----------------------------------------
// Transform
// geometricBounds hint: [y1, x1, y2, x2]
var precision = function(num, dec) {
return Math.round(num * Math.pow(10, dec)) / Math.pow(10, dec);
};
/**
* The function calculates the geometric bounds of any given object. Use b.itemX(), b.itemY(), b.itemPosition(), b.itemWidth(), b.itemHeight() and b.itemSize() to modify PageItems.
* In case the object is any kind of text, then additional typographic information baseline and xHeight are calculated
*
* @cat Document
* @subcat Transformation
* @method bounds
* @param {Text|Object} obj The object to calculate the geometric bounds
* @return {Object} Geometric bounds object with these properties: width, height, left, right, top, bottom and for text: baseline, xHeight
*/
pub.bounds = function (obj) {
var x1,y1,x2,y2,w,h;
if (isText(obj)) {
var baseline = obj.baseline;
var ascent = obj.ascent;
var descent = obj.descent;
x1 = obj.horizontalOffset;
y1 = baseline - ascent;
x2 = obj.endHorizontalOffset;
y2 = baseline + descent;
w = x2-x1;
h = y2-y1;
if (w < 0 || h <0) {
warning("b.bounds(), not possible to get correct bounds, possible line break within textObj");
}
// TODO: not sure if this 100% correct, check
// http://en.wikipedia.org/wiki/File:Typography_Line_Terms.svg
var xHeight = y1+descent;
return {'width':w,
'height':h,
'left':x1,
'right':x2,
'top':y1,
'bottom':y2,
'baseline':baseline,
'xHeight':xHeight };
} else {
// is it a pageItem?
if (obj.hasOwnProperty("geometricBounds")) {
var geometricBounds = obj.geometricBounds; //[y1, x1, y2, x2]
x1 = geometricBounds[1];
y1 = geometricBounds[0];
x2 = geometricBounds[3];
y2 = geometricBounds[2];
w = x2-x1;
h = y2-y1;
return {'width':w, 'height':h, 'left':x1, 'right':x2, 'top':y1, 'bottom':y2};
}
// everything else e.g. page, spread
else if (obj.hasOwnProperty("bounds")) {
var bounds = obj.bounds; //[y1, x1, y2, x2]
x1 = bounds[1];
y1 = bounds[0];
x2 = bounds[3];
y2 = bounds[2];
w = x2-x1;
h = y2-y1;
return {'width':w, 'height':h, 'left':x1, 'right':x2, 'top':y1, 'bottom':y2};
}
// no idea what that might be, give up
else {
error("b.bounds(), invalide type of parameter! Can't get bounds for this object.");
}
}
};
/**
* Positions a PageItem at the designated spot on the x axis. If no x argument is given the current x position is returned.
*
* @cat Document
* @subcat Transformation
* @method itemX
* @param {PageItem} pItem The PageItem to alter
* @param {Number} [x] The new x position
* @returns {Number} The current x position
*/
pub.itemX = function(pItem, x) {
var off = 0;
if(currRectMode !== b.CORNER) pub.warning("b.itemX(), please note that only b.CORNER positioning is fully supported. Use with care.");
if( typeof pItem !== 'undef' && pItem.hasOwnProperty("geometricBounds")) {
if( typeof x === 'number' ){
var width = pItem.geometricBounds[3] - pItem.geometricBounds[1];
var height = pItem.geometricBounds[2] - pItem.geometricBounds[0];
// if(currRectMode === b.CENTER) off = ( pItem.geometricBounds[2] - pItem.geometricBounds[0] ) / 2;
pItem.geometricBounds = [ pItem.geometricBounds[0] - off, x - off, pItem.geometricBounds[0] + height - off, x - off + width ];
} else {
// if(currRectMode === b.CENTER) off = ( pItem.geometricBounds[3] - pItem.geometricBounds[1] ) / 2;
return precision(pItem.geometricBounds[1], 5) + off; // CS6 sets geometricBounds to initially slightly off values... terrible workaround
}
} else {
error("b.itemX(), pItem has to be a valid PageItem");
}
};
/**
* Positions a PageItem at the designated spot on the y axis. If no y argument is given the current y position is returned.
*
* @cat Document
* @subcat Transformation
* @method itemY
* @param {PageItem} pItem The PageItem to alter
* @param {Number} [y] The new y position
* @returns {Number} The current y position
*/
pub.itemY = function(pItem, y) {
var off = 0;
if(currRectMode !== b.CORNER) pub.warning("b.itemY(), please note that only b.CORNER positioning is fully supported. Use with care.");
if( typeof pItem !== 'undef' && pItem.hasOwnProperty("geometricBounds")) {
if( typeof y === 'number' ) {
var width = pItem.geometricBounds[3] - pItem.geometricBounds[1];
var height = pItem.geometricBounds[2] - pItem.geometricBounds[0];
// if(currRectMode === b.CENTER) off = ( pItem.geometricBounds[3] - pItem.geometricBounds[1] ) / 2;
b.itemPosition(pItem, pItem.geometricBounds[1] - off, y);
pItem.geometricBounds = [ y, pItem.geometricBounds[1] - off, y + height, pItem.geometricBounds[1] + width - off ];
} else {
// if(currRectMode === b.CENTER) off = ( pItem.geometricBounds[2] - pItem.geometricBounds[0] ) / 2;
return precision(pItem.geometricBounds[0], 5) + off;
}
} else {
error("b.itemY(), pItem has to be a valid PageItem");
}
};
/**
* Scales the given PageItem to the given width. If width is not given as argument the current width is returned.
*
* @cat Document
* @subcat Transformation
* @method itemWidth
* @param {PageItem} pItem The PageItem to alter
* @param {Number} [width] The new width
* @returns {Number} The current width
*/
pub.itemWidth = function(pItem, width) {
if(currRectMode !== b.CORNER) pub.warning("b.itemWidth(), please note that only b.CORNER positioning is fully supported. Use with care.");
if( typeof pItem !== 'undef' && pItem.hasOwnProperty("geometricBounds")) {
if( typeof width === 'number' ){
b.itemSize( pItem, width, Math.abs(pItem.geometricBounds[2] - pItem.geometricBounds[0]) );
} else {
return Math.abs(pItem.geometricBounds[3] - pItem.geometricBounds[1]);
}
} else {
error("b.itemWidth(), pItem has to be a valid PageItem");
}
};
/**
* Scales the given PageItem to the given height. If height is not given as argument the current height is returned.
*
* @cat Document
* @subcat Transformation
* @method itemHeight
* @param {PageItem} pItem The PageItem to alter
* @param {Number} [height] The new height
* @returns {Number} The current height
*/
pub.itemHeight = function(pItem, height) {
if(currRectMode !== b.CORNER) pub.warning("b.itemHeight(), please note that only b.CORNER positioning is fully supported. Use with care.");
if( typeof pItem !== 'undef' && pItem.hasOwnProperty("geometricBounds")) {
if( typeof height === 'number' ){
b.itemSize( pItem, Math.abs(pItem.geometricBounds[3] - pItem.geometricBounds[1]), height );
} else {
return Math.abs(pItem.geometricBounds[2] - pItem.geometricBounds[0]);
}
} else {
error("b.itemHeight(), pItem has to be a valid PageItem");
}
};
/**
* Moves the given PageItem to the given position. If x or y is not given as argument the current position is returned.
*
* @cat Document
* @subcat Transformation
* @method itemPosition
* @param {PageItem} pItem The PageItem to alter
* @param {Number} [x] The new x coordinate
* @param {Number} [y] The new y coordinate
* @returns {Object} Returns an object with the fields x and y
*/
pub.itemPosition = function(pItem, x, y) {
if(currRectMode !== b.CORNER) pub.warning("b.itemPosition(), please note that only b.CORNER positioning is fully supported. Use with care.");
if ( typeof pItem !== 'undef' && pItem.hasOwnProperty("geometricBounds")) {
if( typeof x === 'number' && typeof y === 'number') {
var width = pItem.geometricBounds[3] - pItem.geometricBounds[1];
var height = pItem.geometricBounds[2] - pItem.geometricBounds[0];
var offX = 0;
var offY = 0;
// if(currRectMode === b.CENTER) {
// offX = width / 2;
// offY = height / 2;
// }
pItem.geometricBounds = [ y + offY, x + offX, y + height + offY, x + width + offX];
} else {
return { x: precision(pItem.geometricBounds[1], 5), y: precision(pItem.geometricBounds[0], 5) };
}
} else {
error("b.itemPosition(), works only with child classes of PageItem.");
}
};
/**
* Scales the given PageItem to the given size. If width or height is not given as argument the current size is returned.
*
* @cat Document
* @subcat Transformation
* @method itemSize
* @param {PageItem} pItem The PageItem to alter
* @param {Number} [width] The new width
* @param {Number} [height] The new height
* @returns {Object} Returns an object with the fields width and height
*/
pub.itemSize = function(pItem, width, height) {
if(currRectMode !== b.CORNER) pub.warning("b.itemSize(), please note that only b.CORNER positioning is fully supported. Use with care.");
if (pItem !== null && pItem.hasOwnProperty("geometricBounds")) {
var x = pItem.geometricBounds[1];
var y = pItem.geometricBounds[0];
if( typeof width === 'number' && typeof height === 'number' ) {
// if(currRectMode === b.CENTER) {
// // current center, calc old width and height
// x = x + (pItem.geometricBounds[3] - pItem.geometricBounds[1]) / 2;
// y = y + (pItem.geometricBounds[2] - pItem.geometricBounds[0]) / 2;
// pItem.geometricBounds = [ y - height / 2, x - width / 2, y + height / 2, x + width / 2];
// } else {
pItem.geometricBounds = [ y, x, y + height, x + width];
// }
} else {
return { width: pItem.geometricBounds[3] - pItem.geometricBounds[1] , height: pItem.geometricBounds[2] - pItem.geometricBounds[0] };
}
} else {
error("b.itemSize(), works only with child classes of PageItem.");
}
};
var printMatrixHelper = function(elements) {
var big = 0;
for (var i = 0; i < elements.length; i++) if (i !== 0) big = Math.max(big, Math.abs(elements[i]));
else big = Math.abs(elements[i]);
var digits = (big + "").indexOf(".");
if (digits === 0) digits = 1;
else if (digits === -1) digits = (big + "").length;
return digits;
};
/* TODO jsdoc */
var Matrix2D = pub.Matrix2D = function() {
if (arguments.length === 0) this.reset();
else if (arguments.length === 1 && arguments[0] instanceof Matrix2D) this.set(arguments[0].array());
else if (arguments.length === 6) this.set(arguments[0], arguments[1], arguments[2], arguments[3], arguments[4], arguments[5]);
};
/* TODO jsdoc */
Matrix2D.prototype = {
set: function() {
if (arguments.length === 6) {
var a = arguments;
this.set([a[0], a[1], a[2], a[3], a[4], a[5]]);
} else if (arguments.length === 1 && arguments[0] instanceof Matrix2D) this.elements = arguments[0].array();
else if (arguments.length === 1 && arguments[0] instanceof Array) this.elements = arguments[0].slice();
},
get: function() {
var outgoing = new Matrix2D();
outgoing.set(this.elements);
return outgoing;
},
reset: function() {
this.set([1, 0, 0, 0, 1, 0]);
},
array: function array() {
return this.elements.slice();
},
adobeMatrix: function array() {
var uVX = new UnitValue(this.elements[2], currUnits);
var uVY = new UnitValue(this.elements[5], currUnits);
return [this.elements[0],
this.elements[3],
this.elements[1],
this.elements[4],
uVX.as("pt"),
uVY.as("pt")];
},
translate: function(tx, ty) {
this.elements[2] = tx * this.elements[0] + ty * this.elements[1] + this.elements[2];
this.elements[5] = tx * this.elements[3] + ty * this.elements[4] + this.elements[5];
},
invTranslate: function(tx, ty) {
this.translate(-tx, -ty);
},
transpose: function() {},
mult: function(source, target) {
var x, y;
if (source instanceof Vector) {
x = source.x;
y = source.y;
if (!target) target = new Vector();
} else if (source instanceof Array) {
x = source[0];
y = source[1];
if (!target) target = [];
}
if (target instanceof Array) {
target[0] = this.elements[0] * x + this.elements[1] * y + this.elements[2];
target[1] = this.elements[3] * x + this.elements[4] * y + this.elements[5];
} else if (target instanceof Vector) {
target.x = this.elements[0] * x + this.elements[1] * y + this.elements[2];
target.y = this.elements[3] * x + this.elements[4] * y + this.elements[5];
target.z = 0;
}
return target;
},
multX: function(x, y) {
return x * this.elements[0] + y * this.elements[1] + this.elements[2];
},
multY: function(x, y) {
return x * this.elements[3] + y * this.elements[4] + this.elements[5];
},
/*
// BUG, seems to be buggy in processing.js, and i am not clever enough to figure it out
shearX: function(angle) {
this.apply(1, 0, 1, Math.tan(angle), 0, 0)
},
shearY: function(angle) {
this.apply(1, 0, 1, 0, Math.tan(angle), 0)
},*/
determinant: function() {
return this.elements[0] * this.elements[4] - this.elements[1] * this.elements[3];
},
invert: function() {
var d = this.determinant();
if (Math.abs(d) > -2147483648) {
var old00 = this.elements[0];
var old01 = this.elements[1];
var old02 = this.elements[2];
var old10 = this.elements[3];
var old11 = this.elements[4];
var old12 = this.elements[5];
this.elements[0] = old11 / d;
this.elements[3] = -old10 / d;
this.elements[1] = -old01 / d;
this.elements[4] = old00 / d;
this.elements[2] = (old01 * old12 - old11 * old02) / d;
this.elements[5] = (old10 * old02 - old00 * old12) / d;
return true;
}
return false;
},
scale: function(sx, sy) {
if (sx && !sy) sy = sx;
if (sx && sy) {
this.elements[0] *= sx;
this.elements[1] *= sy;
this.elements[3] *= sx;
this.elements[4] *= sy;
}
},
invScale: function(sx, sy) {
if (sx && !sy) sy = sx;
this.scale(1 / sx, 1 / sy);
},
apply: function() {
var source;
if (arguments.length === 1 && arguments[0] instanceof Matrix2D) source = arguments[0].array();
else if (arguments.length === 6) source = Array.prototype.slice.call(arguments);
else if (arguments.length === 1 && arguments[0] instanceof Array) source = arguments[0];
var result = [0, 0, this.elements[2], 0, 0, this.elements[5]];
var e = 0;
for (var row = 0; row < 2; row++) for (var col = 0; col < 3; col++, e++) result[e] += this.elements[row * 3 + 0] * source[col + 0] + this.elements[row * 3 + 1] * source[col + 3];
this.elements = result.slice();
},
preApply: function() {
var source;
if (arguments.length === 1 && arguments[0] instanceof Matrix2D) source = arguments[0].array();
else if (arguments.length === 6) source = Array.prototype.slice.call(arguments);
else if (arguments.length === 1 && arguments[0] instanceof Array) source = arguments[0];
var result = [0, 0, source[2], 0, 0, source[5]];
result[2] = source[2] + this.elements[2] * source[0] + this.elements[5] * source[1];
result[5] = source[5] + this.elements[2] * source[3] + this.elements[5] * source[4];
result[0] = this.elements[0] * source[0] + this.elements[3] * source[1];
result[3] = this.elements[0] * source[3] + this.elements[3] * source[4];
result[1] = this.elements[1] * source[0] + this.elements[4] * source[1];
result[4] = this.elements[1] * source[3] + this.elements[4] * source[4];
this.elements = result.slice();
},
rotate: function(angle) {
var c = Math.cos(angle);
var s = Math.sin(angle);
var temp1 = this.elements[0];
var temp2 = this.elements[1];
this.elements[0] = c * temp1 + s * temp2;
this.elements[1] = -s * temp1 + c * temp2;
temp1 = this.elements[3];
temp2 = this.elements[4];
this.elements[3] = c * temp1 + s * temp2;
this.elements[4] = -s * temp1 + c * temp2;
},
rotateZ: function(angle) {
this.rotate(angle);
},
invRotateZ: function(angle) {
this.rotateZ(angle - Math.PI);
},
print: function() {
var digits = printMatrixHelper(this.elements);
var output = "" + pub.nfs(this.elements[0], digits, 4) + " " + pub.nfs(this.elements[1], digits, 4) + " " + pub.nfs(this.elements[2], digits, 4) + "\n" + pub.nfs(this.elements[3], digits, 4) + " " + pub.nfs(this.elements[4], digits, 4) + " " + pub.nfs(this.elements[5], digits, 4) + "\n\n";
pub.println(output);
}
};
/**
* Returns the current matrix as a Matrix2D object for altering existing PageItems with b.transform(). If a Matrix2D object is provided to the function it will overwrite the current matrix.
*
* @cat Document
* @subcat Transformation
* @method matrix
* @param {Matrix2D} [matrix] The matrix to be set as new current matrix
* @returns {Matrix2D} Returns the current matrix
*/
pub.matrix = function(matrix) {
if(matrix instanceof Matrix2D) {
currMatrix = matrix;
}
return currMatrix;
}
/**
* Transforms the given PageItem with the given Matrix2D object.
*
* @cat Document
* @subcat Transformation
* @method transform
* @param {PageItem} obj The item to be transformed
* @param {Matrix2D} matrix The matrix to be applied
*/
pub.transform = function(obj, matrix) {
obj.transform(CoordinateSpaces.PASTEBOARD_COORDINATES,
AnchorPoint.TOP_LEFT_ANCHOR,
matrix.adobeMatrix()
);
}
/**
* Multiplies the current matrix by the one specified through the parameters.
*
* @cat Document
* @subcat Transformation
* @method applyMatrix
* @param {Matrix2D} matrix The matrix to be applied
*/
pub.applyMatrix = function (matrix) {
currMatrix.apply(matrix);
};
/**
* Pops the current transformation matrix off the matrix stack. Understanding pushing and popping requires understanding the concept of a matrix stack. The pushMatrix() function saves the current coordinate system to the stack and popMatrix() restores the prior coordinate system. pushMatrix() and popMatrix() are used in conjuction with the other transformation methods and may be embedded to control the scope of the transformations.
*
* @cat Document
* @subcat Transformation
* @method popMatrix
*/
pub.popMatrix = function () {
if (matrixStack.length > 0) {
currMatrix.set( matrixStack.pop() );
} else {
error("b.popMatrix(), missing a pushMatrix() to go with that popMatrix()");
}
};
/**
* Prints the current matrix to the console window.
*
* @cat Document
* @subcat Transformation
* @method printMatrix
*/
pub.printMatrix = function () {
currMatrix.print();
};
/**
* Pushes the current transformation matrix onto the matrix stack. Understanding pushMatrix() and popMatrix() requires understanding the concept of a matrix stack. The pushMatrix() function saves the current coordinate system to the stack and popMatrix() restores the prior coordinate system. pushMatrix() and popMatrix() are used in conjuction with the other transformation methods and may be embedded to control the scope of the transformations.
*
* @cat Document
* @subcat Transformation
* @method pushMatrix
*/
pub.pushMatrix = function () {
matrixStack.push( currMatrix.array() );
};
/**
* Replaces the current matrix with the identity matrix.
*
* @cat Document
* @subcat Transformation
* @method resetMatrix
*/
pub.resetMatrix = function () {
matrixStack = [];
currMatrix = new Matrix2D();
};
/**
* Rotates an object the amount specified by the angle parameter. Angles should be specified in radians (values from 0 to PI*2) or converted to radians with the radians() function. Objects are always rotated around their relative position to the origin and positive numbers rotate objects in a clockwise direction with 0 radians or degrees being up and HALF_PI being to the right etc. Transformations apply to everything that happens after and subsequent calls to the function accumulates the effect. For example, calling rotate(PI/2) and then rotate(PI/2) is the same as rotate(PI). If rotate() is called within the draw(), the transformation is reset when the loop begins again. Technically, rotate() multiplies the current transformation matrix by a rotation matrix. This function can be further controlled by the pushMatrix() and popMatrix().
*
* @cat Document
* @subcat Transformation
* @method rotate
* @param {Number} angle The angle specified in radians
*/
pub.rotate = function (angle) {
if(typeof arguments[0] === 'undefined') error("Please provide an angle for rotation.");
currMatrix.rotate(angle);
};
/**
* Increasing and decreasing the size of an object by expanding and contracting vertices. Scale values are specified as decimal percentages. The function call scale(2.0) increases the dimension of a shape by 200%. Objects always scale from their relative origin to the coordinate system. Transformations apply to everything that happens after and subsequent calls to the function multiply the effect. For example, calling scale(2.0) and then scale(1.5) is the same as scale(3.0). If scale() is called within draw(), the transformation is reset when the loop begins again. This function can be further controlled by pushMatrix() and popMatrix().
* If only one parameter is given, it is applied on X and Y axis.
*
* @cat Document
* @subcat Transformation
* @method scale
* @param {Number} scaleX The amount to scale the X axis.
* @param {Number} scaleY The amount to scale the Y axis.
*/
pub.scale = function (scaleX,scaleY) {
if(typeof arguments[0] != 'number' || (arguments.length === 2 && typeof arguments[1] != 'number') ) error("Please provide valid x and/or y factors for scaling.");
currMatrix.scale(scaleX,scaleY);
};
/**
* Specifies an amount to displace objects within the page. The x parameter specifies left/right translation, the y parameter specifies up/down translation. Transformations apply to everything that happens after and subsequent calls to the function accumulates the effect. For example, calling translate(50, 0) and then translate(20, 0) is the same as translate(70, 0). This function can be further controlled by the pushMatrix() and popMatrix().
*
* @cat Document
* @subcat Transformation
* @method translate
* @param {Number} tx The amount of offset on the X axis.
* @param {Number} ty The amount of offset on the Y axis.
*/
pub.translate = function (tx,ty) {
if(typeof arguments[0] === 'undefined' || typeof arguments[1] === 'undefined') error("Please provide x and y coordinates for translation.");
currMatrix.translate(tx,ty);
};
// Hey Ken, this is your new home...
init();
})(this, app);