The web is much more than just canvas and p5.dom makes it easy to interact * with other HTML5 objects, including text, hyperlink, image, input, video, * audio, and webcam.
*There is a set of creation methods, DOM manipulation methods, and - * an extended p5.Element that supports a range of HTML elements. See the - * + * an extended p5.Element that supports a range of HTML elements. See the + * * beyond the canvas tutorial for a full overview of how this addon works. * *
Methods and properties shown in black are part of the p5.js core, items in * blue are part of the p5.dom library. You will need to include an extra file * in order to access the blue functions. See the - * using a library + * using a library * section for information on how to include this library. p5.dom comes with - * p5 complete or you can download the single file - * + * p5 complete or you can download the single file + * * here.
- *See tutorial: beyond the canvas + *
See tutorial: beyond the canvas * for more info on how to use this libary. * * @module p5.dom * @submodule p5.dom - * @for p5.dom + * @for p5 * @main */ -(function (root, factory) { +(function(root, factory) { if (typeof define === 'function' && define.amd) - define('p5.dom', ['p5'], function (p5) { (factory(p5));}); - else if (typeof exports === 'object') - factory(require('../p5')); - else - factory(root['p5']); -}(this, function (p5) { - -// ============================================================================= -// p5 additions -// ============================================================================= + define('p5.dom', ['p5'], function(p5) { + factory(p5); + }); + else if (typeof exports === 'object') factory(require('../p5')); + else factory(root['p5']); +})(this, function(p5) { + // ============================================================================= + // p5 additions + // ============================================================================= /** * Searches the page for an element with the given ID, class, or tag name (using the '#' or '.' * prefixes to specify an ID or class respectively, and none for a tag) and returns it as - * a p5.Element. If a class or tag name is given with more than 1 element, + * a p5.Element. If a class or tag name is given with more than 1 element, * only the first element will be returned. * The DOM node itself can be accessed with .elt. * Returns null if none found. You can also specify a container to search within. * * @method select * @param {String} name id, class, or tag name of element to search for - * @param {String} [container] id, p5.Element, or HTML element to search within - * @return {Object|p5.Element|Null} p5.Element containing node found + * @param {String|p5.Element|HTMLElement} [container] id, p5.Element, or + * HTML element to search within + * @return {p5.Element|null} p5.Element containing node found * @example *
* function setup() {
- * createCanvas(100,100);
+ * createCanvas(100, 100);
* //translates canvas 50px down
* select('canvas').position(100, 100);
* }
*
+ *
* // these are all valid calls to select()
* var a = select('#moo');
* var b = select('#blah', '#myContainer');
- * var c = select('#foo', b);
+ * var c, e;
+ * if (b) {
+ * c = select('#foo', b);
+ * }
* var d = document.getElementById('beep');
- * var e = select('p', d);
+ * if (d) {
+ * e = select('p', d);
+ * }
+ * [a, b, c, d, e]; // unused
*
*
*/
- p5.prototype.select = function (e, p) {
+ p5.prototype.select = function(e, p) {
+ p5._validateParameters('select', arguments);
var res = null;
var container = getContainer(p);
- if (e[0] === '.'){
+ if (e[0] === '.') {
e = e.slice(1);
res = container.getElementsByClassName(e);
if (res.length) {
@@ -79,10 +86,10 @@
} else {
res = null;
}
- }else if (e[0] === '#'){
+ } else if (e[0] === '#') {
e = e.slice(1);
res = container.getElementById(e);
- }else {
+ } else {
res = container.getElementsByTagName(e);
if (res.length) {
res = res[0];
@@ -91,7 +98,7 @@
}
}
if (res) {
- return wrapElement(res);
+ return this._wrapElement(res);
} else {
return null;
}
@@ -99,7 +106,7 @@
/**
* Searches the page for elements with the given class or tag name (using the '.' prefix
- * to specify a class and no prefix for a tag) and returns them as p5.Elements
+ * to specify a class and no prefix for a tag) and returns them as p5.Elements
* in an array.
* The DOM node itself can be accessed with .elt.
* Returns an empty array if none found.
@@ -107,8 +114,8 @@
*
* @method selectAll
* @param {String} name class or tag name of elements to search for
- * @param {String} [container] id, p5.Element, or HTML element to search within
- * @return {Array} Array of p5.Elements containing nodes found
+ * @param {String} [container] id, p5.Element, or HTML element to search within
+ * @return {p5.Element[]} Array of p5.Elements containing nodes found
* @example
*
* function setup() {
@@ -117,28 +124,33 @@
* createButton('3rd btn');
* var buttons = selectAll('button');
*
- * for (var i = 0; i < buttons.length; i++){
- * buttons[i].size(100,100);
+ * for (var i = 0; i < buttons.length; i++) {
+ * buttons[i].size(100, 100);
* }
* }
*
*
* // these are all valid calls to selectAll()
* var a = selectAll('.moo');
- * var b = selectAll('div');
- * var c = selectAll('button', '#myContainer');
+ * a = selectAll('div');
+ * a = selectAll('button', '#myContainer');
+ *
* var d = select('#container');
- * var e = selectAll('p', d);
+ * a = selectAll('p', d);
+ *
* var f = document.getElementById('beep');
- * var g = select('.blah', f);
+ * a = select('.blah', f);
+ *
+ * a; // unused
*
*
*/
- p5.prototype.selectAll = function (e, p) {
+ p5.prototype.selectAll = function(e, p) {
+ p5._validateParameters('selectAll', arguments);
var arr = [];
var res;
var container = getContainer(p);
- if (e[0] === '.'){
+ if (e[0] === '.') {
e = e.slice(1);
res = container.getElementsByClassName(e);
} else {
@@ -146,7 +158,7 @@
}
if (res) {
for (var j = 0; j < res.length; j++) {
- var obj = wrapElement(res[j]);
+ var obj = this._wrapElement(res[j]);
arr.push(obj);
}
}
@@ -158,12 +170,12 @@
*/
function getContainer(p) {
var container = document;
- if (typeof p === 'string' && p[0] === '#'){
+ if (typeof p === 'string' && p[0] === '#') {
p = p.slice(1);
container = document.getElementById(p) || document;
- } else if (p instanceof p5.Element){
+ } else if (p instanceof p5.Element) {
container = p.elt;
- } else if (p instanceof HTMLElement){
+ } else if (p instanceof HTMLElement) {
container = p;
}
return container;
@@ -172,33 +184,40 @@
/**
* Helper function for getElement and getElements.
*/
- function wrapElement(elt) {
- if(elt.tagName === "INPUT" && elt.type === "checkbox") {
- var converted = new p5.Element(elt);
- converted.checked = function(){
- if (arguments.length === 0){
- return this.elt.checked;
- } else if(arguments[0]) {
- this.elt.checked = true;
- } else {
- this.elt.checked = false;
- }
- return this;
+ p5.prototype._wrapElement = function(elt) {
+ var children = Array.prototype.slice.call(elt.children);
+ if (elt.tagName === 'INPUT' && elt.type === 'checkbox') {
+ var converted = new p5.Element(elt, this);
+ converted.checked = function() {
+ if (arguments.length === 0) {
+ return this.elt.checked;
+ } else if (arguments[0]) {
+ this.elt.checked = true;
+ } else {
+ this.elt.checked = false;
+ }
+ return this;
};
return converted;
- } else if (elt.tagName === "VIDEO" || elt.tagName === "AUDIO") {
- return new p5.MediaElement(elt);
- } else if ( elt.tagName === "SELECT" ){
- return createSelect( new p5.Element(elt) );
- }
- else {
- return new p5.Element(elt);
+ } else if (elt.tagName === 'VIDEO' || elt.tagName === 'AUDIO') {
+ return new p5.MediaElement(elt, this);
+ } else if (elt.tagName === 'SELECT') {
+ return this.createSelect(new p5.Element(elt, this));
+ } else if (
+ children.length > 0 &&
+ children.every(function(c) {
+ return c.tagName === 'INPUT' || c.tagName === 'LABEL';
+ })
+ ) {
+ return this.createRadio(new p5.Element(elt, this));
+ } else {
+ return new p5.Element(elt, this);
}
- }
+ };
/**
* Removes all elements created by p5, except any canvas / graphics
- * elements created by createCanvas or createGraphics.
+ * elements created by createCanvas or createGraphics.
* Event handlers are removed, and element is removed from the DOM.
* @method removeElements
* @example
@@ -214,8 +233,9 @@
*
- * var myDiv;
- * function setup() {
- * myDiv = createDiv('this is some text');
- * }
+ * createDiv('this is some text');
*
- * var myP;
- * function setup() {
- * myP = createP('this is some text');
- * }
+ * createP('this is some text');
*
- * var mySpan;
- * function setup() {
- * mySpan = createSpan('this is some text');
- * }
+ * createSpan('this is some text');
*
- * var img;
- * function setup() {
- * img = createImg('http://p5js.org/img/asterisk-01.png');
- * }
+ * createImg('http://p5js.org/img/asterisk-01.png');
*
- * var myLink;
- * function setup() {
- * myLink = createA('http://p5js.org/', 'this is a link');
- * }
+ * createA('http://p5js.org/', 'this is a link');
*
* var slider;
@@ -412,16 +426,17 @@
*
* var button;
@@ -454,6 +469,7 @@
*
* var checkbox;
@@ -479,39 +495,42 @@
*
* function myCheckedEvent() {
* if (this.checked()) {
- * console.log("Checking!");
+ * console.log('Checking!');
* } else {
- * console.log("Unchecking!");
+ * console.log('Unchecking!');
* }
* }
*
* var radio;
*
* function setup() {
* radio = createRadio();
- * radio.option("black");
- * radio.option("white");
- * radio.option("gray");
+ * radio.option('black');
+ * radio.option('white');
+ * radio.option('gray');
* radio.style('width', '60px');
* textAlign(CENTER);
* fill(255, 0, 0);
@@ -655,7 +673,7 @@
* function draw() {
* var val = radio.value();
* background(val);
- * text(val, width/2, height/2);
+ * text(val, width / 2, height / 2);
* }
*
@@ -674,112 +692,198 @@
* background(200);
* var val = radio.value();
* if (val) {
- * text('item cost is $'+val, width/2, height/2);
+ * text('item cost is $' + val, width / 2, height / 2);
* }
* }
*
+ *
+ */
+ p5.prototype.createColorPicker = function(value) {
+ p5._validateParameters('createColorPicker', arguments);
+ var elt = document.createElement('input');
+ var self;
+ elt.type = 'color';
+ if (value) {
+ if (value instanceof p5.Color) {
+ elt.value = value.toString('#rrggbb');
+ } else {
+ p5.prototype._colorMode = 'rgb';
+ p5.prototype._colorMaxes = {
+ rgb: [255, 255, 255, 255],
+ hsb: [360, 100, 100, 1],
+ hsl: [360, 100, 100, 1]
+ };
+ elt.value = p5.prototype.color(value).toString('#rrggbb');
}
+ } else {
+ elt.value = '#000000';
+ }
+ self = addElement(elt, this);
+ // Method to return a p5.Color object for the given color.
+ self.color = function() {
+ if (value.mode) {
+ p5.prototype._colorMode = value.mode;
+ }
+ if (value.maxes) {
+ p5.prototype._colorMaxes = value.maxes;
+ }
+ return p5.prototype.color(this.elt.value);
};
- return self
+ return self;
};
/**
* Creates an <input></input> element in the DOM for text input.
- * Use .size() to set the display length of the box.
+ * Use .size() to set the display length of the box.
* Appends to the container node if one is specified, otherwise
* appends to body.
*
* @method createInput
- * @param {Number} [value] default value of the input box
+ * @param {String} [value] default value of the input box
* @param {String} [type] type of text, ie text, password etc. Defaults to text
- * @return {Object|p5.Element} pointer to p5.Element holding created node
+ * @return {p5.Element} pointer to p5.Element holding created node
* @example
*
+ * var inp1, inp2;
+ * function setup() {
+ * createCanvas(100, 100);
+ * background('grey');
+ * inp1 = createColorPicker('#ff0000');
+ * inp2 = createColorPicker(color('yellow'));
+ * inp1.input(setShade1);
+ * inp2.input(setShade2);
+ * setMidShade();
+ * }
+ *
+ * function setMidShade() {
+ * // Finding a shade between the two
+ * var commonShade = lerpColor(inp1.color(), inp2.color(), 0.5);
+ * fill(commonShade);
+ * rect(20, 20, 60, 60);
+ * }
+ *
+ * function setShade1() {
+ * setMidShade();
+ * console.log('You are choosing shade 1 to be : ', this.value());
+ * }
+ * function setShade2() {
+ * setMidShade();
+ * console.log('You are choosing shade 2 to be : ', this.value());
+ * }
+ *
+ *
- * function setup(){
+ * function setup() {
* var inp = createInput('');
* inp.input(myInputEvent);
* }
*
- * function myInputEvent(){
+ * function myInputEvent() {
* console.log('you are typing: ', this.value());
* }
- *
*
* var input;
* var img;
*
@@ -816,9 +921,40 @@
* img.hide();
* }
* }
+ *
+ * var vid;
+ * function setup() {
+ * vid = createVideo(['small.mp4', 'small.ogv', 'small.webm'], vidLoad);
+ * }
+ *
+ * // This function is called when the video loads
+ * function vidLoad() {
+ * vid.play();
+ * }
+ *
+ * var ele;
+ * function setup() {
+ * ele = createAudio('assets/beat.mp3');
+ *
+ * // here we set the element to autoplay
+ * // The element will play as soon
+ * // as it is able to do so.
+ * ele.autoplay(true);
+ * }
+ * Creates a new <video> element that contains the audio/video feed - * from a webcam. This can be drawn onto the canvas using video().
+ *Creates a new HTML5 <video> element that contains the audio/video + * feed from a webcam. The element is separate from the canvas and is + * displayed by default. The element can be hidden using .hide(). The feed + * can be drawn onto the canvas using image(). The loadedmetadata property can + * be used to detect when the element has fully loaded (see second example).
*More specific properties of the feed can be passing in a Constraints object. * See the - * W3C + * W3C * spec for possible properties. Note that not all of these are supported * by all browsers.
*Security note: A new browser security specification requires that getUserMedia, - * which is behind createCapture(), only works when you're running the code locally, - * or on HTTPS. Learn more here - * and here.
+ * which is behind createCapture(), only works when you're running the code locally, + * or on HTTPS. Learn more here + * and here. * * @method createCapture * @param {String|Constant|Object} type type of capture, either VIDEO or - * AUDIO if none specified, default both, - * or a Constraints object - * @param {Function} callback function to be called once - * stream has loaded - * @return {Object|p5.Element} capture video p5.Element + * AUDIO if none specified, default both, + * or a Constraints object + * @param {Function} [callback] function to be called once + * stream has loaded + * @return {p5.Element} capture video p5.Element * @example - *
+ *
* var capture;
*
* function setup() {
- * createCanvas(480, 120);
+ * createCanvas(480, 480);
* capture = createCapture(VIDEO);
+ * capture.hide();
* }
*
* function draw() {
- * image(capture, 0, 0, width, width*capture.height/capture.width);
+ * image(capture, 0, 0, width, width * capture.height / capture.width);
* filter(INVERT);
* }
*
- *
+ *
* function setup() {
* createCanvas(480, 120);
* var constraints = {
@@ -1015,9 +1191,7 @@
* minWidth: 1280,
* minHeight: 720
* },
- * optional: [
- * { maxFrameRate: 10 }
- * ]
+ * optional: [{ maxFrameRate: 10 }]
* },
* audio: true
* };
@@ -1026,13 +1200,28 @@
* });
* }
*
+ *
+ * var capture;
+ *
+ * function setup() {
+ * createCanvas(640, 480);
+ * capture = createCapture(VIDEO);
+ * }
+ * function draw() {
+ * background(0);
+ * if (capture.loadedmetadata) {
+ * var c = capture.get(0, 0, 100, 100);
+ * image(c, 0, 0);
+ * }
+ * }
*/
p5.prototype.createCapture = function() {
+ p5._validateParameters('createCapture', arguments);
var useVideo = true;
var useAudio = true;
var constraints;
var cb;
- for (var i=0; ip5.Element holding created node
* @example
*
- * var h2 = createElement('h2','im an h2 p5.element!');
+ * createElement('h2', 'im an h2 p5.element!');
*
*/
p5.prototype.createElement = function(tag, content) {
+ p5._validateParameters('createElement', arguments);
var elt = document.createElement(tag);
if (typeof content !== 'undefined') {
elt.innerHTML = content;
@@ -1099,10 +1303,9 @@
return addElement(elt, this);
};
-
-// =============================================================================
-// p5.Element additions
-// =============================================================================
+ // =============================================================================
+ // p5.Element additions
+ // =============================================================================
/**
*
* Adds specified class to the element.
@@ -1110,7 +1313,7 @@
* @for p5.Element
* @method addClass
* @param {String} class name of class to add
- * @return {Object|p5.Element}
+ * @chainable
* @example
*
* var div = createDiv('div');
@@ -1122,13 +1325,13 @@
// PEND don't add class more than once
//var regex = new RegExp('[^a-zA-Z\d:]?'+c+'[^a-zA-Z\d:]?');
//if (this.elt.className.search(/[^a-zA-Z\d:]?hi[^a-zA-Z\d:]?/) === -1) {
- this.elt.className = this.elt.className+' '+c;
+ this.elt.className = this.elt.className + ' ' + c;
//}
} else {
this.elt.className = c;
}
return this;
- }
+ };
/**
*
@@ -1136,25 +1339,40 @@
*
* @method removeClass
* @param {String} class name of class to remove
- * @return {Object|p5.Element}
+ * @chainable
+ * @example
+ *
+ * // In this example, a class is set when the div is created
+ * // and removed when mouse is pressed. This could link up
+ * // with a CSS style rule to toggle style properties.
+ *
+ * var div;
+ *
+ * function setup() {
+ * div = createDiv('div');
+ * div.addClass('myClass');
+ * }
+ *
+ * function mousePressed() {
+ * div.removeClass('myClass');
+ * }
+ *
*/
p5.Element.prototype.removeClass = function(c) {
- var regex = new RegExp('(?:^|\\s)'+c+'(?!\\S)');
+ var regex = new RegExp('(?:^|\\s)' + c + '(?!\\S)');
this.elt.className = this.elt.className.replace(regex, '');
- this.elt.className = this.elt.className.replace(/^\s+|\s+$/g, ""); //prettify (optional)
+ this.elt.className = this.elt.className.replace(/^\s+|\s+$/g, ''); //prettify (optional)
return this;
- }
+ };
/**
*
* Attaches the element as a child to the parent specified.
- * Accepts either a string ID, DOM node, or p5.Element.
+ * Accepts either a string ID, DOM node, or p5.Element.
* If no argument is specified, an array of children DOM nodes is returned.
*
* @method child
- * @param {String|Object|p5.Element} [child] the ID, DOM node, or p5.Element
- * to add to the current element
- * @return {p5.Element}
+ * @returns {Node[]} an array of child nodes
* @example
*
* var div0 = createDiv('this is the parent');
@@ -1167,15 +1385,21 @@
* div1.id('apples');
* div0.child('apples'); // use id
*
- *
+ *
* var div0 = createDiv('this is the parent');
* var elt = document.getElementById('myChildDiv');
* div0.child(elt); // use element from page
*
*/
+ /**
+ * @method child
+ * @param {String|p5.Element} [child] the ID, DOM node, or p5.Element
+ * to add to the current element
+ * @chainable
+ */
p5.Element.prototype.child = function(c) {
- if (typeof c === 'undefined'){
- return this.elt.childNodes
+ if (typeof c === 'undefined') {
+ return this.elt.childNodes;
}
if (typeof c === 'string') {
if (c[0] === '#') {
@@ -1195,15 +1419,16 @@
* the body if the Element has no parent. If no argument is passed
* the Element is aligned both vertically and horizontally.
*
- * @param {String} align passing 'vertical', 'horizontal' aligns element accordingly
- * @return {Object|p5.Element} pointer to p5.Element
+ * @method center
+ * @param {String} [align] passing 'vertical', 'horizontal' aligns element accordingly
+ * @chainable
+ *
* @example
*
* function setup() {
- * var div = createDiv('').size(10,10);
- * div.style('background-color','orange');
+ * var div = createDiv('').size(10, 10);
+ * div.style('background-color', 'orange');
* div.center();
- *
* }
*
*/
@@ -1211,12 +1436,12 @@
var style = this.elt.style.display;
var hidden = this.elt.style.display === 'none';
var parentHidden = this.parent().style.display === 'none';
- var pos = { x : this.elt.offsetLeft, y : this.elt.offsetTop };
+ var pos = { x: this.elt.offsetLeft, y: this.elt.offsetTop };
if (hidden) this.show();
this.elt.style.display = 'block';
- this.position(0,0);
+ this.position(0, 0);
if (parentHidden) this.parent().style.display = 'block';
@@ -1225,12 +1450,12 @@
var y = pos.y;
var x = pos.x;
- if (align === 'both' || align === undefined){
- this.position(wOffset/2, hOffset/2);
- }else if (align === 'horizontal'){
- this.position(wOffset/2, y);
- }else if (align === 'vertical'){
- this.position(x, hOffset/2);
+ if (align === 'both' || align === undefined) {
+ this.position(wOffset / 2, hOffset / 2);
+ } else if (align === 'horizontal') {
+ this.position(wOffset / 2, y);
+ } else if (align === 'vertical') {
+ this.position(x, hOffset / 2);
}
this.style('display', style);
@@ -1252,19 +1477,23 @@
*
* @for p5.Element
* @method html
- * @param {String} [html] the HTML to be placed inside the element
- * @param {boolean} [append] whether to append HTML to existing
- * @return {Object|p5.Element|String}
+ * @returns {String} the inner HTML of the element
* @example
*
- * var div = createDiv('').size(100,100);
+ * var div = createDiv('').size(100, 100);
* div.html('hi');
*
*
- * var div = createDiv('Hello ').size(100,100);
+ * var div = createDiv('Hello ').size(100, 100);
* div.html('World', true);
*
*/
+ /**
+ * @method html
+ * @param {String} [html] the HTML to be placed inside the element
+ * @param {boolean} [append] whether to append HTML to existing
+ * @chainable
+ */
p5.Element.prototype.html = function() {
if (arguments.length === 0) {
return this.elt.innerHTML;
@@ -1285,9 +1514,7 @@
* of the element in an object.
*
* @method position
- * @param {Number} [x] x-position relative to upper left of window
- * @param {Number} [y] y-position relative to upper left of window
- * @return {Object|p5.Element}
+ * @returns {Object} the x and y position of the element in an object
* @example
*
* function setup() {
@@ -1298,13 +1525,19 @@
* }
*
*/
+ /**
+ * @method position
+ * @param {Number} [x] x-position relative to upper left of window
+ * @param {Number} [y] y-position relative to upper left of window
+ * @chainable
+ */
p5.Element.prototype.position = function() {
- if (arguments.length === 0){
- return { 'x' : this.elt.offsetLeft , 'y' : this.elt.offsetTop };
- }else{
+ if (arguments.length === 0) {
+ return { x: this.elt.offsetLeft, y: this.elt.offsetTop };
+ } else {
this.elt.style.position = 'absolute';
- this.elt.style.left = arguments[0]+'px';
- this.elt.style.top = arguments[1]+'px';
+ this.elt.style.left = arguments[0] + 'px';
+ this.elt.style.top = arguments[1] + 'px';
this.x = arguments[0];
this.y = arguments[1];
return this;
@@ -1312,7 +1545,7 @@
};
/* Helper method called by p5.Element.style() */
- p5.Element.prototype._translate = function(){
+ p5.Element.prototype._translate = function() {
this.elt.style.position = 'absolute';
// save out initial non-translate transform styling
var transform = '';
@@ -1321,13 +1554,21 @@
transform = transform.replace(/translate[X-Z]?\(.*\)/g, '');
}
if (arguments.length === 2) {
- this.elt.style.transform = 'translate('+arguments[0]+'px, '+arguments[1]+'px)';
+ this.elt.style.transform =
+ 'translate(' + arguments[0] + 'px, ' + arguments[1] + 'px)';
} else if (arguments.length > 2) {
- this.elt.style.transform = 'translate3d('+arguments[0]+'px,'+arguments[1]+'px,'+arguments[2]+'px)';
+ this.elt.style.transform =
+ 'translate3d(' +
+ arguments[0] +
+ 'px,' +
+ arguments[1] +
+ 'px,' +
+ arguments[2] +
+ 'px)';
if (arguments.length === 3) {
this.elt.parentElement.style.perspective = '1000px';
} else {
- this.elt.parentElement.style.perspective = arguments[3]+'px';
+ this.elt.parentElement.style.perspective = arguments[3] + 'px';
}
}
// add any extra transform styling back on end
@@ -1336,22 +1577,23 @@
};
/* Helper method called by p5.Element.style() */
- p5.Element.prototype._rotate = function(){
+ p5.Element.prototype._rotate = function() {
// save out initial non-rotate transform styling
var transform = '';
if (this.elt.style.transform) {
- var transform = this.elt.style.transform.replace(/rotate3d\(.*\)/g, '');
+ transform = this.elt.style.transform.replace(/rotate3d\(.*\)/g, '');
transform = transform.replace(/rotate[X-Z]?\(.*\)/g, '');
}
- if (arguments.length === 1){
- this.elt.style.transform = 'rotate('+arguments[0]+'deg)';
- }else if (arguments.length === 2){
- this.elt.style.transform = 'rotate('+arguments[0]+'deg, '+arguments[1]+'deg)';
- }else if (arguments.length === 3){
- this.elt.style.transform = 'rotateX('+arguments[0]+'deg)';
- this.elt.style.transform += 'rotateY('+arguments[1]+'deg)';
- this.elt.style.transform += 'rotateZ('+arguments[2]+'deg)';
+ if (arguments.length === 1) {
+ this.elt.style.transform = 'rotate(' + arguments[0] + 'deg)';
+ } else if (arguments.length === 2) {
+ this.elt.style.transform =
+ 'rotate(' + arguments[0] + 'deg, ' + arguments[1] + 'deg)';
+ } else if (arguments.length === 3) {
+ this.elt.style.transform = 'rotateX(' + arguments[0] + 'deg)';
+ this.elt.style.transform += 'rotateY(' + arguments[1] + 'deg)';
+ this.elt.style.transform += 'rotateZ(' + arguments[2] + 'deg)';
}
// add remaining transform back on
this.elt.style.transform += transform;
@@ -1369,44 +1611,59 @@
*
* @method style
* @param {String} property property to be set
- * @param {String|Number|p5.Color} [value] value to assign to property (only String|Number for rotate/translate)
- * @return {String|Object|p5.Element} value of property, if no value is specified
- * or p5.Element
+ * @returns {String} value of property
* @example
- *
- * var myDiv = createDiv("I like pandas.");
- * myDiv.style("font-size", "18px");
- * myDiv.style("color", "#ff0000");
+ *
+ * var myDiv = createDiv('I like pandas.');
+ * myDiv.style('font-size', '18px');
+ * myDiv.style('color', '#ff0000');
*
- *
- * var col = color(25,23,200,50);
- * var button = createButton("button");
- * button.style("background-color", col);
+ *
+ * var col = color(25, 23, 200, 50);
+ * var button = createButton('button');
+ * button.style('background-color', col);
* button.position(10, 10);
*
- *
- * var myDiv = createDiv("I like lizards.");
- * myDiv.style("position", 20, 20);
- * myDiv.style("rotate", 45);
+ *
+ * var myDiv = createDiv('I like lizards.');
+ * myDiv.style('position', 20, 20);
+ * myDiv.style('rotate', 45);
*
- *
+ *
* var myDiv;
* function setup() {
* background(200);
- * myDiv = createDiv("I like gray.");
+ * myDiv = createDiv('I like gray.');
* myDiv.position(20, 20);
* }
*
* function draw() {
- * myDiv.style("font-size", mouseX+"px");
+ * myDiv.style('font-size', mouseX + 'px');
* }
*
*/
+ /**
+ * @method style
+ * @param {String} property
+ * @param {String|Number|p5.Color} value value to assign to property (only String|Number for rotate/translate)
+ * @param {String|Number|p5.Color} [value2] position can take a 2nd value
+ * @param {String|Number|p5.Color} [value3] translate can take a 2nd & 3rd value
+ * @chainable
+ */
p5.Element.prototype.style = function(prop, val) {
var self = this;
if (val instanceof p5.Color) {
- val = 'rgba(' + val.levels[0] + ',' + val.levels[1] + ',' + val.levels[2] + ',' + val.levels[3]/255 + ')'
+ val =
+ 'rgba(' +
+ val.levels[0] +
+ ',' +
+ val.levels[1] +
+ ',' +
+ val.levels[2] +
+ ',' +
+ val.levels[3] / 255 +
+ ')';
}
if (typeof val === 'undefined') {
@@ -1424,13 +1681,18 @@
}
}
} else {
- if (prop === 'rotate' || prop === 'translate' || prop === 'position'){
+ if (prop === 'rotate' || prop === 'translate' || prop === 'position') {
var trans = Array.prototype.shift.apply(arguments);
- var f = this[trans] || this['_'+trans];
+ var f = this[trans] || this['_' + trans];
f.apply(this, arguments);
} else {
this.elt.style[prop] = val;
- if (prop === 'width' || prop === 'height' || prop === 'left' || prop === 'top') {
+ if (
+ prop === 'width' ||
+ prop === 'height' ||
+ prop === 'left' ||
+ prop === 'top'
+ ) {
var numVal = val.replace(/\D+/g, '');
this[prop] = parseInt(numVal, 10); // pend: is this necessary?
}
@@ -1439,7 +1701,6 @@
return this;
};
-
/**
*
* Adds a new attribute or changes the value of an existing attribute
@@ -1447,31 +1708,36 @@
* value of the given attribute, or null if attribute is not set.
*
* @method attribute
- * @param {String} attr attribute to set
- * @param {String} [value] value to assign to attribute
- * @return {String|Object|p5.Element} value of attribute, if no value is
- * specified or p5.Element
+ * @return {String} value of attribute
+ *
* @example
- *
- * var myDiv = createDiv("I like pandas.");
- * myDiv.attribute("align", "center");
+ *
+ * var myDiv = createDiv('I like pandas.');
+ * myDiv.attribute('align', 'center');
*
*/
+ /**
+ * @method attribute
+ * @param {String} attr attribute to set
+ * @param {String} value value to assign to attribute
+ * @chainable
+ */
p5.Element.prototype.attribute = function(attr, value) {
//handling for checkboxes and radios to ensure options get
//attributes not divs
- if(this.elt.firstChild != null &&
- (this.elt.firstChild.type === 'checkbox' ||
- this.elt.firstChild.type === 'radio')) {
- if(typeof value === 'undefined') {
+ if (
+ this.elt.firstChild != null &&
+ (this.elt.firstChild.type === 'checkbox' ||
+ this.elt.firstChild.type === 'radio')
+ ) {
+ if (typeof value === 'undefined') {
return this.elt.firstChild.getAttribute(attr);
} else {
- for(var i=0; i
@@ -1501,21 +1766,23 @@
* }
*
* function enableButton() {
- * if( this.checked() ) {
+ * if (this.checked()) {
* // Re-enable the button
* button.removeAttribute('disabled');
* } else {
* // Disable the button
- * button.attribute('disabled','');
+ * button.attribute('disabled', '');
* }
* }
*
*/
p5.Element.prototype.removeAttribute = function(attr) {
- if(this.elt.firstChild != null &&
- (this.elt.firstChild.type === 'checkbox' ||
- this.elt.firstChild.type === 'radio')) {
- for(var i=0; i
* // gets the value
@@ -1551,10 +1816,15 @@
* }
*
* function mousePressed() {
- * inp.value("myValue");
+ * inp.value('myValue');
* }
*
*/
+ /**
+ * @method value
+ * @param {String|Number} value
+ * @chainable
+ */
p5.Element.prototype.value = function() {
if (arguments.length > 0) {
this.elt.value = arguments[0];
@@ -1562,8 +1832,7 @@
} else {
if (this.elt.type === 'range') {
return parseFloat(this.elt.value);
- }
- else return this.elt.value;
+ } else return this.elt.value;
}
};
@@ -1572,11 +1841,11 @@
* Shows the current element. Essentially, setting display:block for the style.
*
* @method show
- * @return {Object|p5.Element}
+ * @chainable
* @example
*
* var div = createDiv('div');
- * div.style("display", "none");
+ * div.style('display', 'none');
* div.show(); // turns display to block
*
*/
@@ -1589,7 +1858,7 @@
* Hides the current element. Essentially, setting display:none for the style.
*
* @method hide
- * @return {Object|p5.Element}
+ * @chainable
* @example
*
* var div = createDiv('this is a div');
@@ -1608,19 +1877,23 @@
* of the element in an object.
*
* @method size
- * @param {Number} [w] width of the element
- * @param {Number} [h] height of the element
- * @return {Object|p5.Element}
+ * @return {Object} the width and height of the element in an object
* @example
*
* var div = createDiv('this is a div');
* div.size(100, 100);
*
*/
+ /**
+ * @method size
+ * @param {Number|Constant} w width of the element, either AUTO, or a number
+ * @param {Number|Constant} [h] height of the element, either AUTO, or a number
+ * @chainable
+ */
p5.Element.prototype.size = function(w, h) {
- if (arguments.length === 0){
- return { 'width' : this.elt.offsetWidth , 'height' : this.elt.offsetHeight };
- }else{
+ if (arguments.length === 0) {
+ return { width: this.elt.offsetWidth, height: this.elt.offsetHeight };
+ } else {
var aW = w;
var aH = h;
var AUTO = p5.prototype.AUTO;
@@ -1633,20 +1906,27 @@
// set diff for cnv vs normal div
if (this.elt instanceof HTMLCanvasElement) {
var j = {};
- var k = this.elt.getContext('2d');
- for (var prop in k) {
+ var k = this.elt.getContext('2d');
+ var prop;
+ for (prop in k) {
j[prop] = k[prop];
}
this.elt.setAttribute('width', aW * this._pInst._pixelDensity);
this.elt.setAttribute('height', aH * this._pInst._pixelDensity);
- this.elt.setAttribute('style', 'width:' + aW + 'px; height:' + aH + 'px');
- this._pInst.scale(this._pInst._pixelDensity, this._pInst._pixelDensity);
- for (var prop in j) {
+ this.elt.setAttribute(
+ 'style',
+ 'width:' + aW + 'px; height:' + aH + 'px'
+ );
+ this._pInst.scale(
+ this._pInst._pixelDensity,
+ this._pInst._pixelDensity
+ );
+ for (prop in j) {
this.elt.getContext('2d')[prop] = j[prop];
}
} else {
- this.elt.style.width = aW+'px';
- this.elt.style.height = aH+'px';
+ this.elt.style.width = aW + 'px';
+ this.elt.style.height = aH + 'px';
this.elt.width = aW;
this.elt.height = aH;
this.width = aW;
@@ -1656,7 +1936,8 @@
this.width = this.elt.offsetWidth;
this.height = this.elt.offsetHeight;
- if (this._pInst) { // main canvas associated with p5 instance
+ if (this._pInst && this._pInst._curElement) {
+ // main canvas associated with p5 instance
if (this._pInst._curElement.elt === this.elt) {
this._pInst._setProperty('width', this.elt.offsetWidth);
this._pInst._setProperty('height', this.elt.offsetHeight);
@@ -1684,21 +1965,18 @@
if (this.elt.parentNode) {
this.elt.parentNode.removeChild(this.elt);
}
- delete(this);
+ delete this;
};
-
-
-// =============================================================================
-// p5.MediaElement additions
-// =============================================================================
-
+ // =============================================================================
+ // p5.MediaElement additions
+ // =============================================================================
/**
- * Extends p5.Element to handle audio and video. In addition to the methods
- * of p5.Element, it also contains methods for controlling media. It is not
- * called directly, but p5.MediaElements are created by calling createVideo,
- * createAudio, and createCapture.
+ * Extends p5.Element to handle audio and video. In addition to the methods
+ * of p5.Element, it also contains methods for controlling media. It is not
+ * called directly, but p5.MediaElements are created by calling createVideo,
+ * createAudio, and createCapture.
*
* @class p5.MediaElement
* @constructor
@@ -1714,18 +1992,54 @@
this._cueIDCounter = 0;
this._cues = [];
this._pixelDensity = 1;
+ this._modified = false;
+ this._pixelsDirty = true;
+ this._pixelsTime = -1; // the time at which we last updated 'pixels'
/**
- * Path to the media element source.
+ * Path to the media element source.
+ *
+ * @property src
+ * @return {String} src
+ * @example
+ *
+ * var ele;
+ *
+ * function setup() {
+ * background(250);
+ *
+ * //p5.MediaElement objects are usually created
+ * //by calling the createAudio(), createVideo(),
+ * //and createCapture() functions.
+ *
+ * //In this example we create
+ * //a new p5.MediaElement via createAudio().
+ * ele = createAudio('assets/beat.mp3');
*
- * @property src
- * @return {String} src
+ * //We'll set up our example so that
+ * //when you click on the text,
+ * //an alert box displays the MediaElement's
+ * //src field.
+ * textAlign(CENTER);
+ * text('Click Me!', width / 2, height / 2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {
+ * //Show our p5.MediaElement's src field
+ * alert(ele.src);
+ * }
+ * }
+ *
*/
Object.defineProperty(self, 'src', {
get: function() {
var firstChildSrc = self.elt.children[0].src;
var srcVal = self.elt.src === window.location.href ? '' : self.elt.src;
- var ret = firstChildSrc === window.location.href ? srcVal : firstChildSrc;
+ var ret =
+ firstChildSrc === window.location.href ? srcVal : firstChildSrc;
return ret;
},
set: function(newValue) {
@@ -1736,37 +2050,75 @@
source.src = newValue;
elt.appendChild(source);
self.elt.src = newValue;
- },
+ self.modified = true;
+ }
});
// private _onended callback, set by the method: onended(callback)
self._onended = function() {};
self.elt.onended = function() {
self._onended(self);
- }
+ };
};
p5.MediaElement.prototype = Object.create(p5.Element.prototype);
-
-
-
/**
* Play an HTML5 media element.
*
* @method play
- * @return {Object|p5.Element}
+ * @chainable
+ * @example
+ *
+ * var ele;
+ *
+ * function setup() {
+ * //p5.MediaElement objects are usually created
+ * //by calling the createAudio(), createVideo(),
+ * //and createCapture() functions.
+ *
+ * //In this example we create
+ * //a new p5.MediaElement via createAudio().
+ * ele = createAudio('assets/beat.mp3');
+ *
+ * background(250);
+ * textAlign(CENTER);
+ * text('Click to Play!', width / 2, height / 2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {
+ * //Here we call the play() function on
+ * //the p5.MediaElement we created above.
+ * //This will start the audio sample.
+ * ele.play();
+ *
+ * background(200);
+ * text('You clicked Play!', width / 2, height / 2);
+ * }
+ * }
+ *
*/
p5.MediaElement.prototype.play = function() {
if (this.elt.currentTime === this.elt.duration) {
this.elt.currentTime = 0;
}
-
+ var promise;
if (this.elt.readyState > 1) {
- this.elt.play();
+ promise = this.elt.play();
} else {
// in Chrome, playback cannot resume after being stopped and must reload
this.elt.load();
- this.elt.play();
+ promise = this.elt.play();
+ }
+ if (promise && promise.catch) {
+ promise.catch(function(e) {
+ console.log(
+ 'WARN: Element play method raised an error asynchronously',
+ e
+ );
+ });
}
return this;
};
@@ -1775,7 +2127,59 @@
* Stops an HTML5 media element (sets current time to zero).
*
* @method stop
- * @return {Object|p5.Element}
+ * @chainable
+ * @example
+ *
+ * //This example both starts
+ * //and stops a sound sample
+ * //when the user clicks the canvas
+ *
+ * //We will store the p5.MediaElement
+ * //object in here
+ * var ele;
+ *
+ * //while our audio is playing,
+ * //this will be set to true
+ * var sampleIsPlaying = false;
+ *
+ * function setup() {
+ * //Here we create a p5.MediaElement object
+ * //using the createAudio() function.
+ * ele = createAudio('assets/beat.mp3');
+ * background(200);
+ * textAlign(CENTER);
+ * text('Click to play!', width / 2, height / 2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {
+ * background(200);
+ *
+ * if (sampleIsPlaying) {
+ * //if the sample is currently playing
+ * //calling the stop() function on
+ * //our p5.MediaElement will stop
+ * //it and reset its current
+ * //time to 0 (i.e. it will start
+ * //at the beginning the next time
+ * //you play it)
+ * ele.stop();
+ *
+ * sampleIsPlaying = false;
+ * text('Click to play!', width / 2, height / 2);
+ * } else {
+ * //loop our sound element until we
+ * //call ele.stop() on it.
+ * ele.loop();
+ *
+ * sampleIsPlaying = true;
+ * text('Click to stop!', width / 2, height / 2);
+ * }
+ * }
+ * }
+ *
*/
p5.MediaElement.prototype.stop = function() {
this.elt.pause();
@@ -1787,7 +2191,58 @@
* Pauses an HTML5 media element.
*
* @method pause
- * @return {Object|p5.Element}
+ * @chainable
+ * @example
+ *
+ * //This example both starts
+ * //and pauses a sound sample
+ * //when the user clicks the canvas
+ *
+ * //We will store the p5.MediaElement
+ * //object in here
+ * var ele;
+ *
+ * //while our audio is playing,
+ * //this will be set to true
+ * var sampleIsPlaying = false;
+ *
+ * function setup() {
+ * //Here we create a p5.MediaElement object
+ * //using the createAudio() function.
+ * ele = createAudio('assets/lucky_dragons.mp3');
+ * background(200);
+ * textAlign(CENTER);
+ * text('Click to play!', width / 2, height / 2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {
+ * background(200);
+ *
+ * if (sampleIsPlaying) {
+ * //Calling pause() on our
+ * //p5.MediaElement will stop it
+ * //playing, but when we call the
+ * //loop() or play() functions
+ * //the sample will start from
+ * //where we paused it.
+ * ele.pause();
+ *
+ * sampleIsPlaying = false;
+ * text('Click to resume!', width / 2, height / 2);
+ * } else {
+ * //loop our sound element until we
+ * //call ele.pause() on it.
+ * ele.loop();
+ *
+ * sampleIsPlaying = true;
+ * text('Click to pause!', width / 2, height / 2);
+ * }
+ * }
+ * }
+ *
*/
p5.MediaElement.prototype.pause = function() {
this.elt.pause();
@@ -1798,7 +2253,52 @@
* Set 'loop' to true for an HTML5 media element, and starts playing.
*
* @method loop
- * @return {Object|p5.Element}
+ * @chainable
+ * @example
+ *
+ * //Clicking the canvas will loop
+ * //the audio sample until the user
+ * //clicks again to stop it
+ *
+ * //We will store the p5.MediaElement
+ * //object in here
+ * var ele;
+ *
+ * //while our audio is playing,
+ * //this will be set to true
+ * var sampleIsLooping = false;
+ *
+ * function setup() {
+ * //Here we create a p5.MediaElement object
+ * //using the createAudio() function.
+ * ele = createAudio('assets/lucky_dragons.mp3');
+ * background(200);
+ * textAlign(CENTER);
+ * text('Click to loop!', width / 2, height / 2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {
+ * background(200);
+ *
+ * if (!sampleIsLooping) {
+ * //loop our sound element until we
+ * //call ele.stop() on it.
+ * ele.loop();
+ *
+ * sampleIsLooping = true;
+ * text('Click to stop!', width / 2, height / 2);
+ * } else {
+ * ele.stop();
+ *
+ * sampleIsLooping = false;
+ * text('Click to loop!', width / 2, height / 2);
+ * }
+ * }
+ * }
+ *
*/
p5.MediaElement.prototype.loop = function() {
this.elt.setAttribute('loop', true);
@@ -1810,20 +2310,59 @@
* when it reaches the end.
*
* @method noLoop
- * @return {Object|p5.Element}
+ * @chainable
+ * @example
+ *
+ * //This example both starts
+ * //and stops loop of sound sample
+ * //when the user clicks the canvas
+ *
+ * //We will store the p5.MediaElement
+ * //object in here
+ * var ele;
+ * //while our audio is playing,
+ * //this will be set to true
+ * var sampleIsPlaying = false;
+ *
+ * function setup() {
+ * //Here we create a p5.MediaElement object
+ * //using the createAudio() function.
+ * ele = createAudio('assets/beat.mp3');
+ * background(200);
+ * textAlign(CENTER);
+ * text('Click to play!', width / 2, height / 2);
+ * }
+ *
+ * function mouseClicked() {
+ * //here we test if the mouse is over the
+ * //canvas element when it's clicked
+ * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {
+ * background(200);
+ *
+ * if (sampleIsPlaying) {
+ * ele.noLoop();
+ * text('No more Loops!', width / 2, height / 2);
+ * } else {
+ * ele.loop();
+ * sampleIsPlaying = true;
+ * text('Click to stop looping!', width / 2, height / 2);
+ * }
+ * }
+ * }
+ *
+ *
*/
p5.MediaElement.prototype.noLoop = function() {
this.elt.setAttribute('loop', false);
return this;
};
-
/**
* Set HTML5 media element to autoplay or not.
*
* @method autoplay
* @param {Boolean} autoplay whether the element should autoplay
- * @return {Object|p5.Element}
+ * @chainable
*/
p5.MediaElement.prototype.autoplay = function(val) {
this.elt.setAttribute('autoplay', val);
@@ -1834,9 +2373,79 @@
* Sets volume for this HTML5 media element. If no argument is given,
* returns the current volume.
*
- * @param {Number} [val] volume between 0.0 and 1.0
- * @return {Number|p5.MediaElement} current volume or p5.MediaElement
* @method volume
+ * @return {Number} current volume
+ *
+ * @example
+ *
+ * var ele;
+ * function setup() {
+ * // p5.MediaElement objects are usually created
+ * // by calling the createAudio(), createVideo(),
+ * // and createCapture() functions.
+ * // In this example we create
+ * // a new p5.MediaElement via createAudio().
+ * ele = createAudio('assets/lucky_dragons.mp3');
+ * background(250);
+ * textAlign(CENTER);
+ * text('Click to Play!', width / 2, height / 2);
+ * }
+ * function mouseClicked() {
+ * // Here we call the volume() function
+ * // on the sound element to set its volume
+ * // Volume must be between 0.0 and 1.0
+ * ele.volume(0.2);
+ * ele.play();
+ * background(200);
+ * text('You clicked Play!', width / 2, height / 2);
+ * }
+ *
+ *
+ * var audio;
+ * var counter = 0;
+ *
+ * function loaded() {
+ * audio.play();
+ * }
+ *
+ * function setup() {
+ * audio = createAudio('assets/lucky_dragons.mp3', loaded);
+ * textAlign(CENTER);
+ * }
+ *
+ * function draw() {
+ * if (counter === 0) {
+ * background(0, 255, 0);
+ * text('volume(0.9)', width / 2, height / 2);
+ * } else if (counter === 1) {
+ * background(255, 255, 0);
+ * text('volume(0.5)', width / 2, height / 2);
+ * } else if (counter === 2) {
+ * background(255, 0, 0);
+ * text('volume(0.1)', width / 2, height / 2);
+ * }
+ * }
+ *
+ * function mousePressed() {
+ * counter++;
+ * if (counter === 0) {
+ * audio.volume(0.9);
+ * } else if (counter === 1) {
+ * audio.volume(0.5);
+ * } else if (counter === 2) {
+ * audio.volume(0.1);
+ * } else {
+ * counter = 0;
+ * audio.volume(0.9);
+ * }
+ * }
+ *
+ *
+ */
+ /**
+ * @method volume
+ * @param {Number} val volume between 0.0 and 1.0
+ * @chainable
*/
p5.MediaElement.prototype.volume = function(val) {
if (typeof val === 'undefined') {
@@ -1854,14 +2463,83 @@
* backward playback and even if they do, playback might not be smooth.)
*
* @method speed
- * @param {Number} [speed] speed multiplier for element playback
- * @return {Number|Object|p5.MediaElement} current playback speed or p5.MediaElement
+ * @return {Number} current playback speed of the element
+ *
+ * @example
+ *
+ * //Clicking the canvas will loop
+ * //the audio sample until the user
+ * //clicks again to stop it
+ *
+ * //We will store the p5.MediaElement
+ * //object in here
+ * var ele;
+ * var button;
+ *
+ * function setup() {
+ * createCanvas(710, 400);
+ * //Here we create a p5.MediaElement object
+ * //using the createAudio() function.
+ * ele = createAudio('assets/beat.mp3');
+ * ele.loop();
+ * background(200);
+ *
+ * button = createButton('2x speed');
+ * button.position(100, 68);
+ * button.mousePressed(twice_speed);
+ *
+ * button = createButton('half speed');
+ * button.position(200, 68);
+ * button.mousePressed(half_speed);
+ *
+ * button = createButton('reverse play');
+ * button.position(300, 68);
+ * button.mousePressed(reverse_speed);
+ *
+ * button = createButton('STOP');
+ * button.position(400, 68);
+ * button.mousePressed(stop_song);
+ *
+ * button = createButton('PLAY!');
+ * button.position(500, 68);
+ * button.mousePressed(play_speed);
+ * }
+ *
+ * function twice_speed() {
+ * ele.speed(2);
+ * }
+ *
+ * function half_speed() {
+ * ele.speed(0.5);
+ * }
+ *
+ * function reverse_speed() {
+ * ele.speed(-1);
+ * }
+ *
+ * function stop_song() {
+ * ele.stop();
+ * }
+ *
+ * function play_speed() {
+ * ele.play();
+ * }
+ *
+ */
+ /**
+ * @method speed
+ * @param {Number} speed speed multiplier for element playback
+ * @chainable
*/
p5.MediaElement.prototype.speed = function(val) {
if (typeof val === 'undefined') {
- return this.elt.playbackRate;
+ return this.presetPlaybackRate || this.elt.playbackRate;
} else {
- this.elt.playbackRate = val;
+ if (this.loadedmetadata) {
+ this.elt.playbackRate = val;
+ } else {
+ this.presetPlaybackRate = val;
+ }
}
};
@@ -1870,15 +2548,57 @@
* If an argument is given the current time of the element is set to it.
*
* @method time
- * @param {Number} [time] time to jump to (in seconds)
- * @return {Number|Object|p5.MediaElement} current time (in seconds)
- * or p5.MediaElement
+ * @return {Number} current time (in seconds)
+ *
+ * @example
+ *
+ * var ele;
+ * var beginning = true;
+ * function setup() {
+ * //p5.MediaElement objects are usually created
+ * //by calling the createAudio(), createVideo(),
+ * //and createCapture() functions.
+ *
+ * //In this example we create
+ * //a new p5.MediaElement via createAudio().
+ * ele = createAudio('assets/lucky_dragons.mp3');
+ * background(250);
+ * textAlign(CENTER);
+ * text('start at beginning', width / 2, height / 2);
+ * }
+ *
+ * // this function fires with click anywhere
+ * function mousePressed() {
+ * if (beginning === true) {
+ * // here we start the sound at the beginning
+ * // time(0) is not necessary here
+ * // as this produces the same result as
+ * // play()
+ * ele.play().time(0);
+ * background(200);
+ * text('jump 2 sec in', width / 2, height / 2);
+ * beginning = false;
+ * } else {
+ * // here we jump 2 seconds into the sound
+ * ele.play().time(2);
+ * background(250);
+ * text('start at beginning', width / 2, height / 2);
+ * beginning = true;
+ * }
+ * }
+ *
+ */
+ /**
+ * @method time
+ * @param {Number} time time to jump to (in seconds)
+ * @chainable
*/
p5.MediaElement.prototype.time = function(val) {
if (typeof val === 'undefined') {
return this.elt.currentTime;
} else {
this.elt.currentTime = val;
+ return this;
}
};
@@ -1887,36 +2607,90 @@
*
* @method duration
* @return {Number} duration
+ *
+ * @example
+ *
+ * var ele;
+ * function setup() {
+ * //p5.MediaElement objects are usually created
+ * //by calling the createAudio(), createVideo(),
+ * //and createCapture() functions.
+ * //In this example we create
+ * //a new p5.MediaElement via createAudio().
+ * ele = createAudio('assets/doorbell.mp3');
+ * background(250);
+ * textAlign(CENTER);
+ * text('Click to know the duration!', 10, 25, 70, 80);
+ * }
+ * function mouseClicked() {
+ * ele.play();
+ * background(200);
+ * //ele.duration dislpays the duration
+ * text(ele.duration() + ' seconds', width / 2, height / 2);
+ * }
+ *
*/
p5.MediaElement.prototype.duration = function() {
return this.elt.duration;
};
p5.MediaElement.prototype.pixels = [];
+ p5.MediaElement.prototype._ensureCanvas = function() {
+ if (!this.canvas) this.loadPixels();
+ };
p5.MediaElement.prototype.loadPixels = function() {
if (!this.canvas) {
this.canvas = document.createElement('canvas');
this.drawingContext = this.canvas.getContext('2d');
}
- if (this.loadedmetadata) { // wait for metadata for w/h
+ if (this.loadedmetadata) {
+ // wait for metadata for w/h
if (this.canvas.width !== this.elt.width) {
this.canvas.width = this.elt.width;
this.canvas.height = this.elt.height;
this.width = this.canvas.width;
this.height = this.canvas.height;
+ this._pixelsDirty = true;
+ }
+
+ var currentTime = this.elt.currentTime;
+ if (this._pixelsDirty || this._pixelsTime !== currentTime) {
+ // only update the pixels array if it's dirty, or
+ // if the video time has changed.
+ this._pixelsTime = currentTime;
+ this._pixelsDirty = true;
+
+ this.drawingContext.drawImage(
+ this.elt,
+ 0,
+ 0,
+ this.canvas.width,
+ this.canvas.height
+ );
+ p5.Renderer2D.prototype.loadPixels.call(this);
}
- this.drawingContext.drawImage(this.elt, 0, 0, this.canvas.width, this.canvas.height);
- p5.Renderer2D.prototype.loadPixels.call(this);
}
+ this.setModified(true);
return this;
- }
- p5.MediaElement.prototype.updatePixels = function(x, y, w, h){
- if (this.loadedmetadata) { // wait for metadata
+ };
+ p5.MediaElement.prototype.updatePixels = function(x, y, w, h) {
+ if (this.loadedmetadata) {
+ // wait for metadata
+ this._ensureCanvas();
p5.Renderer2D.prototype.updatePixels.call(this, x, y, w, h);
}
+ this.setModified(true);
return this;
- }
- p5.MediaElement.prototype.get = function(x, y, w, h){
- if (this.loadedmetadata) { // wait for metadata
+ };
+ p5.MediaElement.prototype.get = function(x, y, w, h) {
+ if (this.loadedmetadata) {
+ // wait for metadata
+ var currentTime = this.elt.currentTime;
+ if (this._pixelsTime !== currentTime) {
+ this.loadPixels();
+ } else {
+ this._ensureCanvas();
+ }
+
return p5.Renderer2D.prototype.get.call(this, x, y, w, h);
} else if (typeof x === 'undefined') {
return new p5.Image(1, 1);
@@ -1926,63 +2700,93 @@
return [0, 0, 0, 255];
}
};
- p5.MediaElement.prototype.set = function(x, y, imgOrCol){
- if (this.loadedmetadata) { // wait for metadata
+ p5.MediaElement.prototype.set = function(x, y, imgOrCol) {
+ if (this.loadedmetadata) {
+ // wait for metadata
+ this._ensureCanvas();
p5.Renderer2D.prototype.set.call(this, x, y, imgOrCol);
+ this.setModified(true);
}
};
- p5.MediaElement.prototype.copy = function(){
+ p5.MediaElement.prototype.copy = function() {
+ this._ensureCanvas();
p5.Renderer2D.prototype.copy.apply(this, arguments);
};
- p5.MediaElement.prototype.mask = function(){
+ p5.MediaElement.prototype.mask = function() {
this.loadPixels();
+ this.setModified(true);
p5.Image.prototype.mask.apply(this, arguments);
};
/**
- * Schedule an event to be called when the audio or video
- * element reaches the end. If the element is looping,
- * this will not be called. The element is passed in
- * as the argument to the onended callback.
- *
- * @method onended
- * @param {Function} callback function to call when the
- * soundfile has ended. The
- * media element will be passed
- * in as the argument to the
- * callback.
- * @return {Object|p5.MediaElement}
- * @example
- *
- * function setup() {
- * audioEl = createAudio('assets/beat.mp3');
- * audioEl.showControls(true);
- * audioEl.onended(sayDone);
- * }
- *
- * function sayDone(elt) {
- * alert('done playing ' + elt.src );
- * }
- *
+ * helper method for web GL mode to figure out if the element
+ * has been modified and might need to be re-uploaded to texture
+ * memory between frames.
+ * @method isModified
+ * @private
+ * @return {boolean} a boolean indicating whether or not the
+ * image has been updated or modified since last texture upload.
+ */
+ p5.MediaElement.prototype.isModified = function() {
+ return this._modified;
+ };
+ /**
+ * helper method for web GL mode to indicate that an element has been
+ * changed or unchanged since last upload. gl texture upload will
+ * set this value to false after uploading the texture; or might set
+ * it to true if metadata has become available but there is no actual
+ * texture data available yet..
+ * @method setModified
+ * @param {boolean} val sets whether or not the element has been
+ * modified.
+ * @private
+ */
+ p5.MediaElement.prototype.setModified = function(value) {
+ this._modified = value;
+ };
+ /**
+ * Schedule an event to be called when the audio or video
+ * element reaches the end. If the element is looping,
+ * this will not be called. The element is passed in
+ * as the argument to the onended callback.
+ *
+ * @method onended
+ * @param {Function} callback function to call when the
+ * soundfile has ended. The
+ * media element will be passed
+ * in as the argument to the
+ * callback.
+ * @chainable
+ * @example
+ *
+ * function setup() {
+ * var audioEl = createAudio('assets/beat.mp3');
+ * audioEl.showControls();
+ * audioEl.onended(sayDone);
+ * }
+ *
+ * function sayDone(elt) {
+ * alert('done playing ' + elt.src);
+ * }
+ *
*/
p5.MediaElement.prototype.onended = function(callback) {
this._onended = callback;
return this;
};
-
/*** CONNECT TO WEB AUDIO API / p5.sound.js ***/
/**
- * Send the audio output of this element to a specified audioNode or
- * p5.sound object. If no element is provided, connects to p5's master
- * output. That connection is established when this method is first called.
- * All connections are removed by the .disconnect() method.
+ * Send the audio output of this element to a specified audioNode or
+ * p5.sound object. If no element is provided, connects to p5's master
+ * output. That connection is established when this method is first called.
+ * All connections are removed by the .disconnect() method.
*
- * This method is meant to be used with the p5.sound.js addon library.
+ * This method is meant to be used with the p5.sound.js addon library.
*
- * @method connect
- * @param {AudioNode|Object} audioNode AudioNode from the Web Audio API,
- * or an object from the p5.sound library
+ * @method connect
+ * @param {AudioNode|Object} audioNode AudioNode from the Web Audio API,
+ * or an object from the p5.sound library
*/
p5.MediaElement.prototype.connect = function(obj) {
var audioContext, masterOutput;
@@ -1994,9 +2798,9 @@
} else {
try {
audioContext = obj.context;
- masterOutput = audioContext.destination
- } catch(e) {
- throw 'connect() is meant to be used with Web Audio API or p5.sound.js'
+ masterOutput = audioContext.destination;
+ } catch (e) {
+ throw 'connect() is meant to be used with Web Audio API or p5.sound.js';
}
}
@@ -2015,21 +2819,18 @@
} else {
this.audioSourceNode.connect(obj);
}
- }
-
- // otherwise connect to master output of p5.sound / AudioContext
- else {
+ } else {
+ // otherwise connect to master output of p5.sound / AudioContext
this.audioSourceNode.connect(masterOutput);
}
-
};
/**
- * Disconnect all Web Audio routing, including to master output.
- * This is useful if you want to re-route the output through
- * audio effects, for example.
+ * Disconnect all Web Audio routing, including to master output.
+ * This is useful if you want to re-route the output through
+ * audio effects, for example.
*
- * @method disconnect
+ * @method disconnect
*/
p5.MediaElement.prototype.disconnect = function() {
if (this.audioSourceNode) {
@@ -2039,13 +2840,32 @@
}
};
-
/*** SHOW / HIDE CONTROLS ***/
/**
- * Show the default MediaElement controls, as determined by the web browser.
+ * Show the default MediaElement controls, as determined by the web browser.
*
- * @method showControls
+ * @method showControls
+ * @example
+ *
+ * var ele;
+ * function setup() {
+ * //p5.MediaElement objects are usually created
+ * //by calling the createAudio(), createVideo(),
+ * //and createCapture() functions.
+ * //In this example we create
+ * //a new p5.MediaElement via createAudio()
+ * ele = createAudio('assets/lucky_dragons.mp3');
+ * background(200);
+ * textAlign(CENTER);
+ * text('Click to Show Controls!', 10, 25, 70, 80);
+ * }
+ * function mousePressed() {
+ * ele.showControls();
+ * background(200);
+ * text('Controls Shown', width / 2, height / 2);
+ * }
+ *
*/
p5.MediaElement.prototype.showControls = function() {
// must set style for the element to show on the page
@@ -2054,9 +2874,29 @@
};
/**
- * Hide the default mediaElement controls.
- *
- * @method hideControls
+ * Hide the default mediaElement controls.
+ * @method hideControls
+ * @example
+ *
+ * var ele;
+ * function setup() {
+ * //p5.MediaElement objects are usually created
+ * //by calling the createAudio(), createVideo(),
+ * //and createCapture() functions.
+ * //In this example we create
+ * //a new p5.MediaElement via createAudio()
+ * ele = createAudio('assets/lucky_dragons.mp3');
+ * ele.showControls();
+ * background(200);
+ * textAlign(CENTER);
+ * text('Click to hide Controls!', 10, 25, 70, 80);
+ * }
+ * function mousePressed() {
+ * ele.hideControls();
+ * background(200);
+ * text('Controls hidden', width / 2, height / 2);
+ * }
+ *
*/
p5.MediaElement.prototype.hideControls = function() {
this.elt.controls = false;
@@ -2064,54 +2904,65 @@
/*** SCHEDULE EVENTS ***/
+ // Cue inspired by JavaScript setTimeout, and the
+ // Tone.js Transport Timeline Event, MIT License Yotam Mann 2015 tonejs.org
+ var Cue = function(callback, time, id, val) {
+ this.callback = callback;
+ this.time = time;
+ this.id = id;
+ this.val = val;
+ };
+
/**
- * Schedule events to trigger every time a MediaElement
- * (audio/video) reaches a playback cue point.
+ * Schedule events to trigger every time a MediaElement
+ * (audio/video) reaches a playback cue point.
*
- * Accepts a callback function, a time (in seconds) at which to trigger
- * the callback, and an optional parameter for the callback.
+ * Accepts a callback function, a time (in seconds) at which to trigger
+ * the callback, and an optional parameter for the callback.
*
- * Time will be passed as the first parameter to the callback function,
- * and param will be the second parameter.
+ * Time will be passed as the first parameter to the callback function,
+ * and param will be the second parameter.
*
*
- * @method addCue
- * @param {Number} time Time in seconds, relative to this media
+ * @method addCue
+ * @param {Number} time Time in seconds, relative to this media
* element's playback. For example, to trigger
* an event every time playback reaches two
* seconds, pass in the number 2. This will be
* passed as the first parameter to
* the callback function.
- * @param {Function} callback Name of a function that will be
+ * @param {Function} callback Name of a function that will be
* called at the given time. The callback will
* receive time and (optionally) param as its
* two parameters.
- * @param {Object} [value] An object to be passed as the
+ * @param {Object} [value] An object to be passed as the
* second parameter to the
* callback function.
- * @return {Number} id ID of this cue,
- * useful for removeCue(id)
- * @example
- *
- * function setup() {
- * background(255,255,255);
- *
- * audioEl = createAudio('assets/beat.mp3');
- * audioEl.showControls();
- *
- * // schedule three calls to changeBackground
- * audioEl.addCue(0.5, changeBackground, color(255,0,0) );
- * audioEl.addCue(1.0, changeBackground, color(0,255,0) );
- * audioEl.addCue(2.5, changeBackground, color(0,0,255) );
- * audioEl.addCue(3.0, changeBackground, color(0,255,255) );
- * audioEl.addCue(4.2, changeBackground, color(255,255,0) );
- * audioEl.addCue(5.0, changeBackground, color(255,255,0) );
- * }
- *
- * function changeBackground(val) {
- * background(val);
- * }
- *
+ * @return {Number} id ID of this cue,
+ * useful for removeCue(id)
+ * @example
+ *
+ * //
+ * //
+ * function setup() {
+ * noCanvas();
+ *
+ * var audioEl = createAudio('assets/beat.mp3');
+ * audioEl.showControls();
+ *
+ * // schedule three calls to changeBackground
+ * audioEl.addCue(0.5, changeBackground, color(255, 0, 0));
+ * audioEl.addCue(1.0, changeBackground, color(0, 255, 0));
+ * audioEl.addCue(2.5, changeBackground, color(0, 0, 255));
+ * audioEl.addCue(3.0, changeBackground, color(0, 255, 255));
+ * audioEl.addCue(4.2, changeBackground, color(255, 255, 0));
+ * audioEl.addCue(5.0, changeBackground, color(255, 255, 0));
+ * }
+ *
+ * function changeBackground(val) {
+ * background(val);
+ * }
+ *
*/
p5.MediaElement.prototype.addCue = function(time, callback, val) {
var id = this._cueIDCounter++;
@@ -2127,30 +2978,80 @@
};
/**
- * Remove a callback based on its ID. The ID is returned by the
- * addCue method.
- *
- * @method removeCue
- * @param {Number} id ID of the cue, as returned by addCue
+ * Remove a callback based on its ID. The ID is returned by the
+ * addCue method.
+ * @method removeCue
+ * @param {Number} id ID of the cue, as returned by addCue
+ * @example
+ *
+ * var audioEl, id1, id2;
+ * function setup() {
+ * background(255, 255, 255);
+ * audioEl = createAudio('assets/beat.mp3');
+ * audioEl.showControls();
+ * // schedule five calls to changeBackground
+ * id1 = audioEl.addCue(0.5, changeBackground, color(255, 0, 0));
+ * audioEl.addCue(1.0, changeBackground, color(0, 255, 0));
+ * audioEl.addCue(2.5, changeBackground, color(0, 0, 255));
+ * audioEl.addCue(3.0, changeBackground, color(0, 255, 255));
+ * id2 = audioEl.addCue(4.2, changeBackground, color(255, 255, 0));
+ * text('Click to remove first and last Cue!', 10, 25, 70, 80);
+ * }
+ * function mousePressed() {
+ * audioEl.removeCue(id1);
+ * audioEl.removeCue(id2);
+ * }
+ * function changeBackground(val) {
+ * background(val);
+ * }
+ *
*/
p5.MediaElement.prototype.removeCue = function(id) {
for (var i = 0; i < this._cues.length; i++) {
- if (this._cues[i] === id) {
- console.log(id)
+ if (this._cues[i].id === id) {
+ console.log(id);
this._cues.splice(i, 1);
}
}
if (this._cues.length === 0) {
- this.elt.ontimeupdate = null
+ this.elt.ontimeupdate = null;
}
};
/**
- * Remove all of the callbacks that had originally been scheduled
- * via the addCue method.
- *
- * @method clearCues
+ * Remove all of the callbacks that had originally been scheduled
+ * via the addCue method.
+ * @method clearCues
+ * @param {Number} id ID of the cue, as returned by addCue
+ * @example
+ *
+ * var audioEl;
+ * function setup() {
+ * background(255, 255, 255);
+ * audioEl = createAudio('assets/beat.mp3');
+ * //Show the default MediaElement controls, as determined by the web browser
+ * audioEl.showControls();
+ * // schedule calls to changeBackground
+ * background(200);
+ * text('Click to change Cue!', 10, 25, 70, 80);
+ * audioEl.addCue(0.5, changeBackground, color(255, 0, 0));
+ * audioEl.addCue(1.0, changeBackground, color(0, 255, 0));
+ * audioEl.addCue(2.5, changeBackground, color(0, 0, 255));
+ * audioEl.addCue(3.0, changeBackground, color(0, 255, 255));
+ * audioEl.addCue(4.2, changeBackground, color(255, 255, 0));
+ * }
+ * function mousePressed() {
+ * // here we clear the scheduled callbacks
+ * audioEl.clearCues();
+ * // then we add some more callbacks
+ * audioEl.addCue(1, changeBackground, color(2, 2, 2));
+ * audioEl.addCue(3, changeBackground, color(255, 255, 0));
+ * }
+ * function changeBackground(val) {
+ * background(val);
+ * }
+ *
*/
p5.MediaElement.prototype.clearCues = function() {
this._cues = [];
@@ -2162,36 +3063,22 @@
p5.MediaElement.prototype._onTimeUpdate = function() {
var playbackTime = this.time();
- for (var i = 0 ; i < this._cues.length; i++) {
+ for (var i = 0; i < this._cues.length; i++) {
var callbackTime = this._cues[i].time;
var val = this._cues[i].val;
-
if (this._prevTime < callbackTime && callbackTime <= playbackTime) {
-
// pass the scheduled callbackTime as parameter to the callback
this._cues[i].callback(val);
}
-
}
this._prevTime = playbackTime;
};
-
- // Cue inspired by JavaScript setTimeout, and the
- // Tone.js Transport Timeline Event, MIT License Yotam Mann 2015 tonejs.org
- var Cue = function(callback, time, id, val) {
- this.callback = callback;
- this.time = time;
- this.id = id;
- this.val = val;
- };
-
-// =============================================================================
-// p5.File
-// =============================================================================
-
+ // =============================================================================
+ // p5.File
+ // =============================================================================
/**
* Base class for a file
@@ -2246,5 +3133,4 @@
*/
this.data = undefined;
};
-
-}));
+});
diff --git a/libraries/p5/p5.dom.min.js b/libraries/p5/p5.dom.min.js
index 85b3c19c..76cd8957 100644
--- a/libraries/p5/p5.dom.min.js
+++ b/libraries/p5/p5.dom.min.js
@@ -1 +1 @@
-/*! p5.js v0.5.16 October 11, 2017 */ !function(a,b){"function"==typeof define&&define.amd?define("p5.dom",["p5"],function(a){b(a)}):b("object"==typeof exports?require("../p5"):a.p5)}(this,function(a){function b(b){var c=document;return"string"==typeof b&&"#"===b[0]?(b=b.slice(1),c=document.getElementById(b)||document):b instanceof a.Element?c=b.elt:b instanceof HTMLElement&&(c=b),c}function c(b){if("INPUT"===b.tagName&&"checkbox"===b.type){var c=new a.Element(b);return c.checked=function(){return 0===arguments.length?this.elt.checked:(arguments[0]?this.elt.checked=!0:this.elt.checked=!1,this)},c}return"VIDEO"===b.tagName||"AUDIO"===b.tagName?new a.MediaElement(b):"SELECT"===b.tagName?createSelect(new a.Element(b)):new a.Element(b)}function d(b,c,d){(c._userNode?c._userNode:document.body).appendChild(b);var e=d?new a.MediaElement(b):new a.Element(b);return c._elements.push(e),e}function e(a,b,c,e){var f=document.createElement(b),c=c||"";"string"==typeof c&&(c=[c]);for(var g=0;g1&&"function"==typeof c[1]?(a.fn=c[1],a.fn()):c.length>1&&"function"==typeof c[2]&&(a.fn=c[2],a.fn())};return b.src=c[0],c.length>1&&"string"==typeof c[1]&&(b.alt=c[1]),b.onload=function(){e()},a=d(b,this)},a.prototype.createA=function(a,b,c){var e=document.createElement("a");return e.href=a,e.innerHTML=b,c&&(e.target=c),d(e,this)},a.prototype.createSlider=function(a,b,c,e){var f=document.createElement("input");return f.type="range",f.min=a,f.max=b,0===e?f.step=1e-18:e&&(f.step=e),"number"==typeof c&&(f.value=c),d(f,this)},a.prototype.createButton=function(a,b){var c=document.createElement("button");return c.innerHTML=a,b&&(c.value=b),d(c,this)},a.prototype.createCheckbox=function(){var a=document.createElement("div"),b=document.createElement("input");b.type="checkbox",a.appendChild(b);var c=d(a,this);if(c.checked=function(){var a=c.elt.getElementsByTagName("input")[0];if(a){if(0===arguments.length)return a.checked;arguments[0]?a.checked=!0:a.checked=!1}return c},this.value=function(a){return c.value=a,this},arguments[0]){var e=Math.random().toString(36).slice(2),f=document.createElement("label");b.setAttribute("id",e),f.htmlFor=e,c.value(arguments[0]),f.appendChild(document.createTextNode(arguments[0])),a.appendChild(f)}return arguments[1]&&(b.checked=!0),c},a.prototype.createSelect=function(){var a,b,c=arguments[0];return"object"==typeof c&&"SELECT"===c.elt.nodeName?(b=c,a=this.elt=c.elt):(a=document.createElement("select"),c&&"boolean"==typeof c&&a.setAttribute("multiple","true"),b=d(a,this)),b.option=function(b,c){for(var d,e=0;e1?f.value=c:f.value=b,a.appendChild(f)}},b.selected=function(a){var b=[];if(arguments.length>0){for(var c=0;c1){var c=a.length,e=a[0].name,f=a[1].name;b=1;for(var g=1;g1?d.value=c:d.value=a,d.setAttribute("name","defaultradio"+b),h.appendChild(d),a){j++;var e=(Math.random().toString(36).slice(2),document.createElement("label"));d.setAttribute("id","defaultradio"+b+"-"+j),e.htmlFor="defaultradio"+b+"-"+j,e.appendChild(document.createTextNode(a)),h.appendChild(e)}return d},i.selected=function(){var a=this.elt.childNodes.length;if(1==arguments.length){for(var b=0;b-1?h.readAsText(g):h.readAsDataURL(g)}}if(window.File&&window.FileReader&&window.FileList&&window.Blob){var f=document.createElement("input");return f.type="file",c&&(f.multiple="multiple"),f.addEventListener("change",e,!1),d(f,this)}console.log("The File APIs are not fully supported in this browser. Cannot create element.")},a.prototype.createVideo=function(a,b){return e(this,"video",a,b)},a.prototype.createAudio=function(a,b){return e(this,"audio",a,b)},a.prototype.VIDEO="video",a.prototype.AUDIO="audio",void 0===navigator.mediaDevices&&(navigator.mediaDevices={}),void 0===navigator.mediaDevices.getUserMedia&&(navigator.mediaDevices.getUserMedia=function(a){var b=navigator.webkitGetUserMedia||navigator.mozGetUserMedia;return b?new Promise(function(c,d){b.call(navigator,a,c,d)}):Promise.reject(new Error("getUserMedia is not implemented in this browser"))}),a.prototype.createCapture=function(){for(var b,c,e=!0,f=!0,g=0;g2&&(this.elt.style.transform="translate3d("+arguments[0]+"px,"+arguments[1]+"px,"+arguments[2]+"px)",3===arguments.length?this.elt.parentElement.style.perspective="1000px":this.elt.parentElement.style.perspective=arguments[3]+"px"),this.elt.style.transform+=a,this},a.Element.prototype._rotate=function(){var a="";if(this.elt.style.transform){var a=this.elt.style.transform.replace(/rotate3d\(.*\)/g,"");a=a.replace(/rotate[X-Z]?\(.*\)/g,"")}return 1===arguments.length?this.elt.style.transform="rotate("+arguments[0]+"deg)":2===arguments.length?this.elt.style.transform="rotate("+arguments[0]+"deg, "+arguments[1]+"deg)":3===arguments.length&&(this.elt.style.transform="rotateX("+arguments[0]+"deg)",this.elt.style.transform+="rotateY("+arguments[1]+"deg)",this.elt.style.transform+="rotateZ("+arguments[2]+"deg)"),this.elt.style.transform+=a,this},a.Element.prototype.style=function(b,c){var d=this;if(c instanceof a.Color&&(c="rgba("+c.levels[0]+","+c.levels[1]+","+c.levels[2]+","+c.levels[3]/255+")"),void 0===c){if(b.indexOf(":")===-1)return window.getComputedStyle(d.elt).getPropertyValue(b);for(var e=b.split(";"),f=0;f0?(this.elt.value=arguments[0],this):"range"===this.elt.type?parseFloat(this.elt.value):this.elt.value},a.Element.prototype.show=function(){return this.elt.style.display="block",this},a.Element.prototype.hide=function(){return this.elt.style.display="none",this},a.Element.prototype.size=function(b,c){if(0===arguments.length)return{width:this.elt.offsetWidth,height:this.elt.offsetHeight};var d=b,e=c,f=a.prototype.AUTO;if(d!==f||e!==f){if(d===f?d=c*this.width/this.height:e===f&&(e=b*this.height/this.width),this.elt instanceof HTMLCanvasElement){var g={},h=this.elt.getContext("2d");for(var i in h)g[i]=h[i];this.elt.setAttribute("width",d*this._pInst._pixelDensity),this.elt.setAttribute("height",e*this._pInst._pixelDensity),this.elt.setAttribute("style","width:"+d+"px; height:"+e+"px"),this._pInst.scale(this._pInst._pixelDensity,this._pInst._pixelDensity);for(var i in g)this.elt.getContext("2d")[i]=g[i]}else this.elt.style.width=d+"px",this.elt.style.height=e+"px",this.elt.width=d,this.elt.height=e,this.width=d,this.height=e;this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this._pInst&&this._pInst._curElement.elt===this.elt&&(this._pInst._setProperty("width",this.elt.offsetWidth),this._pInst._setProperty("height",this.elt.offsetHeight))}return this},a.Element.prototype.remove=function(){for(var a in this._events)this.elt.removeEventListener(a,this._events[a]);this.elt.parentNode&&this.elt.parentNode.removeChild(this.elt),delete this},a.MediaElement=function(b,c){a.Element.call(this,b,c);var d=this;this.elt.crossOrigin="anonymous",this._prevTime=0,this._cueIDCounter=0,this._cues=[],this._pixelDensity=1,this._modified=!1,Object.defineProperty(d,"src",{get:function(){var a=d.elt.children[0].src,b=d.elt.src===window.location.href?"":d.elt.src;return a===window.location.href?b:a},set:function(a){for(var c=0;c1?this.elt.play():(this.elt.load(),this.elt.play()),this},a.MediaElement.prototype.stop=function(){return this.elt.pause(),this.elt.currentTime=0,this},a.MediaElement.prototype.pause=function(){return this.elt.pause(),this},a.MediaElement.prototype.loop=function(){return this.elt.setAttribute("loop",!0),this.play(),this},a.MediaElement.prototype.noLoop=function(){return this.elt.setAttribute("loop",!1),this},a.MediaElement.prototype.autoplay=function(a){return this.elt.setAttribute("autoplay",a),this},a.MediaElement.prototype.volume=function(a){if(void 0===a)return this.elt.volume;this.elt.volume=a},a.MediaElement.prototype.speed=function(a){if(void 0===a)return this.elt.playbackRate;this.elt.playbackRate=a},a.MediaElement.prototype.time=function(a){if(void 0===a)return this.elt.currentTime;this.elt.currentTime=a},a.MediaElement.prototype.duration=function(){return this.elt.duration},a.MediaElement.prototype.pixels=[],a.MediaElement.prototype.loadPixels=function(){return this.canvas||(this.canvas=document.createElement("canvas"),this.drawingContext=this.canvas.getContext("2d")),this.loadedmetadata&&(this.canvas.width!==this.elt.width&&(this.canvas.width=this.elt.width,this.canvas.height=this.elt.height,this.width=this.canvas.width,this.height=this.canvas.height),this.drawingContext.drawImage(this.elt,0,0,this.canvas.width,this.canvas.height),a.Renderer2D.prototype.loadPixels.call(this)),this.setModified(!0),this},a.MediaElement.prototype.updatePixels=function(b,c,d,e){return this.loadedmetadata&&a.Renderer2D.prototype.updatePixels.call(this,b,c,d,e),this.setModified(!0),this},a.MediaElement.prototype.get=function(b,c,d,e){return this.loadedmetadata?a.Renderer2D.prototype.get.call(this,b,c,d,e):void 0===b?new a.Image(1,1):d>1?new a.Image(b,c,d,e):[0,0,0,255]},a.MediaElement.prototype.set=function(b,c,d){this.loadedmetadata&&(a.Renderer2D.prototype.set.call(this,b,c,d),this.setModified(!0))},a.MediaElement.prototype.copy=function(){a.Renderer2D.prototype.copy.apply(this,arguments)},a.MediaElement.prototype.mask=function(){this.loadPixels(),this.setModified(!0),a.Image.prototype.mask.apply(this,arguments)},a.MediaElement.prototype.isModified=function(){return this._modified},a.MediaElement.prototype.setModified=function(a){this._modified=a},a.MediaElement.prototype.onended=function(a){return this._onended=a,this},a.MediaElement.prototype.connect=function(b){var c,d;if("function"==typeof a.prototype.getAudioContext)c=a.prototype.getAudioContext(),d=a.soundOut.input;else try{c=b.context,d=c.destination}catch(a){throw"connect() is meant to be used with Web Audio API or p5.sound.js"}this.audioSourceNode||(this.audioSourceNode=c.createMediaElementSource(this.elt),this.audioSourceNode.connect(d)),b?b.input?this.audioSourceNode.connect(b.input):this.audioSourceNode.connect(b):this.audioSourceNode.connect(d)},a.MediaElement.prototype.disconnect=function(){if(!this.audioSourceNode)throw"nothing to disconnect";this.audioSourceNode.disconnect()},a.MediaElement.prototype.showControls=function(){this.elt.style["text-align"]="inherit",this.elt.controls=!0},a.MediaElement.prototype.hideControls=function(){this.elt.controls=!1},a.MediaElement.prototype.addCue=function(a,b,c){var d=this._cueIDCounter++,e=new f(b,a,d,c);return this._cues.push(e),this.elt.ontimeupdate||(this.elt.ontimeupdate=this._onTimeUpdate.bind(this)),d},a.MediaElement.prototype.removeCue=function(a){for(var b=0;b0&&c.every(function(a){return"INPUT"===a.tagName||"LABEL"===a.tagName})?this.createRadio(new a.Element(b,this)):new a.Element(b,this)},a.prototype.removeElements=function(b){a._validateParameters("removeElements",arguments);for(var c=0;c1&&"function"==typeof e[1]?(b.fn=e[1],b.fn()):e.length>1&&"function"==typeof e[2]&&(b.fn=e[2],b.fn())};return d.src=e[0],e.length>1&&"string"==typeof e[1]&&(d.alt=e[1]),d.onload=function(){f()},b=c(d,this)},a.prototype.createA=function(b,d,e){a._validateParameters("createA",arguments);var f=document.createElement("a");return f.href=b,f.innerHTML=d,e&&(f.target=e),c(f,this)},a.prototype.createSlider=function(b,d,e,f){a._validateParameters("createSlider",arguments);var g=document.createElement("input");return g.type="range",g.min=b,g.max=d,0===f?g.step=1e-18:f&&(g.step=f),"number"==typeof e&&(g.value=e),c(g,this)},a.prototype.createButton=function(b,d){a._validateParameters("createButton",arguments);var e=document.createElement("button");return e.innerHTML=b,d&&(e.value=d),c(e,this)},a.prototype.createCheckbox=function(){a._validateParameters("createCheckbox",arguments);var b=document.createElement("div"),d=document.createElement("input");d.type="checkbox",b.appendChild(d);var e=c(b,this);if(e.checked=function(){var a=e.elt.getElementsByTagName("input")[0];if(a){if(0===arguments.length)return a.checked;arguments[0]?a.checked=!0:a.checked=!1}return e},this.value=function(a){return e.value=a,this},arguments[0]){var f=Math.random().toString(36).slice(2),g=document.createElement("label");d.setAttribute("id",f),g.htmlFor=f,e.value(arguments[0]),g.appendChild(document.createTextNode(arguments[0])),b.appendChild(g)}return arguments[1]&&(d.checked=!0),e},a.prototype.createSelect=function(){a._validateParameters("createSelect",arguments);var b,d,e=arguments[0];return"object"==typeof e&&"SELECT"===e.elt.nodeName?(d=e,b=this.elt=e.elt):(b=document.createElement("select"),e&&"boolean"==typeof e&&b.setAttribute("multiple","true"),d=c(b,this)),d.option=function(a,c){for(var d,e=0;e1?f.value=c:f.value=a,b.appendChild(f)}},d.selected=function(a){var b,c=[];if(arguments.length>0){for(b=0;b1){var f=d.length,g=d[0].name,h=d[1].name;e=1;for(var i=1;i-1?h.readAsText(g):h.readAsDataURL(g)}}if(a._validateParameters("createFileInput",arguments),window.File&&window.FileReader&&window.FileList&&window.Blob){var f=document.createElement("input");return f.type="file",d&&(f.multiple="multiple"),f.addEventListener("change",e,!1),c(f,this)}console.log("The File APIs are not fully supported in this browser. Cannot create element.")},a.prototype.createVideo=function(b,c){return a._validateParameters("createVideo",arguments),d(this,"video",b,c)},a.prototype.createAudio=function(b,c){return a._validateParameters("createAudio",arguments),d(this,"audio",b,c)},a.prototype.VIDEO="video",a.prototype.AUDIO="audio",void 0===navigator.mediaDevices&&(navigator.mediaDevices={}),void 0===navigator.mediaDevices.getUserMedia&&(navigator.mediaDevices.getUserMedia=function(a){var b=navigator.webkitGetUserMedia||navigator.mozGetUserMedia;return b?new Promise(function(c,d){b.call(navigator,a,c,d)}):Promise.reject(new Error("getUserMedia is not implemented in this browser"))}),a.prototype.createCapture=function(){a._validateParameters("createCapture",arguments);for(var b,d,e=!0,f=!0,g=0;g2&&(this.elt.style.transform="translate3d("+arguments[0]+"px,"+arguments[1]+"px,"+arguments[2]+"px)",3===arguments.length?this.elt.parentElement.style.perspective="1000px":this.elt.parentElement.style.perspective=arguments[3]+"px"),this.elt.style.transform+=a,this},a.Element.prototype._rotate=function(){var a="";return this.elt.style.transform&&(a=this.elt.style.transform.replace(/rotate3d\(.*\)/g,""),a=a.replace(/rotate[X-Z]?\(.*\)/g,"")),1===arguments.length?this.elt.style.transform="rotate("+arguments[0]+"deg)":2===arguments.length?this.elt.style.transform="rotate("+arguments[0]+"deg, "+arguments[1]+"deg)":3===arguments.length&&(this.elt.style.transform="rotateX("+arguments[0]+"deg)",this.elt.style.transform+="rotateY("+arguments[1]+"deg)",this.elt.style.transform+="rotateZ("+arguments[2]+"deg)"),this.elt.style.transform+=a,this},a.Element.prototype.style=function(b,c){var d=this;if(c instanceof a.Color&&(c="rgba("+c.levels[0]+","+c.levels[1]+","+c.levels[2]+","+c.levels[3]/255+")"),void 0===c){if(-1===b.indexOf(":"))return window.getComputedStyle(d.elt).getPropertyValue(b);for(var e=b.split(";"),f=0;f0?(this.elt.value=arguments[0],this):"range"===this.elt.type?parseFloat(this.elt.value):this.elt.value},a.Element.prototype.show=function(){return this.elt.style.display="block",this},a.Element.prototype.hide=function(){return this.elt.style.display="none",this},a.Element.prototype.size=function(b,c){if(0===arguments.length)return{width:this.elt.offsetWidth,height:this.elt.offsetHeight};var d=b,e=c,f=a.prototype.AUTO;if(d!==f||e!==f){if(d===f?d=c*this.width/this.height:e===f&&(e=b*this.height/this.width),this.elt instanceof HTMLCanvasElement){var g,h={},i=this.elt.getContext("2d");for(g in i)h[g]=i[g];this.elt.setAttribute("width",d*this._pInst._pixelDensity),this.elt.setAttribute("height",e*this._pInst._pixelDensity),this.elt.setAttribute("style","width:"+d+"px; height:"+e+"px"),this._pInst.scale(this._pInst._pixelDensity,this._pInst._pixelDensity);for(g in h)this.elt.getContext("2d")[g]=h[g]}else this.elt.style.width=d+"px",this.elt.style.height=e+"px",this.elt.width=d,this.elt.height=e,this.width=d,this.height=e;this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this._pInst&&this._pInst._curElement&&this._pInst._curElement.elt===this.elt&&(this._pInst._setProperty("width",this.elt.offsetWidth),this._pInst._setProperty("height",this.elt.offsetHeight))}return this},a.Element.prototype.remove=function(){for(var a in this._events)this.elt.removeEventListener(a,this._events[a]);this.elt.parentNode&&this.elt.parentNode.removeChild(this.elt)},a.MediaElement=function(b,c){a.Element.call(this,b,c);var d=this;this.elt.crossOrigin="anonymous",this._prevTime=0,this._cueIDCounter=0,this._cues=[],this._pixelDensity=1,this._modified=!1,this._pixelsDirty=!0,this._pixelsTime=-1,Object.defineProperty(d,"src",{get:function(){var a=d.elt.children[0].src,b=d.elt.src===window.location.href?"":d.elt.src;return a===window.location.href?b:a},set:function(a){for(var c=0;c1?a=this.elt.play():(this.elt.load(),a=this.elt.play()),a&&a.catch&&a.catch(function(a){console.log("WARN: Element play method raised an error asynchronously",a)}),this},a.MediaElement.prototype.stop=function(){return this.elt.pause(),this.elt.currentTime=0,this},a.MediaElement.prototype.pause=function(){return this.elt.pause(),this},a.MediaElement.prototype.loop=function(){return this.elt.setAttribute("loop",!0),this.play(),this},a.MediaElement.prototype.noLoop=function(){return this.elt.setAttribute("loop",!1),this},a.MediaElement.prototype.autoplay=function(a){return this.elt.setAttribute("autoplay",a),this},a.MediaElement.prototype.volume=function(a){if(void 0===a)return this.elt.volume;this.elt.volume=a},a.MediaElement.prototype.speed=function(a){if(void 0===a)return this.presetPlaybackRate||this.elt.playbackRate;this.loadedmetadata?this.elt.playbackRate=a:this.presetPlaybackRate=a},a.MediaElement.prototype.time=function(a){return void 0===a?this.elt.currentTime:(this.elt.currentTime=a,this)},a.MediaElement.prototype.duration=function(){return this.elt.duration},a.MediaElement.prototype.pixels=[],a.MediaElement.prototype._ensureCanvas=function(){this.canvas||this.loadPixels()},a.MediaElement.prototype.loadPixels=function(){if(this.canvas||(this.canvas=document.createElement("canvas"),this.drawingContext=this.canvas.getContext("2d")),this.loadedmetadata){this.canvas.width!==this.elt.width&&(this.canvas.width=this.elt.width,this.canvas.height=this.elt.height,this.width=this.canvas.width,this.height=this.canvas.height,this._pixelsDirty=!0);var b=this.elt.currentTime;(this._pixelsDirty||this._pixelsTime!==b)&&(this._pixelsTime=b,this._pixelsDirty=!0,this.drawingContext.drawImage(this.elt,0,0,this.canvas.width,this.canvas.height),a.Renderer2D.prototype.loadPixels.call(this))}return this.setModified(!0),this},a.MediaElement.prototype.updatePixels=function(b,c,d,e){return this.loadedmetadata&&(this._ensureCanvas(),a.Renderer2D.prototype.updatePixels.call(this,b,c,d,e)),this.setModified(!0),this},a.MediaElement.prototype.get=function(b,c,d,e){if(this.loadedmetadata){var f=this.elt.currentTime;return this._pixelsTime!==f?this.loadPixels():this._ensureCanvas(),a.Renderer2D.prototype.get.call(this,b,c,d,e)}return void 0===b?new a.Image(1,1):d>1?new a.Image(b,c,d,e):[0,0,0,255]},a.MediaElement.prototype.set=function(b,c,d){this.loadedmetadata&&(this._ensureCanvas(),a.Renderer2D.prototype.set.call(this,b,c,d),this.setModified(!0))},a.MediaElement.prototype.copy=function(){this._ensureCanvas(),a.Renderer2D.prototype.copy.apply(this,arguments)},a.MediaElement.prototype.mask=function(){this.loadPixels(),this.setModified(!0),a.Image.prototype.mask.apply(this,arguments)},a.MediaElement.prototype.isModified=function(){return this._modified},a.MediaElement.prototype.setModified=function(a){this._modified=a},a.MediaElement.prototype.onended=function(a){return this._onended=a,this},a.MediaElement.prototype.connect=function(b){var c,d;if("function"==typeof a.prototype.getAudioContext)c=a.prototype.getAudioContext(),d=a.soundOut.input;else try{c=b.context,d=c.destination}catch(a){throw"connect() is meant to be used with Web Audio API or p5.sound.js"}this.audioSourceNode||(this.audioSourceNode=c.createMediaElementSource(this.elt),this.audioSourceNode.connect(d)),b?b.input?this.audioSourceNode.connect(b.input):this.audioSourceNode.connect(b):this.audioSourceNode.connect(d)},a.MediaElement.prototype.disconnect=function(){if(!this.audioSourceNode)throw"nothing to disconnect";this.audioSourceNode.disconnect()},a.MediaElement.prototype.showControls=function(){this.elt.style["text-align"]="inherit",this.elt.controls=!0},a.MediaElement.prototype.hideControls=function(){this.elt.controls=!1};var e=function(a,b,c,d){this.callback=a,this.time=b,this.id=c,this.val=d};a.MediaElement.prototype.addCue=function(a,b,c){var d=this._cueIDCounter++,f=new e(b,a,d,c);return this._cues.push(f),this.elt.ontimeupdate||(this.elt.ontimeupdate=this._onTimeUpdate.bind(this)),d},a.MediaElement.prototype.removeCue=function(a){for(var b=0;bEach color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.\nInternally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.
\nWe also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.
\n"
+ "description": "Each color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.
\nInternally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.
\nWe also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.
\n"
},
"Setting": {
"name": "Setting",
@@ -795,8 +836,8 @@ module.exports={
"2D Primitives": 1,
"Curves": 1,
"Vertex": 1,
- "3D Models": 1,
- "3D Primitives": 1
+ "3D Primitives": 1,
+ "3D Models": 1
},
"elements": {},
"classes": {},
@@ -817,7 +858,7 @@ module.exports={
"namespaces": {},
"module": "Shape",
"namespace": "",
- "file": "src/core/2d_primitives.js",
+ "file": "src/core/shape/2d_primitives.js",
"line": 1,
"requires": [
"core",
@@ -836,59 +877,62 @@ module.exports={
"namespaces": {},
"module": "Typography",
"namespace": "",
- "file": "src/core/attributes.js",
+ "file": "src/core/shape/attributes.js",
"line": 1,
"requires": [
"core",
"constants"
]
},
- "Constants": {
- "name": "Constants",
+ "Curves": {
+ "name": "Curves",
"submodules": {},
"elements": {},
"classes": {},
"fors": {
"p5": 1
},
+ "is_submodule": 1,
"namespaces": {},
- "module": "Constants",
- "file": "src/core/constants.js",
- "line": 1
+ "module": "Shape",
+ "namespace": "",
+ "file": "src/core/shape/curves.js",
+ "line": 1,
+ "requires": [
+ "core"
+ ]
},
- "Structure": {
- "name": "Structure",
+ "Vertex": {
+ "name": "Vertex",
"submodules": {},
"elements": {},
"classes": {},
"fors": {
"p5": 1
},
+ "is_submodule": 1,
"namespaces": {},
- "module": "Structure",
- "file": "src/core/core.js",
+ "module": "Shape",
+ "namespace": "",
+ "file": "src/core/shape/vertex.js",
"line": 1,
"requires": [
+ "core",
"constants"
]
},
- "Curves": {
- "name": "Curves",
+ "Constants": {
+ "name": "Constants",
"submodules": {},
"elements": {},
"classes": {},
"fors": {
"p5": 1
},
- "is_submodule": 1,
"namespaces": {},
- "module": "Shape",
- "namespace": "",
- "file": "src/core/curves.js",
- "line": 1,
- "requires": [
- "core"
- ]
+ "module": "Constants",
+ "file": "src/core/constants.js",
+ "line": 1
},
"Environment": {
"name": "Environment",
@@ -907,6 +951,22 @@ module.exports={
"constants"
]
},
+ "Structure": {
+ "name": "Structure",
+ "submodules": {},
+ "elements": {},
+ "classes": {},
+ "fors": {
+ "p5": 1
+ },
+ "namespaces": {},
+ "module": "IO",
+ "file": "src/core/main.js",
+ "line": 1,
+ "requires": [
+ "constants"
+ ]
+ },
"DOM": {
"name": "DOM",
"submodules": {},
@@ -920,14 +980,17 @@ module.exports={
"namespaces": {},
"module": "DOM",
"file": "src/core/p5.Element.js",
- "line": 9,
- "description": "Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.
\n"
+ "line": 11,
+ "description": "Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.
\n"
},
"Rendering": {
"name": "Rendering",
- "submodules": {},
+ "submodules": {
+ "undefined": 1
+ },
"elements": {},
"classes": {
+ "p5.RendererGL": 1,
"p5.Graphics": 1,
"p5.Renderer": 1
},
@@ -936,8 +999,8 @@ module.exports={
},
"namespaces": {},
"module": "Rendering",
- "file": "src/core/p5.Renderer.js",
- "line": 10,
+ "file": "src/webgl/p5.RendererGL.js",
+ "line": 427,
"description": "Thin wrapper around a renderer, to be used for creating a\ngraphics buffer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels. The fields and methods for this class are\nextensive, but mirror the normal drawing API for p5.
\n"
},
"Transform": {
@@ -957,30 +1020,12 @@ module.exports={
"constants"
]
},
- "Vertex": {
- "name": "Vertex",
- "submodules": {},
- "elements": {},
- "classes": {},
- "fors": {
- "p5": 1
- },
- "is_submodule": 1,
- "namespaces": {},
- "module": "Shape",
- "namespace": "",
- "file": "src/core/vertex.js",
- "line": 1,
- "requires": [
- "core",
- "constants"
- ]
- },
"Data": {
"name": "Data",
"submodules": {
"Dictionary": 1,
"Array Functions": 1,
+ "Conversion": 1,
"String Functions": 1
},
"elements": {},
@@ -995,7 +1040,7 @@ module.exports={
},
"namespaces": {},
"file": "src/data/p5.TypedDict.js",
- "line": 351
+ "line": 410
},
"Dictionary": {
"name": "Dictionary",
@@ -1007,19 +1052,19 @@ module.exports={
"p5.NumberDict": 1
},
"fors": {
- "p5.TypedDict": 1
+ "p5.TypedDict": 1,
+ "p5": 1
},
"is_submodule": 1,
"namespaces": {},
"module": "Data",
"namespace": "",
"file": "src/data/p5.TypedDict.js",
- "line": 351,
+ "line": 410,
"requires": [
- "core\n\nThis module defines the p5 methods for the p5 Dictionary classes\nthese classes StringDict and NumberDict are for storing and working\nwith key",
- "value pairs"
+ "core\n\nThis module defines the p5 methods for the p5 Dictionary classes.\nThe classes StringDict and NumberDict are for storing and working\nwith key-value pairs."
],
- "description": "Base class for all p5.Dictionary types. More specifically\n typed Dictionary objects inherit from this
\n"
+ "description": "Base class for all p5.Dictionary types. Specifically\n typed Dictionary classes inherit from this class.
\n"
},
"Events": {
"name": "Events",
@@ -1128,7 +1173,7 @@ module.exports={
"requires": [
"core"
],
- "description": "Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n
\np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n
\nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n
\nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.
\n"
+ "description": "Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n
\np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n
\nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n
\nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.
\n"
},
"Loading & Displaying": {
"name": "Loading & Displaying",
@@ -1169,7 +1214,7 @@ module.exports={
"IO": {
"name": "IO",
"submodules": {
- "Color Conversion": 1,
+ "Structure": 1,
"Input": 1,
"Output": 1,
"Table": 1,
@@ -1179,6 +1224,7 @@ module.exports={
"elements": {},
"classes": {
"p5": 1,
+ "p5.PrintWriter": 1,
"p5.Table": 1,
"p5.TableRow": 1,
"p5.XML": 1
@@ -1212,7 +1258,10 @@ module.exports={
"name": "Output",
"submodules": {},
"elements": {},
- "classes": {},
+ "classes": {
+ "p5": 1,
+ "p5.PrintWriter": 1
+ },
"fors": {
"p5": 1
},
@@ -1221,7 +1270,8 @@ module.exports={
"module": "IO",
"namespace": "",
"file": "src/io/files.js",
- "line": 1012
+ "line": 1242,
+ "description": "This is the p5 instance constructor.
\nA p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.
\nA p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object
\n"
},
"Table": {
"name": "Table",
@@ -1241,7 +1291,7 @@ module.exports={
"requires": [
"core"
],
- "description": "Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.
\n"
+ "description": "Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.
\n"
},
"XML": {
"name": "XML",
@@ -1260,7 +1310,7 @@ module.exports={
"requires": [
"core"
],
- "description": "XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.
\n"
+ "description": "XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.
\n"
},
"Math": {
"name": "Math",
@@ -1280,11 +1330,11 @@ module.exports={
"namespaces": {},
"module": "Math",
"file": "src/math/p5.Vector.js",
- "line": 13,
+ "line": 12,
"requires": [
"core"
],
- "description": "A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n
\nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n
\nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.
\n"
+ "description": "A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n
\nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n
\nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.
\n"
},
"Calculation": {
"name": "Calculation",
@@ -1356,7 +1406,6 @@ module.exports={
"line": 1,
"requires": [
"core",
- "polargeometry",
"constants"
]
},
@@ -1392,7 +1441,7 @@ module.exports={
"namespace": "",
"file": "src/typography/p5.Font.js",
"line": 21,
- "description": "This module defines the p5.Font class and functions for\ndrawing text to the display canvas.
\n",
+ "description": "This module defines the p5.Font class and functions for\ndrawing text to the display canvas.
\n",
"requires": [
"core",
"constants"
@@ -1416,6 +1465,24 @@ module.exports={
"core"
]
},
+ "Conversion": {
+ "name": "Conversion",
+ "submodules": {},
+ "elements": {},
+ "classes": {},
+ "fors": {
+ "p5": 1
+ },
+ "is_submodule": 1,
+ "namespaces": {},
+ "module": "Data",
+ "namespace": "",
+ "file": "src/utilities/conversion.js",
+ "line": 1,
+ "requires": [
+ "core"
+ ]
+ },
"String Functions": {
"name": "String Functions",
"submodules": {},
@@ -1452,30 +1519,55 @@ module.exports={
"core"
]
},
+ "3D Primitives": {
+ "name": "3D Primitives",
+ "submodules": {},
+ "elements": {},
+ "classes": {},
+ "fors": {
+ "p5": 1
+ },
+ "is_submodule": 1,
+ "namespaces": {},
+ "module": "Shape",
+ "namespace": "",
+ "file": "src/webgl/3d_primitives.js",
+ "line": 1,
+ "requires": [
+ "core",
+ "p5.Geometry"
+ ]
+ },
"Lights, Camera": {
"name": "Lights, Camera",
"submodules": {
- "Camera": 1,
+ "Interaction": 1,
"Lights": 1,
"Material": 1,
+ "Camera": 1,
"Shaders": 1
},
"elements": {},
"classes": {
+ "p5.Camera": 1,
"p5.Geometry": 1,
- "p5.RendererGL": 1,
+ "p5.Matrix": 1,
"p5.Shader": 1,
- "p5.Texture": 1
+ "p5.Texture": 1,
+ "ImageInfos": 1,
+ "FontInfo": 1,
+ "Cubic": 1
},
"fors": {
- "p5": 1
+ "p5": 1,
+ "p5.Camera": 1
},
"namespaces": {},
- "file": "src/webgl/p5.Texture.js",
- "line": 11
+ "file": "src/webgl/text.js",
+ "line": 259
},
- "Camera": {
- "name": "Camera",
+ "Interaction": {
+ "name": "Interaction",
"submodules": {},
"elements": {},
"classes": {},
@@ -1486,7 +1578,7 @@ module.exports={
"namespaces": {},
"module": "Lights, Camera",
"namespace": "",
- "file": "src/webgl/camera.js",
+ "file": "src/webgl/interaction.js",
"line": 1,
"requires": [
"core"
@@ -1544,50 +1636,53 @@ module.exports={
"module": "Lights, Camera",
"namespace": "",
"file": "src/webgl/p5.Texture.js",
- "line": 11,
+ "line": 14,
"requires": [
"core"
],
"description": "This module defines the p5.Texture class
\n"
},
- "Shaders": {
- "name": "Shaders",
+ "Camera": {
+ "name": "Camera",
"submodules": {},
"elements": {},
"classes": {
- "p5.Shader": 1
+ "p5.Camera": 1
},
"fors": {
- "p5": 1
+ "p5": 1,
+ "p5.Camera": 1
},
"is_submodule": 1,
"namespaces": {},
"module": "Lights, Camera",
"namespace": "",
- "file": "src/webgl/p5.Shader.js",
- "line": 11,
- "description": "This module defines the p5.Shader class
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 209,
"requires": [
"core"
- ]
+ ],
+ "description": "This class describes a camera for use in p5's\n\nWebGL mode. It contains camera position, orientation, and projection\ninformation necessary for rendering a 3D scene.
\nNew p5.Camera objects can be made through the\ncreateCamera() function and controlled through\nthe methods described below. A camera created in this way will use a default\nposition in the scene and a default perspective projection until these\nproperties are changed through the various methods available. It is possible\nto create multiple cameras, in which case the current camera\ncan be set through the setCamera() method.
\nNote:\nThe methods below operate in two coordinate systems: the 'world' coordinate\nsystem describe positions in terms of their relationship to the origin along\nthe X, Y and Z axes whereas the camera's 'local' coordinate system\ndescribes positions from the camera's point of view: left-right, up-down,\nand forward-backward. The move() method,\nfor instance, moves the camera along its own axes, whereas the\nsetPosition()\nmethod sets the camera's position in world-space.
\n"
},
- "3D Primitives": {
- "name": "3D Primitives",
+ "Shaders": {
+ "name": "Shaders",
"submodules": {},
"elements": {},
- "classes": {},
+ "classes": {
+ "p5.Shader": 1
+ },
"fors": {
"p5": 1
},
"is_submodule": 1,
"namespaces": {},
- "module": "Shape",
+ "module": "Lights, Camera",
"namespace": "",
- "file": "src/webgl/primitives.js",
- "line": 1,
+ "file": "src/webgl/p5.Shader.js",
+ "line": 13,
+ "description": "This module defines the p5.Shader class
\n",
"requires": [
- "core",
- "p5.Geometry"
+ "core"
]
},
"p5.dom": {
@@ -1595,19 +1690,18 @@ module.exports={
"submodules": {},
"elements": {},
"classes": {
- "p5.dom": 1,
"p5.MediaElement": 1,
"p5.File": 1
},
"fors": {
- "p5.dom": 1,
+ "p5": 1,
"p5.Element": 1
},
"namespaces": {},
"module": "p5.dom",
"file": "lib/addons/p5.dom.js",
- "line": 2482,
- "description": "The web is much more than just canvas and p5.dom makes it easy to interact\nwith other HTML5 objects, including text, hyperlink, image, input, video,\naudio, and webcam.
\nThere is a set of creation methods, DOM manipulation methods, and\nan extended p5.Element that supports a range of HTML elements. See the\n\nbeyond the canvas tutorial for a full overview of how this addon works.
\nMethods and properties shown in black are part of the p5.js core, items in\nblue are part of the p5.dom library. You will need to include an extra file\nin order to access the blue functions. See the\nusing a library\nsection for information on how to include this library. p5.dom comes with\np5 complete or you can download the single file\n\nhere.
\nSee tutorial: beyond the canvas\nfor more info on how to use this libary.
\n",
+ "line": 3083,
+ "description": "The web is much more than just canvas and p5.dom makes it easy to interact\nwith other HTML5 objects, including text, hyperlink, image, input, video,\naudio, and webcam.
\nThere is a set of creation methods, DOM manipulation methods, and\nan extended p5.Element that supports a range of HTML elements. See the\n\nbeyond the canvas tutorial for a full overview of how this addon works.
\nMethods and properties shown in black are part of the p5.js core, items in\nblue are part of the p5.dom library. You will need to include an extra file\nin order to access the blue functions. See the\nusing a library\nsection for information on how to include this library. p5.dom comes with\np5 complete or you can download the single file\n\nhere.
\nSee tutorial: beyond the canvas\nfor more info on how to use this libary.
\n",
"tag": "main",
"itemtype": "main"
},
@@ -1616,7 +1710,6 @@ module.exports={
"submodules": {},
"elements": {},
"classes": {
- "p5": 1,
"p5.sound": 1,
"p5.SoundFile": 1,
"p5.Amplitude": 1,
@@ -1627,7 +1720,7 @@ module.exports={
"p5.TriOsc": 1,
"p5.SawOsc": 1,
"p5.SqrOsc": 1,
- "p5.Env": 1,
+ "p5.Envelope": 1,
"p5.Pulse": 1,
"p5.Noise": 1,
"p5.AudioIn": 1,
@@ -1635,26 +1728,33 @@ module.exports={
"p5.Filter": 1,
"p5.LowPass": 1,
"p5.HighPass": 1,
- "BandPass": 1,
+ "p5.BandPass": 1,
+ "p5.EQ": 1,
+ "p5.Panner3D": 1,
"p5.Delay": 1,
"p5.Reverb": 1,
"p5.Convolver": 1,
"p5.Phrase": 1,
"p5.Part": 1,
"p5.Score": 1,
+ "p5.SoundLoop": 1,
"p5.Compressor": 1,
"p5.SoundRecorder": 1,
"p5.PeakDetect": 1,
"p5.Gain": 1,
+ "p5.AudioVoice": 1,
+ "p5.MonoSynth": 1,
+ "p5.PolySynth": 1,
"p5.Distortion": 1
},
"fors": {
- "p5.sound": 1
+ "p5.sound": 1,
+ "p5": 1
},
"namespaces": {},
"module": "p5.sound",
"file": "lib/addons/p5.sound.js",
- "line": 10410,
+ "line": 12501,
"description": "p5.sound extends p5 with Web Audio functionality including audio input,\nplayback, analysis and synthesis.\n
\np5.SoundFile: Load and play sound files.
\np5.Amplitude: Get the current volume of a sound.
\np5.AudioIn: Get sound from an input source, typically\n a computer microphone.
\np5.FFT: Analyze the frequency of sound. Returns\n results from the frequency spectrum or time domain (waveform).
\np5.Oscillator: Generate Sine,\n Triangle, Square and Sawtooth waveforms. Base class of\n p5.Noise and p5.Pulse.\n
\np5.Env: An Envelope is a series\n of fades over time. Often used to control an object's\n output gain level as an "ADSR Envelope" (Attack, Decay,\n Sustain, Release). Can also modulate other parameters.
\np5.Delay: A delay effect with\n parameters for feedback, delayTime, and lowpass filter.
\np5.Filter: Filter the frequency range of a\n sound.\n
\np5.Reverb: Add reverb to a sound by specifying\n duration and decay.
\np5.Convolver: Extends\np5.Reverb to simulate the sound of real\n physical spaces through convolution.
\np5.SoundRecorder: Record sound for playback\n / save the .wav file.\np5.Phrase, p5.Part and\np5.Score: Compose musical sequences.\n
\np5.sound is on GitHub.\nDownload the latest version\nhere.
\n",
"tag": "main",
"itemtype": "main"
@@ -1669,11 +1769,36 @@ module.exports={
"extensions": [],
"plugin_for": [],
"extension_for": [],
- "module": "p5.sound",
- "submodule": "p5.sound",
+ "module": "IO",
+ "submodule": "Output",
"namespace": "",
- "file": "lib/addons/p5.sound.js",
- "line": 409
+ "file": "src/core/main.js",
+ "line": 15,
+ "description": "This is the p5 instance constructor.
\nA p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.
\nA p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object
\n",
+ "is_constructor": 1,
+ "params": [
+ {
+ "name": "sketch",
+ "description": "a closure that can set optional preload(),\n setup(), and/or draw() properties on the\n given p5 instance
\n",
+ "type": "Function"
+ },
+ {
+ "name": "node",
+ "description": "element to attach canvas to, if a\n boolean is passed in use it as sync
\n",
+ "type": "HTMLElement|Boolean",
+ "optional": true
+ },
+ {
+ "name": "sync",
+ "description": "start synchronously (optional)
\n",
+ "type": "Boolean",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "a p5 instance",
+ "type": "P5"
+ }
},
"p5.Color": {
"name": "p5.Color",
@@ -1687,9 +1812,8 @@ module.exports={
"submodule": "Creating & Reading",
"namespace": "",
"file": "src/color/p5.Color.js",
- "line": 14,
- "description": "Each color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.
\nInternally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.
\nWe also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.
\n",
- "is_constructor": 1
+ "line": 16,
+ "description": "Each color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.
\nInternally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.
\nWe also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.
\n"
},
"p5.Element": {
"name": "p5.Element",
@@ -1703,9 +1827,8 @@ module.exports={
"submodule": "DOM",
"namespace": "",
"file": "src/core/p5.Element.js",
- "line": 9,
- "description": "Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.
\n",
- "is_constructor": 1,
+ "line": 11,
+ "description": "Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.
\n",
"params": [
{
"name": "elt",
@@ -1732,9 +1855,8 @@ module.exports={
"submodule": "Rendering",
"namespace": "",
"file": "src/core/p5.Graphics.js",
- "line": 10,
+ "line": 12,
"description": "Thin wrapper around a renderer, to be used for creating a\ngraphics buffer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels. The fields and methods for this class are\nextensive, but mirror the normal drawing API for p5.
\n",
- "is_constructor": 1,
"extends": "p5.Element",
"params": [
{
@@ -1772,7 +1894,7 @@ module.exports={
"submodule": "Rendering",
"namespace": "",
"file": "src/core/p5.Renderer.js",
- "line": 10,
+ "line": 12,
"description": "Main graphics and rendering context, as well as the base API\nimplementation for p5.js "core". To be used as the superclass for\nRenderer2D and Renderer3D classes, respecitvely.
\n",
"is_constructor": 1,
"extends": "p5.Element",
@@ -1808,9 +1930,8 @@ module.exports={
"submodule": "Dictionary",
"namespace": "",
"file": "src/data/p5.TypedDict.js",
- "line": 48,
- "description": "Base class for all p5.Dictionary types. More specifically\n typed Dictionary objects inherit from this
\n",
- "is_constructor": 1
+ "line": 84,
+ "description": "Base class for all p5.Dictionary types. Specifically\n typed Dictionary classes inherit from this class.
\n"
},
"p5.StringDict": {
"name": "p5.StringDict",
@@ -1824,9 +1945,8 @@ module.exports={
"submodule": "Dictionary",
"namespace": "",
"file": "src/data/p5.TypedDict.js",
- "line": 330,
- "description": "A Dictionary class for Strings.
\n",
- "is_constructor": 1,
+ "line": 391,
+ "description": "A simple Dictionary class for Strings.
\n",
"extends": "p5.TypedDict"
},
"p5.NumberDict": {
@@ -1841,9 +1961,8 @@ module.exports={
"submodule": "Dictionary",
"namespace": "",
"file": "src/data/p5.TypedDict.js",
- "line": 351,
+ "line": 410,
"description": "A simple Dictionary class for Numbers.
\n",
- "is_constructor": 1,
"extends": "p5.TypedDict"
},
"p5.Image": {
@@ -1859,8 +1978,10 @@ module.exports={
"namespace": "",
"file": "src/image/p5.Image.js",
"line": 23,
- "description": "Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n
\np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n
\nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n
\nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.
\n",
- "is_constructor": 1,
+ "description": "Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n
\np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n
\nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n
\nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.
\n",
+ "example": [
+ "\n\nfunction setup() {\n var img = createImage(100, 100); // same as new p5.Image(100, 100);\n img.loadPixels();\n createCanvas(100, 100);\n background(0);\n\n // helper for writing color to array\n function writeColor(image, x, y, red, green, blue, alpha) {\n var index = (x + y * width) * 4;\n image.pixels[index] = red;\n image.pixels[index + 1] = green;\n image.pixels[index + 2] = blue;\n image.pixels[index + 3] = alpha;\n }\n\n var x, y;\n // fill with random colors\n for (y = 0; y < img.height; y++) {\n for (x = 0; x < img.width; x++) {\n var red = random(255);\n var green = random(255);\n var blue = random(255);\n var alpha = 255;\n writeColor(img, x, y, red, green, blue, alpha);\n }\n }\n\n // draw a red line\n y = 0;\n for (x = 0; x < img.width; x++) {\n writeColor(img, x, y, 255, 0, 0, 255);\n }\n\n // draw a green line\n y = img.height - 1;\n for (x = 0; x < img.width; x++) {\n writeColor(img, x, y, 0, 255, 0, 255);\n }\n\n img.updatePixels();\n image(img, 0, 0);\n}\n"
+ ],
"params": [
{
"name": "width",
@@ -1874,6 +1995,33 @@ module.exports={
}
]
},
+ "p5.PrintWriter": {
+ "name": "p5.PrintWriter",
+ "shortname": "p5.PrintWriter",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "IO",
+ "submodule": "Output",
+ "namespace": "",
+ "file": "src/io/files.js",
+ "line": 1242,
+ "params": [
+ {
+ "name": "filename",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "extension",
+ "description": "",
+ "type": "String",
+ "optional": true
+ }
+ ]
+ },
"p5.Table": {
"name": "p5.Table",
"shortname": "p5.Table",
@@ -1886,8 +2034,8 @@ module.exports={
"submodule": "Table",
"namespace": "",
"file": "src/io/p5.Table.js",
- "line": 36,
- "description": "Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.
\n",
+ "line": 35,
+ "description": "Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.
\n",
"is_constructor": 1,
"params": [
{
@@ -1941,10 +2089,10 @@ module.exports={
"namespace": "",
"file": "src/io/p5.XML.js",
"line": 11,
- "description": "XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.
\n",
+ "description": "XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.
\n",
"is_constructor": 1,
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var children = xml.getChildren(\"animal\");\n\n for (var i = 0; i < children.length; i++) {\n var id = children[i].getNum(\"id\");\n var coloring = children[i].getString(\"species\");\n var name = children[i].getContent();\n print(id + \", \" + coloring + \", \" + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var children = xml.getChildren('animal');\n\n for (var i = 0; i < children.length; i++) {\n var id = children[i].getNum('id');\n var coloring = children[i].getString('species');\n var name = children[i].getContent();\n print(id + ', ' + coloring + ', ' + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n"
],
"alt": "no image displayed"
},
@@ -1960,9 +2108,8 @@ module.exports={
"submodule": "Math",
"namespace": "",
"file": "src/math/p5.Vector.js",
- "line": 13,
- "description": "A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n
\nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n
\nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.
\n",
- "is_constructor": 1,
+ "line": 12,
+ "description": "A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n
\nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n
\nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.
\n",
"params": [
{
"name": "x",
@@ -2002,7 +2149,6 @@ module.exports={
"file": "src/typography/p5.Font.js",
"line": 21,
"description": "Base class for font handling
\n",
- "is_constructor": 1,
"params": [
{
"name": "pInst",
@@ -2012,6 +2158,32 @@ module.exports={
}
]
},
+ "p5.Camera": {
+ "name": "p5.Camera",
+ "shortname": "p5.Camera",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "Lights, Camera",
+ "submodule": "Camera",
+ "namespace": "",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 209,
+ "description": "This class describes a camera for use in p5's\n\nWebGL mode. It contains camera position, orientation, and projection\ninformation necessary for rendering a 3D scene.
\nNew p5.Camera objects can be made through the\ncreateCamera() function and controlled through\nthe methods described below. A camera created in this way will use a default\nposition in the scene and a default perspective projection until these\nproperties are changed through the various methods available. It is possible\nto create multiple cameras, in which case the current camera\ncan be set through the setCamera() method.
\nNote:\nThe methods below operate in two coordinate systems: the 'world' coordinate\nsystem describe positions in terms of their relationship to the origin along\nthe X, Y and Z axes whereas the camera's 'local' coordinate system\ndescribes positions from the camera's point of view: left-right, up-down,\nand forward-backward. The move() method,\nfor instance, moves the camera along its own axes, whereas the\nsetPosition()\nmethod sets the camera's position in world-space.
\n",
+ "params": [
+ {
+ "name": "rendererGL",
+ "description": "instance of WebGL renderer
\n",
+ "type": "RendererGL"
+ }
+ ],
+ "example": [
+ "\n\n\nvar cam;\nvar delta = 0.01;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n // set initial pan angle\n cam.pan(-0.8);\n}\n\nfunction draw() {\n background(200);\n\n // pan camera according to angle 'delta'\n cam.pan(delta);\n\n // every 160 frames, switch direction\n if (frameCount % 160 === 0) {\n delta *= -1;\n }\n\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n"
+ ],
+ "alt": "camera view pans left and right across a series of rotating 3D boxes."
+ },
"p5.Geometry": {
"name": "p5.Geometry",
"shortname": "p5.Geometry",
@@ -2027,21 +2199,16 @@ module.exports={
"description": "p5 Geometry class
\n",
"is_constructor": 1,
"params": [
- {
- "name": "vertData",
- "description": "callback function or Object\n containing routine(s) for vertex data generation
\n",
- "type": "Function | Object"
- },
{
"name": "detailX",
"description": "number of vertices on horizontal surface
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
},
{
"name": "detailY",
"description": "number of vertices on horizontal surface
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
},
{
@@ -2052,25 +2219,6 @@ module.exports={
}
]
},
- "p5.RendererGL": {
- "name": "p5.RendererGL",
- "shortname": "p5.RendererGL",
- "classitems": [],
- "plugins": [],
- "extensions": [],
- "plugin_for": [],
- "extension_for": [],
- "module": "Lights, Camera",
- "namespace": "",
- "file": "src/webgl/p5.RendererGL.js",
- "line": 36,
- "description": "3D graphics class
\n",
- "is_constructor": 1,
- "extends": "p5.Renderer",
- "todo": [
- "extend class to include public method for offscreen\nrendering (FBO)."
- ]
- },
"p5.Shader": {
"name": "p5.Shader",
"shortname": "p5.Shader",
@@ -2083,9 +2231,8 @@ module.exports={
"submodule": "Shaders",
"namespace": "",
"file": "src/webgl/p5.Shader.js",
- "line": 11,
+ "line": 13,
"description": "Shader class for WEBGL Mode
\n",
- "is_constructor": 1,
"params": [
{
"name": "renderer",
@@ -2104,47 +2251,6 @@ module.exports={
}
]
},
- "p5.Texture": {
- "name": "p5.Texture",
- "shortname": "p5.Texture",
- "classitems": [],
- "plugins": [],
- "extensions": [],
- "plugin_for": [],
- "extension_for": [],
- "module": "Lights, Camera",
- "submodule": "Material",
- "namespace": "",
- "file": "src/webgl/p5.Texture.js",
- "line": 11,
- "description": "Texture class for WEBGL Mode
\n",
- "is_constructor": 1,
- "params": [
- {
- "name": "renderer",
- "description": "an instance of p5.RendererGL that\nwill provide the GL context for this new p5.Texture
\n",
- "type": "p5.RendererGL"
- },
- {
- "name": "obj",
- "description": "the\nobject containing the image data to store in the texture.
\n",
- "type": "p5.Image|p5.Graphics|p5.Element|p5.MediaElement",
- "optional": true
- }
- ]
- },
- "p5.dom": {
- "name": "p5.dom",
- "shortname": "p5.dom",
- "classitems": [],
- "plugins": [],
- "extensions": [],
- "plugin_for": [],
- "extension_for": [],
- "module": "p5.dom",
- "submodule": "p5.dom",
- "namespace": ""
- },
"p5.MediaElement": {
"name": "p5.MediaElement",
"shortname": "p5.MediaElement",
@@ -2157,8 +2263,8 @@ module.exports={
"submodule": "p5.dom",
"namespace": "",
"file": "lib/addons/p5.dom.js",
- "line": 1728,
- "description": "Extends p5.Element to handle audio and video. In addition to the methods\nof p5.Element, it also contains methods for controlling media. It is not\ncalled directly, but p5.MediaElements are created by calling createVideo,\ncreateAudio, and createCapture.
\n",
+ "line": 1975,
+ "description": "Extends p5.Element to handle audio and video. In addition to the methods\nof p5.Element, it also contains methods for controlling media. It is not\ncalled directly, but p5.MediaElements are created by calling createVideo,\ncreateAudio, and createCapture.
\n",
"is_constructor": 1,
"params": [
{
@@ -2180,7 +2286,7 @@ module.exports={
"submodule": "p5.dom",
"namespace": "",
"file": "lib/addons/p5.dom.js",
- "line": 2482,
+ "line": 3083,
"description": "Base class for a file\nUsing this for createFileInput
\n",
"is_constructor": 1,
"params": [
@@ -2215,7 +2321,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 754,
+ "line": 808,
"description": "SoundFile object with a path to a file.
\n\nThe p5.SoundFile may not be available immediately because\nit loads the file information asynchronously.
\n\nTo do something with the sound as soon as it loads\npass the name of a function as the second parameter.
\n\nOnly one file path is required. However, audio file formats\n(i.e. mp3, ogg, wav and m4a/aac) are not supported by all\nweb browsers. If you want to ensure compatability, instead of a single\nfile path, you may include an Array of filepaths, and the browser will\nchoose a format that works.
",
"is_constructor": 1,
"params": [
@@ -2259,7 +2365,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 2158,
+ "line": 2234,
"description": "Amplitude measures volume between 0.0 and 1.0.\nListens to all p5sound by default, or use setInput()\nto listen to a specific sound source. Accepts an optional\nsmoothing value, which defaults to 0.
\n",
"is_constructor": 1,
"params": [
@@ -2286,7 +2392,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 2430,
+ "line": 2513,
"description": "FFT (Fast Fourier Transform) is an analysis algorithm that\nisolates individual\n\naudio frequencies within a waveform.
\n\nOnce instantiated, a p5.FFT object can return an array based on\ntwo types of analyses:
• FFT.waveform() computes\namplitude values along the time domain. The array indices correspond\nto samples across a brief moment in time. Each value represents\namplitude of the waveform at that sample of time.
\n• FFT.analyze() computes amplitude values along the\nfrequency domain. The array indices correspond to frequencies (i.e.\npitches), from the lowest to the highest that humans can hear. Each\nvalue represents amplitude at that slice of the frequency spectrum.\nUse with getEnergy() to measure amplitude at specific\nfrequencies, or within a range of frequencies.
\n\nFFT analyzes a very short snapshot of sound called a sample\nbuffer. It returns an array of amplitude measurements, referred\nto as bins. The array is 1024 bins long by default.\nYou can change the bin array length, but it must be a power of 2\nbetween 16 and 1024 in order for the FFT algorithm to function\ncorrectly. The actual size of the FFT buffer is twice the\nnumber of bins, so given a standard sample rate, the buffer is\n2048/44100 seconds long.
",
"is_constructor": 1,
"params": [
@@ -2319,8 +2425,8 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 4274,
- "description": "p5.Signal is a constant audio-rate signal used by p5.Oscillator\nand p5.Envelope for modulation math.
\n\nThis is necessary because Web Audio is processed on a seprate clock.\nFor example, the p5 draw loop runs about 60 times per second. But\nthe audio clock must process samples 44100 times per second. If we\nwant to add a value to each of those samples, we can't do it in the\ndraw loop, but we can do it by adding a constant-rate audio signal.This class mostly functions behind the scenes in p5.sound, and returns\na Tone.Signal from the Tone.js library by Yotam Mann.\nIf you want to work directly with audio signals for modular\nsynthesis, check out\ntone.js.
",
+ "line": 4916,
+ "description": "p5.Signal is a constant audio-rate signal used by p5.Oscillator\nand p5.Envelope for modulation math.
\n\nThis is necessary because Web Audio is processed on a seprate clock.\nFor example, the p5 draw loop runs about 60 times per second. But\nthe audio clock must process samples 44100 times per second. If we\nwant to add a value to each of those samples, we can't do it in the\ndraw loop, but we can do it by adding a constant-rate audio signal.</p.\n\n
This class mostly functions behind the scenes in p5.sound, and returns\na Tone.Signal from the Tone.js library by Yotam Mann.\nIf you want to work directly with audio signals for modular\nsynthesis, check out\ntone.js.
",
"is_constructor": 1,
"return": {
"description": "A Signal object from the Tone.js library",
@@ -2342,7 +2448,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 4419,
+ "line": 5062,
"description": "Creates a signal that oscillates between -1.0 and 1.0.\nBy default, the oscillation takes the form of a sinusoidal\nshape ('sine'). Additional types include 'triangle',\n'sawtooth' and 'square'. The frequency defaults to\n440 oscillations per second (440Hz, equal to the pitch of an\n'A' note).
\n\nSet the type of oscillation with setType(), or by instantiating a\nspecific oscillator: p5.SinOsc, p5.TriOsc, p5.SqrOsc, or p5.SawOsc.\n
",
"is_constructor": 1,
"params": [
@@ -2360,7 +2466,7 @@ module.exports={
}
],
"example": [
- "\n\nvar osc;\nvar playing = false;\n\nfunction setup() {\n backgroundColor = color(255,0,255);\n textAlign(CENTER);\n\n osc = new p5.Oscillator();\n osc.setType('sine');\n osc.freq(240);\n osc.amp(0);\n osc.start();\n}\n\nfunction draw() {\n background(backgroundColor)\n text('click to play', width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {\n if (!playing) {\n // ramp amplitude to 0.5 over 0.1 seconds\n osc.amp(0.5, 0.05);\n playing = true;\n backgroundColor = color(0,255,255);\n } else {\n // ramp amplitude to 0 over 0.5 seconds\n osc.amp(0, 0.5);\n playing = false;\n backgroundColor = color(255,0,255);\n }\n }\n}\n "
+ "\n\nvar osc;\nvar playing = false;\n\nfunction setup() {\n backgroundColor = color(255,0,255);\n textAlign(CENTER);\n\n osc = new p5.Oscillator();\n osc.setType('sine');\n osc.freq(240);\n osc.amp(0);\n osc.start();\n}\n\nfunction draw() {\n background(backgroundColor)\n text('click to play', width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {\n if (!playing) {\n // ramp amplitude to 0.5 over 0.05 seconds\n osc.amp(0.5, 0.05);\n playing = true;\n backgroundColor = color(0,255,255);\n } else {\n // ramp amplitude to 0 over 0.5 seconds\n osc.amp(0, 0.5);\n playing = false;\n backgroundColor = color(255,0,255);\n }\n }\n}\n "
]
},
"p5.SinOsc": {
@@ -2375,10 +2481,10 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 4854,
+ "line": 5503,
"description": "Constructor: new p5.SinOsc().\nThis creates a Sine Wave Oscillator and is\nequivalent to new p5.Oscillator('sine')\n or creating a p5.Oscillator and then calling\nits method setType('sine').\nSee p5.Oscillator for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Oscillator}",
+ "extends": "p5.Oscillator",
"params": [
{
"name": "freq",
@@ -2400,10 +2506,10 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 4871,
+ "line": 5520,
"description": "Constructor: new p5.TriOsc().\nThis creates a Triangle Wave Oscillator and is\nequivalent to new p5.Oscillator('triangle')\n or creating a p5.Oscillator and then calling\nits method setType('triangle').\nSee p5.Oscillator for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Oscillator}",
+ "extends": "p5.Oscillator",
"params": [
{
"name": "freq",
@@ -2425,10 +2531,10 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 4888,
+ "line": 5537,
"description": "Constructor: new p5.SawOsc().\nThis creates a SawTooth Wave Oscillator and is\nequivalent to new p5.Oscillator('sawtooth')\n or creating a p5.Oscillator and then calling\nits method setType('sawtooth').\nSee p5.Oscillator for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Oscillator}",
+ "extends": "p5.Oscillator",
"params": [
{
"name": "freq",
@@ -2450,10 +2556,10 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 4905,
+ "line": 5554,
"description": "Constructor: new p5.SqrOsc().\nThis creates a Square Wave Oscillator and is\nequivalent to new p5.Oscillator('square')\n or creating a p5.Oscillator and then calling\nits method setType('square').\nSee p5.Oscillator for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Oscillator}",
+ "extends": "p5.Oscillator",
"params": [
{
"name": "freq",
@@ -2463,9 +2569,9 @@ module.exports={
}
]
},
- "p5.Env": {
- "name": "p5.Env",
- "shortname": "p5.Env",
+ "p5.Envelope": {
+ "name": "p5.Envelope",
+ "shortname": "p5.Envelope",
"classitems": [],
"plugins": [],
"extensions": [],
@@ -2475,11 +2581,11 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 5280,
- "description": "Envelopes are pre-defined amplitude distribution over time.\nTypically, envelopes are used to control the output volume\nof an object, a series of fades referred to as Attack, Decay,\nSustain and Release (\nADSR\n). Envelopes can also control other Web Audio Parameters—for example, a p5.Env can\ncontrol an Oscillator's frequency like this: osc.freq(env).
\nUse setRange to change the attack/release level.\nUse setADSR to change attackTime, decayTime, sustainPercent and releaseTime.
\nUse the play method to play the entire envelope,\nthe ramp method for a pingable trigger,\nor triggerAttack/\ntriggerRelease to trigger noteOn/noteOff.
",
+ "line": 6011,
+ "description": "Envelopes are pre-defined amplitude distribution over time.\nTypically, envelopes are used to control the output volume\nof an object, a series of fades referred to as Attack, Decay,\nSustain and Release (\nADSR\n). Envelopes can also control other Web Audio Parameters—for example, a p5.Envelope can\ncontrol an Oscillator's frequency like this: osc.freq(env).
\nUse setRange to change the attack/release level.\nUse setADSR to change attackTime, decayTime, sustainPercent and releaseTime.
\nUse the play method to play the entire envelope,\nthe ramp method for a pingable trigger,\nor triggerAttack/\ntriggerRelease to trigger noteOn/noteOff.
",
"is_constructor": 1,
"example": [
- "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"
+ "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"
]
},
"p5.Pulse": {
@@ -2494,7 +2600,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 6076,
+ "line": 6809,
"description": "Creates a Pulse object, an oscillator that implements\nPulse Width Modulation.\nThe pulse is created with two oscillators.\nAccepts a parameter for frequency, and to set the\nwidth between the pulses. See \np5.Oscillator for a full list of methods.
\n",
"extends": "p5.Oscillator",
"is_constructor": 1,
@@ -2528,7 +2634,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 6253,
+ "line": 6988,
"description": "Noise is a type of oscillator that generates a buffer with random values.
\n",
"extends": "p5.Oscillator",
"is_constructor": 1,
@@ -2552,7 +2658,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 6439,
+ "line": 7136,
"description": "Get audio from an input, i.e. your computer's microphone.
\n\nTurn the mic on/off with the start() and stop() methods. When the mic\nis on, its volume can be measured with getLevel or by connecting an\nFFT object.
\n\nIf you want to hear the AudioIn, use the .connect() method.\nAudioIn does not connect to p5.sound output by default to prevent\nfeedback.
\n\nNote: This uses the getUserMedia/\nStream API, which is not supported by certain browsers. Access in Chrome browser\nis limited to localhost and https, but access over http may be limited.
",
"is_constructor": 1,
"params": [
@@ -2579,8 +2685,8 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 7694,
- "description": "Effect is a base class for audio effects in p5.
\nThis module handles the nodes and methods that are \ncommon and useful for current and future effects.
\nThis class is extended by p5.Distortion, \np5.Compressor,\np5.Delay, \np5.Filter, \np5.Reverb.
\n",
+ "line": 8033,
+ "description": "Effect is a base class for audio effects in p5.
\nThis module handles the nodes and methods that are \ncommon and useful for current and future effects.
\nThis class is extended by p5.Distortion, \np5.Compressor,\np5.Delay, \np5.Filter, \np5.Reverb.
\n",
"is_constructor": 1,
"params": [
{
@@ -2592,13 +2698,13 @@ module.exports={
{
"name": "input",
"description": "Gain Node effect wrapper
\n",
- "type": "WebAudioNode",
+ "type": "AudioNode",
"optional": true
},
{
"name": "output",
"description": "Gain Node effect wrapper
\n",
- "type": "WebAudioNode",
+ "type": "AudioNode",
"optional": true
},
{
@@ -2610,7 +2716,7 @@ module.exports={
{
"name": "wet",
"description": "Effects that extend this class should connect\n to the wet signal to this gain node, so that dry and wet \n signals are mixed properly.
\n",
- "type": "WebAudioNode",
+ "type": "AudioNode",
"optional": true
}
]
@@ -2627,7 +2733,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 7825,
+ "line": 8175,
"description": "A p5.Filter uses a Web Audio Biquad Filter to filter\nthe frequency response of an input source. Subclasses\ninclude:
\n\np5.LowPass:\nAllows frequencies below the cutoff frequency to pass through,\nand attenuates frequencies above the cutoff.
p5.HighPass:\nThe opposite of a lowpass filter.
p5.BandPass:\nAllows a range of frequencies to pass through and attenuates\nthe frequencies below and above this frequency range.
\nThe .res() method controls either width of the\nbandpass, or resonance of the low/highpass cutoff frequency.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n",
"extends": "p5.Effect",
"is_constructor": 1,
@@ -2655,10 +2761,10 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 8015,
+ "line": 8407,
"description": "Constructor: new p5.LowPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('lowpass').\nSee p5.Filter for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Filter}"
+ "extends": "p5.Filter"
},
"p5.HighPass": {
"name": "p5.HighPass",
@@ -2672,14 +2778,14 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 8029,
+ "line": 8421,
"description": "Constructor: new p5.HighPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('highpass').\nSee p5.Filter for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Filter}"
+ "extends": "p5.Filter"
},
- "BandPass": {
- "name": "BandPass",
- "shortname": "BandPass",
+ "p5.BandPass": {
+ "name": "p5.BandPass",
+ "shortname": "p5.BandPass",
"classitems": [],
"plugins": [],
"extensions": [],
@@ -2689,10 +2795,58 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 8043,
+ "line": 8435,
"description": "Constructor: new p5.BandPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('bandpass').\nSee p5.Filter for methods.
\n",
"is_constructor": 1,
- "extends": "{p5.Filter}"
+ "extends": "p5.Filter"
+ },
+ "p5.EQ": {
+ "name": "p5.EQ",
+ "shortname": "p5.EQ",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "p5.sound",
+ "submodule": "p5.sound",
+ "namespace": "",
+ "file": "lib/addons/p5.sound.js",
+ "line": 8506,
+ "description": "p5.EQ is an audio effect that performs the function of a multiband\naudio equalizer. Equalization is used to adjust the balance of\nfrequency compoenents of an audio signal. This process is commonly used\nin sound production and recording to change the waveform before it reaches\na sound output device. EQ can also be used as an audio effect to create\ninteresting distortions by filtering out parts of the spectrum. p5.EQ is\nbuilt using a chain of Web Audio Biquad Filter Nodes and can be\ninstantiated with 3 or 8 bands. Bands can be added or removed from\nthe EQ by directly modifying p5.EQ.bands (the array that stores filters).
\nThis class extends p5.Effect.\nMethods amp(), chain(),\ndrywet(), connect(), and\ndisconnect() are available.
\n",
+ "is_constructor": 1,
+ "extends": "p5.Effect",
+ "params": [
+ {
+ "name": "_eqsize",
+ "description": "Constructor will accept 3 or 8, defaults to 3
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "p5.EQ object",
+ "type": "Object"
+ },
+ "example": [
+ "\n\nvar eq;\nvar band_names;\nvar band_index;\n\nvar soundFile, play;\n\nfunction preload() {\n soundFormats('mp3', 'ogg');\n soundFile = loadSound('assets/beat');\n}\n\nfunction setup() {\n eq = new p5.EQ(3);\n soundFile.disconnect();\n eq.process(soundFile);\n\n band_names = ['lows','mids','highs'];\n band_index = 0;\n play = false;\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(30);\n noStroke();\n fill(255);\n text('click to kill',50,25);\n\n fill(255, 40, 255);\n textSize(26);\n text(band_names[band_index],50,55);\n\n fill(255);\n textSize(9);\n text('space = play/pause',50,80);\n}\n\n//If mouse is over canvas, cycle to the next band and kill the frequency\nfunction mouseClicked() {\n for (var i = 0; i < eq.bands.length; i++) {\n eq.bands[i].gain(0);\n }\n eq.bands[band_index].gain(-40);\n if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {\n band_index === 2 ? band_index = 0 : band_index++;\n }\n}\n\n//use space bar to trigger play / pause\nfunction keyPressed() {\n if (key===' ') {\n play = !play\n play ? soundFile.loop() : soundFile.pause();\n }\n}\n"
+ ]
+ },
+ "p5.Panner3D": {
+ "name": "p5.Panner3D",
+ "shortname": "p5.Panner3D",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "p5.sound",
+ "submodule": "p5.sound",
+ "namespace": "",
+ "file": "lib/addons/p5.sound.js",
+ "line": 8698,
+ "description": "Panner3D is based on the \nWeb Audio Spatial Panner Node.\nThis panner is a spatial processing node that allows audio to be positioned\nand oriented in 3D space.
\nThe position is relative to an \nAudio Context Listener, which can be accessed\nby p5.soundOut.audiocontext.listener
\n",
+ "is_constructor": 1
},
"p5.Delay": {
"name": "p5.Delay",
@@ -2706,12 +2860,12 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 8064,
+ "line": 9149,
"description": "Delay is an echo effect. It processes an existing sound source,\nand outputs a delayed version of that sound. The p5.Delay can\nproduce different effects depending on the delayTime, feedback,\nfilter, and type. In the example below, a feedback of 0.5 (the\ndefaul value) will produce a looping delay that decreases in\nvolume by 50% each repeat. A filter will cut out the high\nfrequencies so that the delay does not sound as piercing as the\noriginal source.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n",
"extends": "p5.Effect",
"is_constructor": 1,
"example": [
- "\n\nvar noise, env, delay;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n noise = new p5.Noise('brown');\n noise.amp(0);\n noise.start();\n\n delay = new p5.Delay();\n\n // delay.process() accepts 4 parameters:\n // source, delayTime, feedback, filter frequency\n // play with these numbers!!\n delay.process(noise, .12, .7, 2300);\n\n // play the noise with an envelope,\n // a series of fades ( time / value pairs )\n env = new p5.Env(.01, 0.2, .2, .1);\n}\n\n// mouseClick triggers envelope\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(noise);\n }\n}\n"
+ "\n\nvar noise, env, delay;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n noise = new p5.Noise('brown');\n noise.amp(0);\n noise.start();\n\n delay = new p5.Delay();\n\n // delay.process() accepts 4 parameters:\n // source, delayTime, feedback, filter frequency\n // play with these numbers!!\n delay.process(noise, .12, .7, 2300);\n\n // play the noise with an envelope,\n // a series of fades ( time / value pairs )\n env = new p5.Envelope(.01, 0.2, .2, .1);\n}\n\n// mouseClick triggers envelope\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(noise);\n }\n}\n"
]
},
"p5.Reverb": {
@@ -2726,8 +2880,8 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 8341,
- "description": "Reverb adds depth to a sound through a large number of decaying\nechoes. It creates the perception that sound is occurring in a\nphysical space. The p5.Reverb has paramters for Time (how long does the\nreverb last) and decayRate (how much the sound decays with each echo)\nthat can be set with the .set() or .process() methods. The p5.Convolver\nextends p5.Reverb allowing you to recreate the sound of actual physical\nspaces through convolution.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n",
+ "line": 9426,
+ "description": "Reverb adds depth to a sound through a large number of decaying\nechoes. It creates the perception that sound is occurring in a\nphysical space. The p5.Reverb has paramters for Time (how long does the\nreverb last) and decayRate (how much the sound decays with each echo)\nthat can be set with the .set() or .process() methods. The p5.Convolver\nextends p5.Reverb allowing you to recreate the sound of actual physical\nspaces through convolution.
\nThis class extends p5.Effect.\nMethods amp(), chain(),\ndrywet(), connect(), and\ndisconnect() are available.
\n",
"extends": "p5.Effect",
"is_constructor": 1,
"example": [
@@ -2746,7 +2900,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 8501,
+ "line": 9586,
"description": "p5.Convolver extends p5.Reverb. It can emulate the sound of real\nphysical spaces through a process called \nconvolution.
\n\nConvolution multiplies any audio input by an "impulse response"\nto simulate the dispersion of sound over time. The impulse response is\ngenerated from an audio file that you provide. One way to\ngenerate an impulse response is to pop a balloon in a reverberant space\nand record the echo. Convolution can also be used to experiment with\nsound.
\n\nUse the method createConvolution(path) to instantiate a\np5.Convolver with a path to your impulse response audio file.
",
"extends": "p5.Effect",
"is_constructor": 1,
@@ -2785,7 +2939,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 9074,
+ "line": 10148,
"description": "A phrase is a pattern of musical events over time, i.e.\na series of notes and rests.
\n\nPhrases must be added to a p5.Part for playback, and\neach part can play multiple phrases at the same time.\nFor example, one Phrase might be a kick drum, another\ncould be a snare, and another could be the bassline.
\n\nThe first parameter is a name so that the phrase can be\nmodified or deleted later. The callback is a a function that\nthis phrase will call at every step—for example it might be\ncalled playNote(value){}. The array determines\nwhich value is passed into the callback at each step of the\nphrase. It can be numbers, an object with multiple numbers,\nor a zero (0) indicates a rest so the callback won't be called).
",
"is_constructor": 1,
"params": [
@@ -2821,7 +2975,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 9159,
+ "line": 10233,
"description": "A p5.Part plays back one or more p5.Phrases. Instantiate a part\nwith steps and tatums. By default, each step represents 1/16th note.
\n\nSee p5.Phrase for more about musical timing.
",
"is_constructor": 1,
"params": [
@@ -2854,7 +3008,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 9413,
+ "line": 10487,
"description": "A Score consists of a series of Parts. The parts will\nbe played back in order. For example, you could have an\nA part, a B part, and a C part, and play them back in this order\nnew p5.Score(a, a, b, a, c)
\n",
"is_constructor": 1,
"params": [
@@ -2867,6 +3021,38 @@ module.exports={
}
]
},
+ "p5.SoundLoop": {
+ "name": "p5.SoundLoop",
+ "shortname": "p5.SoundLoop",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "p5.sound",
+ "submodule": "p5.sound",
+ "namespace": "",
+ "file": "lib/addons/p5.sound.js",
+ "line": 10618,
+ "description": "SoundLoop
\n",
+ "is_constructor": 1,
+ "params": [
+ {
+ "name": "callback",
+ "description": "this function will be called on each iteration of theloop
\n",
+ "type": "Function"
+ },
+ {
+ "name": "interval",
+ "description": "amount of time or beats for each iteration of the loop\n defaults to 1
\n",
+ "type": "Number|String",
+ "optional": true
+ }
+ ],
+ "example": [
+ "\n\nvar click;\nvar looper1;\n\nfunction preload() {\n click = loadSound('assets/drum.mp3');\n}\n\nfunction setup() {\n //the looper's callback is passed the timeFromNow\n //this value should be used as a reference point from \n //which to schedule sounds \n looper1 = new p5.SoundLoop(function(timeFromNow){\n click.play(timeFromNow);\n background(255 * (looper1.iterations % 2));\n }, 2);\n\n //stop after 10 iteratios;\n looper1.maxIterations = 10;\n //start the loop\n looper1.start();\n}\n"
+ ]
+ },
"p5.Compressor": {
"name": "p5.Compressor",
"shortname": "p5.Compressor",
@@ -2879,7 +3065,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 9544,
+ "line": 10878,
"description": "Compressor is an audio effect class that performs dynamics compression\non an audio input source. This is a very commonly used technique in music\nand sound production. Compression creates an overall louder, richer, \nand fuller sound by lowering the volume of louds and raising that of softs.\nCompression can be used to avoid clipping (sound distortion due to \npeaks in volume) and is especially useful when many sounds are played \nat once. Compression can be used on indivudal sound sources in addition\nto the master output.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n",
"is_constructor": 1,
"extends": "p5.Effect"
@@ -2896,7 +3082,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 9750,
+ "line": 11089,
"description": "Record sounds for playback and/or to save as a .wav file.\nThe p5.SoundRecorder records all sound output from your sketch,\nor can be assigned a specific source with setInput().
\nThe record() method accepts a p5.SoundFile as a parameter.\nWhen playback is stopped (either after the given amount of time,\nor with the stop() method), the p5.SoundRecorder will send its\nrecording to that p5.SoundFile for playback.
",
"is_constructor": 1,
"example": [
@@ -2915,7 +3101,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 10039,
+ "line": 11378,
"description": "PeakDetect works in conjunction with p5.FFT to\nlook for onsets in some or all of the frequency spectrum.\n
\n\nTo use p5.PeakDetect, call update in the draw loop\nand pass in a p5.FFT object.\n
\n\nYou can listen for a specific part of the frequency spectrum by\nsetting the range between freq1 and freq2.\n
\n\nthreshold is the threshold for detecting a peak,\nscaled between 0 and 1. It is logarithmic, so 0.1 is half as loud\nas 1.0.
\n\n\nThe update method is meant to be run in the draw loop, and\nframes determines how many loops must pass before\nanother peak can be detected.\nFor example, if the frameRate() = 60, you could detect the beat of a\n120 beat-per-minute song with this equation:\n framesPerPeak = 60 / (estimatedBPM / 60 );\n
\n\n\nBased on example contribtued by @b2renger, and a simple beat detection\nexplanation by a\nhref="http://www.airtightinteractive.com/2013/10/making-audio-reactive-visuals/"\ntarget="_blank"Felix Turner.\n
",
"is_constructor": 1,
"params": [
@@ -2945,7 +3131,7 @@ module.exports={
}
],
"example": [
- "\n\n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 10;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n\n soundFile = loadSound('assets/beat.mp3');\n\n // p5.PeakDetect requires a p5.FFT\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n\n}\n\nfunction draw() {\n background(0);\n text('click to play/pause', width/2, height/2);\n\n // peakDetect accepts an fft post-analysis\n fft.analyze();\n peakDetect.update(fft);\n\n if ( peakDetect.isDetected ) {\n ellipseWidth = 50;\n } else {\n ellipseWidth *= 0.95;\n }\n\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// toggle play/stop when canvas is clicked\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n }\n}\n"
+ "\n\n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 10;\n\nfunction preload() {\n soundFile = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n\n // p5.PeakDetect requires a p5.FFT\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n}\n\nfunction draw() {\n background(0);\n text('click to play/pause', width/2, height/2);\n\n // peakDetect accepts an fft post-analysis\n fft.analyze();\n peakDetect.update(fft);\n\n if ( peakDetect.isDetected ) {\n ellipseWidth = 50;\n } else {\n ellipseWidth *= 0.95;\n }\n\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// toggle play/stop when canvas is clicked\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n }\n}\n"
]
},
"p5.Gain": {
@@ -2960,11 +3146,79 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 10259,
+ "line": 11602,
"description": "A gain node is usefull to set the relative volume of sound.\nIt's typically used to build mixers.
\n",
"is_constructor": 1,
"example": [
- "\n\n\n // load two soundfile and crossfade beetween them\n var sound1,sound2;\n var gain1, gain2, gain3;\n\n function preload(){\n soundFormats('ogg', 'mp3');\n sound1 = loadSound('../_files/Damscray_-_Dancing_Tiger_01');\n sound2 = loadSound('../_files/beat.mp3');\n }\n\n function setup() {\n createCanvas(400,200);\n\n // create a 'master' gain to which we will connect both soundfiles\n gain3 = new p5.Gain();\n gain3.connect();\n\n // setup first sound for playing\n sound1.rate(1);\n sound1.loop();\n sound1.disconnect(); // diconnect from p5 output\n\n gain1 = new p5.Gain(); // setup a gain node\n gain1.setInput(sound1); // connect the first sound to its input\n gain1.connect(gain3); // connect its output to the 'master'\n\n sound2.rate(1);\n sound2.disconnect();\n sound2.loop();\n\n gain2 = new p5.Gain();\n gain2.setInput(sound2);\n gain2.connect(gain3);\n\n }\n\n function draw(){\n background(180);\n\n // calculate the horizontal distance beetween the mouse and the right of the screen\n var d = dist(mouseX,0,width,0);\n\n // map the horizontal position of the mouse to values useable for volume control of sound1\n var vol1 = map(mouseX,0,width,0,1);\n var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa\n\n gain1.amp(vol1,0.5,0);\n gain2.amp(vol2,0.5,0);\n\n // map the vertical position of the mouse to values useable for 'master volume control'\n var vol3 = map(mouseY,0,height,0,1);\n gain3.amp(vol3,0.5,0);\n }\n\n"
+ "\n\n\n // load two soundfile and crossfade beetween them\n var sound1,sound2;\n var gain1, gain2, gain3;\n\n function preload(){\n soundFormats('ogg', 'mp3');\n sound1 = loadSound('assets/Damscray_-_Dancing_Tiger_01');\n sound2 = loadSound('assets/beat.mp3');\n }\n\n function setup() {\n createCanvas(400,200);\n\n // create a 'master' gain to which we will connect both soundfiles\n gain3 = new p5.Gain();\n gain3.connect();\n\n // setup first sound for playing\n sound1.rate(1);\n sound1.loop();\n sound1.disconnect(); // diconnect from p5 output\n\n gain1 = new p5.Gain(); // setup a gain node\n gain1.setInput(sound1); // connect the first sound to its input\n gain1.connect(gain3); // connect its output to the 'master'\n\n sound2.rate(1);\n sound2.disconnect();\n sound2.loop();\n\n gain2 = new p5.Gain();\n gain2.setInput(sound2);\n gain2.connect(gain3);\n\n }\n\n function draw(){\n background(180);\n\n // calculate the horizontal distance beetween the mouse and the right of the screen\n var d = dist(mouseX,0,width,0);\n\n // map the horizontal position of the mouse to values useable for volume control of sound1\n var vol1 = map(mouseX,0,width,0,1);\n var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa\n\n gain1.amp(vol1,0.5,0);\n gain2.amp(vol2,0.5,0);\n\n // map the vertical position of the mouse to values useable for 'master volume control'\n var vol3 = map(mouseY,0,height,0,1);\n gain3.amp(vol3,0.5,0);\n }\n\n"
+ ]
+ },
+ "p5.AudioVoice": {
+ "name": "p5.AudioVoice",
+ "shortname": "p5.AudioVoice",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "p5.sound",
+ "submodule": "p5.sound",
+ "namespace": "",
+ "file": "lib/addons/p5.sound.js",
+ "line": 11743,
+ "description": "Base class for monophonic synthesizers. Any extensions of this class\nshould follow the API and implement the methods below in order to \nremain compatible with p5.PolySynth();
\n",
+ "is_constructor": 1
+ },
+ "p5.MonoSynth": {
+ "name": "p5.MonoSynth",
+ "shortname": "p5.MonoSynth",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "p5.sound",
+ "submodule": "p5.sound",
+ "namespace": "",
+ "file": "lib/addons/p5.sound.js",
+ "line": 11796,
+ "description": "A MonoSynth is used as a single voice for sound synthesis.\nThis is a class to be used in conjunction with the PolySynth\nclass. Custom synthetisers should be built inheriting from\nthis class.
\n",
+ "is_constructor": 1,
+ "example": [
+ "\n\nvar monoSynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n monoSynth = new p5.MonoSynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // time from now (in seconds)\n var time = 0;\n // note duration (in seconds)\n var dur = 0.25;\n // velocity (volume, from 0 to 1)\n var v = 0.2;\n\n monoSynth.play(\"G3\", v, time, dur);\n monoSynth.play(\"C4\", v, time += dur, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n"
+ ]
+ },
+ "p5.PolySynth": {
+ "name": "p5.PolySynth",
+ "shortname": "p5.PolySynth",
+ "classitems": [],
+ "plugins": [],
+ "extensions": [],
+ "plugin_for": [],
+ "extension_for": [],
+ "module": "p5.sound",
+ "submodule": "p5.sound",
+ "namespace": "",
+ "file": "lib/addons/p5.sound.js",
+ "line": 12096,
+ "description": "An AudioVoice is used as a single voice for sound synthesis.\nThe PolySynth class holds an array of AudioVoice, and deals\nwith voices allocations, with setting notes to be played, and\nparameters to be set.
\n",
+ "is_constructor": 1,
+ "params": [
+ {
+ "name": "synthVoice",
+ "description": "A monophonic synth voice inheriting\n the AudioVoice class. Defaults to p5.MonoSynth
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "maxVoices",
+ "description": "Number of voices, defaults to 8;
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "example": [
+ "\n\nvar polySynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n polySynth = new p5.PolySynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // note duration (in seconds)\n var dur = 1.5;\n\n // time from now (in seconds)\n var time = 0;\n\n // velocity (volume, from 0 to 1)\n var vel = 0.1;\n\n // notes can overlap with each other\n polySynth.play(\"G2\", vel, 0, dur);\n polySynth.play(\"C3\", vel, time += 1/3, dur);\n polySynth.play(\"G3\", vel, time += 1/3, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n"
]
},
"p5.Distortion": {
@@ -2979,7 +3233,7 @@ module.exports={
"submodule": "p5.sound",
"namespace": "",
"file": "lib/addons/p5.sound.js",
- "line": 10410,
+ "line": 12501,
"description": "A Distortion effect created with a Waveshaper Node,\nwith an approach adapted from\nKevin Ennis
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n",
"extends": "p5.Effect",
"is_constructor": 1,
@@ -3006,57 +3260,57 @@ module.exports={
{
"file": "src/color/color_conversion.js",
"line": 10,
- "description": "Conversions adapted from http://www.easyrgb.com/math.html.
\nIn these functions, hue is always in the range [0,1); all other components\nare in the range [0,1]. 'Brightness' and 'value' are used interchangeably.
\n",
+ "description": "Conversions adapted from http://www.easyrgb.com/en/math.php.
\nIn these functions, hue is always in the range [0, 1], just like all other\ncomponents are in the range [0, 1]. 'Brightness' and 'value' are used\ninterchangeably.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
"file": "src/color/color_conversion.js",
- "line": 20,
+ "line": 21,
"description": "Convert an HSBA array to HSLA.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
"file": "src/color/color_conversion.js",
- "line": 46,
+ "line": 47,
"description": "Convert an HSBA array to RGBA.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
"file": "src/color/color_conversion.js",
- "line": 95,
+ "line": 102,
"description": "Convert an HSLA array to HSBA.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
"file": "src/color/color_conversion.js",
- "line": 118,
+ "line": 125,
"description": "Convert an HSLA array to RGBA.
\nWe need to change basis from HSLA to something that can be more easily be\nprojected onto RGBA. We will choose hue and brightness as our first two\ncomponents, and pick a convenient third one ('zest') so that we don't need\nto calculate formal HSBA saturation.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
"file": "src/color/color_conversion.js",
- "line": 176,
+ "line": 189,
"description": "Convert an RGBA array to HSBA.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
"file": "src/color/color_conversion.js",
- "line": 211,
+ "line": 228,
"description": "Convert an RGBA array to HSLA.
\n",
"class": "p5",
- "module": "Conversion",
+ "module": "Color",
"submodule": "Color Conversion"
},
{
@@ -3068,8 +3322,8 @@ module.exports={
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3077,7 +3331,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nnoStroke();\nc = color(0, 126, 255, 102);\nfill(c);\nrect(15, 15, 35, 70);\nvalue = alpha(c); // Sets 'value' to 102\nfill(value);\nrect(50, 15, 35, 70);\n\n"
+ "\n\n\nnoStroke();\nvar c = color(0, 126, 255, 102);\nfill(c);\nrect(15, 15, 35, 70);\nvar value = alpha(c); // Sets 'value' to 102\nfill(value);\nrect(50, 15, 35, 70);\n\n"
],
"alt": "Left half of canvas light blue and right half light charcoal grey.\nLeft half of canvas light purple and right half a royal blue.\nLeft half of canvas salmon pink and the right half white.\nYellow rect in middle right of canvas, with 55 pixel width and height.\nYellow ellipse in top left canvas, black ellipse in bottom right,both 80x80.\nBright fuschia rect in middle of canvas, 60 pixel width and height.\nTwo bright green rects on opposite sides of the canvas, both 45x80.\nFour blue rects in each corner of the canvas, each are 35x35.\nBright sea green rect on left and darker rect on right of canvas, both 45x80.\nDark green rect on left and light green rect on right of canvas, both 45x80.\nDark blue rect on left and light teal rect on right of canvas, both 45x80.\nblue rect on left and green on right, both with black outlines & 35x60.\nsalmon pink rect on left and black on right, both 35x60.\n4 rects, tan, brown, brownish purple and purple, with white outlines & 20x60.\nlight pastel green rect on left and dark grey rect on right, both 35x60.\nyellow rect on left and red rect on right, both with black outlines & 35x60.\ngrey canvas\ndeep pink rect on left and grey rect on right, both 35x60.",
"class": "p5",
@@ -3086,15 +3340,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 60,
+ "line": 61,
"description": "Extracts the blue value from a color or pixel array.
\n",
"itemtype": "method",
"name": "blue",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3102,7 +3356,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nc = color(175, 100, 220); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nblueValue = blue(c); // Get blue in 'c'\nprint(blueValue); // Prints \"220.0\"\nfill(0, 0, blueValue); // Use 'blueValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n"
+ "\n\n\nvar c = color(175, 100, 220); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nvar blueValue = blue(c); // Get blue in 'c'\nprint(blueValue); // Prints \"220.0\"\nfill(0, 0, blueValue); // Use 'blueValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n"
],
"alt": "Left half of canvas light purple and right half a royal blue.",
"class": "p5",
@@ -3111,15 +3365,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 89,
+ "line": 91,
"description": "Extracts the HSB brightness value from a color or pixel array.
\n",
"itemtype": "method",
"name": "brightness",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3127,7 +3381,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nnoStroke();\ncolorMode(HSB, 255);\nc = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = brightness(c); // Sets 'value' to 255\nfill(value);\nrect(50, 20, 35, 60);\n\n"
+ "\n\n\nnoStroke();\ncolorMode(HSB, 255);\nvar c = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvar value = brightness(c); // Sets 'value' to 255\nfill(value);\nrect(50, 20, 35, 60);\n\n"
],
"alt": "Left half of canvas salmon pink and the right half white.",
"class": "p5",
@@ -3136,8 +3390,8 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 118,
- "description": "Creates colors for storing in variables of the color datatype. The\nparameters are interpreted as RGB or HSB values depending on the\ncurrent colorMode(). The default mode is RGB values from 0 to 255\nand, therefore, the function call color(255, 204, 0) will return a\nbright yellow color.\n
\nNote that if only one value is provided to color(), it will be interpreted\nas a grayscale value. Add a second value, and it will be used for alpha\ntransparency. When three values are specified, they are interpreted as\neither RGB or HSB values. Adding a fourth value applies alpha\ntransparency.\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.
\n",
+ "line": 121,
+ "description": "Creates colors for storing in variables of the color datatype. The\nparameters are interpreted as RGB or HSB values depending on the\ncurrent colorMode(). The default mode is RGB values from 0 to 255\nand, therefore, the function call color(255, 204, 0) will return a\nbright yellow color.\n
\nNote that if only one value is provided to color(), it will be interpreted\nas a grayscale value. Add a second value, and it will be used for alpha\ntransparency. When three values are specified, they are interpreted as\neither RGB or HSB values. Adding a fourth value applies alpha\ntransparency.\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.
\n",
"itemtype": "method",
"name": "color",
"return": {
@@ -3145,7 +3399,7 @@ module.exports={
"type": "p5.Color"
},
"example": [
- "\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(30, 20, 55, 55); // Draw rectangle\n\n\n\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nellipse(25, 25, 80, 80); // Draw left circle\n\n// Using only one value with color()\n// generates a grayscale value.\nvar c = color(65); // Update 'c' with grayscale value\nfill(c); // Use updated 'c' as fill color\nellipse(75, 75, 80, 80); // Draw right circle\n\n\n\n\n\n// Named SVG & CSS colors may be used,\nvar c = color('magenta');\nfill(c); // Use 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(20, 20, 60, 60); // Draw rectangle\n\n\n\n\n\n// as can hex color codes:\nnoStroke(); // Don't draw a stroke around shapes\nvar c = color('#0f0');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('#00ff00');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\n// RGB and RGBA color strings are also supported:\n// these all set to the same color (solid blue)\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('rgb(0,0,255)');\nfill(c); // Use 'c' as fill color\nrect(10, 10, 35, 35); // Draw rectangle\n\nc = color('rgb(0%, 0%, 100%)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 35, 35); // Draw rectangle\n\nc = color('rgba(0, 0, 255, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(10, 55, 35, 35); // Draw rectangle\n\nc = color('rgba(0%, 0%, 100%, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 55, 35, 35); // Draw rectangle\n\n\n\n\n\n// HSL color is also supported and can be specified\n// by value\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsl(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsla(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\n// HSB color is also supported and can be specified\n// by value\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsb(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsba(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\nvar c; // Declare color 'c'\nnoStroke(); // Don't draw a stroke around shapes\n\n// If no colorMode is specified, then the\n// default of RGB with scale of 0-255 is used.\nc = color(50, 55, 100); // Create a color for 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(0, 10, 45, 80); // Draw left rect\n\ncolorMode(HSB, 100); // Use HSB with scale of 0-100\nc = color(50, 55, 100); // Update 'c' with new color\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw right rect\n\n"
+ "\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(30, 20, 55, 55); // Draw rectangle\n\n\n\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nellipse(25, 25, 80, 80); // Draw left circle\n\n// Using only one value with color()\n// generates a grayscale value.\nc = color(65); // Update 'c' with grayscale value\nfill(c); // Use updated 'c' as fill color\nellipse(75, 75, 80, 80); // Draw right circle\n\n\n\n\n\n// Named SVG & CSS colors may be used,\nvar c = color('magenta');\nfill(c); // Use 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(20, 20, 60, 60); // Draw rectangle\n\n\n\n\n\n// as can hex color codes:\nnoStroke(); // Don't draw a stroke around shapes\nvar c = color('#0f0');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('#00ff00');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\n// RGB and RGBA color strings are also supported:\n// these all set to the same color (solid blue)\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('rgb(0,0,255)');\nfill(c); // Use 'c' as fill color\nrect(10, 10, 35, 35); // Draw rectangle\n\nc = color('rgb(0%, 0%, 100%)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 35, 35); // Draw rectangle\n\nc = color('rgba(0, 0, 255, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(10, 55, 35, 35); // Draw rectangle\n\nc = color('rgba(0%, 0%, 100%, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 55, 35, 35); // Draw rectangle\n\n\n\n\n\n// HSL color is also supported and can be specified\n// by value\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsl(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsla(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\n// HSB color is also supported and can be specified\n// by value\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsb(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsba(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\nvar c; // Declare color 'c'\nnoStroke(); // Don't draw a stroke around shapes\n\n// If no colorMode is specified, then the\n// default of RGB with scale of 0-255 is used.\nc = color(50, 55, 100); // Create a color for 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(0, 10, 45, 80); // Draw left rect\n\ncolorMode(HSB, 100); // Use HSB with scale of 0-100\nc = color(50, 55, 100); // Update 'c' with new color\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw right rect\n\n"
],
"alt": "Yellow rect in middle right of canvas, with 55 pixel width and height.\nYellow ellipse in top left of canvas, black ellipse in bottom right,both 80x80.\nBright fuschia rect in middle of canvas, 60 pixel width and height.\nTwo bright green rects on opposite sides of the canvas, both 45x80.\nFour blue rects in each corner of the canvas, each are 35x35.\nBright sea green rect on left and darker rect on right of canvas, both 45x80.\nDark green rect on left and lighter green rect on right of canvas, both 45x80.\nDark blue rect on left and light teal rect on right of canvas, both 45x80.",
"class": "p5",
@@ -3153,7 +3407,7 @@ module.exports={
"submodule": "Creating & Reading",
"overloads": [
{
- "line": 118,
+ "line": 121,
"params": [
{
"name": "gray",
@@ -3173,7 +3427,7 @@ module.exports={
}
},
{
- "line": 277,
+ "line": 280,
"params": [
{
"name": "v1",
@@ -3203,18 +3457,12 @@ module.exports={
}
},
{
- "line": 289,
+ "line": 292,
"params": [
{
"name": "value",
"description": "a color string
\n",
"type": "String"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
}
],
"return": {
@@ -3223,12 +3471,12 @@ module.exports={
}
},
{
- "line": 295,
+ "line": 297,
"params": [
{
"name": "values",
"description": "an array containing the red,green,blue &\n and alpha components of the color
\n",
- "type": "Array"
+ "type": "Number[]"
}
],
"return": {
@@ -3237,7 +3485,7 @@ module.exports={
}
},
{
- "line": 301,
+ "line": 303,
"params": [
{
"name": "color",
@@ -3254,15 +3502,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 326,
+ "line": 319,
"description": "Extracts the green value from a color or pixel array.
\n",
"itemtype": "method",
"name": "green",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3270,7 +3518,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nc = color(20, 75, 200); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\ngreenValue = green(c); // Get green in 'c'\nprint(greenValue); // Print \"75.0\"\nfill(0, greenValue, 0); // Use 'greenValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n"
+ "\n\n\nvar c = color(20, 75, 200); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nvar greenValue = green(c); // Get green in 'c'\nprint(greenValue); // Print \"75.0\"\nfill(0, greenValue, 0); // Use 'greenValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n"
],
"alt": "blue rect on left and green on right, both with black outlines & 35x60.",
"class": "p5",
@@ -3279,15 +3527,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 356,
+ "line": 350,
"description": "Extracts the hue value from a color or pixel array.
\nHue exists in both HSB and HSL. This function will return the\nHSB-normalized hue when supplied with an HSB color object (or when supplied\nwith a pixel array while the color mode is HSB), but will default to the\nHSL-normalized hue otherwise. (The values will only be different if the\nmaximum hue setting for each system is different.)
\n",
"itemtype": "method",
"name": "hue",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3295,7 +3543,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nnoStroke();\ncolorMode(HSB, 255);\nc = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = hue(c); // Sets 'value' to \"0\"\nfill(value);\nrect(50, 20, 35, 60);\n\n"
+ "\n\n\nnoStroke();\ncolorMode(HSB, 255);\nvar c = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvar value = hue(c); // Sets 'value' to \"0\"\nfill(value);\nrect(50, 20, 35, 60);\n\n"
],
"alt": "salmon pink rect on left and black on right, both 35x60.",
"class": "p5",
@@ -3304,8 +3552,8 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 392,
- "description": "Blends two colors to find a third color somewhere between them. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first color, 0.1 is very near the first color, 0.5 is halfway\nin between, etc. An amount below 0 will be treated as 0. Likewise, amounts\nabove 1 will be capped at 1. This is different from the behavior of lerp(),\nbut necessary because otherwise numbers outside the range will produce\nstrange and unexpected colors.\n
\nThe way that colours are interpolated depends on the current color mode.
\n",
+ "line": 387,
+ "description": "Blends two colors to find a third color somewhere between them. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first color, 0.1 is very near the first color, 0.5 is halfway\nin between, etc. An amount below 0 will be treated as 0. Likewise, amounts\nabove 1 will be capped at 1. This is different from the behavior of lerp(),\nbut necessary because otherwise numbers outside the range will produce\nstrange and unexpected colors.\n
\nThe way that colours are interpolated depends on the current color mode.
\n",
"itemtype": "method",
"name": "lerpColor",
"params": [
@@ -3330,7 +3578,7 @@ module.exports={
"type": "p5.Color"
},
"example": [
- "\n\n\ncolorMode(RGB);\nstroke(255);\nbackground(51);\nfrom = color(218, 165, 32);\nto = color(72, 61, 139);\ncolorMode(RGB); // Try changing to HSB.\ninterA = lerpColor(from, to, .33);\ninterB = lerpColor(from, to, .66);\nfill(from);\nrect(10, 20, 20, 60);\nfill(interA);\nrect(30, 20, 20, 60);\nfill(interB);\nrect(50, 20, 20, 60);\nfill(to);\nrect(70, 20, 20, 60);\n\n"
+ "\n\n\ncolorMode(RGB);\nstroke(255);\nbackground(51);\nvar from = color(218, 165, 32);\nvar to = color(72, 61, 139);\ncolorMode(RGB); // Try changing to HSB.\nvar interA = lerpColor(from, to, 0.33);\nvar interB = lerpColor(from, to, 0.66);\nfill(from);\nrect(10, 20, 20, 60);\nfill(interA);\nrect(30, 20, 20, 60);\nfill(interB);\nrect(50, 20, 20, 60);\nfill(to);\nrect(70, 20, 20, 60);\n\n"
],
"alt": "4 rects one tan, brown, brownish purple, purple, with white outlines & 20x60",
"class": "p5",
@@ -3339,15 +3587,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 489,
+ "line": 484,
"description": "Extracts the HSL lightness value from a color or pixel array.
\n",
"itemtype": "method",
"name": "lightness",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3355,7 +3603,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nnoStroke();\ncolorMode(HSL);\nc = color(156, 100, 50, 1);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = lightness(c); // Sets 'value' to 50\nfill(value);\nrect(50, 20, 35, 60);\n\n"
+ "\n\n\nnoStroke();\ncolorMode(HSL);\nvar c = color(156, 100, 50, 1);\nfill(c);\nrect(15, 20, 35, 60);\nvar value = lightness(c); // Sets 'value' to 50\nfill(value);\nrect(50, 20, 35, 60);\n\n"
],
"alt": "light pastel green rect on left and dark grey rect on right, both 35x60.",
"class": "p5",
@@ -3364,15 +3612,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 518,
+ "line": 514,
"description": "Extracts the red value from a color or pixel array.
\n",
"itemtype": "method",
"name": "red",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3380,7 +3628,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nc = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nredValue = red(c); // Get red in 'c'\nprint(redValue); // Print \"255.0\"\nfill(redValue, 0, 0); // Use 'redValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n\n\n\n\ncolorMode(RGB, 255);\nvar c = color(127, 255, 0);\ncolorMode(RGB, 1);\nvar myColor = red(c);\nprint(myColor);\n\n"
+ "\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nvar redValue = red(c); // Get red in 'c'\nprint(redValue); // Print \"255.0\"\nfill(redValue, 0, 0); // Use 'redValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n\n\n\n\ncolorMode(RGB, 255);\nvar c = color(127, 255, 0);\ncolorMode(RGB, 1);\nvar myColor = red(c);\nprint(myColor);\n\n"
],
"alt": "yellow rect on left and red rect on right, both with black outlines and 35x60.\ngrey canvas",
"class": "p5",
@@ -3389,15 +3637,15 @@ module.exports={
},
{
"file": "src/color/creating_reading.js",
- "line": 557,
+ "line": 554,
"description": "Extracts the saturation value from a color or pixel array.
\nSaturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object (or when supplied\nwith a pixel array while the color mode is HSB), but will default to the\nHSL saturation otherwise.
\n",
"itemtype": "method",
"name": "saturation",
"params": [
{
"name": "color",
- "description": "p5.Color object or pixel array
\n",
- "type": "p5.Color|Array"
+ "description": "p5.Color object, color components,\n or CSS color
\n",
+ "type": "p5.Color|Number[]|String"
}
],
"return": {
@@ -3405,7 +3653,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nnoStroke();\ncolorMode(HSB, 255);\nc = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = saturation(c); // Sets 'value' to 126\nfill(value);\nrect(50, 20, 35, 60);\n\n"
+ "\n\n\nnoStroke();\ncolorMode(HSB, 255);\nvar c = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvar value = saturation(c); // Sets 'value' to 126\nfill(value);\nrect(50, 20, 35, 60);\n\n"
],
"alt": "deep pink rect on left and grey rect on right, both 35x60.",
"class": "p5",
@@ -3414,72 +3662,153 @@ module.exports={
},
{
"file": "src/color/p5.Color.js",
- "line": 118,
- "description": "Hue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.
\n",
- "class": "p5.Color",
- "module": "Color",
- "submodule": "Creating & Reading"
- },
- {
- "file": "src/color/p5.Color.js",
- "line": 149,
- "description": "Saturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.
\n",
+ "line": 52,
+ "description": "This function returns the color formatted as a string. This can be useful\nfor debugging, or for using p5.js with other libraries.
\n",
+ "itemtype": "method",
+ "name": "toString",
+ "params": [
+ {
+ "name": "format",
+ "description": "How the color string will be formatted.\nLeaving this empty formats the string as rgba(r, g, b, a).\n'#rgb' '#rgba' '#rrggbb' and '#rrggbbaa' format as hexadecimal color codes.\n'rgb' 'hsb' and 'hsl' return the color formatted in the specified color mode.\n'rgba' 'hsba' and 'hsla' are the same as above but with alpha channels.\n'rgb%' 'hsb%' 'hsl%' 'rgba%' 'hsba%' and 'hsla%' format as percentages.
\n",
+ "type": "String",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "the formatted string",
+ "type": "String"
+ },
+ "example": [
+ "\n\n\nvar myColor;\nfunction setup() {\n createCanvas(200, 200);\n stroke(255);\n myColor = color(100, 100, 250);\n fill(myColor);\n}\n\nfunction draw() {\n rotate(HALF_PI);\n text(myColor.toString(), 0, -5);\n text(myColor.toString('#rrggbb'), 0, -30);\n text(myColor.toString('rgba%'), 0, -55);\n}\n\n"
+ ],
+ "alt": "canvas with text representation of color",
"class": "p5.Color",
"module": "Color",
"submodule": "Creating & Reading"
},
{
"file": "src/color/p5.Color.js",
- "line": 168,
- "description": "CSS named colors.
\n",
+ "line": 248,
+ "itemtype": "method",
+ "name": "setRed",
+ "params": [
+ {
+ "name": "red",
+ "description": "the new red value
\n",
+ "type": "Number"
+ }
+ ],
+ "example": [
+ "\n\n\nvar backgroundColor;\n\nfunction setup() {\n backgroundColor = color(100, 50, 150);\n}\n\nfunction draw() {\n backgroundColor.setRed(128 + 128 * sin(millis() / 1000));\n background(backgroundColor);\n}\n\n"
+ ],
+ "alt": "canvas with gradually changing background color",
"class": "p5.Color",
"module": "Color",
"submodule": "Creating & Reading"
},
{
"file": "src/color/p5.Color.js",
- "line": 321,
- "description": "These regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.
\nNote that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.
\n",
+ "line": 275,
+ "itemtype": "method",
+ "name": "setGreen",
+ "params": [
+ {
+ "name": "green",
+ "description": "the new green value
\n",
+ "type": "Number"
+ }
+ ],
+ "example": [
+ "\n\n\nvar backgroundColor;\n\nfunction setup() {\n backgroundColor = color(100, 50, 150);\n}\n\nfunction draw() {\n backgroundColor.setGreen(128 + 128 * sin(millis() / 1000));\n background(backgroundColor);\n}\n\n"
+ ],
+ "alt": "canvas with gradually changing background color",
"class": "p5.Color",
"module": "Color",
"submodule": "Creating & Reading"
},
{
"file": "src/color/p5.Color.js",
- "line": 334,
- "description": "Full color string patterns. The capture groups are necessary.
\n",
+ "line": 302,
+ "itemtype": "method",
+ "name": "setBlue",
+ "params": [
+ {
+ "name": "blue",
+ "description": "the new blue value
\n",
+ "type": "Number"
+ }
+ ],
+ "example": [
+ "\n\n\nvar backgroundColor;\n\nfunction setup() {\n backgroundColor = color(100, 50, 150);\n}\n\nfunction draw() {\n backgroundColor.setBlue(128 + 128 * sin(millis() / 1000));\n background(backgroundColor);\n}\n\n"
+ ],
+ "alt": "canvas with gradually changing background color",
"class": "p5.Color",
"module": "Color",
"submodule": "Creating & Reading"
},
{
"file": "src/color/p5.Color.js",
- "line": 447,
- "description": "For a number of different inputs, returns a color formatted as [r, g, b, a]\narrays, with each component normalized between 0 and 1.
\n",
+ "line": 329,
+ "itemtype": "method",
+ "name": "setAlpha",
"params": [
{
- "name": "args",
- "description": "An 'array-like' object that represents a list of\n arguments
\n",
- "type": "Array",
- "optional": true,
- "multiple": true
+ "name": "alpha",
+ "description": "the new alpha value
\n",
+ "type": "Number"
}
],
- "return": {
- "description": "a color formatted as [r, g, b, a]\n Example:\n input ==> output\n g ==> [g, g, g, 255]\n g,a ==> [g, g, g, a]\n r, g, b ==> [r, g, b, 255]\n r, g, b, a ==> [r, g, b, a]\n [g] ==> [g, g, g, 255]\n [g, a] ==> [g, g, g, a]\n [r, g, b] ==> [r, g, b, 255]\n [r, g, b, a] ==> [r, g, b, a]",
- "type": "Number[]"
- },
"example": [
- "\n\n\n// todo\n\n"
+ "\n\n\nvar squareColor;\n\nfunction setup() {\n ellipseMode(CORNERS);\n strokeWeight(4);\n squareColor = color(100, 50, 150);\n}\n\nfunction draw() {\n background(255);\n\n noFill();\n stroke(0);\n ellipse(10, 10, width - 10, height - 10);\n\n squareColor.setAlpha(128 + 128 * sin(millis() / 1000));\n fill(squareColor);\n noStroke();\n rect(13, 13, width - 26, height - 26);\n}\n\n"
],
- "alt": "//todo",
+ "alt": "circle behind a square with gradually changing opacity",
"class": "p5.Color",
"module": "Color",
"submodule": "Creating & Reading"
},
{
"file": "src/color/p5.Color.js",
- "line": 638,
+ "line": 410,
+ "description": "Hue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.
\n",
+ "class": "p5.Color",
+ "module": "Color",
+ "submodule": "Creating & Reading"
+ },
+ {
+ "file": "src/color/p5.Color.js",
+ "line": 441,
+ "description": "Saturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.
\n",
+ "class": "p5.Color",
+ "module": "Color",
+ "submodule": "Creating & Reading"
+ },
+ {
+ "file": "src/color/p5.Color.js",
+ "line": 460,
+ "description": "CSS named colors.
\n",
+ "class": "p5.Color",
+ "module": "Color",
+ "submodule": "Creating & Reading"
+ },
+ {
+ "file": "src/color/p5.Color.js",
+ "line": 613,
+ "description": "These regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.
\nNote that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.
\n",
+ "class": "p5.Color",
+ "module": "Color",
+ "submodule": "Creating & Reading"
+ },
+ {
+ "file": "src/color/p5.Color.js",
+ "line": 626,
+ "description": "Full color string patterns. The capture groups are necessary.
\n",
+ "class": "p5.Color",
+ "module": "Color",
+ "submodule": "Creating & Reading"
+ },
+ {
+ "file": "src/color/p5.Color.js",
+ "line": 989,
"description": "For HSB and HSL, interpret the gray level as a brightness/lightness\nvalue (they are equivalent when chroma is zero). For RGB, normalize the\ngray level according to the blue maximum.
\n",
"class": "p5.Color",
"module": "Color",
@@ -3488,7 +3817,7 @@ module.exports={
{
"file": "src/color/setting.js",
"line": 15,
- "description": "The background() function sets the color used for the background of the\np5.js canvas. The default background is light gray. This function is\ntypically used within draw() to clear the display window at the beginning\nof each frame, but it can be used inside setup() to set the background on\nthe first frame of animation or if the background need only be set once.\n
\nThe color is either specified in terms of the RGB, HSB, or HSL color\ndepending on the current colorMode. (The default color space is RGB, with\neach value in the range from 0 to 255).\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n
\nA p5.Color object can also be provided to set the background color.\n
\nA p5.Image can also be provided to set the background iamge.
\n",
+ "description": "The background() function sets the color used for the background of the\np5.js canvas. The default background is light gray. This function is\ntypically used within draw() to clear the display window at the beginning\nof each frame, but it can be used inside setup() to set the background on\nthe first frame of animation or if the background need only be set once.\n
\nThe color is either specified in terms of the RGB, HSB, or HSL color\ndepending on the current colorMode. (The default color space is RGB, with\neach value in the range from 0 to 255). The alpha range by default is also 0 to 255.\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n
\nA p5.Color object can also be provided to set the background color.\n
\nA p5.Image can also be provided to set the background image.
\n",
"itemtype": "method",
"name": "background",
"chainable": 1,
@@ -3505,20 +3834,14 @@ module.exports={
"params": [
{
"name": "color",
- "description": "any value created by the color() function
\n",
+ "description": "any value created by the color() function
\n",
"type": "p5.Color"
- },
- {
- "name": "a",
- "description": "opacity of the background relative to current\n color range (default is 0-100)
\n",
- "type": "Number",
- "optional": true
}
],
"chainable": 1
},
{
- "line": 133,
+ "line": 131,
"params": [
{
"name": "colorstring",
@@ -3527,7 +3850,7 @@ module.exports={
},
{
"name": "a",
- "description": "",
+ "description": "opacity of the background relative to current\n color range (default is 0-255)
\n",
"type": "Number",
"optional": true
}
@@ -3535,7 +3858,7 @@ module.exports={
"chainable": 1
},
{
- "line": 142,
+ "line": 141,
"params": [
{
"name": "gray",
@@ -3552,7 +3875,7 @@ module.exports={
"chainable": 1
},
{
- "line": 149,
+ "line": 148,
"params": [
{
"name": "v1",
@@ -3579,11 +3902,22 @@ module.exports={
"chainable": 1
},
{
- "line": 161,
+ "line": 160,
+ "params": [
+ {
+ "name": "values",
+ "description": "an array containing the red,green,blue &\n and alpha components of the color
\n",
+ "type": "Number[]"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 167,
"params": [
{
"name": "image",
- "description": "image created with loadImage() or createImage(),\n to set as background\n (must be same size as the sketch window)
\n",
+ "description": "image created with loadImage() or createImage(),\n to set as background\n (must be same size as the sketch window)
\n",
"type": "p5.Image"
},
{
@@ -3599,8 +3933,8 @@ module.exports={
},
{
"file": "src/color/setting.js",
- "line": 178,
- "description": "Clears the pixels within a buffer. This function only works on p5.Canvas\nobjects created with the createCanvas() function; it won't work with the\nmain display window. Unlike the main graphics context, pixels in\nadditional graphics areas created with createGraphics() can be entirely\nor partially transparent. This function clears everything to make all of\nthe pixels 100% transparent.
\n",
+ "line": 185,
+ "description": "Clears the pixels within a buffer. This function only works on p5.Canvas\nobjects created with the createCanvas() function; it won't work with the\nmain display window. Unlike the main graphics context, pixels in\nadditional graphics areas created with createGraphics() can be entirely\nor partially transparent. This function clears everything to make all of\nthe pixels 100% transparent.
\n",
"itemtype": "method",
"name": "clear",
"chainable": 1,
@@ -3614,17 +3948,21 @@ module.exports={
},
{
"file": "src/color/setting.js",
- "line": 216,
- "description": "colorMode() changes the way p5.js interprets color data. By default, the\nparameters for fill(), stroke(), background(), and color() are defined by\nvalues between 0 and 255 using the RGB color model. This is equivalent to\nsetting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB\nsystem instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You\ncan also use HSL.\n
\nNote: existing color objects remember the mode that they were created in,\nso you can change modes as you like without affecting their appearance.
\n",
+ "line": 223,
+ "description": "colorMode() changes the way p5.js interprets color data. By default, the\nparameters for fill(), stroke(), background(), and color() are defined by\nvalues between 0 and 255 using the RGB color model. This is equivalent to\nsetting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB\nsystem instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You\ncan also use HSL.\n
\nNote: existing color objects remember the mode that they were created in,\nso you can change modes as you like without affecting their appearance.
\n",
"itemtype": "method",
"name": "colorMode",
"chainable": 1,
+ "example": [
+ "\n\n\nnoStroke();\ncolorMode(RGB, 100);\nfor (var i = 0; i < 100; i++) {\n for (var j = 0; j < 100; j++) {\n stroke(i, j, 0);\n point(i, j);\n }\n}\n\n\n\n\n\nnoStroke();\ncolorMode(HSB, 100);\nfor (var i = 0; i < 100; i++) {\n for (var j = 0; j < 100; j++) {\n stroke(i, j, 100);\n point(i, j);\n }\n}\n\n\n\n\n\ncolorMode(RGB, 255);\nvar c = color(127, 255, 0);\n\ncolorMode(RGB, 1);\nvar myColor = c._getRed();\ntext(myColor, 10, 10, 80, 80);\n\n\n\n\n\nnoFill();\ncolorMode(RGB, 255, 255, 255, 1);\nbackground(255);\n\nstrokeWeight(4);\nstroke(255, 0, 10, 0.3);\nellipse(40, 40, 50, 50);\nellipse(50, 50, 40, 40);\n\n"
+ ],
+ "alt": "Green to red gradient from bottom L to top R. shading originates from top left.\nRainbow gradient from left to right. Brightness increasing to white at top.\nunknown image.\n50x50 ellipse at middle L & 40x40 ellipse at center. Transluscent pink outlines.",
"class": "p5",
"module": "Color",
"submodule": "Setting",
"overloads": [
{
- "line": 216,
+ "line": 223,
"params": [
{
"name": "mode",
@@ -3641,7 +3979,7 @@ module.exports={
"chainable": 1
},
{
- "line": 235,
+ "line": 300,
"params": [
{
"name": "mode",
@@ -3676,17 +4014,21 @@ module.exports={
},
{
"file": "src/color/setting.js",
- "line": 335,
- "description": "Sets the color used to fill shapes. For example, if you run\nfill(204, 102, 0), all subsequent shapes will be filled with orange. This\ncolor is either specified in terms of the RGB or HSB color depending on\nthe current colorMode(). (The default color space is RGB, with each value\nin the range from 0 to 255).\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n
\nA p5 Color object can also be provided to set the fill color.
\n",
+ "line": 344,
+ "description": "Sets the color used to fill shapes. For example, if you run\nfill(204, 102, 0), all subsequent shapes will be filled with orange. This\ncolor is either specified in terms of the RGB or HSB color depending on\nthe current colorMode(). (The default color space is RGB, with each value\nin the range from 0 to 255). The alpha range by default is also 0 to 255.\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n
\nA p5 Color object can also be provided to set the fill color.
\n",
"itemtype": "method",
"name": "fill",
"chainable": 1,
+ "example": [
+ "\n\n\n// Grayscale integer value\nfill(51);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// R, G & B integer values\nfill(255, 204, 0);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// H, S & B integer values\ncolorMode(HSB);\nfill(255, 204, 100);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// Named SVG/CSS color string\nfill('red');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// three-digit hexadecimal RGB notation\nfill('#fae');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// six-digit hexadecimal RGB notation\nfill('#222222');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// integer RGB notation\nfill('rgb(0,255,0)');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// integer RGBA notation\nfill('rgba(0,255,0, 0.25)');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// percentage RGB notation\nfill('rgb(100%,0%,10%)');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// percentage RGBA notation\nfill('rgba(100%,0%,100%,0.5)');\nrect(20, 20, 60, 60);\n\n\n\n\n\n// p5 Color object\nfill(color(0, 0, 255));\nrect(20, 20, 60, 60);\n\n"
+ ],
+ "alt": "60x60 dark charcoal grey rect with black outline in center of canvas.\n60x60 yellow rect with black outline in center of canvas.\n60x60 royal blue rect with black outline in center of canvas.\n60x60 red rect with black outline in center of canvas.\n60x60 pink rect with black outline in center of canvas.\n60x60 black rect with black outline in center of canvas.\n60x60 light green rect with black outline in center of canvas.\n60x60 soft green rect with black outline in center of canvas.\n60x60 red rect with black outline in center of canvas.\n60x60 dark fushcia rect with black outline in center of canvas.\n60x60 blue rect with black outline in center of canvas.",
"class": "p5",
"module": "Color",
"submodule": "Setting",
"overloads": [
{
- "line": 335,
+ "line": 344,
"params": [
{
"name": "v1",
@@ -3713,12 +4055,23 @@ module.exports={
"chainable": 1
},
{
- "line": 359,
+ "line": 469,
"params": [
{
"name": "value",
"description": "a color string
\n",
"type": "String"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 475,
+ "params": [
+ {
+ "name": "gray",
+ "description": "a gray value
\n",
+ "type": "Number"
},
{
"name": "alpha",
@@ -3730,7 +4083,7 @@ module.exports={
"chainable": 1
},
{
- "line": 366,
+ "line": 482,
"params": [
{
"name": "values",
@@ -3741,18 +4094,12 @@ module.exports={
"chainable": 1
},
{
- "line": 373,
+ "line": 489,
"params": [
{
"name": "color",
"description": "the fill color
\n",
"type": "p5.Color"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
}
],
"chainable": 1
@@ -3761,47 +4108,51 @@ module.exports={
},
{
"file": "src/color/setting.js",
- "line": 489,
- "description": "Disables filling geometry. If both noStroke() and noFill() are called,\nnothing will be drawn to the screen.
\n",
+ "line": 501,
+ "description": "Disables filling geometry. If both noStroke() and noFill() are called,\nnothing will be drawn to the screen.
\n",
"itemtype": "method",
"name": "noFill",
"chainable": 1,
"example": [
- "\n\n\nrect(15, 10, 55, 55);\nnoFill();\nrect(20, 20, 60, 60);\n\n"
+ "\n\n\nrect(15, 10, 55, 55);\nnoFill();\nrect(20, 20, 60, 60);\n\n\n\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n noFill();\n stroke(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(45, 45, 45);\n}\n\n"
],
- "alt": "white rect top middle and noFill rect center. Both 60x60 with black outlines.",
+ "alt": "white rect top middle and noFill rect center. Both 60x60 with black outlines.\nblack canvas with purple cube wireframe spinning",
"class": "p5",
"module": "Color",
"submodule": "Setting"
},
{
"file": "src/color/setting.js",
- "line": 514,
- "description": "Disables drawing the stroke (outline). If both noStroke() and noFill()\nare called, nothing will be drawn to the screen.
\n",
+ "line": 542,
+ "description": "Disables drawing the stroke (outline). If both noStroke() and noFill()\nare called, nothing will be drawn to the screen.
\n",
"itemtype": "method",
"name": "noStroke",
"chainable": 1,
"example": [
- "\n\n\nnoStroke();\nrect(20, 20, 60, 60);\n\n"
+ "\n\n\nnoStroke();\nrect(20, 20, 60, 60);\n\n\n\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n noStroke();\n fill(240, 150, 150);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(45, 45, 45);\n}\n\n"
],
- "alt": "60x60 white rect at center. no outline.",
+ "alt": "60x60 white rect at center. no outline.\nblack canvas with pink cube spinning",
"class": "p5",
"module": "Color",
"submodule": "Setting"
},
{
"file": "src/color/setting.js",
- "line": 542,
- "description": "Sets the color used to draw lines and borders around shapes. This color\nis either specified in terms of the RGB or HSB color depending on the\ncurrent colorMode() (the default color space is RGB, with each value in\nthe range from 0 to 255).\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.\n
\nA p5 Color object can also be provided to set the stroke color.
\n",
+ "line": 582,
+ "description": "Sets the color used to draw lines and borders around shapes. This color\nis either specified in terms of the RGB or HSB color depending on the\ncurrent colorMode() (the default color space is RGB, with each value in\nthe range from 0 to 255). The alpha range by default is also 0 to 255.\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.\n
\nA p5 Color object can also be provided to set the stroke color.
\n",
"itemtype": "method",
"name": "stroke",
"chainable": 1,
+ "example": [
+ "\n\n\n// Grayscale integer value\nstrokeWeight(4);\nstroke(51);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// R, G & B integer values\nstroke(255, 204, 0);\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// H, S & B integer values\ncolorMode(HSB);\nstrokeWeight(4);\nstroke(255, 204, 100);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// Named SVG/CSS color string\nstroke('red');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// three-digit hexadecimal RGB notation\nstroke('#fae');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// six-digit hexadecimal RGB notation\nstroke('#222222');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// integer RGB notation\nstroke('rgb(0,255,0)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// integer RGBA notation\nstroke('rgba(0,255,0,0.25)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// percentage RGB notation\nstroke('rgb(100%,0%,10%)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// percentage RGBA notation\nstroke('rgba(100%,0%,100%,0.5)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n\n\n\n\n// p5 Color object\nstroke(color(0, 0, 255));\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n"
+ ],
+ "alt": "60x60 white rect at center. Dark charcoal grey outline.\n60x60 white rect at center. Yellow outline.\n60x60 white rect at center. Royal blue outline.\n60x60 white rect at center. Red outline.\n60x60 white rect at center. Pink outline.\n60x60 white rect at center. Black outline.\n60x60 white rect at center. Bright green outline.\n60x60 white rect at center. Soft green outline.\n60x60 white rect at center. Red outline.\n60x60 white rect at center. Dark fushcia outline.\n60x60 white rect at center. Blue outline.",
"class": "p5",
"module": "Color",
"submodule": "Setting",
"overloads": [
{
- "line": 542,
+ "line": 582,
"params": [
{
"name": "v1",
@@ -3828,12 +4179,23 @@ module.exports={
"chainable": 1
},
{
- "line": 567,
+ "line": 721,
"params": [
{
"name": "value",
"description": "a color string
\n",
"type": "String"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 727,
+ "params": [
+ {
+ "name": "gray",
+ "description": "a gray value
\n",
+ "type": "Number"
},
{
"name": "alpha",
@@ -3845,7 +4207,7 @@ module.exports={
"chainable": 1
},
{
- "line": 574,
+ "line": 734,
"params": [
{
"name": "values",
@@ -3856,18 +4218,12 @@ module.exports={
"chainable": 1
},
{
- "line": 581,
+ "line": 741,
"params": [
{
"name": "color",
"description": "the stroke color
\n",
"type": "p5.Color"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
}
],
"chainable": 1
@@ -3875,29 +4231,29 @@ module.exports={
]
},
{
- "file": "src/core/2d_primitives.js",
+ "file": "src/core/shape/2d_primitives.js",
"line": 16,
- "description": "Draw an arc to the screen. If called with only a, b, c, d, start, and\nstop, the arc will be drawn as an open pie. If mode is provided, the arc\nwill be drawn either open, as a chord, or as a pie as specified. The\norigin may be changed with the ellipseMode() function.
\nNote that drawing a full circle (ex: 0 to TWO_PI) will appear blank\nbecause 0 and TWO_PI are the same position on the unit circle. The\nbest way to handle this is by using the ellipse() function instead\nto create a closed ellipse, and to use the arc() function\nonly to draw parts of an ellipse.
\n",
+ "description": "Draw an arc to the screen. If called with only x, y, w, h, start, and\nstop, the arc will be drawn and filled as an open pie segment. If a mode parameter is provided, the arc\nwill be filled like an open semi-circle (OPEN) , a closed semi-circle (CHORD), or as a closed pie segment (PIE). The\norigin may be changed with the ellipseMode() function.
\nNote that drawing a full circle (ex: 0 to TWO_PI) will appear blank\nbecause 0 and TWO_PI are the same position on the unit circle. The\nbest way to handle this is by using the ellipse() function instead\nto create a closed ellipse, and to use the arc() function\nonly to draw parts of an ellipse.
\n",
"itemtype": "method",
"name": "arc",
"params": [
{
- "name": "a",
+ "name": "x",
"description": "x-coordinate of the arc's ellipse
\n",
"type": "Number"
},
{
- "name": "b",
+ "name": "y",
"description": "y-coordinate of the arc's ellipse
\n",
"type": "Number"
},
{
- "name": "c",
+ "name": "w",
"description": "width of the arc's ellipse by default
\n",
"type": "Number"
},
{
- "name": "d",
+ "name": "h",
"description": "height of the arc's ellipse by default
\n",
"type": "Number"
},
@@ -3913,49 +4269,32 @@ module.exports={
},
{
"name": "mode",
- "description": "optional parameter to determine the way of drawing\n the arc. either CHORD or PIE
\n",
+ "description": "optional parameter to determine the way of drawing\n the arc. either CHORD, PIE or OPEN
\n",
"type": "Constant",
"optional": true
+ },
+ {
+ "name": "detail",
+ "description": "optional parameter for WebGL mode only. This is to\n specify the number of vertices that makes up the\n perimeter of the arc. Default value is 25.
\n",
+ "type": "Number",
+ "optional": true
}
],
"chainable": 1,
"example": [
- "\n\n\narc(50, 55, 50, 50, 0, HALF_PI);\nnoFill();\narc(50, 55, 60, 60, HALF_PI, PI);\narc(50, 55, 70, 70, PI, PI+QUARTER_PI);\narc(50, 55, 80, 80, PI+QUARTER_PI, TWO_PI);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI+QUARTER_PI, OPEN);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI+QUARTER_PI, CHORD);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI+QUARTER_PI, PIE);\n\n"
+ "\n\n\narc(50, 55, 50, 50, 0, HALF_PI);\nnoFill();\narc(50, 55, 60, 60, HALF_PI, PI);\narc(50, 55, 70, 70, PI, PI + QUARTER_PI);\narc(50, 55, 80, 80, PI + QUARTER_PI, TWO_PI);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI, OPEN);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI, CHORD);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI, PIE);\n\n"
],
- "alt": "shattered outline of an ellipse with a quarter of a white circle bottom-right.\nwhite ellipse with black outline with top right missing.\nwhite ellipse with top right missing with black outline around shape.\nwhite ellipse with top right quarter missing with black outline around the shape.",
+ "alt": "shattered outline of an ellipse with a quarter of a white circle bottom-right.\nwhite ellipse with top right quarter missing.\nwhite ellipse with black outline with top right missing.\nwhite ellipse with top right missing with black outline around shape.\nwhite ellipse with top right quarter missing with black outline around the shape.",
"class": "p5",
"module": "Shape",
"submodule": "2D Primitives"
},
{
- "file": "src/core/2d_primitives.js",
- "line": 132,
- "description": "Draws an ellipse (oval) to the screen. An ellipse with equal width and\nheight is a circle. By default, the first two parameters set the location,\nand the third and fourth parameters set the shape's width and height. If\nno height is specified, the value of width is used for both the width and\nheight. If a negative height or width is specified, the absolute value is taken.\nThe origin may be changed with the ellipseMode() function.
\n",
+ "file": "src/core/shape/2d_primitives.js",
+ "line": 149,
+ "description": "Draws an ellipse (oval) to the screen. An ellipse with equal width and\nheight is a circle. By default, the first two parameters set the location,\nand the third and fourth parameters set the shape's width and height. If\nno height is specified, the value of width is used for both the width and\nheight. If a negative height or width is specified, the absolute value is taken.\nThe origin may be changed with the ellipseMode() function.
\n",
"itemtype": "method",
"name": "ellipse",
- "params": [
- {
- "name": "x",
- "description": "x-coordinate of the ellipse.
\n",
- "type": "Number"
- },
- {
- "name": "y",
- "description": "y-coordinate of the ellipse.
\n",
- "type": "Number"
- },
- {
- "name": "w",
- "description": "width of the ellipse.
\n",
- "type": "Number"
- },
- {
- "name": "h",
- "description": "height of the ellipse.
\n",
- "type": "Number",
- "optional": true
- }
- ],
"chainable": 1,
"example": [
"\n\n\nellipse(56, 46, 55, 55);\n\n"
@@ -3963,36 +4302,73 @@ module.exports={
"alt": "white ellipse with black outline in middle-right of canvas that is 55x55.",
"class": "p5",
"module": "Shape",
- "submodule": "2D Primitives"
- },
- {
- "file": "src/core/2d_primitives.js",
- "line": 187,
- "description": "Draws a line (a direct path between two points) to the screen. The version\nof line() with four parameters draws the line in 2D. To color a line, use\nthe stroke() function. A line cannot be filled, therefore the fill()\nfunction will not affect the color of a line. 2D lines are drawn with a\nwidth of one pixel by default, but this can be changed with the\nstrokeWeight() function.
\n",
- "itemtype": "method",
- "name": "line",
- "params": [
- {
- "name": "x1",
- "description": "the x-coordinate of the first point
\n",
- "type": "Number"
- },
- {
- "name": "y1",
- "description": "the y-coordinate of the first point
\n",
- "type": "Number"
- },
+ "submodule": "2D Primitives",
+ "overloads": [
{
- "name": "x2",
- "description": "the x-coordinate of the second point
\n",
- "type": "Number"
+ "line": 149,
+ "params": [
+ {
+ "name": "x",
+ "description": "x-coordinate of the ellipse.
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "y-coordinate of the ellipse.
\n",
+ "type": "Number"
+ },
+ {
+ "name": "w",
+ "description": "width of the ellipse.
\n",
+ "type": "Number"
+ },
+ {
+ "name": "h",
+ "description": "height of the ellipse.
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
},
{
- "name": "y2",
- "description": "the y-coordinate of the second point
\n",
- "type": "Number"
+ "line": 174,
+ "params": [
+ {
+ "name": "x",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "w",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "h",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "detail",
+ "description": "number of radial sectors to draw
\n",
+ "type": "Integer"
+ }
+ ]
}
- ],
+ ]
+ },
+ {
+ "file": "src/core/shape/2d_primitives.js",
+ "line": 208,
+ "description": "Draws a line (a direct path between two points) to the screen. The version\nof line() with four parameters draws the line in 2D. To color a line, use\nthe stroke() function. A line cannot be filled, therefore the fill()\nfunction will not affect the color of a line. 2D lines are drawn with a\nwidth of one pixel by default, but this can be changed with the\nstrokeWeight() function.
\n",
+ "itemtype": "method",
+ "name": "line",
"chainable": 1,
"example": [
"\n\n\nline(30, 20, 85, 75);\n\n\n\n\n\nline(30, 20, 85, 20);\nstroke(126);\nline(85, 20, 85, 75);\nstroke(255);\nline(85, 75, 30, 75);\n\n"
@@ -4000,11 +4376,75 @@ module.exports={
"alt": "line 78 pixels long running from mid-top to bottom-right of canvas.\n3 lines of various stroke sizes. Form top, bottom and right sides of a square.",
"class": "p5",
"module": "Shape",
- "submodule": "2D Primitives"
+ "submodule": "2D Primitives",
+ "overloads": [
+ {
+ "line": 208,
+ "params": [
+ {
+ "name": "x1",
+ "description": "the x-coordinate of the first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y1",
+ "description": "the y-coordinate of the first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x2",
+ "description": "the x-coordinate of the second point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "the y-coordinate of the second point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 244,
+ "params": [
+ {
+ "name": "x1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z1",
+ "description": "the z-coordinate of the first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z2",
+ "description": "the z-coordinate of the second point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
- "file": "src/core/2d_primitives.js",
- "line": 262,
+ "file": "src/core/shape/2d_primitives.js",
+ "line": 264,
"description": "Draws a point, a coordinate in space at the dimension of one pixel.\nThe first parameter is the horizontal value for the point, the second\nvalue is the vertical value for the point. The color of the point is\ndetermined by the current stroke.
\n",
"itemtype": "method",
"name": "point",
@@ -4018,6 +4458,12 @@ module.exports={
"name": "y",
"description": "the y-coordinate
\n",
"type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "the z-coordinate (for WEBGL mode)
\n",
+ "type": "Number",
+ "optional": true
}
],
"chainable": 1,
@@ -4030,8 +4476,8 @@ module.exports={
"submodule": "2D Primitives"
},
{
- "file": "src/core/2d_primitives.js",
- "line": 313,
+ "file": "src/core/shape/2d_primitives.js",
+ "line": 299,
"description": "Draw a quad. A quad is a quadrilateral, a four sided polygon. It is\nsimilar to a rectangle, but the angles between its edges are not\nconstrained to ninety degrees. The first pair of parameters (x1,y1)\nsets the first vertex and the subsequent pairs should proceed\nclockwise or counter-clockwise around the defined shape.
\n",
"itemtype": "method",
"name": "quad",
@@ -4045,7 +4491,7 @@ module.exports={
"submodule": "2D Primitives",
"overloads": [
{
- "line": 313,
+ "line": 299,
"params": [
{
"name": "x1",
@@ -4091,7 +4537,7 @@ module.exports={
"chainable": 1
},
{
- "line": 341,
+ "line": 327,
"params": [
{
"name": "x1",
@@ -4103,6 +4549,11 @@ module.exports={
"description": "",
"type": "Number"
},
+ {
+ "name": "z1",
+ "description": "the z-coordinate of the first point
\n",
+ "type": "Number"
+ },
{
"name": "x2",
"description": "",
@@ -4113,6 +4564,11 @@ module.exports={
"description": "",
"type": "Number"
},
+ {
+ "name": "z2",
+ "description": "the z-coordinate of the second point
\n",
+ "type": "Number"
+ },
{
"name": "x3",
"description": "",
@@ -4123,6 +4579,11 @@ module.exports={
"description": "",
"type": "Number"
},
+ {
+ "name": "z3",
+ "description": "the z-coordinate of the third point
\n",
+ "type": "Number"
+ },
{
"name": "x4",
"description": "",
@@ -4132,6 +4593,11 @@ module.exports={
"name": "y4",
"description": "",
"type": "Number"
+ },
+ {
+ "name": "z4",
+ "description": "the z-coordinate of the fourth point
\n",
+ "type": "Number"
}
],
"chainable": 1
@@ -4139,15 +4605,12 @@ module.exports={
]
},
{
- "file": "src/core/2d_primitives.js",
- "line": 393,
- "description": "Draws a rectangle to the screen. A rectangle is a four-sided shape with\nevery angle at ninety degrees. By default, the first two parameters set\nthe location of the upper-left corner, the third sets the width, and the\nfourth sets the height. The way these parameters are interpreted, however,\nmay be changed with the rectMode() function.\n
\nThe fifth, sixth, seventh and eighth parameters, if specified,\ndetermine corner radius for the top-right, top-left, lower-right and\nlower-left corners, respectively. An omitted corner radius parameter is set\nto the value of the previously specified radius value in the parameter list.
\n",
+ "file": "src/core/shape/2d_primitives.js",
+ "line": 353,
+ "description": "Draws a rectangle to the screen. A rectangle is a four-sided shape with\nevery angle at ninety degrees. By default, the first two parameters set\nthe location of the upper-left corner, the third sets the width, and the\nfourth sets the height. The way these parameters are interpreted, however,\nmay be changed with the rectMode() function.\n
\nThe fifth, sixth, seventh and eighth parameters, if specified,\ndetermine corner radius for the top-left, top-right, lower-right and\nlower-left corners, respectively. An omitted corner radius parameter is set\nto the value of the previously specified radius value in the parameter list.
\n",
"itemtype": "method",
"name": "rect",
- "return": {
- "description": "the p5 object.",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
"\n\n\n// Draw a rectangle at location (30, 20) with a width and height of 55.\nrect(30, 20, 55, 55);\n\n\n\n\n\n// Draw a rectangle with rounded corners, each having a radius of 20.\nrect(30, 20, 55, 55, 20);\n\n\n\n\n\n// Draw a rectangle with rounded corners having the following radii:\n// top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5.\nrect(30, 20, 55, 55, 20, 15, 10, 5);\n\n"
],
@@ -4157,7 +4620,7 @@ module.exports={
"submodule": "2D Primitives",
"overloads": [
{
- "line": 393,
+ "line": 353,
"params": [
{
"name": "x",
@@ -4204,13 +4667,10 @@ module.exports={
"optional": true
}
],
- "return": {
- "description": "the p5 object.",
- "type": "P5"
- }
+ "chainable": 1
},
{
- "line": 443,
+ "line": 403,
"params": [
{
"name": "x",
@@ -4234,14 +4694,14 @@ module.exports={
},
{
"name": "detailX",
- "description": "",
- "type": "Number",
+ "description": "number of segments in the x-direction
\n",
+ "type": "Integer",
"optional": true
},
{
"name": "detailY",
- "description": "",
- "type": "Number",
+ "description": "number of segments in the y-direction
\n",
+ "type": "Integer",
"optional": true
}
],
@@ -4250,8 +4710,8 @@ module.exports={
]
},
{
- "file": "src/core/2d_primitives.js",
- "line": 477,
+ "file": "src/core/shape/2d_primitives.js",
+ "line": 436,
"description": "A triangle is a plane created by connecting three points. The first two\narguments specify the first point, the middle two arguments specify the\nsecond point, and the last two arguments specify the third point.
\n",
"itemtype": "method",
"name": "triangle",
@@ -4297,9 +4757,9 @@ module.exports={
"submodule": "2D Primitives"
},
{
- "file": "src/core/attributes.js",
+ "file": "src/core/shape/attributes.js",
"line": 14,
- "description": "Modifies the location from which ellipses are drawn by changing the way\nin which parameters given to ellipse() are interpreted.\n
\nThe default mode is ellipseMode(CENTER), which interprets the first two\nparameters of ellipse() as the shape's center point, while the third and\nfourth parameters are its width and height.\n
\nellipseMode(RADIUS) also uses the first two parameters of ellipse() as\nthe shape's center point, but uses the third and fourth parameters to\nspecify half of the shapes's width and height.\n
\nellipseMode(CORNER) interprets the first two parameters of ellipse() as\nthe upper-left corner of the shape, while the third and fourth parameters\nare its width and height.\n
\nellipseMode(CORNERS) interprets the first two parameters of ellipse() as\nthe location of one corner of the ellipse's bounding box, and the third\nand fourth parameters as the location of the opposite corner.\n
\nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.
\n",
+ "description": "Modifies the location from which ellipses are drawn by changing the way\nin which parameters given to ellipse() are interpreted.\n
\nThe default mode is ellipseMode(CENTER), which interprets the first two\nparameters of ellipse() as the shape's center point, while the third and\nfourth parameters are its width and height.\n
\nellipseMode(RADIUS) also uses the first two parameters of ellipse() as\nthe shape's center point, but uses the third and fourth parameters to\nspecify half of the shapes's width and height.\n
\nellipseMode(CORNER) interprets the first two parameters of ellipse() as\nthe upper-left corner of the shape, while the third and fourth parameters\nare its width and height.\n
\nellipseMode(CORNERS) interprets the first two parameters of ellipse() as\nthe location of one corner of the ellipse's bounding box, and the third\nand fourth parameters as the location of the opposite corner.\n
\nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.
\n",
"itemtype": "method",
"name": "ellipseMode",
"params": [
@@ -4311,7 +4771,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nellipseMode(RADIUS); // Set ellipseMode to RADIUS\nfill(255); // Set fill to white\nellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode\n\nellipseMode(CENTER); // Set ellipseMode to CENTER\nfill(100); // Set fill to gray\nellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode\n\n\n\n\n\nellipseMode(CORNER); // Set ellipseMode is CORNER\nfill(255); // Set fill to white\nellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode\n\nellipseMode(CORNERS); // Set ellipseMode to CORNERS\nfill(100); // Set fill to gray\nellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode\n\n"
+ "\n\n\nellipseMode(RADIUS); // Set ellipseMode to RADIUS\nfill(255); // Set fill to white\nellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode\n\nellipseMode(CENTER); // Set ellipseMode to CENTER\nfill(100); // Set fill to gray\nellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode\n\n\n\n\n\nellipseMode(CORNER); // Set ellipseMode is CORNER\nfill(255); // Set fill to white\nellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode\n\nellipseMode(CORNERS); // Set ellipseMode to CORNERS\nfill(100); // Set fill to gray\nellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode\n\n"
],
"alt": "60x60 white ellipse and 30x30 grey ellipse with black outlines at center.\n60x60 white ellipse @center and 30x30 grey ellipse top-right, black outlines.",
"class": "p5",
@@ -4319,9 +4779,9 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/attributes.js",
- "line": 80,
- "description": "Draws all geometry with jagged (aliased) edges. Note that smooth() is\nactive by default, so it is necessary to call noSmooth() to disable\nsmoothing of geometry, images, and fonts.
\n",
+ "file": "src/core/shape/attributes.js",
+ "line": 83,
+ "description": "Draws all geometry with jagged (aliased) edges. Note that smooth() is\nactive by default in 2D mode, so it is necessary to call noSmooth() to disable\nsmoothing of geometry, images, and fonts. In 3D mode, noSmooth() is enabled\nby default, so it is necessary to call smooth() if you would like\nsmooth (antialiased) edges on your geometry.
\n",
"itemtype": "method",
"name": "noSmooth",
"chainable": 1,
@@ -4334,9 +4794,9 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/attributes.js",
- "line": 108,
- "description": "Modifies the location from which rectangles are drawn by changing the way\nin which parameters given to rect() are interpreted.\n
\nThe default mode is rectMode(CORNER), which interprets the first two\nparameters of rect() as the upper-left corner of the shape, while the\nthird and fourth parameters are its width and height.\n
\nrectMode(CORNERS) interprets the first two parameters of rect() as the\nlocation of one corner, and the third and fourth parameters as the\nlocation of the opposite corner.\n
\nrectMode(CENTER) interprets the first two parameters of rect() as the\nshape's center point, while the third and fourth parameters are its\nwidth and height.\n
\nrectMode(RADIUS) also uses the first two parameters of rect() as the\nshape's center point, but uses the third and fourth parameters to specify\nhalf of the shapes's width and height.\n
\nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.
\n",
+ "file": "src/core/shape/attributes.js",
+ "line": 113,
+ "description": "Modifies the location from which rectangles are drawn by changing the way\nin which parameters given to rect() are interpreted.\n
\nThe default mode is rectMode(CORNER), which interprets the first two\nparameters of rect() as the upper-left corner of the shape, while the\nthird and fourth parameters are its width and height.\n
\nrectMode(CORNERS) interprets the first two parameters of rect() as the\nlocation of one corner, and the third and fourth parameters as the\nlocation of the opposite corner.\n
\nrectMode(CENTER) interprets the first two parameters of rect() as the\nshape's center point, while the third and fourth parameters are its\nwidth and height.\n
\nrectMode(RADIUS) also uses the first two parameters of rect() as the\nshape's center point, but uses the third and fourth parameters to specify\nhalf of the shapes's width and height.\n
\nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.
\n",
"itemtype": "method",
"name": "rectMode",
"params": [
@@ -4348,7 +4808,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nrectMode(CORNER); // Default rectMode is CORNER\nfill(255); // Set fill to white\nrect(25, 25, 50, 50); // Draw white rect using CORNER mode\n\nrectMode(CORNERS); // Set rectMode to CORNERS\nfill(100); // Set fill to gray\nrect(25, 25, 50, 50); // Draw gray rect using CORNERS mode\n\n\n\n\n\nrectMode(RADIUS); // Set rectMode to RADIUS\nfill(255); // Set fill to white\nrect(50, 50, 30, 30); // Draw white rect using RADIUS mode\n\nrectMode(CENTER); // Set rectMode to CENTER\nfill(100); // Set fill to gray\nrect(50, 50, 30, 30); // Draw gray rect using CENTER mode\n\n"
+ "\n\n\nrectMode(CORNER); // Default rectMode is CORNER\nfill(255); // Set fill to white\nrect(25, 25, 50, 50); // Draw white rect using CORNER mode\n\nrectMode(CORNERS); // Set rectMode to CORNERS\nfill(100); // Set fill to gray\nrect(25, 25, 50, 50); // Draw gray rect using CORNERS mode\n\n\n\n\n\nrectMode(RADIUS); // Set rectMode to RADIUS\nfill(255); // Set fill to white\nrect(50, 50, 30, 30); // Draw white rect using RADIUS mode\n\nrectMode(CENTER); // Set rectMode to CENTER\nfill(100); // Set fill to gray\nrect(50, 50, 30, 30); // Draw gray rect using CENTER mode\n\n"
],
"alt": "50x50 white rect at center and 25x25 grey rect in the top left of the other.\n50x50 white rect at center and 25x25 grey rect in the center of the other.",
"class": "p5",
@@ -4356,9 +4816,9 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/attributes.js",
- "line": 174,
- "description": "Draws all geometry with smooth (anti-aliased) edges. smooth() will also\nimprove image quality of resized images. Note that smooth() is active by\ndefault; noSmooth() can be used to disable smoothing of geometry,\nimages, and fonts.
\n",
+ "file": "src/core/shape/attributes.js",
+ "line": 182,
+ "description": "Draws all geometry with smooth (anti-aliased) edges. smooth() will also\nimprove image quality of resized images. Note that smooth() is active by\ndefault in 2D mode; noSmooth() can be used to disable smoothing of geometry,\nimages, and fonts. In 3D mode, noSmooth() is enabled\nby default, so it is necessary to call smooth() if you would like\nsmooth (antialiased) edges on your geometry.
\n",
"itemtype": "method",
"name": "smooth",
"chainable": 1,
@@ -4371,8 +4831,8 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/attributes.js",
- "line": 203,
+ "file": "src/core/shape/attributes.js",
+ "line": 213,
"description": "Sets the style for rendering line endings. These ends are either squared,\nextended, or rounded, each of which specified with the corresponding\nparameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND.
\n",
"itemtype": "method",
"name": "strokeCap",
@@ -4393,8 +4853,8 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/attributes.js",
- "line": 237,
+ "file": "src/core/shape/attributes.js",
+ "line": 250,
"description": "Sets the style of the joints which connect line segments. These joints\nare either mitered, beveled, or rounded and specified with the\ncorresponding parameters MITER, BEVEL, and ROUND. The default joint is\nMITER.
\n",
"itemtype": "method",
"name": "strokeJoin",
@@ -4415,8 +4875,8 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/attributes.js",
- "line": 301,
+ "file": "src/core/shape/attributes.js",
+ "line": 317,
"description": "Sets the width of the stroke used for lines, points, and the border\naround shapes. All widths are set in units of pixels.
\n",
"itemtype": "method",
"name": "strokeWeight",
@@ -4427,12 +4887,9 @@ module.exports={
"type": "Number"
}
],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
- "\n\n\nstrokeWeight(1); // Default\nline(20, 20, 80, 20);\nstrokeWeight(4); // Thicker\nline(20, 40, 80, 40);\nstrokeWeight(10); // Beastly\nline(20, 70, 80, 70);\n\n"
+ "\n\n\nstrokeWeight(1); // Default\nline(20, 20, 80, 20);\nstrokeWeight(4); // Thicker\nline(20, 40, 80, 40);\nstrokeWeight(10); // Beastly\nline(20, 70, 80, 70);\n\n"
],
"alt": "3 horizontal black lines. Top line: thin, mid: medium, bottom:thick.",
"class": "p5",
@@ -4440,154 +4897,898 @@ module.exports={
"submodule": "Attributes"
},
{
- "file": "src/core/canvas.js",
- "line": 1,
- "requires": [
- "constants"
+ "file": "src/core/shape/curves.js",
+ "line": 13,
+ "description": "Draws a cubic Bezier curve on the screen. These curves are defined by a\nseries of anchor and control points. The first two parameters specify\nthe first anchor point and the last two parameters specify the other\nanchor point, which become the first and last points on the curve. The\nmiddle parameters specify the two control points which define the shape\nof the curve. Approximately speaking, control points "pull" the curve\ntowards them.
Bezier curves were developed by French\nautomotive engineer Pierre Bezier, and are commonly used in computer\ngraphics to define gently sloping curves. See also curve().
\n",
+ "itemtype": "method",
+ "name": "bezier",
+ "chainable": 1,
+ "example": [
+ "\n\n\nnoFill();\nstroke(255, 102, 0);\nline(85, 20, 10, 10);\nline(90, 90, 15, 80);\nstroke(0, 0, 0);\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\n\n\n\n\n\nbackground(0, 0, 0);\nnoFill();\nstroke(255);\nbezier(250, 250, 0, 100, 100, 0, 100, 0, 0, 0, 100, 0);\n\n"
],
+ "alt": "stretched black s-shape in center with orange lines extending from end points.\nstretched black s-shape with 10 5x5 white ellipses along the shape.\nstretched black s-shape with 7 5x5 ellipses and orange lines along the shape.\nstretched black s-shape with 17 small orange lines extending from under shape.\nhorseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.\nLine shaped like right-facing arrow,points move with mouse-x and warp shape.\nhorizontal line that hooks downward on the right and 13 5x5 ellipses along it.\nright curving line mid-right of canvas with 7 short lines radiating from it.",
"class": "p5",
- "module": "Shape"
- },
- {
- "file": "src/core/constants.js",
- "line": 12,
- "itemtype": "property",
- "name": "P2D",
- "type": "String",
- "final": 1,
- "class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves",
+ "overloads": [
+ {
+ "line": 13,
+ "params": [
+ {
+ "name": "x1",
+ "description": "x-coordinate for the first anchor point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y1",
+ "description": "y-coordinate for the first anchor point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x2",
+ "description": "x-coordinate for the first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "y-coordinate for the first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x3",
+ "description": "x-coordinate for the second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "y-coordinate for the second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x4",
+ "description": "x-coordinate for the second anchor point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y4",
+ "description": "y-coordinate for the second anchor point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 66,
+ "params": [
+ {
+ "name": "x1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z1",
+ "description": "z-coordinate for the first anchor point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z2",
+ "description": "z-coordinate for the first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z3",
+ "description": "z-coordinate for the second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x4",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y4",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z4",
+ "description": "z-coordinate for the second anchor point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
- "file": "src/core/constants.js",
- "line": 17,
- "itemtype": "property",
- "name": "WEBGL",
- "type": "String",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 96,
+ "description": "Sets the resolution at which Beziers display.
\nThe default value is 20.
\nThis function is only useful when using the WEBGL renderer\nas the default canvas renderer does not use this information.
\n",
+ "itemtype": "method",
+ "name": "bezierDetail",
+ "params": [
+ {
+ "name": "detail",
+ "description": "resolution of the curves
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1,
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noFill();\n\n bezierDetail(5);\n}\n\nfunction draw() {\n background(200);\n\n // prettier-ignore\n bezier(-40, -40, 0,\n 90, -40, 0,\n -90, 40, 0,\n 40, 40, 0);\n}\n\n"
+ ],
+ "alt": "stretched black s-shape with a low level of bezier detail",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 33,
- "description": "HALF_PI is a mathematical constant with the value\n1.57079632679489661923. It is half the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",
- "itemtype": "property",
- "name": "HALF_PI",
- "type": "Number",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 139,
+ "description": "Evaluates the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a bezier curve at t.
\n",
+ "itemtype": "method",
+ "name": "bezierPoint",
+ "params": [
+ {
+ "name": "a",
+ "description": "coordinate of first point on the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "b",
+ "description": "coordinate of first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "c",
+ "description": "coordinate of second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "d",
+ "description": "coordinate of second point on the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "t",
+ "description": "value between 0 and 1
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "the value of the Bezier at position t",
+ "type": "Number"
+ },
"example": [
- "\n\narc(50, 50, 80, 80, 0, HALF_PI);\n"
+ "\n\n\nnoFill();\nvar x1 = 85,\n x2 = 10,\n x3 = 90,\n x4 = 15;\nvar y1 = 20,\n y2 = 10,\n y3 = 90,\n y4 = 80;\nbezier(x1, y1, x2, y2, x3, y3, x4, y4);\nfill(255);\nvar steps = 10;\nfor (var i = 0; i <= steps; i++) {\n var t = i / steps;\n var x = bezierPoint(x1, x2, x3, x4, t);\n var y = bezierPoint(y1, y2, y3, y4, t);\n ellipse(x, y, 5, 5);\n}\n\n"
],
- "alt": "80x80 white quarter-circle with curve toward bottom right of canvas.",
+ "alt": "stretched black s-shape with 17 small orange lines extending from under shape.",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 52,
- "description": "PI is a mathematical constant with the value\n3.14159265358979323846. It is the ratio of the circumference\nof a circle to its diameter. It is useful in combination with\nthe trigonometric functions sin() and cos().
\n",
- "itemtype": "property",
- "name": "PI",
- "type": "Number",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 194,
+ "description": "Evaluates the tangent to the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.
\n",
+ "itemtype": "method",
+ "name": "bezierTangent",
+ "params": [
+ {
+ "name": "a",
+ "description": "coordinate of first point on the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "b",
+ "description": "coordinate of first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "c",
+ "description": "coordinate of second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "d",
+ "description": "coordinate of second point on the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "t",
+ "description": "value between 0 and 1
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "the tangent at position t",
+ "type": "Number"
+ },
"example": [
- "\n\narc(50, 50, 80, 80, 0, PI);\n"
+ "\n\n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nvar steps = 6;\nfill(255);\nfor (var i = 0; i <= steps; i++) {\n var t = i / steps;\n // Get the location of the point\n var x = bezierPoint(85, 10, 90, 15, t);\n var y = bezierPoint(20, 10, 90, 80, t);\n // Get the tangent points\n var tx = bezierTangent(85, 10, 90, 15, t);\n var ty = bezierTangent(20, 10, 90, 80, t);\n // Calculate an angle from the tangent points\n var a = atan2(ty, tx);\n a += PI;\n stroke(255, 102, 0);\n line(x, y, cos(a) * 30 + x, sin(a) * 30 + y);\n // The following line of code makes a line\n // inverse of the above line\n //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y);\n stroke(0);\n ellipse(x, y, 5, 5);\n}\n\n\n\n\n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nstroke(255, 102, 0);\nvar steps = 16;\nfor (var i = 0; i <= steps; i++) {\n var t = i / steps;\n var x = bezierPoint(85, 10, 90, 15, t);\n var y = bezierPoint(20, 10, 90, 80, t);\n var tx = bezierTangent(85, 10, 90, 15, t);\n var ty = bezierTangent(20, 10, 90, 80, t);\n var a = atan2(ty, tx);\n a -= HALF_PI;\n line(x, y, cos(a) * 8 + x, sin(a) * 8 + y);\n}\n\n"
],
- "alt": "white half-circle with curve toward bottom of canvas.",
+ "alt": "s-shaped line with 17 short orange lines extending from underside of shape",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 71,
- "description": "QUARTER_PI is a mathematical constant with the value 0.7853982.\nIt is one quarter the ratio of the circumference of a circle to\nits diameter. It is useful in combination with the trigonometric\nfunctions sin() and cos().
\n",
- "itemtype": "property",
- "name": "QUARTER_PI",
- "type": "Number",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 273,
+ "description": "Draws a curved line on the screen between two points, given as the\nmiddle four parameters. The first two parameters are a control point, as\nif the curve came from this point even though it's not drawn. The last\ntwo parameters similarly describe the other control point.
\nLonger curves can be created by putting a series of curve() functions\ntogether or using curveVertex(). An additional function called\ncurveTightness() provides control for the visual quality of the curve.\nThe curve() function is an implementation of Catmull-Rom splines.
\n",
+ "itemtype": "method",
+ "name": "curve",
+ "chainable": 1,
"example": [
- "\n\narc(50, 50, 80, 80, 0, QUARTER_PI);\n"
+ "\n\n\nnoFill();\nstroke(255, 102, 0);\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\nstroke(0);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nstroke(255, 102, 0);\ncurve(73, 24, 73, 61, 15, 65, 15, 65);\n\n\n\n\n// Define the curve points as JavaScript objects\nvar p1 = { x: 5, y: 26 },\n p2 = { x: 73, y: 24 };\nvar p3 = { x: 73, y: 61 },\n p4 = { x: 15, y: 65 };\nnoFill();\nstroke(255, 102, 0);\ncurve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y);\nstroke(0);\ncurve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y);\nstroke(255, 102, 0);\ncurve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y);\n\n\n\n\nnoFill();\nstroke(255, 102, 0);\ncurve(5, 26, 0, 5, 26, 0, 73, 24, 0, 73, 61, 0);\nstroke(0);\ncurve(5, 26, 0, 73, 24, 0, 73, 61, 0, 15, 65, 0);\nstroke(255, 102, 0);\ncurve(73, 24, 0, 73, 61, 0, 15, 65, 0, 15, 65, 0);\n\n"
],
- "alt": "white eighth-circle rotated about 40 degrees with curve bottom right canvas.",
+ "alt": "horseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.\ncurving black and orange lines.",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves",
+ "overloads": [
+ {
+ "line": 273,
+ "params": [
+ {
+ "name": "x1",
+ "description": "x-coordinate for the beginning control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y1",
+ "description": "y-coordinate for the beginning control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x2",
+ "description": "x-coordinate for the first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "y-coordinate for the first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x3",
+ "description": "x-coordinate for the second point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "y-coordinate for the second point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x4",
+ "description": "x-coordinate for the ending control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y4",
+ "description": "y-coordinate for the ending control point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 338,
+ "params": [
+ {
+ "name": "x1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z1",
+ "description": "z-coordinate for the beginning control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z2",
+ "description": "z-coordinate for the first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z3",
+ "description": "z-coordinate for the second point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x4",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y4",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z4",
+ "description": "z-coordinate for the ending control point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
- "file": "src/core/constants.js",
- "line": 90,
- "description": "TAU is an alias for TWO_PI, a mathematical constant with the\nvalue 6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",
- "itemtype": "property",
- "name": "TAU",
- "type": "Number",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 364,
+ "description": "Sets the resolution at which curves display.
\nThe default value is 20 while the minimum value is 3.
\nThis function is only useful when using the WEBGL renderer\nas the default canvas renderer does not use this\ninformation.
\n",
+ "itemtype": "method",
+ "name": "curveDetail",
+ "params": [
+ {
+ "name": "resolution",
+ "description": "of the curves
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1,
"example": [
- "\n\narc(50, 50, 80, 80, 0, TAU);\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n\n curveDetail(5);\n}\nfunction draw() {\n background(200);\n\n curve(250, 600, 0, -30, 40, 0, 30, 30, 0, -250, 600, 0);\n}\n\n"
],
- "alt": "80x80 white ellipse shape in center of canvas.",
+ "alt": "white arch shape with a low level of curve detail.",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 109,
- "description": "TWO_PI is a mathematical constant with the value\n6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",
- "itemtype": "property",
- "name": "TWO_PI",
- "type": "Number",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 406,
+ "description": "Modifies the quality of forms created with curve() and curveVertex().\nThe parameter tightness determines how the curve fits to the vertex\npoints. The value 0.0 is the default value for tightness (this value\ndefines the curves to be Catmull-Rom splines) and the value 1.0 connects\nall the points with straight lines. Values within the range -5.0 and 5.0\nwill deform the curves but will leave them recognizable and as values\nincrease in magnitude, they will continue to deform.
\n",
+ "itemtype": "method",
+ "name": "curveTightness",
+ "params": [
+ {
+ "name": "amount",
+ "description": "of deformation from the original vertices
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1,
"example": [
- "\n\narc(50, 50, 80, 80, 0, TWO_PI);\n"
+ "\n\n\n// Move the mouse left and right to see the curve change\n\nfunction setup() {\n createCanvas(100, 100);\n noFill();\n}\n\nfunction draw() {\n background(204);\n var t = map(mouseX, 0, width, -5, 5);\n curveTightness(t);\n beginShape();\n curveVertex(10, 26);\n curveVertex(10, 26);\n curveVertex(83, 24);\n curveVertex(83, 61);\n curveVertex(25, 65);\n curveVertex(25, 65);\n endShape();\n}\n\n"
],
- "alt": "80x80 white ellipse shape in center of canvas.",
+ "alt": "Line shaped like right-facing arrow,points move with mouse-x and warp shape.",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 128,
- "itemtype": "property",
- "name": "DEGREES",
- "type": "String",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 453,
+ "description": "Evaluates the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are control points\nof the curve, and b and c are the start and end points of the curve.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a curve at t.
\n",
+ "itemtype": "method",
+ "name": "curvePoint",
+ "params": [
+ {
+ "name": "a",
+ "description": "coordinate of first control point of the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "b",
+ "description": "coordinate of first point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "c",
+ "description": "coordinate of second point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "d",
+ "description": "coordinate of second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "t",
+ "description": "value between 0 and 1
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "bezier value at position t",
+ "type": "Number"
+ },
+ "example": [
+ "\n\n\nnoFill();\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nfill(255);\nellipseMode(CENTER);\nvar steps = 6;\nfor (var i = 0; i <= steps; i++) {\n var t = i / steps;\n var x = curvePoint(5, 5, 73, 73, t);\n var y = curvePoint(26, 26, 24, 61, t);\n ellipse(x, y, 5, 5);\n x = curvePoint(5, 73, 73, 15, t);\n y = curvePoint(26, 24, 61, 65, t);\n ellipse(x, y, 5, 5);\n}\n\n\n\nline hooking down to right-bottom with 13 5x5 white ellipse points"
+ ],
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 133,
- "itemtype": "property",
- "name": "RADIANS",
- "type": "String",
- "final": 1,
+ "file": "src/core/shape/curves.js",
+ "line": 502,
+ "description": "Evaluates the tangent to the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are points on the curve,\nand b and c are the control points.
\n",
+ "itemtype": "method",
+ "name": "curveTangent",
+ "params": [
+ {
+ "name": "a",
+ "description": "coordinate of first point on the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "b",
+ "description": "coordinate of first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "c",
+ "description": "coordinate of second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "d",
+ "description": "coordinate of second point on the curve
\n",
+ "type": "Number"
+ },
+ {
+ "name": "t",
+ "description": "value between 0 and 1
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "the tangent at position t",
+ "type": "Number"
+ },
+ "example": [
+ "\n\n\nnoFill();\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nvar steps = 6;\nfor (var i = 0; i <= steps; i++) {\n var t = i / steps;\n var x = curvePoint(5, 73, 73, 15, t);\n var y = curvePoint(26, 24, 61, 65, t);\n //ellipse(x, y, 5, 5);\n var tx = curveTangent(5, 73, 73, 15, t);\n var ty = curveTangent(26, 24, 61, 65, t);\n var a = atan2(ty, tx);\n a -= PI / 2.0;\n line(x, y, cos(a) * 8 + x, sin(a) * 8 + y);\n}\n\n"
+ ],
+ "alt": "right curving line mid-right of canvas with 7 short lines radiating from it.",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Curves"
},
{
- "file": "src/core/constants.js",
- "line": 142,
- "itemtype": "property",
- "name": "CORNER",
- "type": "String",
- "final": 1,
+ "file": "src/core/shape/vertex.js",
+ "line": 22,
+ "description": "Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n
\nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.
\n",
+ "itemtype": "method",
+ "name": "beginContour",
+ "chainable": 1,
+ "example": [
+ "\n\n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n"
+ ],
+ "alt": "white rect and smaller grey rect with red outlines in center of canvas.",
"class": "p5",
- "module": "Constants",
- "submodule": "Constants"
+ "module": "Shape",
+ "submodule": "Vertex"
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 70,
+ "description": "Using the beginShape() and endShape() functions allow creating more\ncomplex forms. beginShape() begins recording vertices for a shape and\nendShape() stops recording. The value of the kind parameter tells it which\ntypes of shapes to create from the provided vertices. With no mode\nspecified, the shape can be any irregular polygon.\n
\nThe parameters available for beginShape() are POINTS, LINES, TRIANGLES,\nTRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the\nbeginShape() function, a series of vertex() commands must follow. To stop\ndrawing the shape, call endShape(). Each shape will be outlined with the\ncurrent stroke color and filled with the fill color.\n
\nTransformations such as translate(), rotate(), and scale() do not work\nwithin beginShape(). It is also not possible to use other shapes, such as\nellipse() or rect() within beginShape().
\n",
+ "itemtype": "method",
+ "name": "beginShape",
+ "params": [
+ {
+ "name": "kind",
+ "description": "either POINTS, LINES, TRIANGLES, TRIANGLE_FAN\n TRIANGLE_STRIP, QUADS, or QUAD_STRIP
\n",
+ "type": "Constant",
+ "optional": true
+ }
+ ],
+ "chainable": 1,
+ "example": [
+ "\n\n\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n\n\n\n\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nbeginShape(LINES);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n\n\n\n\nbeginShape(TRIANGLES);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nendShape();\n\n\n\n\n\nbeginShape(TRIANGLE_STRIP);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nvertex(90, 75);\nendShape();\n\n\n\n\n\nbeginShape(TRIANGLE_FAN);\nvertex(57.5, 50);\nvertex(57.5, 15);\nvertex(92, 50);\nvertex(57.5, 85);\nvertex(22, 50);\nvertex(57.5, 15);\nendShape();\n\n\n\n\n\nbeginShape(QUADS);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 75);\nvertex(50, 20);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 75);\nvertex(85, 20);\nendShape();\n\n\n\n\n\nbeginShape(QUAD_STRIP);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 20);\nvertex(50, 75);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 20);\nvertex(85, 75);\nendShape();\n\n\n\n\n\nbeginShape();\nvertex(20, 20);\nvertex(40, 20);\nvertex(40, 40);\nvertex(60, 40);\nvertex(60, 60);\nvertex(20, 60);\nendShape(CLOSE);\n\n"
+ ],
+ "alt": "white square-shape with black outline in middle-right of canvas.\n4 black points in a square shape in middle-right of canvas.\n2 horizontal black lines. In the top-right and bottom-right of canvas.\n3 line shape with horizontal on top, vertical in middle and horizontal bottom.\nsquare line shape in middle-right of canvas.\n2 white triangle shapes mid-right canvas. left one pointing up and right down.\n5 horizontal interlocking and alternating white triangles in mid-right canvas.\n4 interlocking white triangles in 45 degree rotated square-shape.\n2 white rectangle shapes in mid-right canvas. Both 20x55.\n3 side-by-side white rectangles center rect is smaller in mid-right canvas.\nThick white l-shape with black outline mid-top-left of canvas.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex"
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 270,
+ "description": "Specifies vertex coordinates for Bezier curves. Each call to\nbezierVertex() defines the position of two control points and\none anchor point of a Bezier curve, adding a new segment to a\nline or shape. For WebGL mode bezierVertex() can be used in 2D\nas well as 3D mode. 2D mode expects 6 parameters, while 3D mode\nexpects 9 parameters (including z coordinates).\n
\nThe first time bezierVertex() is used within a beginShape()\ncall, it must be prefaced with a call to vertex() to set the first anchor\npoint. This function must be used between beginShape() and endShape()\nand only when there is no MODE or POINTS parameter specified to\nbeginShape().
\n",
+ "itemtype": "method",
+ "name": "bezierVertex",
+ "chainable": 1,
+ "example": [
+ "\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nendShape();\n\n\n\n\n\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nbezierVertex(50, 80, 60, 25, 30, 20);\nendShape();\n\n"
+ ],
+ "alt": "crescent-shaped line in middle of canvas. Points facing left.\nwhite crescent shape in middle of canvas. Points facing left.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex",
+ "overloads": [
+ {
+ "line": 270,
+ "params": [
+ {
+ "name": "x2",
+ "description": "x-coordinate for the first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "y-coordinate for the first control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x3",
+ "description": "x-coordinate for the second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "y-coordinate for the second control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x4",
+ "description": "x-coordinate for the anchor point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y4",
+ "description": "y-coordinate for the anchor point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 317,
+ "params": [
+ {
+ "name": "x2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z2",
+ "description": "z-coordinate for the first control point (for WebGL mode)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "x3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z3",
+ "description": "z-coordinate for the second control point (for WebGL mode)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "x4",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y4",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z4",
+ "description": "z-coordinate for the anchor point (for WebGL mode)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 390,
+ "description": "Specifies vertex coordinates for curves. This function may only\nbe used between beginShape() and endShape() and only when there\nis no MODE parameter specified to beginShape().\nFor WebGL mode curveVertex() can be used in 2D as well as 3D mode.\n2D mode expects 2 parameters, while 3D mode expects 3 parameters.\n
\nThe first and last points in a series of curveVertex() lines will be used to\nguide the beginning and end of a the curve. A minimum of four\npoints is required to draw a tiny curve between the second and\nthird points. Adding a fifth point with curveVertex() will draw\nthe curve between the second, third, and fourth points. The\ncurveVertex() function is an implementation of Catmull-Rom\nsplines.
\n",
+ "itemtype": "method",
+ "name": "curveVertex",
+ "chainable": 1,
+ "example": [
+ "\n\n\nstrokeWeight(5);\npoint(84, 91);\npoint(68, 19);\npoint(21, 17);\npoint(32, 91);\nstrokeWeight(1);\n\nnoFill();\nbeginShape();\ncurveVertex(84, 91);\ncurveVertex(84, 91);\ncurveVertex(68, 19);\ncurveVertex(21, 17);\ncurveVertex(32, 91);\ncurveVertex(32, 91);\nendShape();\n\n"
+ ],
+ "alt": "Upside-down u-shape line, mid canvas. left point extends beyond canvas view.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex",
+ "overloads": [
+ {
+ "line": 390,
+ "params": [
+ {
+ "name": "x",
+ "description": "x-coordinate of the vertex
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "y-coordinate of the vertex
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 435,
+ "params": [
+ {
+ "name": "x",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "z-coordinate of the vertex (for WebGL mode)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 500,
+ "description": "Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n
\nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.
\n",
+ "itemtype": "method",
+ "name": "endContour",
+ "chainable": 1,
+ "example": [
+ "\n\n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n"
+ ],
+ "alt": "white rect and smaller grey rect with red outlines in center of canvas.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex"
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 560,
+ "description": "The endShape() function is the companion to beginShape() and may only be\ncalled after beginShape(). When endshape() is called, all of image data\ndefined since the previous call to beginShape() is written into the image\nbuffer. The constant CLOSE as the value for the MODE parameter to close\nthe shape (to connect the beginning and the end).
\n",
+ "itemtype": "method",
+ "name": "endShape",
+ "params": [
+ {
+ "name": "mode",
+ "description": "use CLOSE to close the shape
\n",
+ "type": "Constant",
+ "optional": true
+ }
+ ],
+ "chainable": 1,
+ "example": [
+ "\n\n\nnoFill();\n\nbeginShape();\nvertex(20, 20);\nvertex(45, 20);\nvertex(45, 80);\nendShape(CLOSE);\n\nbeginShape();\nvertex(50, 20);\nvertex(75, 20);\nvertex(75, 80);\nendShape();\n\n"
+ ],
+ "alt": "Triangle line shape with smallest interior angle on bottom and upside-down L.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex"
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 646,
+ "description": "Specifies vertex coordinates for quadratic Bezier curves. Each call to\nquadraticVertex() defines the position of one control points and one\nanchor point of a Bezier curve, adding a new segment to a line or shape.\nThe first time quadraticVertex() is used within a beginShape() call, it\nmust be prefaced with a call to vertex() to set the first anchor point.\nFor WebGL mode quadraticVertex() can be used in 2D as well as 3D mode.\n2D mode expects 4 parameters, while 3D mode expects 6 parameters\n(including z coordinates).\n
\nThis function must be used between beginShape() and endShape()\nand only when there is no MODE or POINTS parameter specified to\nbeginShape().
\n",
+ "itemtype": "method",
+ "name": "quadraticVertex",
+ "chainable": 1,
+ "example": [
+ "\n\n\nstrokeWeight(5);\npoint(20, 20);\npoint(80, 20);\npoint(50, 50);\n\nnoFill();\nstrokeWeight(1);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nendShape();\n\n\n\n\n\nstrokeWeight(5);\npoint(20, 20);\npoint(80, 20);\npoint(50, 50);\n\npoint(20, 80);\npoint(80, 80);\npoint(80, 60);\n\nnoFill();\nstrokeWeight(1);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nquadraticVertex(20, 80, 80, 80);\nvertex(80, 60);\nendShape();\n\n"
+ ],
+ "alt": "arched-shaped black line with 4 pixel thick stroke weight.\nbackwards s-shaped black line with 4 pixel thick stroke weight.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex",
+ "overloads": [
+ {
+ "line": 646,
+ "params": [
+ {
+ "name": "cx",
+ "description": "x-coordinate for the control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "cy",
+ "description": "y-coordinate for the control point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x3",
+ "description": "x-coordinate for the anchor point
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "y-coordinate for the anchor point
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 709,
+ "params": [
+ {
+ "name": "cx",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "cy",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "cz",
+ "description": "z-coordinate for the control point (for WebGL mode)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "x3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z3",
+ "description": "z-coordinate for the anchor point (for WebGL mode)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
+ },
+ {
+ "file": "src/core/shape/vertex.js",
+ "line": 800,
+ "description": "All shapes are constructed by connecting a series of vertices. vertex()\nis used to specify the vertex coordinates for points, lines, triangles,\nquads, and polygons. It is used exclusively within the beginShape() and\nendShape() functions.
\n",
+ "itemtype": "method",
+ "name": "vertex",
+ "chainable": 1,
+ "example": [
+ "\n\n\nstrokeWeight(3);\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n"
+ ],
+ "alt": "8 points making 4 lines",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "Vertex",
+ "overloads": [
+ {
+ "line": 800,
+ "params": [
+ {
+ "name": "x",
+ "description": "x-coordinate of the vertex
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "y-coordinate of the vertex
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 887,
+ "params": [
+ {
+ "name": "x",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "z-coordinate of the vertex
\n",
+ "type": "Number"
+ },
+ {
+ "name": "u",
+ "description": "the vertex's texture u-coordinate
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "v",
+ "description": "the vertex's texture v-coordinate
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "src/core/constants.js",
- "line": 147,
+ "line": 13,
"itemtype": "property",
- "name": "CORNERS",
+ "name": "P2D",
"type": "String",
"final": 1,
"class": "p5",
@@ -4596,9 +5797,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 152,
+ "line": 18,
"itemtype": "property",
- "name": "RADIUS",
+ "name": "WEBGL",
"type": "String",
"final": 1,
"class": "p5",
@@ -4607,9 +5808,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 157,
+ "line": 25,
"itemtype": "property",
- "name": "RIGHT",
+ "name": "ARROW",
"type": "String",
"final": 1,
"class": "p5",
@@ -4618,9 +5819,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 162,
+ "line": 30,
"itemtype": "property",
- "name": "LEFT",
+ "name": "CROSS",
"type": "String",
"final": 1,
"class": "p5",
@@ -4629,9 +5830,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 167,
+ "line": 35,
"itemtype": "property",
- "name": "CENTER",
+ "name": "HAND",
"type": "String",
"final": 1,
"class": "p5",
@@ -4640,9 +5841,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 172,
+ "line": 40,
"itemtype": "property",
- "name": "TOP",
+ "name": "MOVE",
"type": "String",
"final": 1,
"class": "p5",
@@ -4651,9 +5852,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 177,
+ "line": 45,
"itemtype": "property",
- "name": "BOTTOM",
+ "name": "TEXT",
"type": "String",
"final": 1,
"class": "p5",
@@ -4662,105 +5863,130 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 182,
+ "line": 50,
"itemtype": "property",
- "name": "BASELINE",
+ "name": "WAIT",
"type": "String",
"final": 1,
- "default": "alphabetic",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 188,
+ "line": 58,
+ "description": "HALF_PI is a mathematical constant with the value\n1.57079632679489661923. It is half the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",
"itemtype": "property",
- "name": "POINTS",
+ "name": "HALF_PI",
"type": "Number",
"final": 1,
- "default": "0x0000",
+ "example": [
+ "\n\narc(50, 50, 80, 80, 0, HALF_PI);\n"
+ ],
+ "alt": "80x80 white quarter-circle with curve toward bottom right of canvas.",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 194,
+ "line": 77,
+ "description": "PI is a mathematical constant with the value\n3.14159265358979323846. It is the ratio of the circumference\nof a circle to its diameter. It is useful in combination with\nthe trigonometric functions sin() and cos().
\n",
"itemtype": "property",
- "name": "LINES",
+ "name": "PI",
"type": "Number",
"final": 1,
- "default": "0x0001",
+ "example": [
+ "\n\narc(50, 50, 80, 80, 0, PI);\n"
+ ],
+ "alt": "white half-circle with curve toward bottom of canvas.",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 200,
+ "line": 96,
+ "description": "QUARTER_PI is a mathematical constant with the value 0.7853982.\nIt is one quarter the ratio of the circumference of a circle to\nits diameter. It is useful in combination with the trigonometric\nfunctions sin() and cos().
\n",
"itemtype": "property",
- "name": "LINE_STRIP",
+ "name": "QUARTER_PI",
"type": "Number",
"final": 1,
- "default": "0x0003",
+ "example": [
+ "\n\narc(50, 50, 80, 80, 0, QUARTER_PI);\n"
+ ],
+ "alt": "white eighth-circle rotated about 40 degrees with curve bottom right canvas.",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 206,
+ "line": 115,
+ "description": "TAU is an alias for TWO_PI, a mathematical constant with the\nvalue 6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",
"itemtype": "property",
- "name": "LINE_LOOP",
+ "name": "TAU",
"type": "Number",
"final": 1,
- "default": "0x0002",
+ "example": [
+ "\n\narc(50, 50, 80, 80, 0, TAU);\n"
+ ],
+ "alt": "80x80 white ellipse shape in center of canvas.",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 212,
+ "line": 134,
+ "description": "TWO_PI is a mathematical constant with the value\n6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",
"itemtype": "property",
- "name": "TRIANGLES",
+ "name": "TWO_PI",
"type": "Number",
"final": 1,
- "default": "0x0004",
+ "example": [
+ "\n\narc(50, 50, 80, 80, 0, TWO_PI);\n"
+ ],
+ "alt": "80x80 white ellipse shape in center of canvas.",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 218,
+ "line": 153,
+ "description": "Constant to be used with angleMode() function, to set the mode which\np5.js interprates and calculates angles (either DEGREES or RADIANS).
\n",
"itemtype": "property",
- "name": "TRIANGLE_FAN",
- "type": "Number",
+ "name": "DEGREES",
+ "type": "String",
"final": 1,
- "default": "0x0006",
+ "example": [
+ "\n\nfunction setup() {\n angleMode(DEGREES);\n}\n"
+ ],
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 224,
+ "line": 167,
+ "description": "Constant to be used with angleMode() function, to set the mode which\np5.js interprates and calculates angles (either RADIANS or DEGREES).
\n",
"itemtype": "property",
- "name": "TRIANGLE_STRIP",
- "type": "Number",
+ "name": "RADIANS",
+ "type": "String",
"final": 1,
- "default": "0x0005",
+ "example": [
+ "\n\nfunction setup() {\n angleMode(RADIANS);\n}\n"
+ ],
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 230,
+ "line": 185,
"itemtype": "property",
- "name": "QUADS",
+ "name": "CORNER",
"type": "String",
"final": 1,
"class": "p5",
@@ -4769,21 +5995,20 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 235,
+ "line": 190,
"itemtype": "property",
- "name": "QUAD_STRIP",
+ "name": "CORNERS",
"type": "String",
"final": 1,
- "default": "quad_strip",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 241,
+ "line": 195,
"itemtype": "property",
- "name": "CLOSE",
+ "name": "RADIUS",
"type": "String",
"final": 1,
"class": "p5",
@@ -4792,9 +6017,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 246,
+ "line": 200,
"itemtype": "property",
- "name": "OPEN",
+ "name": "RIGHT",
"type": "String",
"final": 1,
"class": "p5",
@@ -4803,9 +6028,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 251,
+ "line": 205,
"itemtype": "property",
- "name": "CHORD",
+ "name": "LEFT",
"type": "String",
"final": 1,
"class": "p5",
@@ -4814,9 +6039,9 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 256,
+ "line": 210,
"itemtype": "property",
- "name": "PIE",
+ "name": "CENTER",
"type": "String",
"final": 1,
"class": "p5",
@@ -4825,88 +6050,229 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 261,
+ "line": 215,
"itemtype": "property",
- "name": "PROJECT",
+ "name": "TOP",
"type": "String",
"final": 1,
- "default": "square",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 267,
+ "line": 220,
"itemtype": "property",
- "name": "SQUARE",
+ "name": "BOTTOM",
"type": "String",
"final": 1,
- "default": "butt",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 273,
+ "line": 225,
"itemtype": "property",
- "name": "ROUND",
+ "name": "BASELINE",
"type": "String",
"final": 1,
+ "default": "alphabetic",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 278,
+ "line": 231,
"itemtype": "property",
- "name": "BEVEL",
- "type": "String",
+ "name": "POINTS",
+ "type": "Number",
"final": 1,
+ "default": "0x0000",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 283,
+ "line": 237,
"itemtype": "property",
- "name": "MITER",
- "type": "String",
+ "name": "LINES",
+ "type": "Number",
"final": 1,
+ "default": "0x0001",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 290,
+ "line": 243,
"itemtype": "property",
- "name": "RGB",
- "type": "String",
+ "name": "LINE_STRIP",
+ "type": "Number",
"final": 1,
+ "default": "0x0003",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 295,
+ "line": 249,
"itemtype": "property",
- "name": "HSB",
- "type": "String",
+ "name": "LINE_LOOP",
+ "type": "Number",
"final": 1,
+ "default": "0x0002",
"class": "p5",
"module": "Constants",
"submodule": "Constants"
},
{
"file": "src/core/constants.js",
- "line": 300,
+ "line": 255,
"itemtype": "property",
- "name": "HSL",
+ "name": "TRIANGLES",
+ "type": "Number",
+ "final": 1,
+ "default": "0x0004",
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 261,
+ "itemtype": "property",
+ "name": "TRIANGLE_FAN",
+ "type": "Number",
+ "final": 1,
+ "default": "0x0006",
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 267,
+ "itemtype": "property",
+ "name": "TRIANGLE_STRIP",
+ "type": "Number",
+ "final": 1,
+ "default": "0x0005",
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 273,
+ "itemtype": "property",
+ "name": "QUADS",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 278,
+ "itemtype": "property",
+ "name": "QUAD_STRIP",
+ "type": "String",
+ "final": 1,
+ "default": "quad_strip",
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 284,
+ "itemtype": "property",
+ "name": "CLOSE",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 289,
+ "itemtype": "property",
+ "name": "OPEN",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 294,
+ "itemtype": "property",
+ "name": "CHORD",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 299,
+ "itemtype": "property",
+ "name": "PIE",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 304,
+ "itemtype": "property",
+ "name": "PROJECT",
+ "type": "String",
+ "final": 1,
+ "default": "square",
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 310,
+ "itemtype": "property",
+ "name": "SQUARE",
+ "type": "String",
+ "final": 1,
+ "default": "butt",
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 316,
+ "itemtype": "property",
+ "name": "ROUND",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 321,
+ "itemtype": "property",
+ "name": "BEVEL",
"type": "String",
"final": 1,
"class": "p5",
@@ -4917,6 +6283,61 @@ module.exports={
"file": "src/core/constants.js",
"line": 326,
"itemtype": "property",
+ "name": "MITER",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 333,
+ "itemtype": "property",
+ "name": "RGB",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 338,
+ "itemtype": "property",
+ "name": "HSB",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 343,
+ "itemtype": "property",
+ "name": "HSL",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 350,
+ "itemtype": "property",
+ "name": "AUTO",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/constants.js",
+ "line": 373,
+ "itemtype": "property",
"name": "BLEND",
"type": "String",
"final": 1,
@@ -4927,7 +6348,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 332,
+ "line": 379,
"itemtype": "property",
"name": "ADD",
"type": "String",
@@ -4939,7 +6360,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 340,
+ "line": 387,
"itemtype": "property",
"name": "DARKEST",
"type": "String",
@@ -4950,7 +6371,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 345,
+ "line": 392,
"itemtype": "property",
"name": "LIGHTEST",
"type": "String",
@@ -4962,7 +6383,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 351,
+ "line": 398,
"itemtype": "property",
"name": "DIFFERENCE",
"type": "String",
@@ -4973,7 +6394,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 356,
+ "line": 403,
"itemtype": "property",
"name": "EXCLUSION",
"type": "String",
@@ -4984,7 +6405,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 361,
+ "line": 408,
"itemtype": "property",
"name": "MULTIPLY",
"type": "String",
@@ -4995,7 +6416,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 366,
+ "line": 413,
"itemtype": "property",
"name": "SCREEN",
"type": "String",
@@ -5006,7 +6427,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 371,
+ "line": 418,
"itemtype": "property",
"name": "REPLACE",
"type": "String",
@@ -5018,7 +6439,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 377,
+ "line": 424,
"itemtype": "property",
"name": "OVERLAY",
"type": "String",
@@ -5029,7 +6450,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 382,
+ "line": 429,
"itemtype": "property",
"name": "HARD_LIGHT",
"type": "String",
@@ -5040,7 +6461,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 387,
+ "line": 434,
"itemtype": "property",
"name": "SOFT_LIGHT",
"type": "String",
@@ -5051,7 +6472,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 392,
+ "line": 439,
"itemtype": "property",
"name": "DODGE",
"type": "String",
@@ -5063,7 +6484,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 398,
+ "line": 445,
"itemtype": "property",
"name": "BURN",
"type": "String",
@@ -5075,7 +6496,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 406,
+ "line": 453,
"itemtype": "property",
"name": "THRESHOLD",
"type": "String",
@@ -5086,7 +6507,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 411,
+ "line": 458,
"itemtype": "property",
"name": "GRAY",
"type": "String",
@@ -5097,7 +6518,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 416,
+ "line": 463,
"itemtype": "property",
"name": "OPAQUE",
"type": "String",
@@ -5108,7 +6529,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 421,
+ "line": 468,
"itemtype": "property",
"name": "INVERT",
"type": "String",
@@ -5119,7 +6540,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 426,
+ "line": 473,
"itemtype": "property",
"name": "POSTERIZE",
"type": "String",
@@ -5130,7 +6551,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 431,
+ "line": 478,
"itemtype": "property",
"name": "DILATE",
"type": "String",
@@ -5141,7 +6562,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 436,
+ "line": 483,
"itemtype": "property",
"name": "ERODE",
"type": "String",
@@ -5152,7 +6573,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 441,
+ "line": 488,
"itemtype": "property",
"name": "BLUR",
"type": "String",
@@ -5163,7 +6584,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 448,
+ "line": 495,
"itemtype": "property",
"name": "NORMAL",
"type": "String",
@@ -5174,7 +6595,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 453,
+ "line": 500,
"itemtype": "property",
"name": "ITALIC",
"type": "String",
@@ -5185,7 +6606,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 458,
+ "line": 505,
"itemtype": "property",
"name": "BOLD",
"type": "String",
@@ -5196,7 +6617,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 482,
+ "line": 536,
"itemtype": "property",
"name": "LANDSCAPE",
"type": "String",
@@ -5207,7 +6628,7 @@ module.exports={
},
{
"file": "src/core/constants.js",
- "line": 487,
+ "line": 541,
"itemtype": "property",
"name": "PORTRAIT",
"type": "String",
@@ -5217,734 +6638,214 @@ module.exports={
"submodule": "Constants"
},
{
- "file": "src/core/core.js",
- "line": 15,
- "description": "This is the p5 instance constructor.
\nA p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.
\nA p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object
\n",
- "params": [
- {
- "name": "sketch",
- "description": "a closure that can set optional preload(),\n setup(), and/or draw() properties on the\n given p5 instance
\n",
- "type": "Function"
- },
- {
- "name": "node",
- "description": "element to attach canvas to, if a\n boolean is passed in use it as sync
\n",
- "type": "HTMLElement|boolean",
- "optional": true
- },
- {
- "name": "sync",
- "description": "start synchronously (optional)
\n",
- "type": "Boolean",
- "optional": true
- }
- ],
- "return": {
- "description": "a p5 instance",
- "type": "P5"
- },
+ "file": "src/core/constants.js",
+ "line": 551,
+ "itemtype": "property",
+ "name": "GRID",
+ "type": "String",
+ "final": 1,
"class": "p5",
- "module": "Structure",
- "submodule": "Structure"
+ "module": "Constants",
+ "submodule": "Constants"
},
{
- "file": "src/core/core.js",
- "line": 49,
- "description": "Called directly before setup(), the preload() function is used to handle\nasynchronous loading of external files. If a preload function is\ndefined, setup() will wait until any load calls within have finished.\nNothing besides load calls should be inside preload (loadImage,\nloadJSON, loadFont, loadStrings, etc).
\nBy default the text "loading..." will be displayed. To make your own\nloading page, include an HTML element with id "p5_loading" in your\npage. More information here.
\n",
+ "file": "src/core/constants.js",
+ "line": 557,
+ "itemtype": "property",
+ "name": "AXES",
+ "type": "String",
+ "final": 1,
+ "class": "p5",
+ "module": "Constants",
+ "submodule": "Constants"
+ },
+ {
+ "file": "src/core/environment.js",
+ "line": 22,
+ "description": "The print() function writes to the console area of your browser.\nThis function is often helpful for looking at the data a program is\nproducing. This function creates a new line of text for each call to\nthe function. Individual elements can be\nseparated with quotes ("") and joined with the addition operator (+).
\n",
"itemtype": "method",
- "name": "preload",
+ "name": "print",
+ "params": [
+ {
+ "name": "contents",
+ "description": "any combination of Number, String, Object, Boolean,\n Array to print
\n",
+ "type": "Any"
+ }
+ ],
"example": [
- "\n\nvar img;\nvar c;\nfunction preload() { // preload() runs once\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() { // setup() waits until preload() is done\n img.loadPixels();\n // get color of middle pixel\n c = img.get(img.width/2, img.height/2);\n}\n\nfunction draw() {\n background(c);\n image(img, 25, 25, 50, 50);\n}\n"
+ "\n\nvar x = 10;\nprint('The value of x is ' + x);\n// prints \"The value of x is 10\"\n"
],
- "alt": "nothing displayed",
+ "alt": "default grey canvas",
"class": "p5",
- "module": "Structure",
- "submodule": "Structure"
+ "module": "Environment",
+ "submodule": "Environment"
},
{
- "file": "src/core/core.js",
- "line": 85,
- "description": "The setup() function is called once when the program starts. It's used to\ndefine initial environment properties such as screen size and background\ncolor and to load media such as images and fonts as the program starts.\nThere can only be one setup() function for each program and it shouldn't\nbe called again after its initial execution.\n
\nNote: Variables declared within setup() are not accessible within other\nfunctions, including draw().
\n",
- "itemtype": "method",
- "name": "setup",
+ "file": "src/core/environment.js",
+ "line": 49,
+ "description": "The system variable frameCount contains the number of frames that have\nbeen displayed since the program started. Inside setup() the value is 0,\nafter the first iteration of draw it is 1, etc.
\n",
+ "itemtype": "property",
+ "name": "frameCount",
+ "type": "Integer",
+ "readonly": "",
"example": [
- "\n\nvar a = 0;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(102);\n}\n\nfunction draw() {\n rect(a++%width, 10, 2, 80);\n}\n"
+ "\n \nfunction setup() {\n frameRate(30);\n textSize(30);\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(200);\n text(frameCount, width / 2, height / 2);\n}\n"
],
- "alt": "nothing displayed",
+ "alt": "numbers rapidly counting upward with frame count set to 30.",
"class": "p5",
- "module": "Structure",
- "submodule": "Structure"
+ "module": "Environment",
+ "submodule": "Environment"
},
{
- "file": "src/core/core.js",
- "line": 116,
- "description": "Called directly after setup(), the draw() function continuously executes\nthe lines of code contained inside its block until the program is stopped\nor noLoop() is called. Note if noLoop() is called in setup(), draw() will\nstill be executed once before stopping. draw() is called automatically and\nshould never be called explicitly.\n
\nIt should always be controlled with noLoop(), redraw() and loop(). After\nnoLoop() stops the code in draw() from executing, redraw() causes the\ncode inside draw() to execute once, and loop() will cause the code\ninside draw() to resume executing continuously.\n
\nThe number of times draw() executes in each second may be controlled with\nthe frameRate() function.\n
\nThere can only be one draw() function for each sketch, and draw() must\nexist if you want the code to run continuously, or to process events such\nas mousePressed(). Sometimes, you might have an empty call to draw() in\nyour program, as shown in the above example.\n
\nIt is important to note that the drawing coordinate system will be reset\nat the beginning of each draw() call. If any transformations are performed\nwithin draw() (ex: scale, rotate, translate, their effects will be\nundone at the beginning of draw(), so transformations will not accumulate\nover time. On the other hand, styling applied (ex: fill, stroke, etc) will\nremain in effect.
\n",
- "itemtype": "method",
- "name": "draw",
+ "file": "src/core/environment.js",
+ "line": 76,
+ "description": "Confirms if the window a p5.js program is in is "focused," meaning that\nthe sketch will accept mouse or keyboard input. This variable is\n"true" if the window is focused and "false" if not.
\n",
+ "itemtype": "property",
+ "name": "focused",
+ "type": "Boolean",
+ "readonly": "",
"example": [
- "\n\nvar yPos = 0;\nfunction setup() { // setup() runs once\n frameRate(30);\n}\nfunction draw() { // draw() loops forever, until stopped\n background(204);\n yPos = yPos - 1;\n if (yPos < 0) {\n yPos = height;\n }\n line(0, yPos, width, yPos);\n}\n"
+ "\n\n// To demonstrate, put two windows side by side.\n// Click on the window that the p5 sketch isn't in!\nfunction draw() {\n background(200);\n noStroke();\n fill(0, 200, 0);\n ellipse(25, 25, 50, 50);\n\n if (!focused) {\n // or \"if (focused === false)\"\n stroke(200, 0, 0);\n line(0, 0, 100, 100);\n line(100, 0, 0, 100);\n }\n}\n"
],
- "alt": "nothing displayed",
+ "alt": "green 50x50 ellipse at top left. Red X covers canvas when page focus changes",
"class": "p5",
- "module": "Structure",
- "submodule": "Structure"
+ "module": "Environment",
+ "submodule": "Environment"
},
{
- "file": "src/core/core.js",
- "line": 393,
- "description": "Removes the entire p5 sketch. This will remove the canvas and any\nelements created by p5.js. It will also stop the draw loop and unbind\nany properties or methods from the window global scope. It will\nleave a variable p5 in case you wanted to create a new p5 sketch.\nIf you like, you can set p5 = null to erase it. While all functions and\nvariables and objects created by the p5 library will be removed, any\nother global variables created by your code will remain.
\n",
+ "file": "src/core/environment.js",
+ "line": 108,
+ "description": "Sets the cursor to a predefined symbol or an image, or makes it visible\nif already hidden. If you are trying to set an image as the cursor, the\nrecommended size is 16x16 or 32x32 pixels. The values for parameters x and y\nmust be less than the dimensions of the image.
\n",
"itemtype": "method",
- "name": "remove",
+ "name": "cursor",
+ "params": [
+ {
+ "name": "type",
+ "description": "either ARROW, CROSS, HAND, MOVE, TEXT, or\n WAIT, or path for image
\n",
+ "type": "String|Constant"
+ },
+ {
+ "name": "x",
+ "description": "the horizontal active spot of the cursor
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "y",
+ "description": "the vertical active spot of the cursor
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
"example": [
- "\n\nfunction draw() {\n ellipse(50, 50, 10, 10);\n}\n\nfunction mousePressed() {\n remove(); // remove whole sketch on mouse press\n}\n"
+ "\n\n// Move the mouse left and right across the image\n// to see the cursor change from a cross to a hand\nfunction draw() {\n line(width / 2, 0, width / 2, height);\n if (mouseX < 50) {\n cursor(CROSS);\n } else {\n cursor(HAND);\n }\n}\n"
],
- "alt": "nothing displayed",
+ "alt": "horizontal line divides canvas. cursor on left is a cross, right is hand.",
"class": "p5",
- "module": "Structure",
- "submodule": "Structure"
+ "module": "Environment",
+ "submodule": "Environment"
},
{
- "file": "src/core/curves.js",
- "line": 16,
- "description": "Draws a cubic Bezier curve on the screen. These curves are defined by a\nseries of anchor and control points. The first two parameters specify\nthe first anchor point and the last two parameters specify the other\nanchor point, which become the first and last points on the curve. The\nmiddle parameters specify the two control points which define the shape\nof the curve. Approximately speaking, control points "pull" the curve\ntowards them.
Bezier curves were developed by French\nautomotive engineer Pierre Bezier, and are commonly used in computer\ngraphics to define gently sloping curves. See also curve().
\n",
+ "file": "src/core/environment.js",
+ "line": 167,
+ "description": "Specifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default frame rate is based on the frame rate of the display\n(here also called "refresh rate"), which is set to 60 frames per second on most\ncomputers. A frame rate of 24 frames per second (usual for movies) or above\nwill be enough for smooth animations\nThis is the same as setFrameRate(val).\n
\nCalling frameRate() with no arguments returns the current framerate. The\ndraw function must run at least once before it will return a value. This\nis the same as getFrameRate().\n
\nCalling frameRate() with arguments that are not of the type numbers\nor are non positive also returns current framerate.
\n",
"itemtype": "method",
- "name": "bezier",
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
+ "name": "frameRate",
+ "chainable": 1,
"example": [
- "\n\n\nnoFill();\nstroke(255, 102, 0);\nline(85, 20, 10, 10);\nline(90, 90, 15, 80);\nstroke(0, 0, 0);\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\n\n"
+ "\n\n\nvar rectX = 0;\nvar fr = 30; //starting FPS\nvar clr;\n\nfunction setup() {\n background(200);\n frameRate(fr); // Attempt to refresh at starting FPS\n clr = color(255, 0, 0);\n}\n\nfunction draw() {\n background(200);\n rectX = rectX += 1; // Move Rectangle\n\n if (rectX >= width) {\n // If you go off screen.\n if (fr === 30) {\n clr = color(0, 0, 255);\n fr = 10;\n frameRate(fr); // make frameRate 10 FPS\n } else {\n clr = color(255, 0, 0);\n fr = 30;\n frameRate(fr); // make frameRate 30 FPS\n }\n rectX = 0;\n }\n fill(clr);\n rect(rectX, 40, 20, 20);\n}\n"
],
- "alt": "stretched black s-shape in center with orange lines extending from end points.\nstretched black s-shape with 10 5x5 white ellipses along the shape.\nstretched black s-shape with 7 5x5 ellipses and orange lines along the shape.\nstretched black s-shape with 17 small orange lines extending from under shape.\nhorseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.\nLine shaped like right-facing arrow,points move with mouse-x and warp shape.\nhorizontal line that hooks downward on the right and 13 5x5 ellipses along it.\nright curving line mid-right of canvas with 7 short lines radiating from it.",
+ "alt": "blue rect moves left to right, followed by red rect moving faster. Loops.",
"class": "p5",
- "module": "Shape",
- "submodule": "Curves",
+ "module": "Environment",
+ "submodule": "Environment",
"overloads": [
{
- "line": 16,
+ "line": 167,
"params": [
{
- "name": "x1",
- "description": "x-coordinate for the first anchor point
\n",
- "type": "Number"
- },
- {
- "name": "y1",
- "description": "y-coordinate for the first anchor point
\n",
- "type": "Number"
- },
- {
- "name": "x2",
- "description": "x-coordinate for the first control point
\n",
- "type": "Number"
- },
- {
- "name": "y2",
- "description": "y-coordinate for the first control point
\n",
- "type": "Number"
- },
- {
- "name": "x3",
- "description": "x-coordinate for the second control point
\n",
- "type": "Number"
- },
- {
- "name": "y3",
- "description": "y-coordinate for the second control point
\n",
- "type": "Number"
- },
- {
- "name": "x4",
- "description": "x-coordinate for the second anchor point
\n",
- "type": "Number"
- },
- {
- "name": "y4",
- "description": "y-coordinate for the second anchor point
\n",
+ "name": "fps",
+ "description": "number of frames to be displayed every second
\n",
"type": "Number"
}
],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- }
+ "chainable": 1
},
{
- "line": 59,
- "params": [
- {
- "name": "z1",
- "description": "z-coordinate for the first anchor point
\n",
- "type": "Number"
- },
- {
- "name": "z2",
- "description": "z-coordinate for the first control point
\n",
- "type": "Number"
- },
- {
- "name": "z3",
- "description": "z-coordinate for the first anchor point
\n",
- "type": "Number"
- },
- {
- "name": "z4",
- "description": "z-coordinate for the first control point
\n",
- "type": "Number"
- }
- ],
- "chainable": 1
+ "line": 228,
+ "params": [],
+ "return": {
+ "description": "current frameRate",
+ "type": "Number"
+ }
}
]
},
{
- "file": "src/core/curves.js",
- "line": 99,
- "description": "Sets the resolution at which Beziers display.
\nThe default value is 20.
\n",
- "params": [
- {
- "name": "detail",
- "description": "resolution of the curves
\n",
- "type": "Number"
- }
+ "file": "src/core/environment.js",
+ "line": 268,
+ "description": "Hides the cursor from view.
\n",
+ "itemtype": "method",
+ "name": "noCursor",
+ "example": [
+ "\n\nfunction setup() {\n noCursor();\n}\n\nfunction draw() {\n background(200);\n ellipse(mouseX, mouseY, 10, 10);\n}\n"
],
- "chainable": 1,
+ "alt": "cursor becomes 10x 10 white ellipse the moves with mouse x and y.",
+ "class": "p5",
+ "module": "Environment",
+ "submodule": "Environment"
+ },
+ {
+ "file": "src/core/environment.js",
+ "line": 293,
+ "description": "System variable that stores the width of the screen display according to The\ndefault pixelDensity. This is used to run a\nfull-screen program on any display size. To return actual screen size,\nmultiply this by pixelDensity.
\n",
+ "itemtype": "property",
+ "name": "displayWidth",
+ "type": "Number",
+ "readonly": "",
"example": [
- "\n\n\nbackground(204);\nbezierDetail(50);\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\n\n"
+ "\n\ncreateCanvas(displayWidth, displayHeight);\n"
],
- "alt": "stretched black s-shape with 7 5x5 ellipses and orange lines along the shape.",
+ "alt": "cursor becomes 10x 10 white ellipse the moves with mouse x and y.",
"class": "p5",
- "module": "Shape",
- "submodule": "Curves"
+ "module": "Environment",
+ "submodule": "Environment"
},
{
- "file": "src/core/curves.js",
- "line": 124,
- "description": "Evaluates the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a bezier curve at t.
\n",
- "itemtype": "method",
- "name": "bezierPoint",
- "params": [
- {
- "name": "a",
- "description": "coordinate of first point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "b",
- "description": "coordinate of first control point
\n",
- "type": "Number"
- },
- {
- "name": "c",
- "description": "coordinate of second control point
\n",
- "type": "Number"
- },
- {
- "name": "d",
- "description": "coordinate of second point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "t",
- "description": "value between 0 and 1
\n",
- "type": "Number"
- }
+ "file": "src/core/environment.js",
+ "line": 312,
+ "description": "System variable that stores the height of the screen display according to The\ndefault pixelDensity. This is used to run a\nfull-screen program on any display size. To return actual screen size,\nmultiply this by pixelDensity.
\n",
+ "itemtype": "property",
+ "name": "displayHeight",
+ "type": "Number",
+ "readonly": "",
+ "example": [
+ "\n\ncreateCanvas(displayWidth, displayHeight);\n"
],
- "return": {
- "description": "the value of the Bezier at position t",
- "type": "Number"
- },
+ "alt": "no display.",
+ "class": "p5",
+ "module": "Environment",
+ "submodule": "Environment"
+ },
+ {
+ "file": "src/core/environment.js",
+ "line": 331,
+ "description": "System variable that stores the width of the inner window, it maps to\nwindow.innerWidth.
\n",
+ "itemtype": "property",
+ "name": "windowWidth",
+ "type": "Number",
+ "readonly": "",
"example": [
- "\n\n\nnoFill();\nx1 = 85, x2 = 10, x3 = 90, x4 = 15;\ny1 = 20, y2 = 10, y3 = 90, y4 = 80;\nbezier(x1, y1, x2, y2, x3, y3, x4, y4);\nfill(255);\nsteps = 10;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = bezierPoint(x1, x2, x3, x4, t);\n y = bezierPoint(y1, y2, y3, y4, t);\n ellipse(x, y, 5, 5);\n}\n\n"
+ "\n\ncreateCanvas(windowWidth, windowHeight);\n"
],
- "alt": "stretched black s-shape with 17 small orange lines extending from under shape.",
+ "alt": "no display.",
"class": "p5",
- "module": "Shape",
- "submodule": "Curves"
- },
- {
- "file": "src/core/curves.js",
- "line": 175,
- "description": "Evaluates the tangent to the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.
\n",
- "itemtype": "method",
- "name": "bezierTangent",
- "params": [
- {
- "name": "a",
- "description": "coordinate of first point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "b",
- "description": "coordinate of first control point
\n",
- "type": "Number"
- },
- {
- "name": "c",
- "description": "coordinate of second control point
\n",
- "type": "Number"
- },
- {
- "name": "d",
- "description": "coordinate of second point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "t",
- "description": "value between 0 and 1
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "the tangent at position t",
- "type": "Number"
- },
- "example": [
- "\n\n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nsteps = 6;\nfill(255);\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n // Get the location of the point\n x = bezierPoint(85, 10, 90, 15, t);\n y = bezierPoint(20, 10, 90, 80, t);\n // Get the tangent points\n tx = bezierTangent(85, 10, 90, 15, t);\n ty = bezierTangent(20, 10, 90, 80, t);\n // Calculate an angle from the tangent points\n a = atan2(ty, tx);\n a += PI;\n stroke(255, 102, 0);\n line(x, y, cos(a)*30 + x, sin(a)*30 + y);\n // The following line of code makes a line\n // inverse of the above line\n //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y);\n stroke(0);\n ellipse(x, y, 5, 5);\n}\n\n\n\n\n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nstroke(255, 102, 0);\nsteps = 16;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = bezierPoint(85, 10, 90, 15, t);\n y = bezierPoint(20, 10, 90, 80, t);\n tx = bezierTangent(85, 10, 90, 15, t);\n ty = bezierTangent(20, 10, 90, 80, t);\n a = atan2(ty, tx);\n a -= HALF_PI;\n line(x, y, cos(a)*8 + x, sin(a)*8 + y);\n}\n\n"
- ],
- "alt": "s-shaped line with 17 short orange lines extending from underside of shape",
- "class": "p5",
- "module": "Shape",
- "submodule": "Curves"
- },
- {
- "file": "src/core/curves.js",
- "line": 256,
- "description": "Draws a curved line on the screen between two points, given as the\nmiddle four parameters. The first two parameters are a control point, as\nif the curve came from this point even though it's not drawn. The last\ntwo parameters similarly describe the other control point.
\nLonger curves can be created by putting a series of curve() functions\ntogether or using curveVertex(). An additional function called\ncurveTightness() provides control for the visual quality of the curve.\nThe curve() function is an implementation of Catmull-Rom splines.
\n",
- "itemtype": "method",
- "name": "curve",
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
- "example": [
- "\n\n\nnoFill();\nstroke(255, 102, 0);\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\nstroke(0);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nstroke(255, 102, 0);\ncurve(73, 24, 73, 61, 15, 65, 15, 65);\n\n\n\n\n// Define the curve points as JavaScript objects\np1 = {x: 5, y: 26}, p2 = {x: 73, y: 24}\np3 = {x: 73, y: 61}, p4 = {x: 15, y: 65}\nnoFill();\nstroke(255, 102, 0);\ncurve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y)\nstroke(0);\ncurve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y)\nstroke(255, 102, 0);\ncurve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y)\n\n"
- ],
- "alt": "horseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Curves",
- "overloads": [
- {
- "line": 256,
- "params": [
- {
- "name": "x1",
- "description": "x-coordinate for the beginning control point
\n",
- "type": "Number"
- },
- {
- "name": "y1",
- "description": "y-coordinate for the beginning control point
\n",
- "type": "Number"
- },
- {
- "name": "x2",
- "description": "x-coordinate for the first point
\n",
- "type": "Number"
- },
- {
- "name": "y2",
- "description": "y-coordinate for the first point
\n",
- "type": "Number"
- },
- {
- "name": "x3",
- "description": "x-coordinate for the second point
\n",
- "type": "Number"
- },
- {
- "name": "y3",
- "description": "y-coordinate for the second point
\n",
- "type": "Number"
- },
- {
- "name": "x4",
- "description": "x-coordinate for the ending control point
\n",
- "type": "Number"
- },
- {
- "name": "y4",
- "description": "y-coordinate for the ending control point
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- }
- },
- {
- "line": 308,
- "params": [
- {
- "name": "z1",
- "description": "z-coordinate for the beginning control point
\n",
- "type": "Number"
- },
- {
- "name": "z2",
- "description": "z-coordinate for the first point
\n",
- "type": "Number"
- },
- {
- "name": "z3",
- "description": "z-coordinate for the second point
\n",
- "type": "Number"
- },
- {
- "name": "z4",
- "description": "z-coordinate for the ending control point
\n",
- "type": "Number"
- }
- ],
- "chainable": 1
- }
- ]
- },
- {
- "file": "src/core/curves.js",
- "line": 353,
- "description": "Sets the resolution at which curves display.
\nThe default value is 20.
\n",
- "params": [
- {
- "name": "resolution",
- "description": "of the curves
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\nbackground(204);\ncurveDetail(20);\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\n\n"
- ],
- "alt": "white arch shape in top-mid canvas.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Curves"
- },
- {
- "file": "src/core/curves.js",
- "line": 378,
- "description": "Modifies the quality of forms created with curve() and curveVertex().\nThe parameter tightness determines how the curve fits to the vertex\npoints. The value 0.0 is the default value for tightness (this value\ndefines the curves to be Catmull-Rom splines) and the value 1.0 connects\nall the points with straight lines. Values within the range -5.0 and 5.0\nwill deform the curves but will leave them recognizable and as values\nincrease in magnitude, they will continue to deform.
\n",
- "itemtype": "method",
- "name": "curveTightness",
- "params": [
- {
- "name": "amount",
- "description": "of deformation from the original vertices
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n// Move the mouse left and right to see the curve change\n\nfunction setup() {\n createCanvas(100, 100);\n noFill();\n}\n\nfunction draw() {\n background(204);\n var t = map(mouseX, 0, width, -5, 5);\n curveTightness(t);\n beginShape();\n curveVertex(10, 26);\n curveVertex(10, 26);\n curveVertex(83, 24);\n curveVertex(83, 61);\n curveVertex(25, 65);\n curveVertex(25, 65);\n endShape();\n}\n\n"
- ],
- "alt": "Line shaped like right-facing arrow,points move with mouse-x and warp shape.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Curves"
- },
- {
- "file": "src/core/curves.js",
- "line": 423,
- "description": "Evaluates the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are points\non the curve, and b and c are the control points.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a curve at t.
\n",
- "itemtype": "method",
- "name": "curvePoint",
- "params": [
- {
- "name": "a",
- "description": "coordinate of first point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "b",
- "description": "coordinate of first control point
\n",
- "type": "Number"
- },
- {
- "name": "c",
- "description": "coordinate of second control point
\n",
- "type": "Number"
- },
- {
- "name": "d",
- "description": "coordinate of second point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "t",
- "description": "value between 0 and 1
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "bezier value at position t",
- "type": "Number"
- },
- "example": [
- "\n\n\nnoFill();\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nfill(255);\nellipseMode(CENTER);\nsteps = 6;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = curvePoint(5, 5, 73, 73, t);\n y = curvePoint(26, 26, 24, 61, t);\n ellipse(x, y, 5, 5);\n x = curvePoint(5, 73, 73, 15, t);\n y = curvePoint(26, 24, 61, 65, t);\n ellipse(x, y, 5, 5);\n}\n\n\n\nline hooking down to right-bottom with 13 5x5 white ellipse points"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "Curves"
- },
- {
- "file": "src/core/curves.js",
- "line": 476,
- "description": "Evaluates the tangent to the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are points on the curve,\nand b and c are the control points.
\n",
- "itemtype": "method",
- "name": "curveTangent",
- "params": [
- {
- "name": "a",
- "description": "coordinate of first point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "b",
- "description": "coordinate of first control point
\n",
- "type": "Number"
- },
- {
- "name": "c",
- "description": "coordinate of second control point
\n",
- "type": "Number"
- },
- {
- "name": "d",
- "description": "coordinate of second point on the curve
\n",
- "type": "Number"
- },
- {
- "name": "t",
- "description": "value between 0 and 1
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "the tangent at position t",
- "type": "Number"
- },
- "example": [
- "\n\n\nnoFill();\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nsteps = 6;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = curvePoint(5, 73, 73, 15, t);\n y = curvePoint(26, 24, 61, 65, t);\n //ellipse(x, y, 5, 5);\n tx = curveTangent(5, 73, 73, 15, t);\n ty = curveTangent(26, 24, 61, 65, t);\n a = atan2(ty, tx);\n a -= PI/2.0;\n line(x, y, cos(a)*8 + x, sin(a)*8 + y);\n}\n\n"
- ],
- "alt": "right curving line mid-right of canvas with 7 short lines radiating from it.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Curves"
- },
- {
- "file": "src/core/environment.js",
- "line": 22,
- "description": "The print() function writes to the console area of your browser.\nThis function is often helpful for looking at the data a program is\nproducing. This function creates a new line of text for each call to\nthe function. Individual elements can be\nseparated with quotes ("") and joined with the addition operator (+).
\n",
- "itemtype": "method",
- "name": "print",
- "params": [
- {
- "name": "contents",
- "description": "any combination of Number, String, Object, Boolean,\n Array to print
\n",
- "type": "Any"
- }
- ],
- "example": [
- "\n\nvar x = 10;\nprint(\"The value of x is \" + x);\n// prints \"The value of x is 10\"\n"
- ],
- "alt": "default grey canvas",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 51,
- "description": "The system variable frameCount contains the number of frames that have\nbeen displayed since the program started. Inside setup() the value is 0,\nafter the first iteration of draw it is 1, etc.
\n",
- "itemtype": "property",
- "name": "frameCount",
- "type": "Number",
- "readonly": "",
- "example": [
- "\n \n function setup() {\n frameRate(30);\n textSize(20);\n textSize(30);\n textAlign(CENTER);\n }\n\n function draw() {\n background(200);\n text(frameCount, width/2, height/2);\n }\n "
- ],
- "alt": "numbers rapidly counting upward with frame count set to 30.",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 79,
- "description": "Confirms if the window a p5.js program is in is "focused," meaning that\nthe sketch will accept mouse or keyboard input. This variable is\n"true" if the window is focused and "false" if not.
\n",
- "itemtype": "property",
- "name": "focused",
- "type": "Boolean",
- "readonly": "",
- "example": [
- "\n\n// To demonstrate, put two windows side by side.\n// Click on the window that the p5 sketch isn't in!\nfunction draw() {\n background(200);\n noStroke();\n fill(0, 200, 0);\n ellipse(25, 25, 50, 50);\n\n if (!focused) { // or \"if (focused === false)\"\n stroke(200,0,0);\n line(0, 0, 100, 100);\n line(100, 0, 0, 100);\n }\n}\n"
- ],
- "alt": "green 50x50 ellipse at top left. Red X covers canvas when page focus changes",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 110,
- "description": "Sets the cursor to a predefined symbol or an image, or makes it visible\nif already hidden. If you are trying to set an image as the cursor, the\nrecommended size is 16x16 or 32x32 pixels. It is not possible to load an\nimage as the cursor if you are exporting your program for the Web, and not\nall MODES work with all browsers. The values for parameters x and y must\nbe less than the dimensions of the image.
\n",
- "itemtype": "method",
- "name": "cursor",
- "params": [
- {
- "name": "type",
- "description": "either ARROW, CROSS, HAND, MOVE, TEXT, or\n WAIT, or path for image
\n",
- "type": "String|Constant"
- },
- {
- "name": "x",
- "description": "the horizontal active spot of the cursor
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "y",
- "description": "the vertical active spot of the cursor
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "example": [
- "\n\n// Move the mouse left and right across the image\n// to see the cursor change from a cross to a hand\nfunction draw() {\n line(width/2, 0, width/2, height);\n if (mouseX < 50) {\n cursor(CROSS);\n } else {\n cursor(HAND);\n }\n}\n"
- ],
- "alt": "horizontal line divides canvas. cursor on left is a cross, right is hand.",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 169,
- "description": "Specifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second. This is the same as\nsetFrameRate(val).\n
\nCalling frameRate() with no arguments returns the current framerate. The\ndraw function must run at least once before it will return a value. This\nis the same as getFrameRate().\n
\nCalling frameRate() with arguments that are not of the type numbers\nor are non positive also returns current framerate.
\n",
- "itemtype": "method",
- "name": "frameRate",
- "chainable": 1,
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment",
- "overloads": [
- {
- "line": 169,
- "params": [
- {
- "name": "fps",
- "description": "number of frames to be displayed every second
\n",
- "type": "Number"
- }
- ],
- "chainable": 1
- },
- {
- "line": 188,
- "params": [],
- "return": {
- "description": "current frameRate",
- "type": "Number"
- }
- }
- ]
- },
- {
- "file": "src/core/environment.js",
- "line": 238,
- "description": "Returns the current framerate.
\n",
- "return": {
- "description": "current frameRate",
- "type": "Number"
- },
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 247,
- "description": "Specifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second.
\nCalling frameRate() with no arguments returns the current framerate.
\n",
- "params": [
- {
- "name": "fps",
- "description": "number of frames to be displayed every second
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 262,
- "description": "Hides the cursor from view.
\n",
- "itemtype": "method",
- "name": "noCursor",
- "example": [
- "\n\nfunction setup() {\n noCursor();\n}\n\nfunction draw() {\n background(200);\n ellipse(mouseX, mouseY, 10, 10);\n}\n"
- ],
- "alt": "cursor becomes 10x 10 white ellipse the moves with mouse x and y.",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 288,
- "description": "System variable that stores the width of the entire screen display. This\nis used to run a full-screen program on any display size.
\n",
- "itemtype": "property",
- "name": "displayWidth",
- "type": "Number",
- "readonly": "",
- "example": [
- "\n\ncreateCanvas(displayWidth, displayHeight);\n"
- ],
- "alt": "cursor becomes 10x 10 white ellipse the moves with mouse x and y.",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 305,
- "description": "System variable that stores the height of the entire screen display. This\nis used to run a full-screen program on any display size.
\n",
- "itemtype": "property",
- "name": "displayHeight",
- "type": "Number",
- "readonly": "",
- "example": [
- "\n\ncreateCanvas(displayWidth, displayHeight);\n"
- ],
- "alt": "no display.",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
- },
- {
- "file": "src/core/environment.js",
- "line": 322,
- "description": "System variable that stores the width of the inner window, it maps to\nwindow.innerWidth.
\n",
- "itemtype": "property",
- "name": "windowWidth",
- "type": "Number",
- "readonly": "",
- "example": [
- "\n\ncreateCanvas(windowWidth, windowHeight);\n"
- ],
- "alt": "no display.",
- "class": "p5",
- "module": "Environment",
- "submodule": "Environment"
+ "module": "Environment",
+ "submodule": "Environment"
},
{
"file": "src/core/environment.js",
- "line": 338,
+ "line": 347,
"description": "System variable that stores the height of the inner window, it maps to\nwindow.innerHeight.
\n",
"itemtype": "property",
"name": "windowHeight",
@@ -5960,12 +6861,12 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 354,
- "description": "The windowResized() function is called once every time the browser window\nis resized. This is a good place to resize the canvas or do any other\nadjustments to accommodate the new window size.
\n",
+ "line": 363,
+ "description": "The windowResized() function is called once every time the browser window\nis resized. This is a good place to resize the canvas or do any other\nadjustments to accommodate the new window size.
\n",
"itemtype": "method",
"name": "windowResized",
"example": [
- "\n\nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n"
+ "\n\nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n"
],
"alt": "no display.",
"class": "p5",
@@ -5974,8 +6875,8 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 404,
- "description": "System variable that stores the width of the drawing canvas. This value\nis set by the first parameter of the createCanvas() function.\nFor example, the function call createCanvas(320, 240) sets the width\nvariable to the value 320. The value of width defaults to 100 if\ncreateCanvas() is not used in a program.
\n",
+ "line": 417,
+ "description": "System variable that stores the width of the drawing canvas. This value\nis set by the first parameter of the createCanvas() function.\nFor example, the function call createCanvas(320, 240) sets the width\nvariable to the value 320. The value of width defaults to 100 if\ncreateCanvas() is not used in a program.
\n",
"itemtype": "property",
"name": "width",
"type": "Number",
@@ -5986,8 +6887,8 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 416,
- "description": "System variable that stores the height of the drawing canvas. This value\nis set by the second parameter of the createCanvas() function. For\nexample, the function call createCanvas(320, 240) sets the height\nvariable to the value 240. The value of height defaults to 100 if\ncreateCanvas() is not used in a program.
\n",
+ "line": 429,
+ "description": "System variable that stores the height of the drawing canvas. This value\nis set by the second parameter of the createCanvas() function. For\nexample, the function call createCanvas(320, 240) sets the height\nvariable to the value 240. The value of height defaults to 100 if\ncreateCanvas() is not used in a program.
\n",
"itemtype": "property",
"name": "height",
"type": "Number",
@@ -5998,7 +6899,7 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 428,
+ "line": 441,
"description": "If argument is given, sets the sketch to fullscreen or not based on the\nvalue of the argument. If no argument is given, returns the current\nfullscreen state. Note that due to browser restrictions this can only\nbe called on user input, for example, on mouse press like the example\nbelow.
\n",
"itemtype": "method",
"name": "fullscreen",
@@ -6024,33 +6925,43 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 475,
- "description": "Sets the pixel scaling for high pixel density displays. By default\npixel density is set to match display density, call pixelDensity(1)\nto turn this off. Calling pixelDensity() with no arguments returns\nthe current pixel density of the sketch.
\n",
+ "line": 492,
+ "description": "Sets the pixel scaling for high pixel density displays. By default\npixel density is set to match display density, call pixelDensity(1)\nto turn this off. Calling pixelDensity() with no arguments returns\nthe current pixel density of the sketch.
\n",
"itemtype": "method",
"name": "pixelDensity",
- "params": [
- {
- "name": "val",
- "description": "whether or how much the sketch should scale
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "return": {
- "description": "current pixel density of the sketch",
- "type": "Number"
- },
+ "chainable": 1,
"example": [
- "\n\n\nfunction setup() {\n pixelDensity(1);\n createCanvas(100, 100);\n background(200);\n ellipse(width/2, height/2, 50, 50);\n}\n\n\n\n\nfunction setup() {\n pixelDensity(3.0);\n createCanvas(100, 100);\n background(200);\n ellipse(width/2, height/2, 50, 50);\n}\n\n"
+ "\n\n\nfunction setup() {\n pixelDensity(1);\n createCanvas(100, 100);\n background(200);\n ellipse(width / 2, height / 2, 50, 50);\n}\n\n\n\n\nfunction setup() {\n pixelDensity(3.0);\n createCanvas(100, 100);\n background(200);\n ellipse(width / 2, height / 2, 50, 50);\n}\n\n"
],
"alt": "fuzzy 50x50 white ellipse with black outline in center of canvas.\nsharp 50x50 white ellipse with black outline in center of canvas.",
"class": "p5",
"module": "Environment",
- "submodule": "Environment"
+ "submodule": "Environment",
+ "overloads": [
+ {
+ "line": 492,
+ "params": [
+ {
+ "name": "val",
+ "description": "whether or how much the sketch should scale
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 527,
+ "params": [],
+ "return": {
+ "description": "current pixel density of the sketch",
+ "type": "Number"
+ }
+ }
+ ]
},
{
"file": "src/core/environment.js",
- "line": 520,
+ "line": 547,
"description": "Returns the pixel density of the current display the sketch is running on.
\n",
"itemtype": "method",
"name": "displayDensity",
@@ -6059,7 +6970,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfunction setup() {\n var density = displayDensity();\n pixelDensity(density);\n createCanvas(100, 100);\n background(200);\n ellipse(width/2, height/2, 50, 50);\n}\n\n"
+ "\n\n\nfunction setup() {\n var density = displayDensity();\n pixelDensity(density);\n createCanvas(100, 100);\n background(200);\n ellipse(width / 2, height / 2, 50, 50);\n}\n\n"
],
"alt": "50x50 white ellipse with black outline in center of canvas.",
"class": "p5",
@@ -6068,7 +6979,7 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 577,
+ "line": 604,
"description": "Gets the current URL.
\n",
"itemtype": "method",
"name": "getURL",
@@ -6077,7 +6988,7 @@ module.exports={
"type": "String"
},
"example": [
- "\n\n\nvar url;\nvar x = 100;\n\nfunction setup() {\n fill(0);\n noStroke();\n url = getURL();\n}\n\nfunction draw() {\n background(200);\n text(url, x, height/2);\n x--;\n}\n\n"
+ "\n\n\nvar url;\nvar x = 100;\n\nfunction setup() {\n fill(0);\n noStroke();\n url = getURL();\n}\n\nfunction draw() {\n background(200);\n text(url, x, height / 2);\n x--;\n}\n\n"
],
"alt": "current url (http://p5js.org/reference/#/p5/getURL) moves right to left.",
"class": "p5",
@@ -6086,7 +6997,7 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 608,
+ "line": 635,
"description": "Gets the current URL path as an array.
\n",
"itemtype": "method",
"name": "getURLPath",
@@ -6095,7 +7006,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\nfunction setup() {\n var urlPath = getURLPath();\n for (var i=0; i<urlPath.length; i++) {\n text(urlPath[i], 10, i*20+20);\n }\n}\n"
+ "\n\nfunction setup() {\n var urlPath = getURLPath();\n for (var i = 0; i < urlPath.length; i++) {\n text(urlPath[i], 10, i * 20 + 20);\n }\n}\n"
],
"alt": "no display",
"class": "p5",
@@ -6104,7 +7015,7 @@ module.exports={
},
{
"file": "src/core/environment.js",
- "line": 629,
+ "line": 658,
"description": "Gets the current URL params as an Object.
\n",
"itemtype": "method",
"name": "getURLParams",
@@ -6113,7 +7024,7 @@ module.exports={
"type": "Object"
},
"example": [
- "\n\n\n// Example: http://p5js.org?year=2014&month=May&day=15\n\nfunction setup() {\n var params = getURLParams();\n text(params.day, 10, 20);\n text(params.month, 10, 40);\n text(params.year, 10, 60);\n}\n\n"
+ "\n\n\n// Example: http://p5js.org?year=2014&month=May&day=15\n\nfunction setup() {\n var params = getURLParams();\n text(params.day, 10, 20);\n text(params.month, 10, 40);\n text(params.year, 10, 60);\n}\n\n"
],
"alt": "no display.",
"class": "p5",
@@ -6131,91 +7042,136 @@ module.exports={
},
{
"file": "src/core/error_helpers.js",
- "line": 34,
- "description": "Prints out a fancy, colorful message to the console log
\n",
- "params": [
- {
- "name": "message",
- "description": "the words to be said
\n",
- "type": "String"
- },
- {
- "name": "func",
- "description": "the name of the function to link
\n",
- "type": "String"
- },
- {
- "name": "color",
- "description": "CSS color string or error type
\n",
- "type": "Number|String"
- }
- ],
- "return": {
- "description": "console logs"
- },
- "class": "p5",
- "module": "Environment"
- },
- {
- "file": "src/core/error_helpers.js",
- "line": 106,
+ "line": 563,
"description": "Validates parameters\nparam {String} func the name of the function\nparam {Array} args user input arguments
\nexample:\n var a;\n ellipse(10,10,a,5);\nconsole ouput:\n "It looks like ellipse received an empty variable in spot #2."
\nexample:\n ellipse(10,"foo",5,5);\nconsole output:\n "ellipse was expecting a number for parameter #1,\n received "foo" instead."
\n",
"class": "p5",
"module": "Environment"
},
{
"file": "src/core/error_helpers.js",
- "line": 273,
+ "line": 624,
"description": "Prints out all the colors in the color pallete with white text.\nFor color blindness testing.
\n",
"class": "p5",
"module": "Environment"
},
{
- "file": "src/core/init.js",
- "line": 5,
- "description": "_globalInit
\nTODO: ???\nif sketch is on window\nassume "global" mode\nand instantiate p5 automatically\notherwise do nothing
\n",
- "return": {
- "description": "",
- "type": "Undefined"
- },
- "class": "p5.Element",
+ "file": "src/core/helpers.js",
+ "line": 1,
+ "requires": [
+ "constants"
+ ],
+ "class": "p5",
"module": "Environment"
},
{
- "file": "src/core/p5.Element.js",
- "line": 25,
- "description": "Underlying HTML element. All normal HTML methods can be called on this.
\n",
- "itemtype": "property",
- "name": "elt",
- "readonly": "",
- "class": "p5.Element",
- "module": "DOM",
- "submodule": "DOM"
+ "file": "src/core/legacy.js",
+ "line": 1,
+ "requires": [
+ "core\nThese are functions that are part of the Processing API but are not part of\nthe p5.js API. In some cases they have a new name",
+ "in others",
+ "they are\nremoved completely. Not all unsupported Processing functions are listed here\nbut we try to include ones that a user coming from Processing might likely\ncall."
+ ],
+ "class": "p5",
+ "module": "Environment"
},
{
- "file": "src/core/p5.Element.js",
- "line": 39,
- "description": "Attaches the element to the parent specified. A way of setting\n the container for the element. Accepts either a string ID, DOM\n node, or p5.Element. If no arguments given, parent node is returned.\n For more ways to position the canvas, see the\n \n positioning the canvas wiki page.
\n",
+ "file": "src/core/main.js",
+ "line": 49,
+ "description": "Called directly before setup(), the preload() function is used to handle\nasynchronous loading of external files in a blocking way. If a preload\nfunction is defined, setup() will wait until any load calls within have\nfinished. Nothing besides load calls (loadImage, loadJSON, loadFont,\nloadStrings, etc.) should be inside the preload function. If asynchronous\nloading is preferred, the load methods can instead be called in setup()\nor anywhere else with the use of a callback parameter.\n
\nBy default the text "loading..." will be displayed. To make your own\nloading page, include an HTML element with id "p5_loading" in your\npage. More information here.
\n",
"itemtype": "method",
- "name": "parent",
+ "name": "preload",
+ "example": [
+ "\n\nvar img;\nvar c;\nfunction preload() {\n // preload() runs once\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() {\n // setup() waits until preload() is done\n img.loadPixels();\n // get color of middle pixel\n c = img.get(img.width / 2, img.height / 2);\n}\n\nfunction draw() {\n background(c);\n image(img, 25, 25, 50, 50);\n}\n"
+ ],
+ "alt": "nothing displayed",
+ "class": "p5",
+ "module": "Structure",
+ "submodule": "Structure"
+ },
+ {
+ "file": "src/core/main.js",
+ "line": 90,
+ "description": "The setup() function is called once when the program starts. It's used to\ndefine initial environment properties such as screen size and background\ncolor and to load media such as images and fonts as the program starts.\nThere can only be one setup() function for each program and it shouldn't\nbe called again after its initial execution.\n
\nNote: Variables declared within setup() are not accessible within other\nfunctions, including draw().
\n",
+ "itemtype": "method",
+ "name": "setup",
+ "example": [
+ "\n\nvar a = 0;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(102);\n}\n\nfunction draw() {\n rect(a++ % width, 10, 2, 80);\n}\n"
+ ],
+ "alt": "nothing displayed",
+ "class": "p5",
+ "module": "Structure",
+ "submodule": "Structure"
+ },
+ {
+ "file": "src/core/main.js",
+ "line": 121,
+ "description": "Called directly after setup(), the draw() function continuously executes\nthe lines of code contained inside its block until the program is stopped\nor noLoop() is called. Note if noLoop() is called in setup(), draw() will\nstill be executed once before stopping. draw() is called automatically and\nshould never be called explicitly.\n
\nIt should always be controlled with noLoop(), redraw() and loop(). After\nnoLoop() stops the code in draw() from executing, redraw() causes the\ncode inside draw() to execute once, and loop() will cause the code\ninside draw() to resume executing continuously.\n
\nThe number of times draw() executes in each second may be controlled with\nthe frameRate() function.\n
\nThere can only be one draw() function for each sketch, and draw() must\nexist if you want the code to run continuously, or to process events such\nas mousePressed(). Sometimes, you might have an empty call to draw() in\nyour program, as shown in the above example.\n
\nIt is important to note that the drawing coordinate system will be reset\nat the beginning of each draw() call. If any transformations are performed\nwithin draw() (ex: scale, rotate, translate), their effects will be\nundone at the beginning of draw(), so transformations will not accumulate\nover time. On the other hand, styling applied (ex: fill, stroke, etc) will\nremain in effect.
\n",
+ "itemtype": "method",
+ "name": "draw",
+ "example": [
+ "\n\nvar yPos = 0;\nfunction setup() {\n // setup() runs once\n frameRate(30);\n}\nfunction draw() {\n // draw() loops forever, until stopped\n background(204);\n yPos = yPos - 1;\n if (yPos < 0) {\n yPos = height;\n }\n line(0, yPos, width, yPos);\n}\n"
+ ],
+ "alt": "nothing displayed",
+ "class": "p5",
+ "module": "Structure",
+ "submodule": "Structure"
+ },
+ {
+ "file": "src/core/main.js",
+ "line": 408,
+ "description": "Removes the entire p5 sketch. This will remove the canvas and any\nelements created by p5.js. It will also stop the draw loop and unbind\nany properties or methods from the window global scope. It will\nleave a variable p5 in case you wanted to create a new p5 sketch.\nIf you like, you can set p5 = null to erase it. While all functions and\nvariables and objects created by the p5 library will be removed, any\nother global variables created by your code will remain.
\n",
+ "itemtype": "method",
+ "name": "remove",
+ "example": [
+ "\n\nfunction draw() {\n ellipse(50, 50, 10, 10);\n}\n\nfunction mousePressed() {\n remove(); // remove whole sketch on mouse press\n}\n"
+ ],
+ "alt": "nothing displayed",
+ "class": "p5",
+ "module": "Structure",
+ "submodule": "Structure"
+ },
+ {
+ "file": "src/core/p5.Element.js",
+ "line": 26,
+ "description": "Underlying HTML element. All normal HTML methods can be called on this.
\n",
+ "example": [
+ "\n\n\ncreateCanvas(300, 500);\nbackground(0, 0, 0, 0);\nvar input = createInput();\ninput.position(20, 225);\nvar inputElem = new p5.Element(input.elt);\ninputElem.style('width:450px;');\ninputElem.value('some string');\n\n"
+ ],
+ "itemtype": "property",
+ "name": "elt",
+ "readonly": "",
+ "class": "p5.Element",
+ "module": "DOM",
+ "submodule": "DOM"
+ },
+ {
+ "file": "src/core/p5.Element.js",
+ "line": 51,
+ "description": "Attaches the element to the parent specified. A way of setting\n the container for the element. Accepts either a string ID, DOM\n node, or p5.Element. If no arguments given, parent node is returned.\n For more ways to position the canvas, see the\n \n positioning the canvas wiki page.
\n",
+ "itemtype": "method",
+ "name": "parent",
"chainable": 1,
+ "example": [
+ "\n \n // in the html file:\n // <div id=\"myContainer\"></div>\n// in the js file:\n var cnv = createCanvas(100, 100);\n cnv.parent('myContainer');\n \n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div1.parent(div0); // use p5.Element\n \n \n var div0 = createDiv('this is the parent');\n div0.id('apples');\n var div1 = createDiv('this is the child');\n div1.parent('apples'); // use id\n \n \n var elt = document.getElementById('myParentDiv');\n var div1 = createDiv('this is the child');\n div1.parent(elt); // use element from page\n "
+ ],
+ "alt": "no display.",
"class": "p5.Element",
"module": "DOM",
"submodule": "DOM",
"overloads": [
{
- "line": 39,
+ "line": 51,
"params": [
{
"name": "parent",
- "description": "the ID, DOM node, or p5.Element\n of desired parent element
\n",
+ "description": "the ID, DOM node, or p5.Element\n of desired parent element
\n",
"type": "String|p5.Element|Object"
}
],
"chainable": 1
},
{
- "line": 53,
+ "line": 94,
"params": [],
"return": {
"description": "",
@@ -6226,17 +7182,21 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 103,
+ "line": 116,
"description": "Sets the ID of the element. If no ID argument is passed in, it instead\n returns the current ID of the element.
\n",
"itemtype": "method",
"name": "id",
"chainable": 1,
+ "example": [
+ "\n \n function setup() {\n var cnv = createCanvas(100, 100);\n // Assigns a CSS selector ID to\n // the canvas element.\n cnv.id('mycanvas');\n }\n "
+ ],
+ "alt": "no display.",
"class": "p5.Element",
"module": "DOM",
"submodule": "DOM",
"overloads": [
{
- "line": 103,
+ "line": 116,
"params": [
{
"name": "id",
@@ -6247,7 +7207,7 @@ module.exports={
"chainable": 1
},
{
- "line": 112,
+ "line": 138,
"params": [],
"return": {
"description": "the id of the element",
@@ -6258,17 +7218,21 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 141,
+ "line": 153,
"description": "Adds given class to the element. If no class argument is passed in, it\n instead returns a string containing the current class(es) of the element.
\n",
"itemtype": "method",
"name": "class",
"chainable": 1,
+ "example": [
+ "\n \n function setup() {\n var cnv = createCanvas(100, 100);\n // Assigns a CSS selector class 'small'\n // to the canvas element.\n cnv.class('small');\n }\n "
+ ],
+ "alt": "no display.",
"class": "p5.Element",
"module": "DOM",
"submodule": "DOM",
"overloads": [
{
- "line": 141,
+ "line": 153,
"params": [
{
"name": "class",
@@ -6279,7 +7243,7 @@ module.exports={
"chainable": 1
},
{
- "line": 150,
+ "line": 175,
"params": [],
"return": {
"description": "the class of the element",
@@ -6290,8 +7254,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 163,
- "description": "The .mousePressed() function is called once after every time a\nmouse button is pressed over the element. This can be used to\nattach element specific event listeners.
\n",
+ "line": 188,
+ "description": "The .mousePressed() function is called once after every time a\nmouse button is pressed over the element.\nSome mobile browsers may also trigger this event on a touch screen,\nif the user performs a quick tap.\nThis can be used to attach element specific event listeners.
\n",
"itemtype": "method",
"name": "mousePressed",
"params": [
@@ -6303,7 +7267,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mousePressed(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any click anywhere\nfunction mousePressed() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
+ "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mousePressed(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any click anywhere\nfunction mousePressed() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6312,8 +7276,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 213,
- "description": "The .doubleClicked() function is called once after every time a\nmouse button is pressed twice over the element. This can be used to\nattach element and action specific event listeners.
\n",
+ "line": 249,
+ "description": "The .doubleClicked() function is called once after every time a\nmouse button is pressed twice over the element. This can be used to\nattach element and action specific event listeners.
\n",
"itemtype": "method",
"name": "doubleClicked",
"params": [
@@ -6328,7 +7292,7 @@ module.exports={
"type": "p5.Element"
},
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.doubleClicked(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any double click anywhere\nfunction doubleClicked() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
+ "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.doubleClicked(changeGray); // attach listener for\n // canvas double click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any double click anywhere\nfunction doubleClicked() {\n d = d + 10;\n}\n\n// this function fires only when cnv is double clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6337,8 +7301,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 263,
- "description": "The .mouseWheel() function is called once after every time a\nmouse wheel is scrolled over the element. This can be used to\nattach element specific event listeners.\n
\nThe function accepts a callback function as argument which will be executed\nwhen the wheel event is triggered on the element, the callback function is\npassed one argument event. The event.deltaY property returns negative\nvalues if the mouse wheel is rotated up or away from the user and positive\nin the other direction. The event.deltaX does the same as event.deltaY\nexcept it reads the horizontal wheel scroll of the mouse wheel.\n
\nOn OS X with "natural" scrolling enabled, the event.deltaY values are\nreversed.
\n",
+ "line": 298,
+ "description": "The .mouseWheel() function is called once after every time a\nmouse wheel is scrolled over the element. This can be used to\nattach element specific event listeners.\n
\nThe function accepts a callback function as argument which will be executed\nwhen the wheel event is triggered on the element, the callback function is\npassed one argument event. The event.deltaY property returns negative\nvalues if the mouse wheel is rotated up or away from the user and positive\nin the other direction. The event.deltaX does the same as event.deltaY\nexcept it reads the horizontal wheel scroll of the mouse wheel.\n
\nOn OS X with "natural" scrolling enabled, the event.deltaY values are\nreversed.
\n",
"itemtype": "method",
"name": "mouseWheel",
"params": [
@@ -6350,7 +7314,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseWheel(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with mousewheel movement\n// anywhere on screen\nfunction mouseWheel() {\n g = g + 10;\n}\n\n// this function fires with mousewheel movement\n// over canvas only\nfunction changeSize(event) {\n if (event.deltaY > 0) {\n d = d + 10;\n } else {\n d = d - 10;\n }\n}\n"
+ "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseWheel(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with mousewheel movement\n// anywhere on screen\nfunction mouseWheel() {\n g = g + 10;\n}\n\n// this function fires with mousewheel movement\n// over canvas only\nfunction changeSize(event) {\n if (event.deltaY > 0) {\n d = d + 10;\n } else {\n d = d - 10;\n }\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6359,8 +7323,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 329,
- "description": "The .mouseReleased() function is called once after every time a\nmouse button is released over the element. This can be used to\nattach element specific event listeners.
\n",
+ "line": 364,
+ "description": "The .mouseReleased() function is called once after every time a\nmouse button is released over the element.\nSome mobile browsers may also trigger this event on a touch screen,\nif the user performs a quick tap.\nThis can be used to attach element specific event listeners.
\n",
"itemtype": "method",
"name": "mouseReleased",
"params": [
@@ -6372,7 +7336,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseReleased(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires after the mouse has been\n// released\nfunction mouseReleased() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// released while on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n"
+ "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseReleased(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires after the mouse has been\n// released\nfunction mouseReleased() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// released while on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6381,8 +7345,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 383,
- "description": "The .mouseClicked() function is called once after a mouse button is\npressed and released over the element. This can be used to\nattach element specific event listeners.
\n",
+ "line": 418,
+ "description": "The .mouseClicked() function is called once after a mouse button is\npressed and released over the element.\nSome mobile browsers may also trigger this event on a touch screen,\nif the user performs a quick tap.\nThis can be used to attach element specific event listeners.
\n",
"itemtype": "method",
"name": "mouseClicked",
"params": [
@@ -6394,7 +7358,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nvar cnv;\nvar d;\nvar g;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseClicked(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires after the mouse has been\n// clicked anywhere\nfunction mouseClicked() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// clicked on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n\n"
+ "\n\n\nvar cnv;\nvar d;\nvar g;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseClicked(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires after the mouse has been\n// clicked anywhere\nfunction mouseClicked() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// clicked on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6403,8 +7367,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 437,
- "description": "The .mouseMoved() function is called once every time a\nmouse moves over the element. This can be used to attach an\nelement specific event listener.
\n",
+ "line": 474,
+ "description": "The .mouseMoved() function is called once every time a\nmouse moves over the element. This can be used to attach an\nelement specific event listener.
\n",
"itemtype": "method",
"name": "mouseMoved",
"params": [
@@ -6416,7 +7380,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d = 30;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseMoved(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n fill(200);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires when mouse moves anywhere on\n// page\nfunction mouseMoved() {\n g = g + 5;\n if (g > 255) {\n g = 0;\n }\n}\n\n// this function fires when mouse moves over canvas\nfunction changeSize() {\n d = d + 2;\n if (d > 100) {\n d = 0;\n }\n}\n"
+ "\n\nvar cnv;\nvar d = 30;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseMoved(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n fill(200);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires when mouse moves anywhere on\n// page\nfunction mouseMoved() {\n g = g + 5;\n if (g > 255) {\n g = 0;\n }\n}\n\n// this function fires when mouse moves over canvas\nfunction changeSize() {\n d = d + 2;\n if (d > 100) {\n d = 0;\n }\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6425,8 +7389,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 496,
- "description": "The .mouseOver() function is called once after every time a\nmouse moves onto the element. This can be used to attach an\nelement specific event listener.
\n",
+ "line": 532,
+ "description": "The .mouseOver() function is called once after every time a\nmouse moves onto the element. This can be used to attach an\nelement specific event listener.
\n",
"itemtype": "method",
"name": "mouseOver",
"params": [
@@ -6438,7 +7402,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOver(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width/2, height/2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n"
+ "\n\nvar cnv;\nvar d;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOver(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width / 2, height / 2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6447,8 +7411,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 541,
- "description": "The .changed() function is called when the value of an\nelement changes.\nThis can be used to attach an element specific event listener.
\n",
+ "line": 575,
+ "description": "The .changed() function is called when the value of an\nelement changes.\nThis can be used to attach an element specific event listener.
\n",
"itemtype": "method",
"name": "changed",
"params": [
@@ -6460,7 +7424,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text(\"it's a \"+item+\"!\", 50, 50);\n}\n\n\nvar checkbox;\nvar cnv;\n\nfunction setup() {\n checkbox = createCheckbox(\" fill\");\n checkbox.changed(changeFill);\n cnv = createCanvas(100, 100);\n cnv.position(0, 30);\n noFill();\n}\n\nfunction draw() {\n background(200);\n ellipse(50, 50, 50, 50);\n}\n\nfunction changeFill() {\n if (checkbox.checked()) {\n fill(0);\n } else {\n noFill();\n }\n}\n"
+ "\n\nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text(\"it's a \" + item + '!', 50, 50);\n}\n\n\nvar checkbox;\nvar cnv;\n\nfunction setup() {\n checkbox = createCheckbox(' fill');\n checkbox.changed(changeFill);\n cnv = createCanvas(100, 100);\n cnv.position(0, 30);\n noFill();\n}\n\nfunction draw() {\n background(200);\n ellipse(50, 50, 50, 50);\n}\n\nfunction changeFill() {\n if (checkbox.checked()) {\n fill(0);\n } else {\n noFill();\n }\n}\n"
],
"alt": "dropdown: pear, kiwi, grape. When selected text \"its a\" + selection shown.",
"class": "p5.Element",
@@ -6469,8 +7433,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 608,
- "description": "The .input() function is called when any user input is\ndetected with an element. The input event is often used\nto detect keystrokes in a input element, or changes on a\nslider element. This can be used to attach an element specific\nevent listener.
\n",
+ "line": 642,
+ "description": "The .input() function is called when any user input is\ndetected with an element. The input event is often used\nto detect keystrokes in a input element, or changes on a\nslider element. This can be used to attach an element specific\nevent listener.
\n",
"itemtype": "method",
"name": "input",
"params": [
@@ -6491,8 +7455,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 643,
- "description": "The .mouseOut() function is called once after every time a\nmouse moves off the element. This can be used to attach an\nelement specific event listener.
\n",
+ "line": 677,
+ "description": "The .mouseOut() function is called once after every time a\nmouse moves off the element. This can be used to attach an\nelement specific event listener.
\n",
"itemtype": "method",
"name": "mouseOut",
"params": [
@@ -6504,7 +7468,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOut(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width/2, height/2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n"
+ "\n\nvar cnv;\nvar d;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOut(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width / 2, height / 2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6513,8 +7477,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 686,
- "description": "The .touchStarted() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.
\n",
+ "line": 719,
+ "description": "The .touchStarted() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.
\n",
"itemtype": "method",
"name": "touchStarted",
"params": [
@@ -6526,7 +7490,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchStarted(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchStarted() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
+ "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchStarted(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchStarted() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6535,8 +7499,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 735,
- "description": "The .touchMoved() function is called once after every time a touch move is\nregistered. This can be used to attach element specific event listeners.
\n",
+ "line": 767,
+ "description": "The .touchMoved() function is called once after every time a touch move is\nregistered. This can be used to attach element specific event listeners.
\n",
"itemtype": "method",
"name": "touchMoved",
"params": [
@@ -6548,7 +7512,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchMoved(changeGray); // attach listener for\n // canvas click only\n g = 100;\n}\n\nfunction draw() {\n background(g);\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
+ "\n\nvar cnv;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchMoved(changeGray); // attach listener for\n // canvas click only\n g = 100;\n}\n\nfunction draw() {\n background(g);\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6557,8 +7521,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 776,
- "description": "The .touchEnded() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.
\n",
+ "line": 807,
+ "description": "The .touchEnded() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.
\n",
"itemtype": "method",
"name": "touchEnded",
"params": [
@@ -6570,7 +7534,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchEnded(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchEnded() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
+ "\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchEnded(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchEnded() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"
],
"alt": "no display.",
"class": "p5.Element",
@@ -6579,8 +7543,8 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 828,
- "description": "The .dragOver() function is called once after every time a\nfile is dragged over the element. This can be used to attach an\nelement specific event listener.
\n",
+ "line": 856,
+ "description": "The .dragOver() function is called once after every time a\nfile is dragged over the element. This can be used to attach an\nelement specific event listener.
\n",
"itemtype": "method",
"name": "dragOver",
"params": [
@@ -6592,7 +7556,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n// To test this sketch, simply drag a\n// file over the canvas\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width/2, height/2);\n c.dragOver(dragOverCallback);\n}\n\n// This function will be called whenever\n// a file is dragged over the canvas\nfunction dragOverCallback() {\n background(240);\n text('Dragged over', width/2, height/2);\n}\n"
+ "\n\n// To test this sketch, simply drag a\n// file over the canvas\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width / 2, height / 2);\n c.dragOver(dragOverCallback);\n}\n\n// This function will be called whenever\n// a file is dragged over the canvas\nfunction dragOverCallback() {\n background(240);\n text('Dragged over', width / 2, height / 2);\n}\n"
],
"alt": "nothing displayed",
"class": "p5.Element",
@@ -6601,7 +7565,7 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 866,
+ "line": 894,
"description": "The .dragLeave() function is called once after every time a\ndragged file leaves the element area. This can be used to attach an\nelement specific event listener.
\n",
"itemtype": "method",
"name": "dragLeave",
@@ -6614,7 +7578,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n// To test this sketch, simply drag a file\n// over and then out of the canvas area\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width/2, height/2);\n c.dragLeave(dragLeaveCallback);\n}\n\n// This function will be called whenever\n// a file is dragged out of the canvas\nfunction dragLeaveCallback() {\n background(240);\n text('Dragged off', width/2, height/2);\n}\n"
+ "\n\n// To test this sketch, simply drag a file\n// over and then out of the canvas area\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width / 2, height / 2);\n c.dragLeave(dragLeaveCallback);\n}\n\n// This function will be called whenever\n// a file is dragged out of the canvas\nfunction dragLeaveCallback() {\n background(240);\n text('Dragged off', width / 2, height / 2);\n}\n"
],
"alt": "nothing displayed",
"class": "p5.Element",
@@ -6623,25 +7587,26 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 904,
- "description": "The .drop() function is called for each file dropped on the element.\nIt requires a callback that is passed a p5.File object. You can\noptionally pass two callbacks, the first one (required) is triggered\nfor each file dropped when the file is loaded. The second (optional)\nis triggered just once when a file (or files) are dropped.
\n",
+ "line": 932,
+ "description": "The .drop() function is called for each file dropped on the element.\nIt requires a callback that is passed a p5.File object. You can\noptionally pass two callbacks, the first one (required) is triggered\nfor each file dropped when the file is loaded. The second (optional)\nis triggered just once when a file (or files) are dropped.
\n",
"itemtype": "method",
"name": "drop",
"params": [
{
"name": "callback",
"description": "callback triggered when files are dropped.
\n",
- "type": "Function|Boolean"
+ "type": "Function"
},
{
"name": "fxn",
"description": "callback to receive loaded file.
\n",
- "type": "Function|Boolean"
+ "type": "Function",
+ "optional": true
}
],
"chainable": 1,
"example": [
- "\n\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('drop image', width/2, height/2);\n c.drop(gotFile);\n}\n\nfunction gotFile(file) {\n var img = createImg(file.data).hide();\n // Draw the image onto the canvas\n image(img, 0, 0, width, height);\n}\n"
+ "\n\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('drop file', width / 2, height / 2);\n c.drop(gotFile);\n}\n\nfunction gotFile(file) {\n background(200);\n text('received file:', width / 2, height / 2);\n text(file.name, width / 2, height / 2 + 50);\n}\n\n\n\nvar img;\n\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('drop image', width / 2, height / 2);\n c.drop(gotFile);\n}\n\nfunction draw() {\n if (img) {\n image(img, 0, 0, width, height);\n }\n}\n\nfunction gotFile(file) {\n img = createImg(file.data).hide();\n}\n"
],
"alt": "Canvas turns into whatever image is dragged/dropped onto it.",
"class": "p5.Element",
@@ -6650,15 +7615,29 @@ module.exports={
},
{
"file": "src/core/p5.Element.js",
- "line": 1031,
+ "line": 1088,
"description": "Helper fxn for sharing pixel methods
\n",
"class": "p5.Element",
"module": "DOM",
"submodule": "DOM"
},
+ {
+ "file": "src/core/p5.Graphics.js",
+ "line": 65,
+ "description": "Removes a Graphics object from the page and frees any resources\nassociated with it.
\n",
+ "itemtype": "method",
+ "name": "remove",
+ "example": [
+ "\n\nvar bg;\nfunction setup() {\n bg = createCanvas(100, 100);\n bg.background(0);\n image(bg, 0, 0);\n bg.remove();\n}\n\n\n\nvar bg;\nfunction setup() {\n pixelDensity(1);\n createCanvas(100, 100);\n stroke(255);\n fill(0);\n\n // create and draw the background image\n bg = createGraphics(100, 100);\n bg.background(200);\n bg.ellipse(50, 50, 80, 80);\n}\nfunction draw() {\n var t = millis() / 1000;\n // draw the background\n if (bg) {\n image(bg, frameCount % 100, 0);\n image(bg, frameCount % 100 - 100, 0);\n }\n // draw the foreground\n var p = p5.Vector.fromAngle(t, 35).add(50, 50);\n ellipse(p.x, p.y, 30);\n}\nfunction mouseClicked() {\n // remove the background\n if (bg) {\n bg.remove();\n bg = null;\n }\n}\n"
+ ],
+ "alt": "no image\na multi-colored circle moving back and forth over a scrolling background.",
+ "class": "p5.Graphics",
+ "module": "Rendering",
+ "submodule": "Rendering"
+ },
{
"file": "src/core/p5.Renderer.js",
- "line": 72,
+ "line": 96,
"description": "Resize our canvas element.
\n",
"class": "p5.Renderer",
"module": "Rendering",
@@ -6666,7 +7645,7 @@ module.exports={
},
{
"file": "src/core/p5.Renderer.js",
- "line": 146,
+ "line": 300,
"description": "Helper fxn to check font type (system or otf)
\n",
"class": "p5.Renderer",
"module": "Rendering",
@@ -6674,7 +7653,7 @@ module.exports={
},
{
"file": "src/core/p5.Renderer.js",
- "line": 202,
+ "line": 353,
"description": "Helper fxn to measure ascent and descent.\nAdapted from http://stackoverflow.com/a/25355178
\n",
"class": "p5.Renderer",
"module": "Rendering",
@@ -6689,15 +7668,15 @@ module.exports={
},
{
"file": "src/core/p5.Renderer2D.js",
- "line": 356,
+ "line": 414,
"description": "Generate a cubic Bezier representing an arc on the unit circle of total\nangle size radians, beginning start radians above the x-axis. Up to\nfour of these curves are combined to make a full arc.
\nSee www.joecridge.me/bezier.pdf for an explanation of the method.
\n",
"class": "p5",
"module": "Rendering"
},
{
"file": "src/core/rendering.js",
- "line": 14,
- "description": "Creates a canvas element in the document, and sets the dimensions of it\nin pixels. This method should be called only once at the start of setup.\nCalling createCanvas more than once in a sketch will result in very\nunpredicable behavior. If you want more than one drawing canvas\nyou could use createGraphics (hidden by default but it can be shown).\n
\nThe system variables width and height are set by the parameters passed\nto this function. If createCanvas() is not used, the window will be\ngiven a default size of 100x100 pixels.\n
\nFor more ways to position the canvas, see the\n\npositioning the canvas wiki page.
\n",
+ "line": 17,
+ "description": "Creates a canvas element in the document, and sets the dimensions of it\nin pixels. This method should be called only once at the start of setup.\nCalling createCanvas more than once in a sketch will result in very\nunpredictable behavior. If you want more than one drawing canvas\nyou could use createGraphics (hidden by default but it can be shown).\n
\nThe system variables width and height are set by the parameters passed\nto this function. If createCanvas() is not used, the window will be\ngiven a default size of 100x100 pixels.\n
\nFor more ways to position the canvas, see the\n\npositioning the canvas wiki page.
\n",
"itemtype": "method",
"name": "createCanvas",
"params": [
@@ -6719,8 +7698,8 @@ module.exports={
}
],
"return": {
- "description": "canvas generated",
- "type": "HTMLCanvasElement"
+ "description": "",
+ "type": "p5.Renderer"
},
"example": [
"\n\n\nfunction setup() {\n createCanvas(100, 50);\n background(153);\n line(0, 0, width, height);\n}\n\n"
@@ -6732,7 +7711,7 @@ module.exports={
},
{
"file": "src/core/rendering.js",
- "line": 112,
+ "line": 119,
"description": "Resizes the canvas to given width and height. The canvas will be cleared\nand draw will be called immediately, allowing the sketch to re-render itself\nin the resized canvas.
\n",
"itemtype": "method",
"name": "resizeCanvas",
@@ -6755,7 +7734,7 @@ module.exports={
}
],
"example": [
- "\n\nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n"
+ "\n\nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n"
],
"alt": "No image displayed.",
"class": "p5",
@@ -6764,7 +7743,7 @@ module.exports={
},
{
"file": "src/core/rendering.js",
- "line": 162,
+ "line": 174,
"description": "Removes the default canvas for a p5 sketch that doesn't\nrequire a canvas
\n",
"itemtype": "method",
"name": "noCanvas",
@@ -6778,7 +7757,7 @@ module.exports={
},
{
"file": "src/core/rendering.js",
- "line": 185,
+ "line": 197,
"description": "Creates and returns a new p5.Renderer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels.
\n",
"itemtype": "method",
"name": "createGraphics",
@@ -6805,7 +7784,7 @@ module.exports={
"type": "p5.Graphics"
},
"example": [
- "\n\n\nvar pg;\nfunction setup() {\n createCanvas(100, 100);\n pg = createGraphics(100, 100);\n}\nfunction draw() {\n background(200);\n pg.background(100);\n pg.noStroke();\n pg.ellipse(pg.width/2, pg.height/2, 50, 50);\n image(pg, 50, 50);\n image(pg, 0, 0, 50, 50);\n}\n\n"
+ "\n\n\nvar pg;\nfunction setup() {\n createCanvas(100, 100);\n pg = createGraphics(100, 100);\n}\nfunction draw() {\n background(200);\n pg.background(100);\n pg.noStroke();\n pg.ellipse(pg.width / 2, pg.height / 2, 50, 50);\n image(pg, 50, 50);\n image(pg, 0, 0, 50, 50);\n}\n\n"
],
"alt": "4 grey squares alternating light and dark grey. White quarter circle mid-left.",
"class": "p5",
@@ -6814,8 +7793,8 @@ module.exports={
},
{
"file": "src/core/rendering.js",
- "line": 223,
- "description": "Blends the pixels in the display window according to the defined mode.\nThere is a choice of the following modes to blend the source pixels (A)\nwith the ones of pixels already in the display window (B):
\n\nBLEND - linear interpolation of colours: C =\nAfactor + B. This is the default blending mode.ADD - sum of A and BDARKEST - only the darkest colour succeeds: C =\nmin(Afactor, B).LIGHTEST - only the lightest colour succeeds: C =\nmax(A*factor, B).DIFFERENCE - subtract colors from underlying image.EXCLUSION - similar to DIFFERENCE, but less\nextreme.MULTIPLY - multiply the colors, result will always be\ndarker.SCREEN - opposite multiply, uses inverse values of the\ncolors.REPLACE - the pixels entirely replace the others and\ndon't utilize alpha (transparency) values.OVERLAY - mix of MULTIPLY and SCREEN\n. Multiplies dark values, and screens light values.HARD_LIGHT - SCREEN when greater than 50%\ngray, MULTIPLY when lower.SOFT_LIGHT - mix of DARKEST and\nLIGHTEST. Works like OVERLAY, but not as harsh.\nDODGE - lightens light tones and increases contrast,\nignores darks.BURN - darker areas are applied, increasing contrast,\nignores lights.
",
+ "line": 236,
+ "description": "Blends the pixels in the display window according to the defined mode.\nThere is a choice of the following modes to blend the source pixels (A)\nwith the ones of pixels already in the display window (B):
\n\nBLEND - linear interpolation of colours: C =\nA*factor + B. This is the default blending mode.ADD - sum of A and BDARKEST - only the darkest colour succeeds: C =\nmin(A*factor, B).LIGHTEST - only the lightest colour succeeds: C =\nmax(A*factor, B).DIFFERENCE - subtract colors from underlying image.EXCLUSION - similar to DIFFERENCE, but less\nextreme.MULTIPLY - multiply the colors, result will always be\ndarker.SCREEN - opposite multiply, uses inverse values of the\ncolors.REPLACE - the pixels entirely replace the others and\ndon't utilize alpha (transparency) values.OVERLAY - mix of MULTIPLY and SCREEN\n. Multiplies dark values, and screens light values.HARD_LIGHT - SCREEN when greater than 50%\ngray, MULTIPLY when lower.SOFT_LIGHT - mix of DARKEST and\nLIGHTEST. Works like OVERLAY, but not as harsh.\nDODGE - lightens light tones and increases contrast,\nignores darks.BURN - darker areas are applied, increasing contrast,\nignores lights.
",
"itemtype": "method",
"name": "blendMode",
"params": [
@@ -6835,15 +7814,22 @@ module.exports={
},
{
"file": "src/core/shim.js",
- "line": 65,
+ "line": 23,
"description": "shim for Uint8ClampedArray.slice\n(allows arrayCopy to work with pixels[])\nwith thanks to http://halfpapstudios.com/blog/tag/html5-canvas/\nEnumerable set to false to protect for...in from\nUint8ClampedArray.prototype pollution.
\n",
"class": "p5",
"module": "Rendering"
},
+ {
+ "file": "src/core/shim.js",
+ "line": 45,
+ "description": "this is implementation of Object.assign() which is unavailable in\nIE11 and (non-Chrome) Android browsers.\nThe assign() method is used to copy the values of all enumerable\nown properties from one or more source objects to a target object.\nIt will return the target object.\nModified from https://github.com/ljharb/object.assign
\n",
+ "class": "p5",
+ "module": "Rendering"
+ },
{
"file": "src/core/structure.js",
- "line": 15,
- "description": "Stops p5.js from continuously executing the code within draw().\nIf loop() is called, the code in draw() begins to run continuously again.\nIf using noLoop() in setup(), it should be the last line inside the block.\n
\nWhen noLoop() is used, it's not possible to manipulate or access the\nscreen inside event handling functions such as mousePressed() or\nkeyPressed(). Instead, use those functions to call redraw() or loop(),\nwhich will run draw(), which can update the screen properly. This means\nthat when noLoop() has been called, no drawing can happen, and functions\nlike saveFrame() or loadPixels() may not be used.\n
\nNote that if the sketch is resized, redraw() will be called to update\nthe sketch, even after noLoop() has been specified. Otherwise, the sketch\nwould enter an odd state until loop() was called.
\n",
+ "line": 12,
+ "description": "Stops p5.js from continuously executing the code within draw().\nIf loop() is called, the code in draw() begins to run continuously again.\nIf using noLoop() in setup(), it should be the last line inside the block.\n
\nWhen noLoop() is used, it's not possible to manipulate or access the\nscreen inside event handling functions such as mousePressed() or\nkeyPressed(). Instead, use those functions to call redraw() or loop(),\nwhich will run draw(), which can update the screen properly. This means\nthat when noLoop() has been called, no drawing can happen, and functions\nlike saveFrame() or loadPixels() may not be used.\n
\nNote that if the sketch is resized, redraw() will be called to update\nthe sketch, even after noLoop() has been specified. Otherwise, the sketch\nwould enter an odd state until loop() was called.
\n",
"itemtype": "method",
"name": "noLoop",
"example": [
@@ -6856,8 +7842,8 @@ module.exports={
},
{
"file": "src/core/structure.js",
- "line": 77,
- "description": "By default, p5.js loops through draw() continuously, executing the code\nwithin it. However, the draw() loop may be stopped by calling noLoop().\nIn that case, the draw() loop can be resumed with loop().
\n",
+ "line": 74,
+ "description": "By default, p5.js loops through draw() continuously, executing the code\nwithin it. However, the draw() loop may be stopped by calling noLoop().\nIn that case, the draw() loop can be resumed with loop().
\n",
"itemtype": "method",
"name": "loop",
"example": [
@@ -6870,12 +7856,12 @@ module.exports={
},
{
"file": "src/core/structure.js",
- "line": 119,
- "description": "The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n
\npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textMode(), textSize(), textLeading().
\n",
+ "line": 116,
+ "description": "The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n
\npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textMode(), textSize(), textLeading().
\n",
"itemtype": "method",
"name": "push",
"example": [
- "\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\ntranslate(50, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n"
+ "\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\ntranslate(50, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n"
],
"alt": "Gold ellipse + thick black outline @center 2 white ellipses on left and right.\n2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.",
"class": "p5",
@@ -6884,12 +7870,12 @@ module.exports={
},
{
"file": "src/core/structure.js",
- "line": 194,
- "description": "The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n
\npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textMode(), textSize(), textLeading().
\n",
+ "line": 181,
+ "description": "The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n
\npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textMode(), textSize(), textLeading().
\n",
"itemtype": "method",
"name": "pop",
"example": [
- "\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\ntranslate(50, 0);\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n"
+ "\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\ntranslate(50, 0);\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n"
],
"alt": "Gold ellipse + thick black outline @center 2 white ellipses on left and right.\n2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.",
"class": "p5",
@@ -6898,8 +7884,8 @@ module.exports={
},
{
"file": "src/core/structure.js",
- "line": 266,
- "description": "Executes the code within draw() one time. This functions allows the\n program to update the display window only when necessary, for example\n when an event registered by mousePressed() or keyPressed() occurs.\n
\n In structuring a program, it only makes sense to call redraw() within\n events such as mousePressed(). This is because redraw() does not run\n draw() immediately (it only sets a flag that indicates an update is\n needed).\n
\n The redraw() function does not work properly when called inside draw().\n To enable/disable animations, use loop() and noLoop().\n
\n In addition you can set the number of redraws per method call. Just\n add an integer as single parameter for the number of redraws.
\n",
+ "line": 247,
+ "description": "Executes the code within draw() one time. This functions allows the\n program to update the display window only when necessary, for example\n when an event registered by mousePressed() or keyPressed() occurs.\n
\n In structuring a program, it only makes sense to call redraw() within\n events such as mousePressed(). This is because redraw() does not run\n draw() immediately (it only sets a flag that indicates an update is\n needed).\n
\n The redraw() function does not work properly when called inside draw().\n To enable/disable animations, use loop() and noLoop().\n
\n In addition you can set the number of redraws per method call. Just\n add an integer as single parameter for the number of redraws.
\n",
"itemtype": "method",
"name": "redraw",
"params": [
@@ -6920,7 +7906,7 @@ module.exports={
},
{
"file": "src/core/transform.js",
- "line": 15,
+ "line": 13,
"description": "Multiplies the current matrix by the one specified through the parameters.\nThis is a powerful operation that can perform the equivalent of translate,\nscale, shear and rotate all at once. You can learn more about transformation\nmatrices on \nWikipedia.
\nThe naming of the arguments here follows the naming of the \nWHATWG specification and corresponds to a\ntransformation matrix of the\nform:
\n\n![](\"assets/transformation-matrix.png\"\nalt=\"The)
\n
\n",
"itemtype": "method",
"name": "applyMatrix",
@@ -6958,7 +7944,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n // Equivalent to translate(x, y);\n applyMatrix(1, 0, 0, 1, 40 + step, 50);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n translate(50, 50);\n // Equivalent to scale(x, y);\n applyMatrix(1 / step, 0, 0, 1 / step, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20\n var angle = map(step, 0, 20, 0, TWO_PI);\n var cos_a = cos(angle);\n var sin_a = sin(angle);\n background(200);\n translate(50, 50);\n // Equivalent to rotate(angle);\n applyMatrix(cos_a, sin_a, -sin_a, cos_a, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20\n var angle = map(step, 0, 20, -PI/4, PI/4);\n background(200);\n translate(50, 50);\n // equivalent to shearX(angle);\n var shear_factor = 1 / tan(PI/2 - angle);\n applyMatrix(1, 0, shear_factor, 1, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n"
+ "\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n // Equivalent to translate(x, y);\n applyMatrix(1, 0, 0, 1, 40 + step, 50);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n translate(50, 50);\n // Equivalent to scale(x, y);\n applyMatrix(1 / step, 0, 0, 1 / step, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n var angle = map(step, 0, 20, 0, TWO_PI);\n var cos_a = cos(angle);\n var sin_a = sin(angle);\n background(200);\n translate(50, 50);\n // Equivalent to rotate(angle);\n applyMatrix(cos_a, sin_a, -sin_a, cos_a, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n var angle = map(step, 0, 20, -PI / 4, PI / 4);\n background(200);\n translate(50, 50);\n // equivalent to shearX(angle);\n var shear_factor = 1 / tan(PI / 2 - angle);\n applyMatrix(1, 0, shear_factor, 1, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n"
],
"alt": "A rectangle translating to the right\nA rectangle shrinking to the center\nA rectangle rotating clockwise about the center\nA rectangle shearing",
"class": "p5",
@@ -6967,7 +7953,7 @@ module.exports={
},
{
"file": "src/core/transform.js",
- "line": 137,
+ "line": 135,
"description": "Replaces the current matrix with the identity matrix.
\n",
"itemtype": "method",
"name": "resetMatrix",
@@ -6982,8 +7968,8 @@ module.exports={
},
{
"file": "src/core/transform.js",
- "line": 163,
- "description": "Rotates a shape the amount specified by the angle parameter. This\nfunction accounts for angleMode, so angles can be entered in either\nRADIANS or DEGREES.\n
\nObjects are always rotated around their relative position to the\norigin and positive numbers rotate objects in a clockwise direction.\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nrotate(HALF_PI) and then rotate(HALF_PI) is the same as rotate(PI).\nAll tranformations are reset when draw() begins again.\n
\nTechnically, rotate() multiplies the current transformation matrix\nby a rotation matrix. This function can be further controlled by\nthe push() and pop().
\n",
+ "line": 161,
+ "description": "Rotates a shape the amount specified by the angle parameter. This\nfunction accounts for angleMode, so angles can be entered in either\nRADIANS or DEGREES.\n
\nObjects are always rotated around their relative position to the\norigin and positive numbers rotate objects in a clockwise direction.\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nrotate(HALF_PI) and then rotate(HALF_PI) is the same as rotate(PI).\nAll tranformations are reset when draw() begins again.\n
\nTechnically, rotate() multiplies the current transformation matrix\nby a rotation matrix. This function can be further controlled by\nthe push() and pop().
\n",
"itemtype": "method",
"name": "rotate",
"params": [
@@ -6995,13 +7981,13 @@ module.exports={
{
"name": "axis",
"description": "(in 3d) the axis to rotate around
\n",
- "type": "p5.Vector|Array",
+ "type": "p5.Vector|Number[]",
"optional": true
}
],
"chainable": 1,
"example": [
- "\n\n\ntranslate(width/2, height/2);\nrotate(PI/3.0);\nrect(-26, -26, 52, 52);\n\n"
+ "\n\n\ntranslate(width / 2, height / 2);\nrotate(PI / 3.0);\nrect(-26, -26, 52, 52);\n\n"
],
"alt": "white 52x52 rect with black outline at center rotated counter 45 degrees",
"class": "p5",
@@ -7010,96 +7996,125 @@ module.exports={
},
{
"file": "src/core/transform.js",
- "line": 218,
+ "line": 201,
"description": "Rotates around X axis.
\n",
"itemtype": "method",
"name": "rotateX",
"params": [
{
- "name": "rad",
- "description": "angles in radians
\n",
+ "name": "angle",
+ "description": "the angle of rotation, specified in radians\n or degrees, depending on current angleMode
\n",
"type": "Number"
}
],
"chainable": 1,
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(255);\n rotateX(millis() / 1000);\n box();\n}\n\n"
+ ],
+ "alt": "3d box rotating around the x axis.",
"class": "p5",
"module": "Transform",
"submodule": "Transform"
},
{
"file": "src/core/transform.js",
- "line": 233,
+ "line": 231,
"description": "Rotates around Y axis.
\n",
"itemtype": "method",
"name": "rotateY",
"params": [
{
- "name": "rad",
- "description": "angles in radians
\n",
+ "name": "angle",
+ "description": "the angle of rotation, specified in radians\n or degrees, depending on current angleMode
\n",
"type": "Number"
}
],
"chainable": 1,
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(255);\n rotateY(millis() / 1000);\n box();\n}\n\n"
+ ],
+ "alt": "3d box rotating around the y axis.",
"class": "p5",
"module": "Transform",
"submodule": "Transform"
},
{
"file": "src/core/transform.js",
- "line": 248,
+ "line": 261,
"description": "Rotates around Z axis. Webgl mode only.
\n",
"itemtype": "method",
"name": "rotateZ",
"params": [
{
- "name": "rad",
- "description": "angles in radians
\n",
+ "name": "angle",
+ "description": "the angle of rotation, specified in radians\n or degrees, depending on current angleMode
\n",
"type": "Number"
}
],
"chainable": 1,
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(255);\n rotateZ(millis() / 1000);\n box();\n}\n\n"
+ ],
+ "alt": "3d box rotating around the z axis.",
"class": "p5",
"module": "Transform",
"submodule": "Transform"
},
{
"file": "src/core/transform.js",
- "line": 263,
- "description": "Increases or decreases the size of a shape by expanding and contracting\nvertices. Objects always scale from their relative origin to the\ncoordinate system. Scale values are specified as decimal percentages.\nFor example, the function call scale(2.0) increases the dimension of a\nshape by 200%.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function multiply the effect. For example, calling scale(2.0)\nand then scale(1.5) is the same as scale(3.0). If scale() is called\nwithin draw(), the transformation is reset when the loop begins again.\n
\nUsing this function with the z parameter is only available in WEBGL mode.\nThis function can be further controlled with push() and pop().
\n",
+ "line": 291,
+ "description": "Increases or decreases the size of a shape by expanding and contracting\nvertices. Objects always scale from their relative origin to the\ncoordinate system. Scale values are specified as decimal percentages.\nFor example, the function call scale(2.0) increases the dimension of a\nshape by 200%.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function multiply the effect. For example, calling scale(2.0)\nand then scale(1.5) is the same as scale(3.0). If scale() is called\nwithin draw(), the transformation is reset when the loop begins again.\n
\nUsing this function with the z parameter is only available in WEBGL mode.\nThis function can be further controlled with push() and pop().
\n",
"itemtype": "method",
"name": "scale",
- "params": [
- {
- "name": "s",
- "description": "percent to scale the object, or percentage to\n scale the object in the x-axis if multiple arguments\n are given
\n",
- "type": "Number|p5.Vector|Array"
- },
- {
- "name": "y",
- "description": "percent to scale the object in the y-axis
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "z",
- "description": "percent to scale the object in the z-axis (webgl only)
\n",
- "type": "Number",
- "optional": true
- }
- ],
"chainable": 1,
"example": [
- "\n\n\ntranslate(width/2, height/2);\nrotate(PI/3.0);\nrect(-26, -26, 52, 52);\n\n\n\n\n\nrect(30, 20, 50, 50);\nscale(0.5, 1.3);\nrect(30, 20, 50, 50);\n\n"
+ "\n\n\nrect(30, 20, 50, 50);\nscale(0.5);\nrect(30, 20, 50, 50);\n\n\n\n\n\nrect(30, 20, 50, 50);\nscale(0.5, 1.3);\nrect(30, 20, 50, 50);\n\n"
],
"alt": "white 52x52 rect with black outline at center rotated counter 45 degrees\n2 white rects with black outline- 1 50x50 at center. other 25x65 bottom left",
"class": "p5",
"module": "Transform",
- "submodule": "Transform"
+ "submodule": "Transform",
+ "overloads": [
+ {
+ "line": 291,
+ "params": [
+ {
+ "name": "s",
+ "description": "percent to scale the object, or percentage to\n scale the object in the x-axis if multiple arguments\n are given
\n",
+ "type": "Number|p5.Vector|Number[]"
+ },
+ {
+ "name": "y",
+ "description": "percent to scale the object in the y-axis
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "z",
+ "description": "percent to scale the object in the z-axis (webgl only)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 336,
+ "params": [
+ {
+ "name": "scales",
+ "description": "per-axis percents to scale the object
\n",
+ "type": "p5.Vector|Number[]"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "src/core/transform.js",
- "line": 345,
- "description": "Shears a shape around the x-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode.\nObjects are always sheared around their relative position to the origin\nand positive numbers shear objects in a clockwise direction.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearX(PI/2) and then shearX(PI/2) is the same as shearX(PI).\nIf shearX() is called within the draw(), the transformation is reset when\nthe loop begins again.\n
\nTechnically, shearX() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.
\n",
+ "line": 366,
+ "description": "Shears a shape around the x-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode.\nObjects are always sheared around their relative position to the origin\nand positive numbers shear objects in a clockwise direction.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearX(PI/2) and then shearX(PI/2) is the same as shearX(PI).\nIf shearX() is called within the draw(), the transformation is reset when\nthe loop begins again.\n
\nTechnically, shearX() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.
\n",
"itemtype": "method",
"name": "shearX",
"params": [
@@ -7111,7 +8126,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\ntranslate(width/4, height/4);\nshearX(PI/4.0);\nrect(0, 0, 30, 30);\n\n"
+ "\n\n\ntranslate(width / 4, height / 4);\nshearX(PI / 4.0);\nrect(0, 0, 30, 30);\n\n"
],
"alt": "white irregular quadrilateral with black outline at top middle.",
"class": "p5",
@@ -7120,8 +8135,8 @@ module.exports={
},
{
"file": "src/core/transform.js",
- "line": 386,
- "description": "Shears a shape around the y-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode. Objects\nare always sheared around their relative position to the origin and\npositive numbers shear objects in a clockwise direction.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If\nshearY() is called within the draw(), the transformation is reset when\nthe loop begins again.\n
\nTechnically, shearY() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.
\n",
+ "line": 405,
+ "description": "Shears a shape around the y-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode. Objects\nare always sheared around their relative position to the origin and\npositive numbers shear objects in a clockwise direction.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If\nshearY() is called within the draw(), the transformation is reset when\nthe loop begins again.\n
\nTechnically, shearY() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.
\n",
"itemtype": "method",
"name": "shearY",
"params": [
@@ -7133,7 +8148,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\ntranslate(width/4, height/4);\nshearY(PI/4.0);\nrect(0, 0, 30, 30);\n\n"
+ "\n\n\ntranslate(width / 4, height / 4);\nshearY(PI / 4.0);\nrect(0, 0, 30, 30);\n\n"
],
"alt": "white irregular quadrilateral with black outline at middle bottom.",
"class": "p5",
@@ -7142,321 +8157,170 @@ module.exports={
},
{
"file": "src/core/transform.js",
- "line": 427,
- "description": "Specifies an amount to displace objects within the display window.\nThe x parameter specifies left/right translation, the y parameter\nspecifies up/down translation.\n
\nTransformations are cumulative and apply to everything that happens after\nand subsequent calls to the function accumulates the effect. For example,\ncalling translate(50, 0) and then translate(20, 0) is the same as\ntranslate(70, 0). If translate() is called within draw(), the\ntransformation is reset when the loop begins again. This function can be\nfurther controlled by using push() and pop().
\n",
+ "line": 444,
+ "description": "Specifies an amount to displace objects within the display window.\nThe x parameter specifies left/right translation, the y parameter\nspecifies up/down translation.\n
\nTransformations are cumulative and apply to everything that happens after\nand subsequent calls to the function accumulates the effect. For example,\ncalling translate(50, 0) and then translate(20, 0) is the same as\ntranslate(70, 0). If translate() is called within draw(), the\ntransformation is reset when the loop begins again. This function can be\nfurther controlled by using push() and pop().
\n",
"itemtype": "method",
"name": "translate",
- "params": [
- {
- "name": "x",
- "description": "left/right translation
\n",
- "type": "Number"
- },
- {
- "name": "y",
- "description": "up/down translation
\n",
- "type": "Number"
- },
- {
- "name": "z",
- "description": "forward/backward translation (webgl only)
\n",
- "type": "Number",
- "optional": true
- }
- ],
"chainable": 1,
"example": [
- "\n\n\ntranslate(30, 20);\nrect(0, 0, 55, 55);\n\n\n\n\n\nrect(0, 0, 55, 55); // Draw rect at original 0,0\ntranslate(30, 20);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\ntranslate(14, 14);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\n\n"
+ "\n\n\ntranslate(30, 20);\nrect(0, 0, 55, 55);\n\n\n\n\n\nrect(0, 0, 55, 55); // Draw rect at original 0,0\ntranslate(30, 20);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\ntranslate(14, 14);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\n\n\n\n\n\n\nfunction draw() {\n background(200);\n rectMode(CENTER);\n translate(width / 2, height / 2);\n translate(p5.Vector.fromAngle(millis() / 1000, 40));\n rect(0, 0, 20, 20);\n}\n\n"
],
- "alt": "white 55x55 rect with black outline at center right.\n3 white 55x55 rects with black outlines at top-l, center-r and bottom-r.",
+ "alt": "white 55x55 rect with black outline at center right.\n3 white 55x55 rects with black outlines at top-l, center-r and bottom-r.\na 20x20 white rect moving in a circle around the canvas",
"class": "p5",
"module": "Transform",
- "submodule": "Transform"
- },
- {
- "file": "src/core/vertex.js",
- "line": 22,
- "description": "Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n
\nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.
\n",
- "itemtype": "method",
- "name": "beginContour",
- "chainable": 1,
- "example": [
- "\n\n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n"
- ],
- "alt": "white rect and smaller grey rect with red outlines in center of canvas.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
- },
- {
- "file": "src/core/vertex.js",
- "line": 70,
- "description": "Using the beginShape() and endShape() functions allow creating more\ncomplex forms. beginShape() begins recording vertices for a shape and\nendShape() stops recording. The value of the kind parameter tells it which\ntypes of shapes to create from the provided vertices. With no mode\nspecified, the shape can be any irregular polygon.\n
\nThe parameters available for beginShape() are POINTS, LINES, TRIANGLES,\nTRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the\nbeginShape() function, a series of vertex() commands must follow. To stop\ndrawing the shape, call endShape(). Each shape will be outlined with the\ncurrent stroke color and filled with the fill color.\n
\nTransformations such as translate(), rotate(), and scale() do not work\nwithin beginShape(). It is also not possible to use other shapes, such as\nellipse() or rect() within beginShape().
\n",
- "itemtype": "method",
- "name": "beginShape",
- "params": [
- {
- "name": "kind",
- "description": "either POINTS, LINES, TRIANGLES, TRIANGLE_FAN\n TRIANGLE_STRIP, QUADS, or QUAD_STRIP
\n",
- "type": "Constant",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n\n\n\n\n// currently not working\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nbeginShape(LINES);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n\n\n\n\nbeginShape(TRIANGLES);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nendShape();\n\n\n\n\n\nbeginShape(TRIANGLE_STRIP);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nvertex(90, 75);\nendShape();\n\n\n\n\n\nbeginShape(TRIANGLE_FAN);\nvertex(57.5, 50);\nvertex(57.5, 15);\nvertex(92, 50);\nvertex(57.5, 85);\nvertex(22, 50);\nvertex(57.5, 15);\nendShape();\n\n\n\n\n\nbeginShape(QUADS);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 75);\nvertex(50, 20);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 75);\nvertex(85, 20);\nendShape();\n\n\n\n\n\nbeginShape(QUAD_STRIP);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 20);\nvertex(50, 75);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 20);\nvertex(85, 75);\nendShape();\n\n\n\n\n\nbeginShape();\nvertex(20, 20);\nvertex(40, 20);\nvertex(40, 40);\nvertex(60, 40);\nvertex(60, 60);\nvertex(20, 60);\nendShape(CLOSE);\n\n"
- ],
- "alt": "white square-shape with black outline in middle-right of canvas.\n4 black points in a square shape in middle-right of canvas.\n2 horizontal black lines. In the top-right and bottom-right of canvas.\n3 line shape with horizontal on top, vertical in middle and horizontal bottom.\nsquare line shape in middle-right of canvas.\n2 white triangle shapes mid-right canvas. left one pointing up and right down.\n5 horizontal interlocking and alternating white triangles in mid-right canvas.\n4 interlocking white triangles in 45 degree rotated square-shape.\n2 white rectangle shapes in mid-right canvas. Both 20x55.\n3 side-by-side white rectangles center rect is smaller in mid-right canvas.\nThick white l-shape with black outline mid-top-left of canvas.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
- },
- {
- "file": "src/core/vertex.js",
- "line": 267,
- "description": "Specifies vertex coordinates for Bezier curves. Each call to\nbezierVertex() defines the position of two control points and\none anchor point of a Bezier curve, adding a new segment to a\nline or shape.\n
\nThe first time bezierVertex() is used within a\nbeginShape() call, it must be prefaced with a call to vertex()\nto set the first anchor point. This function must be used between\nbeginShape() and endShape() and only when there is no MODE\nparameter specified to beginShape().
\n",
- "itemtype": "method",
- "name": "bezierVertex",
- "params": [
- {
- "name": "x2",
- "description": "x-coordinate for the first control point
\n",
- "type": "Number"
- },
- {
- "name": "y2",
- "description": "y-coordinate for the first control point
\n",
- "type": "Number"
- },
- {
- "name": "x3",
- "description": "x-coordinate for the second control point
\n",
- "type": "Number"
- },
- {
- "name": "y3",
- "description": "y-coordinate for the second control point
\n",
- "type": "Number"
- },
- {
- "name": "x4",
- "description": "x-coordinate for the anchor point
\n",
- "type": "Number"
- },
- {
- "name": "y4",
- "description": "y-coordinate for the anchor point
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nendShape();\n\n\n\n\n\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nbezierVertex(50, 80, 60, 25, 30, 20);\nendShape();\n\n"
- ],
- "alt": "crescent-shaped line in middle of canvas. Points facing left.\nwhite crescent shape in middle of canvas. Points facing left.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
- },
- {
- "file": "src/core/vertex.js",
- "line": 332,
- "description": "Specifies vertex coordinates for curves. This function may only\nbe used between beginShape() and endShape() and only when there\nis no MODE parameter specified to beginShape().\n
\nThe first and last points in a series of curveVertex() lines will be used to\nguide the beginning and end of a the curve. A minimum of four\npoints is required to draw a tiny curve between the second and\nthird points. Adding a fifth point with curveVertex() will draw\nthe curve between the second, third, and fourth points. The\ncurveVertex() function is an implementation of Catmull-Rom\nsplines.
\n",
- "itemtype": "method",
- "name": "curveVertex",
- "params": [
+ "submodule": "Transform",
+ "overloads": [
{
- "name": "x",
- "description": "x-coordinate of the vertex
\n",
- "type": "Number"
+ "line": 444,
+ "params": [
+ {
+ "name": "x",
+ "description": "left/right translation
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "up/down translation
\n",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "forward/backward translation (webgl only)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
},
{
- "name": "y",
- "description": "y-coordinate of the vertex
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\nnoFill();\nbeginShape();\ncurveVertex(84, 91);\ncurveVertex(84, 91);\ncurveVertex(68, 19);\ncurveVertex(21, 17);\ncurveVertex(32, 100);\ncurveVertex(32, 100);\nendShape();\n\n"
- ],
- "alt": "Upside-down u-shape line, mid canvas. left point extends beyond canvas view.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
- },
- {
- "file": "src/core/vertex.js",
- "line": 374,
- "description": "Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n
\nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.
\n",
- "itemtype": "method",
- "name": "endContour",
- "chainable": 1,
- "example": [
- "\n\n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n"
- ],
- "alt": "white rect and smaller grey rect with red outlines in center of canvas.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
- },
- {
- "file": "src/core/vertex.js",
- "line": 434,
- "description": "The endShape() function is the companion to beginShape() and may only be\ncalled after beginShape(). When endshape() is called, all of image data\ndefined since the previous call to beginShape() is written into the image\nbuffer. The constant CLOSE as the value for the MODE parameter to close\nthe shape (to connect the beginning and the end).
\n",
- "itemtype": "method",
- "name": "endShape",
- "params": [
- {
- "name": "mode",
- "description": "use CLOSE to close the shape
\n",
- "type": "Constant",
- "optional": true
+ "line": 498,
+ "params": [
+ {
+ "name": "vector",
+ "description": "the vector to translate by
\n",
+ "type": "p5.Vector"
+ }
+ ],
+ "chainable": 1
}
- ],
- "chainable": 1,
- "example": [
- "\n\n\nnoFill();\n\nbeginShape();\nvertex(20, 20);\nvertex(45, 20);\nvertex(45, 80);\nendShape(CLOSE);\n\nbeginShape();\nvertex(50, 20);\nvertex(75, 20);\nvertex(75, 80);\nendShape();\n\n"
- ],
- "alt": "Triangle line shape with smallest interior angle on bottom and upside-down L.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
+ ]
},
{
- "file": "src/core/vertex.js",
- "line": 502,
- "description": "Specifies vertex coordinates for quadratic Bezier curves. Each call to\nquadraticVertex() defines the position of one control points and one\nanchor point of a Bezier curve, adding a new segment to a line or shape.\nThe first time quadraticVertex() is used within a beginShape() call, it\nmust be prefaced with a call to vertex() to set the first anchor point.\nThis function must be used between beginShape() and endShape() and only\nwhen there is no MODE parameter specified to beginShape().
\n",
+ "file": "src/data/p5.TypedDict.js",
+ "line": 16,
+ "description": "Creates a new instance of p5.StringDict using the key-value pair\n or the object you provide.
\n",
"itemtype": "method",
- "name": "quadraticVertex",
- "params": [
- {
- "name": "cx",
- "description": "x-coordinate for the control point
\n",
- "type": "Number"
- },
- {
- "name": "cy",
- "description": "y-coordinate for the control point
\n",
- "type": "Number"
- },
- {
- "name": "x3",
- "description": "x-coordinate for the anchor point
\n",
- "type": "Number"
- },
- {
- "name": "y3",
- "description": "y-coordinate for the anchor point
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
+ "name": "createStringDict",
+ "return": {
+ "description": "",
+ "type": "p5.StringDict"
+ },
"example": [
- "\n\n\nnoFill();\nstrokeWeight(4);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nendShape();\n\n\n\n\n\nnoFill();\nstrokeWeight(4);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nquadraticVertex(20, 80, 80, 80);\nvertex(80, 60);\nendShape();\n\n"
+ "\n \n \n function setup() {\n var myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // logs true to console\n var anotherDictionary = createStringDict({ happy: 'coding' });\n print(anotherDictionary.hasKey('happy')); // logs true to console\n }\n "
],
- "alt": "arched-shaped black line with 4 pixel thick stroke weight.\nbackwards s-shaped black line with 4 pixel thick stroke weight.",
"class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
- },
- {
- "file": "src/core/vertex.js",
- "line": 579,
- "description": "All shapes are constructed by connecting a series of vertices. vertex()\nis used to specify the vertex coordinates for points, lines, triangles,\nquads, and polygons. It is used exclusively within the beginShape() and\nendShape() functions.
\n",
- "itemtype": "method",
- "name": "vertex",
- "params": [
- {
- "name": "x",
- "description": "x-coordinate of the vertex
\n",
- "type": "Number"
- },
+ "module": "Data",
+ "submodule": "Dictionary",
+ "overloads": [
{
- "name": "y",
- "description": "y-coordinate of the vertex
\n",
- "type": "Number"
+ "line": 16,
+ "params": [
+ {
+ "name": "key",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "value",
+ "description": "",
+ "type": "String"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "p5.StringDict"
+ }
},
{
- "name": "z",
- "description": "z-coordinate of the vertex
\n",
- "type": "Number|Boolean",
- "optional": true
+ "line": 39,
+ "params": [
+ {
+ "name": "object",
+ "description": "object
\n",
+ "type": "Object"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "p5.StringDict"
+ }
}
- ],
- "chainable": 1,
- "example": [
- "\n\n\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n"
- ],
- "alt": "4 black points in a square shape in middle-right of canvas.",
- "class": "p5",
- "module": "Shape",
- "submodule": "Vertex"
+ ]
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 16,
- "description": "Creates a new instance of p5.StringDict using the key, value pair\n or object you provide.
\n",
+ "line": 50,
+ "description": "Creates a new instance of p5.NumberDict using the key-value pair\n or object you provide.
\n",
"itemtype": "method",
- "name": "createStringDict",
- "params": [
- {
- "name": "key",
- "description": "or object
\n",
- "type": "String|Object"
- },
- {
- "name": "value",
- "description": "",
- "type": "String"
- }
- ],
+ "name": "createNumberDict",
"return": {
"description": "",
- "type": "p5.StringDict"
+ "type": "p5.NumberDict"
},
- "class": "p5.TypedDict",
+ "example": [
+ "\n \n \n function setup() {\n var myDictionary = createNumberDict(100, 42);\n print(myDictionary.hasKey(100)); // logs true to console\n var anotherDictionary = createNumberDict({ 200: 84 });\n print(anotherDictionary.hasKey(200)); // logs true to console\n }\n "
+ ],
+ "class": "p5",
"module": "Data",
- "submodule": "Dictionary"
- },
- {
- "file": "src/data/p5.TypedDict.js",
- "line": 32,
- "description": "Creates a new instance of p5.NumberDict using the key, value pair\n or object you provide.
\n",
- "itemtype": "method",
- "name": "createNumberDict",
- "params": [
+ "submodule": "Dictionary",
+ "overloads": [
{
- "name": "key",
- "description": "or object
\n",
- "type": "Number|Object"
+ "line": 50,
+ "params": [
+ {
+ "name": "key",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "value",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "p5.NumberDict"
+ }
},
{
- "name": "value",
- "description": "",
- "type": "Number"
+ "line": 73,
+ "params": [
+ {
+ "name": "object",
+ "description": "object
\n",
+ "type": "Object"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "p5.NumberDict"
+ }
}
- ],
- "return": {
- "description": "",
- "type": "p5.NumberDict"
- },
- "class": "p5.TypedDict",
- "module": "Data",
- "submodule": "Dictionary"
+ ]
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 68,
- "description": "Returns the number of key-value pairs currently in Dictionary object
\n",
+ "line": 103,
+ "description": "Returns the number of key-value pairs currently stored in the Dictionary.
\n",
"itemtype": "method",
"name": "size",
"return": {
- "description": "the number of key-value pairs in Dictionary object",
- "type": "Number"
+ "description": "the number of key-value pairs in the Dictionary",
+ "type": "Integer"
},
"example": [
- "\n\n\n\nfunction setup() {\n var myDictionary = createNumberDict(1, 10);\n myDictionary.create(2, 20);\n myDictionary.create(3, 30);\n var amt = myDictionary.size(); // value of amt is 3\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(1, 10);\n myDictionary.create(2, 20);\n myDictionary.create(3, 30);\n print(myDictionary.size()); // logs 3 to the console\n}\n\n"
],
"class": "p5.TypedDict",
"module": "Data",
@@ -7464,14 +8328,14 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 92,
- "description": "Returns true if key exists in Dictionary\notherwise returns false
\n",
+ "line": 125,
+ "description": "Returns true if the given key exists in the Dictionary,\notherwise returns false.
\n",
"itemtype": "method",
"name": "hasKey",
"params": [
{
"name": "key",
- "description": "that you want to access
\n",
+ "description": "that you want to look up
\n",
"type": "Number|String"
}
],
@@ -7480,7 +8344,7 @@ module.exports={
"type": "Boolean"
},
"example": [
- "\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // logs true to console\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // logs true to console\n}\n\n"
],
"class": "p5.TypedDict",
"module": "Data",
@@ -7488,14 +8352,14 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 117,
- "description": "Returns value stored at supplied key.
\n",
+ "line": 148,
+ "description": "Returns the value stored at the given key.
\n",
"itemtype": "method",
"name": "get",
"params": [
{
- "name": "key",
- "description": "that you want to access
\n",
+ "name": "the",
+ "description": "key you want to access
\n",
"type": "Number|String"
}
],
@@ -7504,7 +8368,7 @@ module.exports={
"type": "Number|String"
},
"example": [
- "\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n var myValue = myDictionary.get('p5');\n print(myValue === 'js'); // logs true to console\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n var myValue = myDictionary.get('p5');\n print(myValue === 'js'); // logs true to console\n}\n\n"
],
"class": "p5.TypedDict",
"module": "Data",
@@ -7512,8 +8376,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 146,
- "description": "Changes the value of key if in it already exists in\nin the Dictionary otherwise makes a new key-value pair
\n",
+ "line": 175,
+ "description": "Updates the value associated with the given key in case it already exists\nin the Dictionary. Otherwise a new key-value pair is added.
\n",
"itemtype": "method",
"name": "set",
"params": [
@@ -7529,7 +8393,7 @@ module.exports={
}
],
"example": [
- "\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.set('p5', 'JS');\n myDictionary.print()\n // above logs \"key: p5 - value: JS\" to console\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.set('p5', 'JS');\n myDictionary.print(); // logs \"key: p5 - value: JS\" to console\n}\n\n"
],
"class": "p5.TypedDict",
"module": "Data",
@@ -7537,24 +8401,27 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 179,
- "description": "private helper function to handle the user passing objects in\nduring construction or calls to create()
\n",
+ "line": 203,
+ "description": "private helper function to handle the user passing in objects\nduring construction or calls to create()
\n",
"class": "p5.TypedDict",
"module": "Data",
"submodule": "Dictionary"
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 194,
- "description": "Removes a key-value pair in the Dictionary
\n",
+ "line": 214,
+ "description": "Creates a new key-value pair in the Dictionary.
\n",
"itemtype": "method",
"name": "create",
+ "example": [
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print();\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n}\n"
+ ],
"class": "p5.TypedDict",
"module": "Data",
"submodule": "Dictionary",
"overloads": [
{
- "line": 194,
+ "line": 214,
"params": [
{
"name": "key",
@@ -7569,7 +8436,7 @@ module.exports={
]
},
{
- "line": 201,
+ "line": 232,
"params": [
{
"name": "obj",
@@ -7582,18 +8449,21 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 234,
- "description": "Empties Dictionary of all key-value pairs
\n",
+ "line": 250,
+ "description": "Removes all previously stored key-value pairs from the Dictionary.
\n",
"itemtype": "method",
"name": "clear",
+ "example": [
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // prints 'true'\n myDictionary.clear();\n print(myDictionary.hasKey('p5')); // prints 'false'\n}\n\n"
+ ],
"class": "p5.TypedDict",
"module": "Data",
"submodule": "Dictionary"
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 245,
- "description": "Removes a key-value pair in the Dictionary
\n",
+ "line": 271,
+ "description": "Removes the key-value pair stored at the given key from the Dictionary.
\n",
"itemtype": "method",
"name": "remove",
"params": [
@@ -7604,7 +8474,7 @@ module.exports={
}
],
"example": [
- "\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print()\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n myDictionary.remove('p5');\n myDictionary.print();\n // above logs \"key: happy value: coding\" to console\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print();\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n myDictionary.remove('p5');\n myDictionary.print();\n // above logs \"key: happy value: coding\" to console\n}\n\n"
],
"class": "p5.TypedDict",
"module": "Data",
@@ -7612,37 +8482,46 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 277,
- "description": "Logs the list of items currently in the Dictionary to the console
\n",
+ "line": 301,
+ "description": "Logs the set of items currently stored in the Dictionary to the console.
\n",
"itemtype": "method",
"name": "print",
+ "example": [
+ "\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print();\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n}\n\n"
+ ],
"class": "p5.TypedDict",
"module": "Data",
"submodule": "Dictionary"
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 289,
- "description": "Converts the Dictionary into a CSV file for local\nstorage.
\n",
+ "line": 325,
+ "description": "Converts the Dictionary into a CSV file for local download.
\n",
"itemtype": "method",
"name": "saveTable",
+ "example": [
+ "\n\n\ncreateButton('save')\n .position(10, 10)\n .mousePressed(function() {\n createStringDict({\n john: 1940,\n paul: 1942,\n george: 1943,\n ringo: 1940\n }).saveTable('beatles');\n });\n\n"
+ ],
"class": "p5.TypedDict",
"module": "Data",
"submodule": "Dictionary"
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 310,
- "description": "Converts the Dictionary into a JSON file for local\nstorage.
\n",
+ "line": 357,
+ "description": "Converts the Dictionary into a JSON file for local download.
\n",
"itemtype": "method",
"name": "saveJSON",
+ "example": [
+ "\n\n\ncreateButton('save')\n .position(10, 10)\n .mousePressed(function() {\n createStringDict({\n john: 1940,\n paul: 1942,\n george: 1943,\n ringo: 1940\n }).saveJSON('beatles');\n });\n\n"
+ ],
"class": "p5.TypedDict",
"module": "Data",
"submodule": "Dictionary"
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 321,
+ "line": 382,
"description": "private helper function to ensure that the user passed in valid\nvalues for the Dictionary type
\n",
"class": "p5.TypedDict",
"module": "Data",
@@ -7650,7 +8529,7 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 368,
+ "line": 425,
"description": "private helper function to ensure that the user passed in valid\nvalues for the Dictionary type
\n",
"class": "p5.NumberDict",
"module": "Data",
@@ -7658,24 +8537,24 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 377,
- "description": "Add to a value stored at a certain key\nThe sum is stored in that location in the Dictionary.
\n",
+ "line": 434,
+ "description": "Add the given number to the value currently stored at the given key.\nThe sum then replaces the value previously stored in the Dictionary.
\n",
"itemtype": "method",
"name": "add",
"params": [
{
"name": "Key",
- "description": "for value you wish to add to
\n",
+ "description": "for the value you wish to add to
\n",
"type": "Number"
},
{
- "name": "Amount",
+ "name": "Number",
"description": "to add to the value
\n",
"type": "Number"
}
],
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 5);\n myDictionary.add(2, 2);\n console.log(myDictionary.get(2)); // logs 7 to console.\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 5);\n myDictionary.add(2, 2);\n print(myDictionary.get(2)); // logs 7 to console.\n}\n\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7683,24 +8562,24 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 405,
- "description": "Subtract from a value stored at a certain key\nThe difference is stored in that location in the Dictionary.
\n",
+ "line": 462,
+ "description": "Subtract the given number from the value currently stored at the given key.\nThe difference then replaces the value previously stored in the Dictionary.
\n",
"itemtype": "method",
"name": "sub",
"params": [
{
"name": "Key",
- "description": "for value you wish to subtract from
\n",
+ "description": "for the value you wish to subtract from
\n",
"type": "Number"
},
{
- "name": "Amount",
+ "name": "Number",
"description": "to subtract from the value
\n",
"type": "Number"
}
],
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 5);\n myDictionary.sub(2, 2);\n console.log(myDictionary.get(2)); // logs 3 to console.\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 5);\n myDictionary.sub(2, 2);\n print(myDictionary.get(2)); // logs 3 to console.\n}\n\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7708,8 +8587,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 429,
- "description": "Multiply a value stored at a certain key\nThe product is stored in that location in the Dictionary.
\n",
+ "line": 486,
+ "description": "Multiply the given number with the value currently stored at the given key.\nThe product then replaces the value previously stored in the Dictionary.
\n",
"itemtype": "method",
"name": "mult",
"params": [
@@ -7725,7 +8604,7 @@ module.exports={
}
],
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 4);\n myDictionary.mult(2, 2);\n console.log(myDictionary.get(2)); // logs 8 to console.\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 4);\n myDictionary.mult(2, 2);\n print(myDictionary.get(2)); // logs 8 to console.\n}\n\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7733,8 +8612,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 457,
- "description": "Divide a value stored at a certain key\nThe quotient is stored in that location in the Dictionary.
\n",
+ "line": 514,
+ "description": "Divide the given number with the value currently stored at the given key.\nThe quotient then replaces the value previously stored in the Dictionary.
\n",
"itemtype": "method",
"name": "div",
"params": [
@@ -7750,7 +8629,7 @@ module.exports={
}
],
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 8);\n myDictionary.div(2, 2);\n console.log(myDictionary.get(2)); // logs 4 to console.\n}\n\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 8);\n myDictionary.div(2, 2);\n print(myDictionary.get(2)); // logs 4 to console.\n}\n\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7758,7 +8637,7 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 485,
+ "line": 542,
"description": "private helper function for finding lowest or highest value\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'
\n",
"class": "p5.NumberDict",
"module": "Data",
@@ -7766,8 +8645,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 508,
- "description": "Return the lowest value.
\n",
+ "line": 567,
+ "description": "Return the lowest number currently stored in the Dictionary.
\n",
"itemtype": "method",
"name": "minValue",
"return": {
@@ -7775,7 +8654,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({2 : -10, 4 : 0.65, 1.2 : 3});\n var lowestValue = myDictionary.minValue(); // value is -10\n}\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 });\n var lowestValue = myDictionary.minValue(); // value is -10\n print(lowestValue);\n}\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7783,8 +8662,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 528,
- "description": "Return the highest value.
\n",
+ "line": 588,
+ "description": "Return the highest number currently stored in the Dictionary.
\n",
"itemtype": "method",
"name": "maxValue",
"return": {
@@ -7792,7 +8671,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({2 : -10, 4 : 0.65, 1.2 : 3});\n var highestValue = myDictionary.maxValue(); // value is 3\n}\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 });\n var highestValue = myDictionary.maxValue(); // value is 3\n print(highestValue);\n}\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7800,7 +8679,7 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 548,
+ "line": 609,
"description": "private helper function for finding lowest or highest key\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'
\n",
"class": "p5.NumberDict",
"module": "Data",
@@ -7808,8 +8687,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 571,
- "description": "Return the lowest key.
\n",
+ "line": 632,
+ "description": "Return the lowest key currently used in the Dictionary.
\n",
"itemtype": "method",
"name": "minKey",
"return": {
@@ -7817,7 +8696,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({2 : 4, 4 : 6, 1.2 : 3});\n var lowestKey = myDictionary.minKey(); // value is 1.2\n}\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 });\n var lowestKey = myDictionary.minKey(); // value is 1.2\n print(lowestKey);\n}\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7825,8 +8704,8 @@ module.exports={
},
{
"file": "src/data/p5.TypedDict.js",
- "line": 591,
- "description": "Return the highest key.
\n",
+ "line": 653,
+ "description": "Return the highest key currently used in the Dictionary.
\n",
"itemtype": "method",
"name": "maxKey",
"return": {
@@ -7834,7 +8713,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({ 2 : 4, 4 : 6, 1.2 : 3});\n var highestKey = myDictionary.maxKey(); // value is 4\n}\n\n"
+ "\n\n\nfunction setup() {\n var myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 });\n var highestKey = myDictionary.maxKey(); // value is 4\n print(highestKey);\n}\n\n"
],
"class": "p5.NumberDict",
"module": "Data",
@@ -7924,22 +8803,12 @@ module.exports={
"module": "Events",
"submodule": "Acceleration"
},
- {
- "file": "src/events/acceleration.js",
- "line": 80,
- "description": "_updatePAccelerations updates the pAcceleration values
\n",
- "access": "private",
- "tagname": "",
- "class": "p5",
- "module": "Events",
- "submodule": "Acceleration"
- },
{
"file": "src/events/acceleration.js",
"line": 91,
"description": "The system variable rotationX always contains the rotation of the\ndevice along the x axis. Value is represented as 0 to +/-180 degrees.\n
\nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.
\n",
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n //rotateZ(radians(rotationZ));\n rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n //rotateZ(radians(rotationZ));\n rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"
],
"itemtype": "property",
"name": "rotationX",
@@ -7955,7 +8824,7 @@ module.exports={
"line": 125,
"description": "The system variable rotationY always contains the rotation of the\ndevice along the y axis. Value is represented as 0 to +/-90 degrees.\n
\nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.
\n",
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n //rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n //rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"
],
"itemtype": "property",
"name": "rotationY",
@@ -7971,7 +8840,7 @@ module.exports={
"line": 158,
"description": "The system variable rotationZ always contains the rotation of the\ndevice along the z axis. Value is represented as 0 to 359 degrees.\n
\nUnlike rotationX and rotationY, this variable is available for devices\nwith a built-in compass only.\n
\nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.
\n",
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"
],
"itemtype": "property",
"name": "rotationZ",
@@ -7987,7 +8856,7 @@ module.exports={
"line": 194,
"description": "The system variable pRotationX always contains the rotation of the\ndevice along the x axis in the frame previous to the current frame. Value\nis represented as 0 to +/-180 degrees.\n
\npRotationX can also be used with rotationX to determine the rotate\ndirection of the device along the X-axis.
\n",
"example": [
- "\n\n\n// A simple if statement looking at whether\n// rotationX - pRotationX < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely neccessary but the logic\n// will be different in that case.\n\nvar rX = rotationX + 180;\nvar pRX = pRotationX + 180;\n\nif ((rX - pRX > 0 && rX - pRX < 270)|| rX - pRX < -270){\n rotateDirection = 'clockwise';\n} else if (rX - pRX < 0 || rX - pRX > 270){\n rotateDirection = 'counter-clockwise';\n}\n\n"
+ "\n\n\n// A simple if statement looking at whether\n// rotationX - pRotationX < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely necessary but the logic\n// will be different in that case.\n\nvar rX = rotationX + 180;\nvar pRX = pRotationX + 180;\n\nif ((rX - pRX > 0 && rX - pRX < 270) || rX - pRX < -270) {\n rotateDirection = 'clockwise';\n} else if (rX - pRX < 0 || rX - pRX > 270) {\n rotateDirection = 'counter-clockwise';\n}\n\nprint(rotateDirection);\n\n"
],
"alt": "no image to display.",
"itemtype": "property",
@@ -8000,10 +8869,10 @@ module.exports={
},
{
"file": "src/events/acceleration.js",
- "line": 237,
+ "line": 239,
"description": "The system variable pRotationY always contains the rotation of the\ndevice along the y axis in the frame previous to the current frame. Value\nis represented as 0 to +/-90 degrees.\n
\npRotationY can also be used with rotationY to determine the rotate\ndirection of the device along the Y-axis.
\n",
"example": [
- "\n\n\n// A simple if statement looking at whether\n// rotationY - pRotationY < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely neccessary but the logic\n// will be different in that case.\n\nvar rY = rotationY + 180;\nvar pRY = pRotationY + 180;\n\nif ((rY - pRY > 0 && rY - pRY < 270)|| rY - pRY < -270){\n rotateDirection = 'clockwise';\n} else if (rY - pRY < 0 || rY - pRY > 270){\n rotateDirection = 'counter-clockwise';\n}\n\n"
+ "\n\n\n// A simple if statement looking at whether\n// rotationY - pRotationY < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely necessary but the logic\n// will be different in that case.\n\nvar rY = rotationY + 180;\nvar pRY = pRotationY + 180;\n\nif ((rY - pRY > 0 && rY - pRY < 270) || rY - pRY < -270) {\n rotateDirection = 'clockwise';\n} else if (rY - pRY < 0 || rY - pRY > 270) {\n rotateDirection = 'counter-clockwise';\n}\nprint(rotateDirection);\n\n"
],
"alt": "no image to display.",
"itemtype": "property",
@@ -8016,10 +8885,10 @@ module.exports={
},
{
"file": "src/events/acceleration.js",
- "line": 280,
+ "line": 283,
"description": "The system variable pRotationZ always contains the rotation of the\ndevice along the z axis in the frame previous to the current frame. Value\nis represented as 0 to 359 degrees.\n
\npRotationZ can also be used with rotationZ to determine the rotate\ndirection of the device along the Z-axis.
\n",
"example": [
- "\n\n\n// A simple if statement looking at whether\n// rotationZ - pRotationZ < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\nif ((rotationZ - pRotationZ > 0 &&\n rotationZ - pRotationZ < 270)||\n rotationZ - pRotationZ < -270){\n\n rotateDirection = 'clockwise';\n\n} else if (rotationZ - pRotationZ < 0 ||\n rotationZ - pRotationZ > 270){\n\n rotateDirection = 'counter-clockwise';\n\n}\n\n"
+ "\n\n\n// A simple if statement looking at whether\n// rotationZ - pRotationZ < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\nif (\n (rotationZ - pRotationZ > 0 && rotationZ - pRotationZ < 270) ||\n rotationZ - pRotationZ < -270\n) {\n rotateDirection = 'clockwise';\n} else if (rotationZ - pRotationZ < 0 || rotationZ - pRotationZ > 270) {\n rotateDirection = 'counter-clockwise';\n}\nprint(rotateDirection);\n\n"
],
"alt": "no image to display.",
"itemtype": "property",
@@ -8032,8 +8901,19 @@ module.exports={
},
{
"file": "src/events/acceleration.js",
- "line": 346,
- "description": "The setMoveThreshold() function is used to set the movement threshold for\nthe deviceMoved() function. The default threshold is set to 0.5.
\n",
+ "line": 341,
+ "itemtype": "property",
+ "name": "turnAxis",
+ "type": "String",
+ "readonly": "",
+ "class": "p5",
+ "module": "Events",
+ "submodule": "Acceleration"
+ },
+ {
+ "file": "src/events/acceleration.js",
+ "line": 350,
+ "description": "The setMoveThreshold() function is used to set the movement threshold for\nthe deviceMoved() function. The default threshold is set to 0.5.
\n",
"itemtype": "method",
"name": "setMoveThreshold",
"params": [
@@ -8043,14 +8923,18 @@ module.exports={
"type": "Number"
}
],
+ "example": [
+ "\n\n\n// Run this example on a mobile device\n// You will need to move the device incrementally further\n// the closer the square's color gets to white in order to change the value.\n\nvar value = 0;\nvar threshold = 0.5;\nfunction setup() {\n setMoveThreshold(threshold);\n}\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceMoved() {\n value = value + 5;\n threshold = threshold + 0.1;\n if (value > 255) {\n value = 0;\n threshold = 30;\n }\n setMoveThreshold(threshold);\n}\n\n"
+ ],
+ "alt": "50x50 black rect in center of canvas. turns white on mobile when device moves",
"class": "p5",
"module": "Events",
"submodule": "Acceleration"
},
{
"file": "src/events/acceleration.js",
- "line": 359,
- "description": "The setShakeThreshold() function is used to set the movement threshold for\nthe deviceShaken() function. The default threshold is set to 30.
\n",
+ "line": 393,
+ "description": "The setShakeThreshold() function is used to set the movement threshold for\nthe deviceShaken() function. The default threshold is set to 30.
\n",
"itemtype": "method",
"name": "setShakeThreshold",
"params": [
@@ -8060,14 +8944,18 @@ module.exports={
"type": "Number"
}
],
+ "example": [
+ "\n\n\n// Run this example on a mobile device\n// You will need to shake the device more firmly\n// the closer the box's fill gets to white in order to change the value.\n\nvar value = 0;\nvar threshold = 30;\nfunction setup() {\n setShakeThreshold(threshold);\n}\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceMoved() {\n value = value + 5;\n threshold = threshold + 5;\n if (value > 255) {\n value = 0;\n threshold = 30;\n }\n setShakeThreshold(threshold);\n}\n\n"
+ ],
+ "alt": "50x50 black rect in center of canvas. turns white on mobile when device\nis being shaked",
"class": "p5",
"module": "Events",
"submodule": "Acceleration"
},
{
"file": "src/events/acceleration.js",
- "line": 372,
- "description": "The deviceMoved() function is called when the device is moved by more than\nthe threshold value along X, Y or Z axis. The default threshold is set to\n0.5.
\n",
+ "line": 437,
+ "description": "The deviceMoved() function is called when the device is moved by more than\nthe threshold value along X, Y or Z axis. The default threshold is set to\n0.5.
\n",
"itemtype": "method",
"name": "deviceMoved",
"example": [
@@ -8080,12 +8968,12 @@ module.exports={
},
{
"file": "src/events/acceleration.js",
- "line": 403,
- "description": "The deviceTurned() function is called when the device rotates by\nmore than 90 degrees continuously.\n
\nThe axis that triggers the deviceTurned() method is stored in the turnAxis\nvariable. The deviceTurned() method can be locked to trigger on any axis:\nX, Y or Z by comparing the turnAxis variable to 'X', 'Y' or 'Z'.
\n",
+ "line": 468,
+ "description": "The deviceTurned() function is called when the device rotates by\nmore than 90 degrees continuously.\n
\nThe axis that triggers the deviceTurned() method is stored in the turnAxis\nvariable. The deviceTurned() method can be locked to trigger on any axis:\nX, Y or Z by comparing the turnAxis variable to 'X', 'Y' or 'Z'.
\n",
"itemtype": "method",
"name": "deviceTurned",
"example": [
- "\n\n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees\n// to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (value == 0){\n value = 255\n } else if (value == 255) {\n value = 0;\n }\n}\n\n\n\n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees in the\n// X-axis to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (turnAxis == 'X'){\n if (value == 0){\n value = 255\n } else if (value == 255) {\n value = 0;\n }\n }\n}\n\n"
+ "\n\n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees\n// to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (value === 0) {\n value = 255;\n } else if (value === 255) {\n value = 0;\n }\n}\n\n\n\n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees in the\n// X-axis to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (turnAxis === 'X') {\n if (value === 0) {\n value = 255;\n } else if (value === 255) {\n value = 0;\n }\n }\n}\n\n"
],
"alt": "50x50 black rect in center of canvas. turns white on mobile when device turns\n50x50 black rect in center of canvas. turns white on mobile when x-axis turns",
"class": "p5",
@@ -8094,8 +8982,8 @@ module.exports={
},
{
"file": "src/events/acceleration.js",
- "line": 462,
- "description": "The deviceShaken() function is called when the device total acceleration\nchanges of accelerationX and accelerationY values is more than\nthe threshold value. The default threshold is set to 30.
\n",
+ "line": 527,
+ "description": "The deviceShaken() function is called when the device total acceleration\nchanges of accelerationX and accelerationY values is more than\nthe threshold value. The default threshold is set to 30.
\n",
"itemtype": "method",
"name": "deviceShaken",
"example": [
@@ -8106,26 +8994,16 @@ module.exports={
"module": "Events",
"submodule": "Acceleration"
},
- {
- "file": "src/events/keyboard.js",
- "line": 12,
- "description": "Holds the key codes of currently pressed keys.
\n",
- "access": "private",
- "tagname": "",
- "class": "p5",
- "module": "Events",
- "submodule": "Keyboard"
- },
{
"file": "src/events/keyboard.js",
"line": 18,
- "description": "The boolean system variable keyIsPressed is true if any key is pressed\nand false if no keys are pressed.
\n",
+ "description": "The boolean system variable keyIsPressed is true if any key is pressed\nand false if no keys are pressed.
\n",
"itemtype": "property",
"name": "keyIsPressed",
"type": "Boolean",
"readonly": "",
"example": [
- "\n\n\nvar value = 0;\nfunction draw() {\n if (keyIsPressed === true) {\n fill(0);\n } else {\n fill(255);\n }\n rect(25, 25, 50, 50);\n}\n\n"
+ "\n\n\nfunction draw() {\n if (keyIsPressed === true) {\n fill(0);\n } else {\n fill(255);\n }\n rect(25, 25, 50, 50);\n}\n\n"
],
"alt": "50x50 white rect that turns black on keypress.",
"class": "p5",
@@ -8134,14 +9012,14 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 46,
- "description": "The system variable key always contains the value of the most recent\nkey on the keyboard that was typed. To get the proper capitalization, it\nis best to use it within keyTyped(). For non-ASCII keys, use the keyCode\nvariable.
\n",
+ "line": 45,
+ "description": "The system variable key always contains the value of the most recent\nkey on the keyboard that was typed. To get the proper capitalization, it\nis best to use it within keyTyped(). For non-ASCII keys, use the keyCode\nvariable.
\n",
"itemtype": "property",
"name": "key",
"type": "String",
"readonly": "",
"example": [
- "\n\n// Click any key to display it!\n// (Not Guaranteed to be Case Sensitive)\nfunction setup() {\n fill(245, 123, 158);\n textSize(50);\n}\n\nfunction draw() {\n background(200);\n text(key, 33,65); // Display last key pressed.\n}\n "
+ "\n\n// Click any key to display it!\n// (Not Guaranteed to be Case Sensitive)\nfunction setup() {\n fill(245, 123, 158);\n textSize(50);\n}\n\nfunction draw() {\n background(200);\n text(key, 33, 65); // Display last key pressed.\n}\n"
],
"alt": "canvas displays any key value that is pressed in pink font.",
"class": "p5",
@@ -8150,14 +9028,14 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 75,
+ "line": 74,
"description": "The variable keyCode is used to detect special keys such as BACKSPACE,\nDELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL, OPTION, ALT, UP_ARROW,\nDOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\nYou can also check for custom keys by looking up the keyCode of any key\non a site like this: keycode.info.
\n",
"itemtype": "property",
"name": "keyCode",
- "type": "Number",
+ "type": "Integer",
"readonly": "",
"example": [
- "\n\nvar fillVal = 126;\nfunction draw() {\n fill(fillVal);\n rect(25, 25, 50, 50);\n}\n\nfunction keyPressed() {\n if (keyCode == UP_ARROW) {\n fillVal = 255;\n } else if (keyCode == DOWN_ARROW) {\n fillVal = 0;\n }\n return false; // prevent default\n}\n"
+ "\n\nvar fillVal = 126;\nfunction draw() {\n fill(fillVal);\n rect(25, 25, 50, 50);\n}\n\nfunction keyPressed() {\n if (keyCode === UP_ARROW) {\n fillVal = 255;\n } else if (keyCode === DOWN_ARROW) {\n fillVal = 0;\n }\n return false; // prevent default\n}\n"
],
"alt": "Grey rect center. turns white when up arrow pressed and black when down",
"class": "p5",
@@ -8166,12 +9044,12 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 108,
- "description": "The keyPressed() function is called once every time a key is pressed. The\nkeyCode for the key that was pressed is stored in the keyCode variable.\n
\nFor non-ASCII keys, use the keyCode variable. You can check if the keyCode\nequals BACKSPACE, DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL,\nOPTION, ALT, UP_ARROW, DOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\n
\nFor ASCII keys that was pressed is stored in the key variable. However, it\ndoes not distinguish between uppercase and lowercase. For this reason, it\nis recommended to use keyTyped() to read the key variable, in which the\ncase of the variable will be distinguished.\n
\nBecause of how operating systems handle key repeats, holding down a key\nmay cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.
\nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 107,
+ "description": "The keyPressed() function is called once every time a key is pressed. The\nkeyCode for the key that was pressed is stored in the keyCode variable.\n
\nFor non-ASCII keys, use the keyCode variable. You can check if the keyCode\nequals BACKSPACE, DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL,\nOPTION, ALT, UP_ARROW, DOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\n
\nFor ASCII keys that was pressed is stored in the key variable. However, it\ndoes not distinguish between uppercase and lowercase. For this reason, it\nis recommended to use keyTyped() to read the key variable, in which the\ncase of the variable will be distinguished.\n
\nBecause of how operating systems handle key repeats, holding down a key\nmay cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.
\nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "keyPressed",
"example": [
- "\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (keyCode === LEFT_ARROW) {\n value = 255;\n } else if (keyCode === RIGHT_ARROW) {\n value = 0;\n }\n}\n\n\n\n\nfunction keyPressed(){\n // Do something\n return false; // prevent any default behaviour\n}\n\n"
+ "\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (keyCode === LEFT_ARROW) {\n value = 255;\n } else if (keyCode === RIGHT_ARROW) {\n value = 0;\n }\n}\n\n\n\n\nfunction keyPressed() {\n // Do something\n return false; // prevent any default behaviour\n}\n\n"
],
"alt": "black rect center. turns white when key pressed and black when released\nblack rect center. turns white when left arrow pressed and black when right.",
"class": "p5",
@@ -8180,8 +9058,8 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 198,
- "description": "The keyReleased() function is called once every time a key is released.\nSee key and keyCode for more information.
\nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 194,
+ "description": "The keyReleased() function is called once every time a key is released.\nSee key and keyCode for more information.
\nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "keyReleased",
"example": [
@@ -8194,8 +9072,8 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 254,
- "description": "The keyTyped() function is called once every time a key is pressed, but\naction keys such as Ctrl, Shift, and Alt are ignored. The most recent\nkey pressed will be stored in the key variable.\n
\nBecause of how operating systems handle key repeats, holding down a key\nwill cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.
\nBrowsers may have different default behaviors attached to various key\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
+ "line": 246,
+ "description": "The keyTyped() function is called once every time a key is pressed, but\naction keys such as Ctrl, Shift, and Alt are ignored. The most recent\nkey pressed will be stored in the key variable.\n
\nBecause of how operating systems handle key repeats, holding down a key\nwill cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.
\nBrowsers may have different default behaviors attached to various key\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
"itemtype": "method",
"name": "keyTyped",
"example": [
@@ -8208,7 +9086,7 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 307,
+ "line": 300,
"description": "The onblur function is called when the user is no longer focused\non the p5 element. Because the keyup events will not fire if the user is\nnot focused on the element we must assume all keys currently down have\nbeen released.
\n",
"class": "p5",
"module": "Events",
@@ -8216,8 +9094,8 @@ module.exports={
},
{
"file": "src/events/keyboard.js",
- "line": 317,
- "description": "The keyIsDown() function checks if the key is currently down, i.e. pressed.\nIt can be used if you have an object that moves, and you want several keys\nto be able to affect its behaviour simultaneously, such as moving a\nsprite diagonally. You can put in any number representing the keyCode of\nthe key, or use any of the variable keyCode names listed\nhere.
\n",
+ "line": 310,
+ "description": "The keyIsDown() function checks if the key is currently down, i.e. pressed.\nIt can be used if you have an object that moves, and you want several keys\nto be able to affect its behaviour simultaneously, such as moving a\nsprite diagonally. You can put in any number representing the keyCode of\nthe key, or use any of the variable keyCode names listed\nhere.
\n",
"itemtype": "method",
"name": "keyIsDown",
"params": [
@@ -8232,26 +9110,16 @@ module.exports={
"type": "Boolean"
},
"example": [
- "\n\nvar x = 100;\nvar y = 100;\n\nfunction setup() {\n createCanvas(512, 512);\n}\n\nfunction draw() {\n if (keyIsDown(LEFT_ARROW))\n x-=5;\n\n if (keyIsDown(RIGHT_ARROW))\n x+=5;\n\n if (keyIsDown(UP_ARROW))\n y-=5;\n\n if (keyIsDown(DOWN_ARROW))\n y+=5;\n\n clear();\n fill(255, 0, 0);\n ellipse(x, y, 50, 50);\n}\n"
+ "\n\nvar x = 100;\nvar y = 100;\n\nfunction setup() {\n createCanvas(512, 512);\n}\n\nfunction draw() {\n if (keyIsDown(LEFT_ARROW)) {\n x -= 5;\n }\n\n if (keyIsDown(RIGHT_ARROW)) {\n x += 5;\n }\n\n if (keyIsDown(UP_ARROW)) {\n y -= 5;\n }\n\n if (keyIsDown(DOWN_ARROW)) {\n y += 5;\n }\n\n clear();\n fill(255, 0, 0);\n ellipse(x, y, 50, 50);\n}\n\n\n\nvar diameter = 50;\n\nfunction setup() {\n createCanvas(512, 512);\n}\n\nfunction draw() {\n // 107 and 187 are keyCodes for \"+\"\n if (keyIsDown(107) || keyIsDown(187)) {\n diameter += 1;\n }\n\n // 109 and 189 are keyCodes for \"-\"\n if (keyIsDown(109) || keyIsDown(189)) {\n diameter -= 1;\n }\n\n clear();\n fill(255, 0, 0);\n ellipse(50, 50, diameter, diameter);\n}\n"
],
- "alt": "50x50 red ellipse moves left, right, up and down with arrow presses.",
- "class": "p5",
- "module": "Events",
- "submodule": "Keyboard"
- },
- {
- "file": "src/events/keyboard.js",
- "line": 364,
- "description": "The checkDownKeys function returns a boolean true if any keys pressed\nand a false if no keys are currently pressed.
\nHelps avoid instances where a multiple keys are pressed simultaneously and\nreleasing a single key will then switch the\nkeyIsPressed property to true.
\n",
- "access": "private",
- "tagname": "",
+ "alt": "50x50 red ellipse moves left, right, up and down with arrow presses.\n50x50 red ellipse gets bigger or smaller when + or - are pressed.",
"class": "p5",
"module": "Events",
"submodule": "Keyboard"
},
{
"file": "src/events/mouse.js",
- "line": 23,
+ "line": 22,
"description": "The system variable mouseX always contains the current horizontal\nposition of the mouse, relative to (0, 0) of the canvas. If touch is\nused instead of mouse input, mouseX will hold the x value of the most\nrecent touch point.
\n",
"itemtype": "property",
"name": "mouseX",
@@ -8267,7 +9135,7 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 49,
+ "line": 48,
"description": "The system variable mouseY always contains the current vertical position\nof the mouse, relative to (0, 0) of the canvas. If touch is\nused instead of mouse input, mouseY will hold the y value of the most\nrecent touch point.
\n",
"itemtype": "property",
"name": "mouseY",
@@ -8283,14 +9151,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 75,
- "description": "The system variable pmouseX always contains the horizontal position of\nthe mouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas.
\n",
+ "line": 74,
+ "description": "The system variable pmouseX always contains the horizontal position of\nthe mouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas. Note: pmouseX will be reset to the current mouseX\nvalue at the start of each touch event.
\n",
"itemtype": "property",
"name": "pmouseX",
"type": "Number",
"readonly": "",
"example": [
- "\n\n\n// Move the mouse across the canvas to leave a trail\nfunction setup() {\n //slow down the frameRate to make it more visible\n frameRate(10);\n}\n\nfunction draw() {\n background(244, 248, 252);\n line(mouseX, mouseY, pmouseX, pmouseY);\n print(pmouseX + \" -> \" + mouseX);\n}\n\n\n"
+ "\n\n\n// Move the mouse across the canvas to leave a trail\nfunction setup() {\n //slow down the frameRate to make it more visible\n frameRate(10);\n}\n\nfunction draw() {\n background(244, 248, 252);\n line(mouseX, mouseY, pmouseX, pmouseY);\n print(pmouseX + ' -> ' + mouseX);\n}\n\n"
],
"alt": "line trail is created from cursor movements. faster movement make longer line.",
"class": "p5",
@@ -8299,14 +9167,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 107,
- "description": "The system variable pmouseY always contains the vertical position of the\nmouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas.
\n",
+ "line": 106,
+ "description": "The system variable pmouseY always contains the vertical position of the\nmouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas. Note: pmouseY will be reset to the current mouseY\nvalue at the start of each touch event.
\n",
"itemtype": "property",
"name": "pmouseY",
"type": "Number",
"readonly": "",
"example": [
- "\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n //draw a square only if the mouse is not moving\n if(mouseY == pmouseY && mouseX == pmouseX)\n rect(20,20,60,60);\n\n print(pmouseY + \" -> \" + mouseY);\n}\n\n\n"
+ "\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n //draw a square only if the mouse is not moving\n if (mouseY === pmouseY && mouseX === pmouseX) {\n rect(20, 20, 60, 60);\n }\n\n print(pmouseY + ' -> ' + mouseY);\n}\n\n"
],
"alt": "60x60 black rect center, fuschia background. rect flickers on mouse movement",
"class": "p5",
@@ -8322,7 +9190,7 @@ module.exports={
"type": "Number",
"readonly": "",
"example": [
- "\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the horizontal mouse position\n //relative to the window\n myCanvas.position(winMouseX+1, windowHeight/2);\n\n //the y of the square is relative to the canvas\n rect(20,mouseY,60,60);\n}\n\n\n"
+ "\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the horizontal mouse position\n //rela tive to the window\n myCanvas.position(winMouseX + 1, windowHeight / 2);\n\n //the y of the square is relative to the canvas\n rect(20, mouseY, 60, 60);\n}\n\n"
],
"alt": "60x60 black rect y moves with mouse y and fuschia canvas moves with mouse x",
"class": "p5",
@@ -8331,14 +9199,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 175,
+ "line": 174,
"description": "The system variable winMouseY always contains the current vertical\nposition of the mouse, relative to (0, 0) of the window.
\n",
"itemtype": "property",
"name": "winMouseY",
"type": "Number",
"readonly": "",
"example": [
- "\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the vertical mouse position\n //relative to the window\n myCanvas.position(windowWidth/2, winMouseY+1);\n\n //the x of the square is relative to the canvas\n rect(mouseX,20,60,60);\n}\n\n\n"
+ "\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the vertical mouse position\n //rel ative to the window\n myCanvas.position(windowWidth / 2, winMouseY + 1);\n\n //the x of the square is relative to the canvas\n rect(mouseX, 20, 60, 60);\n}\n\n"
],
"alt": "60x60 black rect x moves with mouse x and fuschia canvas y moves with mouse y",
"class": "p5",
@@ -8347,14 +9215,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 213,
- "description": "The system variable pwinMouseX always contains the horizontal position\nof the mouse in the frame previous to the current frame, relative to\n(0, 0) of the window.
\n",
+ "line": 211,
+ "description": "The system variable pwinMouseX always contains the horizontal position\nof the mouse in the frame previous to the current frame, relative to\n(0, 0) of the window. Note: pwinMouseX will be reset to the current winMouseX\nvalue at the start of each touch event.
\n",
"itemtype": "property",
"name": "pwinMouseX",
"type": "Number",
"readonly": "",
"example": [
- "\n\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n }\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current x position is the horizontal mouse speed\n var speed = abs(winMouseX-pwinMouseX);\n //change the size of the circle\n //according to the horizontal speed\n ellipse(50, 50, 10+speed*5, 10+speed*5);\n //move the canvas to the mouse position\n myCanvas.position( winMouseX+1, winMouseY+1);\n}\n\n\n"
+ "\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n}\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current x position is the horizontal mouse speed\n var speed = abs(winMouseX - pwinMouseX);\n //change the size of the circle\n //according to the horizontal speed\n ellipse(50, 50, 10 + speed * 5, 10 + speed * 5);\n //move the canvas to the mouse position\n myCanvas.position(winMouseX + 1, winMouseY + 1);\n}\n\n"
],
"alt": "fuschia ellipse moves with mouse x and y. Grows and shrinks with mouse speed",
"class": "p5",
@@ -8363,14 +9231,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 255,
- "description": "The system variable pwinMouseY always contains the vertical position of\nthe mouse in the frame previous to the current frame, relative to (0, 0)\nof the window.
\n",
+ "line": 252,
+ "description": "The system variable pwinMouseY always contains the vertical position of\nthe mouse in the frame previous to the current frame, relative to (0, 0)\nof the window. Note: pwinMouseY will be reset to the current winMouseY\nvalue at the start of each touch event.
\n",
"itemtype": "property",
"name": "pwinMouseY",
"type": "Number",
"readonly": "",
"example": [
- "\n\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n }\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current y position is the vertical mouse speed\n var speed = abs(winMouseY-pwinMouseY);\n //change the size of the circle\n //according to the vertical speed\n ellipse(50, 50, 10+speed*5, 10+speed*5);\n //move the canvas to the mouse position\n myCanvas.position( winMouseX+1, winMouseY+1);\n}\n\n\n"
+ "\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n}\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current y position is the vertical mouse speed\n var speed = abs(winMouseY - pwinMouseY);\n //change the size of the circle\n //according to the vertical speed\n ellipse(50, 50, 10 + speed * 5, 10 + speed * 5);\n //move the canvas to the mouse position\n myCanvas.position(winMouseX + 1, winMouseY + 1);\n}\n\n"
],
"alt": "fuschia ellipse moves with mouse x and y. Grows and shrinks with mouse speed",
"class": "p5",
@@ -8379,14 +9247,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 298,
+ "line": 294,
"description": "Processing automatically tracks if the mouse button is pressed and which\nbutton is pressed. The value of the system variable mouseButton is either\nLEFT, RIGHT, or CENTER depending on which button was pressed last.\nWarning: different browsers may track mouseButton differently.
\n",
"itemtype": "property",
"name": "mouseButton",
"type": "Constant",
"readonly": "",
"example": [
- "\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed) {\n if (mouseButton == LEFT)\n ellipse(50, 50, 50, 50);\n if (mouseButton == RIGHT)\n rect(25, 25, 50, 50);\n if (mouseButton == CENTER)\n triangle(23, 75, 50, 20, 78, 75);\n }\n\n print(mouseButton);\n}\n\n"
+ "\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed) {\n if (mouseButton === LEFT) {\n ellipse(50, 50, 50, 50);\n }\n if (mouseButton === RIGHT) {\n rect(25, 25, 50, 50);\n }\n if (mouseButton === CENTER) {\n triangle(23, 75, 50, 20, 78, 75);\n }\n }\n\n print(mouseButton);\n}\n\n"
],
"alt": "50x50 black ellipse appears on center of fuschia canvas on mouse click/press.",
"class": "p5",
@@ -8395,14 +9263,14 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 334,
+ "line": 333,
"description": "The boolean system variable mouseIsPressed is true if the mouse is pressed\nand false if not.
\n",
"itemtype": "property",
"name": "mouseIsPressed",
"type": "Boolean",
"readonly": "",
"example": [
- "\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed)\n ellipse(50, 50, 50, 50);\n else\n rect(25, 25, 50, 50);\n\n print(mouseIsPressed);\n}\n\n"
+ "\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed) {\n ellipse(50, 50, 50, 50);\n } else {\n rect(25, 25, 50, 50);\n }\n\n print(mouseIsPressed);\n}\n\n"
],
"alt": "black 50x50 rect becomes ellipse with mouse click/press. fuschia background.",
"class": "p5",
@@ -8411,8 +9279,8 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 416,
- "description": "The mouseMoved() function is called every time the mouse moves and a mouse\nbutton is not pressed.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 424,
+ "description": "The mouseMoved() function is called every time the mouse moves and a mouse\nbutton is not pressed.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "mouseMoved",
"example": [
@@ -8425,8 +9293,8 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 460,
- "description": "The mouseDragged() function is called once every time the mouse moves and\na mouse button is pressed. If no mouseDragged() function is defined, the\ntouchMoved() function will be called instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 468,
+ "description": "The mouseDragged() function is called once every time the mouse moves and\na mouse button is pressed. If no mouseDragged() function is defined, the\ntouchMoved() function will be called instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "mouseDragged",
"example": [
@@ -8439,12 +9307,12 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 531,
- "description": "The mousePressed() function is called once after every time a mouse button\nis pressed. The mouseButton variable (see the related reference entry)\ncan be used to determine which button has been pressed. If no\nmousePressed() function is defined, the touchStarted() function will be\ncalled instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 538,
+ "description": "The mousePressed() function is called once after every time a mouse button\nis pressed. The mouseButton variable (see the related reference entry)\ncan be used to determine which button has been pressed. If no\nmousePressed() function is defined, the touchStarted() function will be\ncalled instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "mousePressed",
"example": [
- "\n\n\n// Click within the image to change\n// the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mousePressed() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mousePressed() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
+ "\n\n\n// Click within the image to change\n// the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mousePressed() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mousePressed() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
],
"alt": "black 50x50 rect turns white with mouse click/press.\nno image displayed",
"class": "p5",
@@ -8453,12 +9321,12 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 597,
- "description": "The mouseReleased() function is called every time a mouse button is\nreleased. If no mouseReleased() function is defined, the touchEnded()\nfunction will be called instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 604,
+ "description": "The mouseReleased() function is called every time a mouse button is\nreleased. If no mouseReleased() function is defined, the touchEnded()\nfunction will be called instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "mouseReleased",
"example": [
- "\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseReleased() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseReleased() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
+ "\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseReleased() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseReleased() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
],
"alt": "black 50x50 rect turns white with mouse click/press.\nno image displayed",
"class": "p5",
@@ -8467,12 +9335,12 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 664,
- "description": "The mouseClicked() function is called once after a mouse button has been\npressed and then released.
\nBrowsers handle clicks differently, so this function is only guaranteed to be\nrun when the left mouse button is clicked. To handle other mouse buttons\nbeing pressed or released, see mousePressed() or mouseReleased().
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
+ "line": 671,
+ "description": "The mouseClicked() function is called once after a mouse button has been\npressed and then released.
\nBrowsers handle clicks differently, so this function is only guaranteed to be\nrun when the left mouse button is clicked. To handle other mouse buttons\nbeing pressed or released, see mousePressed() or mouseReleased().
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",
"itemtype": "method",
"name": "mouseClicked",
"example": [
- "\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction mouseClicked() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
+ "\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction mouseClicked() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
],
"alt": "black 50x50 rect turns white with mouse click/press.\nno image displayed",
"class": "p5",
@@ -8481,12 +9349,12 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 723,
- "description": "The doubleClicked() function is executed every time a event\nlistener has detected a dblclick event which is a part of the\nDOM L3 specification. The doubleClicked event is fired when a\npointing device button (usually a mouse's primary button)\nis clicked twice on a single element. For more info on the\ndblclick event refer to mozilla's documentation here:\nhttps://developer.mozilla.org/en-US/docs/Web/Events/dblclick
\n",
+ "line": 730,
+ "description": "The doubleClicked() function is executed every time a event\nlistener has detected a dblclick event which is a part of the\nDOM L3 specification. The doubleClicked event is fired when a\npointing device button (usually a mouse's primary button)\nis clicked twice on a single element. For more info on the\ndblclick event refer to mozilla's documentation here:\nhttps://developer.mozilla.org/en-US/docs/Web/Events/dblclick
\n",
"itemtype": "method",
"name": "doubleClicked",
"example": [
- "\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been double clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction doubleClicked() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction doubleClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
+ "\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been double clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction doubleClicked() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction doubleClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
],
"alt": "black 50x50 rect turns white with mouse doubleClick/press.\nno image displayed",
"class": "p5",
@@ -8495,8 +9363,8 @@ module.exports={
},
{
"file": "src/events/mouse.js",
- "line": 781,
- "description": "The function mouseWheel() is executed every time a vertical mouse wheel\nevent is detected either triggered by an actual mouse wheel or by a\ntouchpad.
\nThe event.delta property returns the amount the mouse wheel\nhave scrolled. The values can be positive or negative depending on the\nscroll direction (on OS X with "natural" scrolling enabled, the signs\nare inverted).
\nBrowsers may have different default behaviors attached to various\nmouse events. To prevent any default behavior for this event, add\n"return false" to the end of the method.
\nDue to the current support of the "wheel" event on Safari, the function\nmay only work as expected if "return false" is included while using Safari.
\n",
+ "line": 804,
+ "description": "The function mouseWheel() is executed every time a vertical mouse wheel\nevent is detected either triggered by an actual mouse wheel or by a\ntouchpad.
\nThe event.delta property returns the amount the mouse wheel\nhave scrolled. The values can be positive or negative depending on the\nscroll direction (on OS X with "natural" scrolling enabled, the signs\nare inverted).
\nBrowsers may have different default behaviors attached to various\nmouse events. To prevent any default behavior for this event, add\n"return false" to the end of the method.
\nDue to the current support of the "wheel" event on Safari, the function\nmay only work as expected if "return false" is included while using Safari.
\n",
"itemtype": "method",
"name": "mouseWheel",
"example": [
@@ -8515,18 +9383,22 @@ module.exports={
"name": "touches",
"type": "Object[]",
"readonly": "",
+ "example": [
+ "\n\n\n// On a touchscreen device, touch\n// the canvas using one or more fingers\n// at the same time\nfunction draw() {\n clear();\n var display = touches.length + ' touches';\n text(display, 5, 10);\n}\n\n"
+ ],
+ "alt": "Number of touches currently registered are displayed on the canvas",
"class": "p5",
"module": "Events",
"submodule": "Touch"
},
{
"file": "src/events/touch.js",
- "line": 53,
- "description": "The touchStarted() function is called once after every time a touch is\nregistered. If no touchStarted() function is defined, the mousePressed()\nfunction will be called instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
+ "line": 74,
+ "description": "The touchStarted() function is called once after every time a touch is\nregistered. If no touchStarted() function is defined, the mousePressed()\nfunction will be called instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
"itemtype": "method",
"name": "touchStarted",
"example": [
- "\n\n\n// Touch within the image to change\n// the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchStarted() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchStarted() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
+ "\n\n\n// Touch within the image to change\n// the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchStarted() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchStarted() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
],
"alt": "50x50 black rect turns white with touch event.\nno image displayed",
"class": "p5",
@@ -8535,8 +9407,8 @@ module.exports={
},
{
"file": "src/events/touch.js",
- "line": 116,
- "description": "The touchMoved() function is called every time a touch move is registered.\nIf no touchMoved() function is defined, the mouseDragged() function will\nbe called instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
+ "line": 138,
+ "description": "The touchMoved() function is called every time a touch move is registered.\nIf no touchMoved() function is defined, the mouseDragged() function will\nbe called instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
"itemtype": "method",
"name": "touchMoved",
"example": [
@@ -8549,12 +9421,12 @@ module.exports={
},
{
"file": "src/events/touch.js",
- "line": 178,
- "description": "The touchEnded() function is called every time a touch ends. If no\ntouchEnded() function is defined, the mouseReleased() function will be\ncalled instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
+ "line": 200,
+ "description": "The touchEnded() function is called every time a touch ends. If no\ntouchEnded() function is defined, the mouseReleased() function will be\ncalled instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",
"itemtype": "method",
"name": "touchEnded",
"example": [
- "\n\n\n// Release touch within the image to\n// change the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchEnded() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchEnded() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
+ "\n\n\n// Release touch within the image to\n// change the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchEnded() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchEnded() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n"
],
"alt": "50x50 black rect turns white with touch.\nno image displayed",
"class": "p5",
@@ -8568,261 +9440,18 @@ module.exports={
"class": "p5",
"module": "Events"
},
- {
- "file": "src/image/filters.js",
- "line": 28,
- "description": "Returns the pixel buffer for a canvas
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "canvas",
- "description": "the canvas to get pixels from
\n",
- "type": "Canvas|ImageData"
- }
- ],
- "return": {
- "description": "a one-dimensional array containing\n the data in thc RGBA order, with integer\n values between 0 and 255",
- "type": "Uint8ClampedArray"
- },
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 51,
- "description": "Returns a 32 bit number containing ARGB data at ith pixel in the\n1D array containing pixels data.
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "data",
- "description": "array returned by _toPixels()
\n",
- "type": "Uint8ClampedArray"
- },
- {
- "name": "i",
- "description": "index of a 1D Image Array
\n",
- "type": "Integer"
- }
- ],
- "return": {
- "description": "32 bit integer value representing\n ARGB value.",
- "type": "Integer"
- },
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 70,
- "description": "Modifies pixels RGBA values to values contained in the data object.
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "pixels",
- "description": "array returned by _toPixels()
\n",
- "type": "Uint8ClampedArray"
- },
- {
- "name": "data",
- "description": "source 1D array where each value\n represents ARGB values
\n",
- "type": "Int32Array"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 90,
- "description": "Returns the ImageData object for a canvas\nhttps://developer.mozilla.org/en-US/docs/Web/API/ImageData
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "canvas",
- "description": "canvas to get image data from
\n",
- "type": "Canvas|ImageData"
- }
- ],
- "return": {
- "description": "Holder of pixel data (and width and\n height) for a canvas",
- "type": "ImageData"
- },
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 113,
- "description": "Returns a blank ImageData object.
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "width",
- "description": "",
- "type": "Integer"
- },
- {
- "name": "height",
- "description": "",
- "type": "Integer"
- }
- ],
- "return": {
- "description": "",
- "type": "ImageData"
- },
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 129,
- "description": "Applys a filter function to a canvas.
\nThe difference between this and the actual filter functions defined below\nis that the filter functions generally modify the pixel buffer but do\nnot actually put that data back to the canvas (where it would actually\nupdate what is visible). By contrast this method does make the changes\nactually visible in the canvas.
\nThe apply method is the method that callers of this module would generally\nuse. It has been separated from the actual filters to support an advanced\nuse case of creating a filter chain that executes without actually updating\nthe canvas in between everystep.
\n",
- "params": [
- {
- "name": "canvas",
- "description": "[description]
\n",
- "type": "HTMLCanvasElement"
- },
- {
- "name": "func",
- "description": "[description]
\n",
- "type": "Function(ImageData,Object)"
- },
- {
- "name": "filterParam",
- "description": "[description]
\n",
- "type": "Object"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 167,
- "description": "Converts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.
\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- },
- {
- "name": "level",
- "description": "",
- "type": "Float"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 202,
- "description": "Converts any colors in the image to grayscale equivalents.\nNo parameter is used.
\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 224,
- "description": "Sets the alpha channel to entirely opaque. No parameter is used.
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 239,
- "description": "Sets each pixel to its inverse value. No parameter is used.
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 255,
- "description": "Limits each channel of the image to the number of colors specified as\nthe parameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.
\nAdapted from java based processing implementation
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- },
- {
- "name": "level",
- "description": "",
- "type": "Integer"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 286,
- "description": "reduces the bright areas in an image
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
- {
- "file": "src/image/filters.js",
- "line": 367,
- "description": "increases the bright areas in an image
\n",
- "params": [
- {
- "name": "canvas",
- "description": "",
- "type": "Canvas"
- }
- ],
- "class": "p5",
- "module": "Events"
- },
{
"file": "src/image/image.js",
"line": 8,
- "description": "This module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.
\n",
+ "description": "This module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.
\n",
"class": "p5",
"module": "Image",
"submodule": "Image"
},
{
"file": "src/image/image.js",
- "line": 24,
- "description": "Creates a new p5.Image (the datatype for storing images). This provides a\nfresh buffer of pixels to play with. Set the size of the buffer with the\nwidth and height parameters.\n
\n.pixels gives access to an array containing the values for all the pixels\nin the display window.\nThese values are numbers. This array is the size (including an appropriate\nfactor for the pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. See .pixels for\nmore info. It may also be simpler to use set() or get().\n
\nBefore accessing the pixels of an image, the data must loaded with the\nloadPixels() function. After the array data has been modified, the\nupdatePixels() function must be run to update the changes.
\n",
+ "line": 22,
+ "description": "Creates a new p5.Image (the datatype for storing images). This provides a\nfresh buffer of pixels to play with. Set the size of the buffer with the\nwidth and height parameters.\n
\n.pixels gives access to an array containing the values for all the pixels\nin the display window.\nThese values are numbers. This array is the size (including an appropriate\nfactor for the pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. See .pixels for\nmore info. It may also be simpler to use set() or get().\n
\nBefore accessing the pixels of an image, the data must loaded with the\nloadPixels() function. After the array data has been modified, the\nupdatePixels() function must be run to update the changes.
\n",
"itemtype": "method",
"name": "createImage",
"params": [
@@ -8838,11 +9467,11 @@ module.exports={
}
],
"return": {
- "description": "the p5.Image object",
+ "description": "the p5.Image object",
"type": "p5.Image"
},
"example": [
- "\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n\n\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, i % img.width * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n\n\n\n\nvar pink = color(255, 102, 204);\nimg = createImage(66, 66);\nimg.loadPixels();\nvar d = pixelDensity();\nvar halfImage = 4 * (width * d) * (height/2 * d);\nfor (var i = 0; i < halfImage; i+=4) {\n img.pixels[i] = red(pink);\n img.pixels[i+1] = green(pink);\n img.pixels[i+2] = blue(pink);\n img.pixels[i+3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n"
+ "\n\n\nvar img = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < img.width; i++) {\n for (var j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n\n\n\n\nvar img = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < img.width; i++) {\n for (var j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, (i % img.width) * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n\n\n\n\nvar pink = color(255, 102, 204);\nvar img = createImage(66, 66);\nimg.loadPixels();\nvar d = pixelDensity();\nvar halfImage = 4 * (img.width * d) * (img.height / 2 * d);\nfor (var i = 0; i < halfImage; i += 4) {\n img.pixels[i] = red(pink);\n img.pixels[i + 1] = green(pink);\n img.pixels[i + 2] = blue(pink);\n img.pixels[i + 3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n"
],
"alt": "66x66 dark turquoise rect in center of canvas.\n2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas\nno image displayed",
"class": "p5",
@@ -8851,16 +9480,20 @@ module.exports={
},
{
"file": "src/image/image.js",
- "line": 103,
- "description": "Save the current canvas as an image. In Safari, this will open the\nimage in the window and the user must provide their own\nfilename on save-as. Other browsers will either save the\nfile immediately, or prompt the user with a dialogue window.
\n",
+ "line": 102,
+ "description": "Save the current canvas as an image. The browser will either save the\nfile immediately, or prompt the user with a dialogue window.
\n",
"itemtype": "method",
"name": "saveCanvas",
+ "example": [
+ "\n \n function setup() {\n var c = createCanvas(100, 100);\n background(255, 0, 0);\n saveCanvas(c, 'myCanvas', 'jpg');\n }\n \n \n // note that this example has the same result as above\n // if no canvas is specified, defaults to main canvas\n function setup() {\n var c = createCanvas(100, 100);\n background(255, 0, 0);\n saveCanvas('myCanvas', 'jpg');\n\n // all of the following are valid\n saveCanvas(c, 'myCanvas', 'jpg');\n saveCanvas(c, 'myCanvas.jpg');\n saveCanvas(c, 'myCanvas');\n saveCanvas(c);\n saveCanvas('myCanvas', 'png');\n saveCanvas('myCanvas');\n saveCanvas();\n }\n "
+ ],
+ "alt": "no image displayed\n no image displayed\n no image displayed",
"class": "p5",
"module": "Image",
"submodule": "Image",
"overloads": [
{
- "line": 103,
+ "line": 102,
"params": [
{
"name": "selectedCanvas",
@@ -8882,7 +9515,7 @@ module.exports={
]
},
{
- "line": 115,
+ "line": 144,
"params": [
{
"name": "filename",
@@ -8902,8 +9535,8 @@ module.exports={
},
{
"file": "src/image/image.js",
- "line": 233,
- "description": "Capture a sequence of frames that can be used to create a movie.\nAccepts a callback. For example, you may wish to send the frames\nto a server where they can be stored or converted into a movie.\nIf no callback is provided, the browser will pop up save dialogues in an\nattempt to download all of the images that have just been created. With the\ncallback provided the image data isn't saved by default but instead passed\nas an argument to the callback function as an array of objects, with the\nsize of array equal to the total number of frames.
\nNote that saveFrames() will only save the first 15 frames of an animation.\nTo export longer animations, you might look into a library like\nccapture.js.
\n",
+ "line": 195,
+ "description": "Capture a sequence of frames that can be used to create a movie.\nAccepts a callback. For example, you may wish to send the frames\nto a server where they can be stored or converted into a movie.\nIf no callback is provided, the browser will pop up save dialogues in an\nattempt to download all of the images that have just been created. With the\ncallback provided the image data isn't saved by default but instead passed\nas an argument to the callback function as an array of objects, with the\nsize of array equal to the total number of frames.
\nNote that saveFrames() will only save the first 15 frames of an animation.\nTo export longer animations, you might look into a library like\nccapture.js.
\n",
"itemtype": "method",
"name": "saveFrames",
"params": [
@@ -8935,7 +9568,7 @@ module.exports={
}
],
"example": [
- "\n\nfunction draw() {\n background(mouseX);\n}\n\nfunction mousePressed() {\n saveFrames(\"out\", \"png\", 1, 25, function(data){\n print(data);\n });\n}\n"
+ "\n\n function draw() {\n background(mouseX);\n }\n\n function mousePressed() {\n saveFrames('out', 'png', 1, 25, function(data) {\n print(data);\n });\n }\n"
],
"alt": "canvas background goes from light to dark with mouse x.",
"class": "p5",
@@ -8945,7 +9578,7 @@ module.exports={
{
"file": "src/image/loading_displaying.js",
"line": 17,
- "description": "Loads an image from a path and creates a p5.Image from it.\n
\nThe image may not be immediately available for rendering\nIf you want to ensure that the image is ready before doing\nanything with it, place the loadImage() call in preload().\nYou may also supply a callback function to handle the image when it's ready.\n
\nThe path to the image should be relative to the HTML file\nthat links in your sketch. Loading an image from a URL or other\nremote location may be blocked due to your browser's built-in\nsecurity.
\n",
+ "description": "Loads an image from a path and creates a p5.Image from it.\n
\nThe image may not be immediately available for rendering\nIf you want to ensure that the image is ready before doing\nanything with it, place the loadImage() call in preload().\nYou may also supply a callback function to handle the image when it's ready.\n
\nThe path to the image should be relative to the HTML file\nthat links in your sketch. Loading an image from a URL or other\nremote location may be blocked due to your browser's built-in\nsecurity.
\n",
"itemtype": "method",
"name": "loadImage",
"params": [
@@ -8956,7 +9589,7 @@ module.exports={
},
{
"name": "successCallback",
- "description": "Function to be called once\n the image is loaded. Will be passed the\n p5.Image.
\n",
+ "description": "Function to be called once\n the image is loaded. Will be passed the\n p5.Image.
\n",
"type": "function(p5.Image)",
"optional": true
},
@@ -8968,43 +9601,17 @@ module.exports={
}
],
"return": {
- "description": "the p5.Image object",
+ "description": "the p5.Image object",
"type": "p5.Image"
},
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/laDefense.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n}\n\n\n\n\nfunction setup() {\n // here we use a callback to display the image after loading\n loadImage(\"assets/laDefense.jpg\", function(img) {\n image(img, 0, 0);\n });\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n}\n\n\n\n\nfunction setup() {\n // here we use a callback to display the image after loading\n loadImage('assets/laDefense.jpg', function(img) {\n image(img, 0, 0);\n });\n}\n\n"
],
"alt": "image of the underside of a white umbrella and grided ceililng above\nimage of the underside of a white umbrella and grided ceililng above",
"class": "p5",
"module": "Image",
"submodule": "Loading & Displaying"
},
- {
- "file": "src/image/loading_displaying.js",
- "line": 107,
- "description": "Validates clipping params. Per drawImage spec sWidth and sHight cannot be\nnegative or greater than image intrinsic width and height
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "sVal",
- "description": "",
- "type": "Number"
- },
- {
- "name": "iVal",
- "description": "",
- "type": "Number"
- }
- ],
- "return": {
- "description": "",
- "type": "Number"
- },
- "class": "p5",
- "module": "Image",
- "submodule": "Loading & Displaying"
- },
{
"file": "src/image/loading_displaying.js",
"line": 125,
@@ -9012,7 +9619,7 @@ module.exports={
"itemtype": "method",
"name": "image",
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/laDefense.jpg\");\n}\nfunction setup() {\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img's original width and height\n image(img, 0, 0);\n}\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/laDefense.jpg\");\n}\nfunction setup() {\n background(50);\n // Top-left corner of the img is at (10, 10)\n // Width and height are 50 x 50\n image(img, 10, 10, 50, 50);\n}\n\n\n\n\nfunction setup() {\n // Here, we use a callback to display the image after loading\n loadImage(\"assets/laDefense.jpg\", function(img) {\n image(img, 0, 0);\n });\n}\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/gradient.png\");\n}\nfunction setup() {\n // 1. Background image\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img's original width and height, 100 x 100\n image(img, 0, 0);\n // 2. Top right image\n // Top-left corner of destination rectangle is at (50, 0)\n // Destination rectangle width and height are 40 x 20\n // The next parameters are relative to the source image:\n // - Starting at position (50, 50) on the source image, capture a 50 x 50\n // subsection\n // - Draw this subsection to fill the dimensions of the destination rectangle\n image(img, 50, 0, 40, 20, 50, 50, 50, 50);\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img's original width and height\n image(img, 0, 0);\n}\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n background(50);\n // Top-left corner of the img is at (10, 10)\n // Width and height are 50 x 50\n image(img, 10, 10, 50, 50);\n}\n\n\n\n\nfunction setup() {\n // Here, we use a callback to display the image after loading\n loadImage('assets/laDefense.jpg', function(img) {\n image(img, 0, 0);\n });\n}\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/gradient.png');\n}\nfunction setup() {\n // 1. Background image\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img's original width and height, 100 x 100\n image(img, 0, 0);\n // 2. Top right image\n // Top-left corner of destination rectangle is at (50, 0)\n // Destination rectangle width and height are 40 x 20\n // The next parameters are relative to the source image:\n // - Starting at position (50, 50) on the source image, capture a 50 x 50\n // subsection\n // - Draw this subsection to fill the dimensions of the destination rectangle\n image(img, 50, 0, 40, 20, 50, 50, 50, 50);\n}\n\n"
],
"alt": "image of the underside of a white umbrella and gridded ceiling above\nimage of the underside of a white umbrella and gridded ceiling above",
"class": "p5",
@@ -9025,7 +9632,7 @@ module.exports={
{
"name": "img",
"description": "the image to display
\n",
- "type": "p5.Image|p5.Graphics"
+ "type": "p5.Image|p5.Element"
},
{
"name": "x",
@@ -9057,7 +9664,7 @@ module.exports={
{
"name": "img",
"description": "",
- "type": "p5.Image|p5.Graphics"
+ "type": "p5.Image|p5.Element"
},
{
"name": "dx",
@@ -9107,16 +9714,20 @@ module.exports={
},
{
"file": "src/image/loading_displaying.js",
- "line": 289,
- "description": "Sets the fill value for displaying images. Images can be tinted to\nspecified colors or made transparent by including an alpha value.\n
\nTo apply transparency to an image without affecting its color, use\nwhite as the tint color and specify an alpha value. For instance,\ntint(255, 128) will make an image 50% transparent (assuming the default\nalpha range of 0-255, which can be changed with colorMode()).\n
\nThe value for the gray parameter must be less than or equal to the current\nmaximum value as specified by colorMode(). The default maximum value is\n255.
\n",
+ "line": 296,
+ "description": "Sets the fill value for displaying images. Images can be tinted to\nspecified colors or made transparent by including an alpha value.\n
\nTo apply transparency to an image without affecting its color, use\nwhite as the tint color and specify an alpha value. For instance,\ntint(255, 128) will make an image 50% transparent (assuming the default\nalpha range of 0-255, which can be changed with colorMode()).\n
\nThe value for the gray parameter must be less than or equal to the current\nmaximum value as specified by colorMode(). The default maximum value is\n255.
\n",
"itemtype": "method",
"name": "tint",
+ "example": [
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n tint(0, 153, 204); // Tint blue\n image(img, 50, 0);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n tint(0, 153, 204, 126); // Tint blue and set transparency\n image(img, 50, 0);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n tint(255, 126); // Apply transparency without changing color\n image(img, 50, 0);\n}\n\n"
+ ],
+ "alt": "2 side by side images of umbrella and ceiling, one image with blue tint\nImages of umbrella and ceiling, one half of image with blue tint\n2 side by side images of umbrella and ceiling, one image translucent",
"class": "p5",
"module": "Image",
"submodule": "Loading & Displaying",
"overloads": [
{
- "line": 289,
+ "line": 296,
"params": [
{
"name": "v1",
@@ -9142,12 +9753,22 @@ module.exports={
]
},
{
- "line": 313,
+ "line": 369,
"params": [
{
"name": "value",
"description": "a color string
\n",
"type": "String"
+ }
+ ]
+ },
+ {
+ "line": 374,
+ "params": [
+ {
+ "name": "gray",
+ "description": "a gray value
\n",
+ "type": "Number"
},
{
"name": "alpha",
@@ -9158,7 +9779,7 @@ module.exports={
]
},
{
- "line": 319,
+ "line": 380,
"params": [
{
"name": "values",
@@ -9168,18 +9789,12 @@ module.exports={
]
},
{
- "line": 325,
+ "line": 386,
"params": [
{
"name": "color",
"description": "the tint color
\n",
"type": "p5.Color"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
}
]
}
@@ -9187,12 +9802,12 @@ module.exports={
},
{
"file": "src/image/loading_displaying.js",
- "line": 384,
+ "line": 396,
"description": "Removes the current fill value for displaying images and reverts to\ndisplaying images with their original hues.
\n",
"itemtype": "method",
"name": "noTint",
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n tint(0, 153, 204); // Tint blue\n image(img, 0, 0);\n noTint(); // Disable tint\n image(img, 50, 0);\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n tint(0, 153, 204); // Tint blue\n image(img, 0, 0);\n noTint(); // Disable tint\n image(img, 50, 0);\n}\n\n"
],
"alt": "2 side by side images of bricks, left image with blue tint",
"class": "p5",
@@ -9201,27 +9816,8 @@ module.exports={
},
{
"file": "src/image/loading_displaying.js",
- "line": 413,
- "description": "Apply the current tint color to the input image, return the resulting\ncanvas.
\n",
- "params": [
- {
- "name": "The",
- "description": "image to be tinted
\n",
- "type": "p5.Image"
- }
- ],
- "return": {
- "description": "The resulting tinted canvas",
- "type": "Canvas"
- },
- "class": "p5",
- "module": "Image",
- "submodule": "Loading & Displaying"
- },
- {
- "file": "src/image/loading_displaying.js",
- "line": 449,
- "description": "Set image mode. Modifies the location from which images are drawn by\nchanging the way in which parameters given to image() are interpreted.\nThe default mode is imageMode(CORNER), which interprets the second and\nthird parameters of image() as the upper-left corner of the image. If\ntwo additional parameters are specified, they are used to set the image's\nwidth and height.\n
\nimageMode(CORNERS) interprets the second and third parameters of image()\nas the location of one corner, and the fourth and fifth parameters as the\nopposite corner.\n
\nimageMode(CENTER) interprets the second and third parameters of image()\nas the image's center point. If two additional parameters are specified,\nthey are used to set the image's width and height.
\n",
+ "line": 462,
+ "description": "Set image mode. Modifies the location from which images are drawn by\nchanging the way in which parameters given to image() are interpreted.\nThe default mode is imageMode(CORNER), which interprets the second and\nthird parameters of image() as the upper-left corner of the image. If\ntwo additional parameters are specified, they are used to set the image's\nwidth and height.\n
\nimageMode(CORNERS) interprets the second and third parameters of image()\nas the location of one corner, and the fourth and fifth parameters as the\nopposite corner.\n
\nimageMode(CENTER) interprets the second and third parameters of image()\nas the image's center point. If two additional parameters are specified,\nthey are used to set the image's width and height.
\n",
"itemtype": "method",
"name": "imageMode",
"params": [
@@ -9232,7 +9828,7 @@ module.exports={
}
],
"example": [
- "\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n imageMode(CORNER);\n image(img, 10, 10, 50, 50);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n imageMode(CORNERS);\n image(img, 10, 10, 90, 40);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n imageMode(CENTER);\n image(img, 50, 50, 80, 80);\n}\n\n"
+ "\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n imageMode(CORNER);\n image(img, 10, 10, 50, 50);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n imageMode(CORNERS);\n image(img, 10, 10, 90, 40);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n imageMode(CENTER);\n image(img, 50, 50, 80, 80);\n}\n\n"
],
"alt": "small square image of bricks\nhorizontal rectangle image of bricks\nlarge square image of bricks",
"class": "p5",
@@ -9242,21 +9838,21 @@ module.exports={
{
"file": "src/image/p5.Image.js",
"line": 9,
- "description": "This module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.
\n",
+ "description": "This module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.
\n",
"class": "p5.Image",
"module": "Image",
"submodule": "Image"
},
{
"file": "src/image/p5.Image.js",
- "line": 45,
+ "line": 90,
"description": "Image width.
\n",
"itemtype": "property",
"name": "width",
"type": "Number",
"readonly": "",
"example": [
- "\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (var i=0; i < img.width; i++) {\n var c = img.get(i, img.height/2);\n stroke(c);\n line(i, height/2, i, height);\n }\n}\n"
+ "\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (var i = 0; i < img.width; i++) {\n var c = img.get(i, img.height / 2);\n stroke(c);\n line(i, height / 2, i, height);\n }\n}\n"
],
"alt": "rocky mountains in top and horizontal lines in corresponding colors in bottom.",
"class": "p5.Image",
@@ -9265,14 +9861,14 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 72,
+ "line": 117,
"description": "Image height.
\n",
"itemtype": "property",
"name": "height",
"type": "Number",
"readonly": "",
"example": [
- "\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (var i=0; i < img.height; i++) {\n var c = img.get(img.width/2, i);\n stroke(c);\n line(0, i, width/2, i);\n }\n}\n"
+ "\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (var i = 0; i < img.height; i++) {\n var c = img.get(img.width / 2, i);\n stroke(c);\n line(0, i, width / 2, i);\n }\n}\n"
],
"alt": "rocky mountains on right and vertical lines in corresponding colors on left.",
"class": "p5.Image",
@@ -9281,13 +9877,13 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 106,
- "description": "Array containing the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh denisty displays may have more pixels[] (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. With\npixelDensity = 2, there will be 160,000. The first four values\n(indices 0-3) in the array will be the R, G, B, A values of the pixel at\n(0, 0). The second four values (indices 4-7) will contain the R, G, B, A\nvalues of the pixel at (1, 0). More generally, to set values for a pixel\nat (x, y):
\nvar d = pixelDensity;\nfor (var i = 0; i < d; i++) {\n for (var j = 0; j < d; j++) {\n // loop over\n idx = 4 * ((y * d + j) * width * d + (x * d + i));\n pixels[idx] = r;\n pixels[idx+1] = g;\n pixels[idx+2] = b;\n pixels[idx+3] = a;\n }\n}\n
\n
\nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.
\n",
+ "line": 152,
+ "description": "Array containing the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh denisty displays may have more pixels (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. With\npixelDensity = 2, there will be 160,000. The first four values\n(indices 0-3) in the array will be the R, G, B, A values of the pixel at\n(0, 0). The second four values (indices 4-7) will contain the R, G, B, A\nvalues of the pixel at (1, 0). More generally, to set values for a pixel\nat (x, y):
\nvar d = pixelDensity();\nfor (var i = 0; i < d; i++) {\n for (var j = 0; j < d; j++) {\n // loop over\n idx = 4 * ((y * d + j) * width * d + (x * d + i));\n pixels[idx] = r;\n pixels[idx+1] = g;\n pixels[idx+2] = b;\n pixels[idx+3] = a;\n }\n}\n
\n
\nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.
\n",
"itemtype": "property",
"name": "pixels",
"type": "Number[]",
"example": [
- "\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n\n\n\nvar pink = color(255, 102, 204);\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < 4*(width*height/2); i+=4) {\n img.pixels[i] = red(pink);\n img.pixels[i+1] = green(pink);\n img.pixels[i+2] = blue(pink);\n img.pixels[i+3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n"
+ "\n\n\nvar img = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < img.width; i++) {\n for (var j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n\n\n\nvar pink = color(255, 102, 204);\nvar img = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < 4 * (width * height / 2); i += 4) {\n img.pixels[i] = red(pink);\n img.pixels[i + 1] = green(pink);\n img.pixels[i + 2] = blue(pink);\n img.pixels[i + 3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n"
],
"alt": "66x66 turquoise rect in center of canvas\n66x66 pink rect in center of canvas",
"class": "p5.Image",
@@ -9296,7 +9892,7 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 177,
+ "line": 222,
"description": "Helper fxn for sharing pixel methods
\n",
"class": "p5.Image",
"module": "Image",
@@ -9304,12 +9900,12 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 186,
+ "line": 231,
"description": "Loads the pixels data for this image into the [pixels] attribute.
\n",
"itemtype": "method",
"name": "loadPixels",
"example": [
- "\n\nvar myImage;\nvar halfImage;\n\nfunction preload() {\n myImage = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n myImage.loadPixels();\n halfImage = 4 * width * height/2;\n for(var i = 0; i < halfImage; i++){\n myImage.pixels[i+halfImage] = myImage.pixels[i];\n }\n myImage.updatePixels();\n}\n\nfunction draw() {\n image(myImage, 0, 0);\n}\n"
+ "\n\nvar myImage;\nvar halfImage;\n\nfunction preload() {\n myImage = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n myImage.loadPixels();\n halfImage = 4 * width * height / 2;\n for (var i = 0; i < halfImage; i++) {\n myImage.pixels[i + halfImage] = myImage.pixels[i];\n }\n myImage.updatePixels();\n}\n\nfunction draw() {\n image(myImage, 0, 0);\n}\n"
],
"alt": "2 images of rocky mountains vertically stacked",
"class": "p5.Image",
@@ -9318,16 +9914,20 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 222,
+ "line": 267,
"description": "Updates the backing canvas for this image with the contents of\nthe [pixels] array.
\n",
"itemtype": "method",
"name": "updatePixels",
+ "example": [
+ "\n\nvar myImage;\nvar halfImage;\n\nfunction preload() {\n myImage = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n myImage.loadPixels();\n halfImage = 4 * width * height / 2;\n for (var i = 0; i < halfImage; i++) {\n myImage.pixels[i + halfImage] = myImage.pixels[i];\n }\n myImage.updatePixels();\n}\n\nfunction draw() {\n image(myImage, 0, 0);\n}\n"
+ ],
+ "alt": "2 images of rocky mountains vertically stacked",
"class": "p5.Image",
"module": "Image",
"submodule": "Image",
"overloads": [
{
- "line": 222,
+ "line": 267,
"params": [
{
"name": "x",
@@ -9352,15 +9952,15 @@ module.exports={
]
},
{
- "line": 236,
+ "line": 307,
"params": []
}
]
},
{
"file": "src/image/p5.Image.js",
- "line": 270,
- "description": "Get a region of pixels from an image.
\nIf no params are passed, those whole image is returned,\nif x and y are the only params passed a single pixel is extracted\nif all params are passed a rectangle region is extracted and a p5.Image\nis returned.
\nReturns undefined if the region is outside the bounds of the image
\n",
+ "line": 315,
+ "description": "Get a region of pixels from an image.
\nIf no params are passed, those whole image is returned,\nif x and y are the only params passed a single pixel is extracted\nif all params are passed a rectangle region is extracted and a p5.Image\nis returned.
\nReturns undefined if the region is outside the bounds of the image
\n",
"itemtype": "method",
"name": "get",
"params": [
@@ -9390,11 +9990,11 @@ module.exports={
}
],
"return": {
- "description": "color of pixel at x,y in array format\n [R, G, B, A] or p5.Image",
+ "description": "color of pixel at x,y in array format\n [R, G, B, A] or p5.Image",
"type": "Number[]|Color|p5.Image"
},
"example": [
- "\n\nvar myImage;\nvar c;\n\nfunction preload() {\n myImage = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n background(myImage);\n noStroke();\n c = myImage.get(60, 90);\n fill(c);\n rect(25, 25, 50, 50);\n}\n\n//get() returns color here\n"
+ "\n\nvar myImage;\nvar c;\n\nfunction preload() {\n myImage = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n background(myImage);\n noStroke();\n c = myImage.get(60, 90);\n fill(c);\n rect(25, 25, 50, 50);\n}\n\n//get() returns color here\n"
],
"alt": "image of rocky mountains with 50x50 green rect in front",
"class": "p5.Image",
@@ -9403,8 +10003,8 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 315,
- "description": "Set the color of a single pixel or write an image into\nthis p5.Image.
\nNote that for a large number of pixels this will\nbe slower than directly manipulating the pixels array\nand then calling updatePixels().
\n",
+ "line": 360,
+ "description": "Set the color of a single pixel or write an image into\nthis p5.Image.
\nNote that for a large number of pixels this will\nbe slower than directly manipulating the pixels array\nand then calling updatePixels().
\n",
"itemtype": "method",
"name": "set",
"params": [
@@ -9420,12 +10020,12 @@ module.exports={
},
{
"name": "a",
- "description": "grayscale value | pixel array |\n a p5.Color | image to copy
\n",
- "type": "Number|Array|Object"
+ "description": "grayscale value | pixel array |\n a p5.Color | image to copy
\n",
+ "type": "Number|Number[]|Object"
}
],
"example": [
- "\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, i % img.width * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n"
+ "\n\n\nvar img = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < img.width; i++) {\n for (var j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, (i % img.width) * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n"
],
"alt": "2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas",
"class": "p5.Image",
@@ -9434,7 +10034,7 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 353,
+ "line": 398,
"description": "Resize the image to a new width and height. To make the image scale\nproportionally, use 0 as the value for the wide or high parameter.\nFor instance, to make the width of an image 150 pixels, and change\nthe height using the same proportion, use resize(150, 0).
\n",
"itemtype": "method",
"name": "resize",
@@ -9451,7 +10051,7 @@ module.exports={
}
],
"example": [
- "\n\nvar img;\n\nfunction setup() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction draw() {\n image(img, 0, 0);\n}\n\nfunction mousePressed() {\n img.resize(50, 100);\n}\n"
+ "\n\nvar img;\n\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction draw() {\n image(img, 0, 0);\n}\n\nfunction mousePressed() {\n img.resize(50, 100);\n}\n"
],
"alt": "image of rocky mountains. zoomed in",
"class": "p5.Image",
@@ -9460,68 +10060,118 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 435,
+ "line": 483,
"description": "Copies a region of pixels from one image to another. If no\nsrcImage is specified this is used as the source. If the source\nand destination regions aren't the same size, it will\nautomatically resize source pixels to fit the specified\ntarget region.
\n",
"itemtype": "method",
"name": "copy",
- "params": [
- {
- "name": "srcImage",
- "description": "source image
\n",
- "type": "p5.Image|p5.Graphics|undefined"
- },
- {
- "name": "sx",
- "description": "X coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sy",
- "description": "Y coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sw",
- "description": "source image width
\n",
- "type": "Integer"
- },
- {
- "name": "sh",
- "description": "source image height
\n",
- "type": "Integer"
- },
- {
- "name": "dx",
- "description": "X coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dy",
- "description": "Y coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dw",
- "description": "destination image width
\n",
- "type": "Integer"
- },
- {
- "name": "dh",
- "description": "destination image height
\n",
- "type": "Integer"
- }
- ],
"example": [
- "\n\nvar photo;\nvar bricks;\nvar x;\nvar y;\n\nfunction preload() {\n photo = loadImage(\"assets/rockies.jpg\");\n bricks = loadImage(\"assets/bricks.jpg\");\n}\n\nfunction setup() {\n x = bricks.width/2;\n y = bricks.height/2;\n photo.copy(bricks, 0, 0, x, y, 0, 0, x, y);\n image(photo, 0, 0);\n}\n"
+ "\n\nvar photo;\nvar bricks;\nvar x;\nvar y;\n\nfunction preload() {\n photo = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks.jpg');\n}\n\nfunction setup() {\n x = bricks.width / 2;\n y = bricks.height / 2;\n photo.copy(bricks, 0, 0, x, y, 0, 0, x, y);\n image(photo, 0, 0);\n}\n"
],
"alt": "image of rocky mountains and smaller image on top of bricks at top left",
"class": "p5.Image",
"module": "Image",
- "submodule": "Image"
+ "submodule": "Image",
+ "overloads": [
+ {
+ "line": 483,
+ "params": [
+ {
+ "name": "srcImage",
+ "description": "source image
\n",
+ "type": "p5.Image|p5.Element"
+ },
+ {
+ "name": "sx",
+ "description": "X coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "Y coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "source image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "source image height
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "X coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "Y coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "destination image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "destination image height
\n",
+ "type": "Integer"
+ }
+ ]
+ },
+ {
+ "line": 524,
+ "params": [
+ {
+ "name": "sx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "",
+ "type": "Integer"
+ }
+ ]
+ }
+ ]
},
{
"file": "src/image/p5.Image.js",
- "line": 480,
+ "line": 564,
"description": "Masks part of an image from displaying by loading another\nimage and using it's alpha channel as an alpha channel for\nthis image.
\n",
"itemtype": "method",
"name": "mask",
@@ -9533,7 +10183,7 @@ module.exports={
}
],
"example": [
- "\n\nvar photo, maskImage;\nfunction preload() {\n photo = loadImage(\"assets/rockies.jpg\");\n maskImage = loadImage(\"assets/mask2.png\");\n}\n\nfunction setup() {\n createCanvas(100, 100);\n photo.mask(maskImage);\n image(photo, 0, 0);\n}\n"
+ "\n\nvar photo, maskImage;\nfunction preload() {\n photo = loadImage('assets/rockies.jpg');\n maskImage = loadImage('assets/mask2.png');\n}\n\nfunction setup() {\n createCanvas(100, 100);\n photo.mask(maskImage);\n image(photo, 0, 0);\n}\n"
],
"alt": "image of rocky mountains with white at right\n\n\nhttp://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/",
"class": "p5.Image",
@@ -9542,24 +10192,25 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 543,
- "description": "Applies an image filter to a p5.Image
\n",
+ "line": 627,
+ "description": "Applies an image filter to a p5.Image
\n",
"itemtype": "method",
"name": "filter",
"params": [
{
- "name": "operation",
- "description": "one of threshold, gray, invert, posterize, opaque\n erode, dilate and blur. See Filters.js for docs on\n each available filter
\n",
- "type": "String"
+ "name": "filterType",
+ "description": "either THRESHOLD, GRAY, OPAQUE, INVERT,\n POSTERIZE, BLUR, ERODE, DILATE or BLUR.\n See Filters.js for docs on\n each available filter
\n",
+ "type": "Constant"
},
{
- "name": "value",
- "description": "",
- "type": "Number|undefined"
+ "name": "filterParam",
+ "description": "an optional parameter unique\n to each filter, see above
\n",
+ "type": "Number",
+ "optional": true
}
],
"example": [
- "\n\nvar photo1;\nvar photo2;\n\nfunction preload() {\n photo1 = loadImage(\"assets/rockies.jpg\");\n photo2 = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n photo2.filter(\"gray\");\n image(photo1, 0, 0);\n image(photo2, width/2, 0);\n}\n"
+ "\n\nvar photo1;\nvar photo2;\n\nfunction preload() {\n photo1 = loadImage('assets/rockies.jpg');\n photo2 = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n photo2.filter('gray');\n image(photo1, 0, 0);\n image(photo2, width / 2, 0);\n}\n"
],
"alt": "2 images of rocky mountains left one in color, right in black and white",
"class": "p5.Image",
@@ -9568,108 +10219,128 @@ module.exports={
},
{
"file": "src/image/p5.Image.js",
- "line": 577,
+ "line": 663,
"description": "Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.
\n",
"itemtype": "method",
"name": "blend",
- "params": [
- {
- "name": "srcImage",
- "description": "source image
\n",
- "type": "p5.Image|undefined"
- },
- {
- "name": "sx",
- "description": "X coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sy",
- "description": "Y coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sw",
- "description": "source image width
\n",
- "type": "Integer"
- },
- {
- "name": "sh",
- "description": "source image height
\n",
- "type": "Integer"
- },
- {
- "name": "dx",
- "description": "X coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dy",
- "description": "Y coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dw",
- "description": "destination image width
\n",
- "type": "Integer"
- },
- {
- "name": "dh",
- "description": "destination image height
\n",
- "type": "Integer"
- },
- {
- "name": "blendMode",
- "description": "the blend mode
\nAvailable blend modes are: normal | multiply | screen | overlay |\n darken | lighten | color-dodge | color-burn | hard-light |\n soft-light | difference | exclusion | hue | saturation |\n color | luminosity
\nhttp://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/
\n",
- "type": "Integer"
- }
- ],
"example": [
- "\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage(\"assets/rockies.jpg\");\n bricks = loadImage(\"assets/bricks_third.jpg\");\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage(\"assets/rockies.jpg\");\n bricks = loadImage(\"assets/bricks_third.jpg\");\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage(\"assets/rockies.jpg\");\n bricks = loadImage(\"assets/bricks_third.jpg\");\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n"
+ "\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n"
],
"alt": "image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent",
"class": "p5.Image",
"module": "Image",
- "submodule": "Image"
- },
- {
- "file": "src/image/p5.Image.js",
- "line": 658,
- "description": "helper method for web GL mode to indicate that an image has been\nchanged or unchanged since last upload. gl texture upload will\nset this value to false after uploading the texture.
\n",
- "itemtype": "method",
- "name": "setModified",
- "params": [
+ "submodule": "Image",
+ "overloads": [
{
- "name": "val",
- "description": "sets whether or not the image has been\nmodified.
\n",
- "type": "Boolean"
+ "line": 663,
+ "params": [
+ {
+ "name": "srcImage",
+ "description": "source image
\n",
+ "type": "p5.Image"
+ },
+ {
+ "name": "sx",
+ "description": "X coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "Y coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "source image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "source image height
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "X coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "Y coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "destination image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "destination image height
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "blendMode",
+ "description": "the blend mode. either\n BLEND, DARKEST, LIGHTEST, DIFFERENCE,\n MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,\n SOFT_LIGHT, DODGE, BURN, ADD or NORMAL.
\nAvailable blend modes are: normal | multiply | screen | overlay |\n darken | lighten | color-dodge | color-burn | hard-light |\n soft-light | difference | exclusion | hue | saturation |\n color | luminosity
\nhttp://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/
\n",
+ "type": "Constant"
+ }
+ ]
+ },
+ {
+ "line": 742,
+ "params": [
+ {
+ "name": "sx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "blendMode",
+ "description": "",
+ "type": "Constant"
+ }
+ ]
}
- ],
- "access": "private",
- "tagname": "",
- "class": "p5.Image",
- "module": "Image",
- "submodule": "Image"
- },
- {
- "file": "src/image/p5.Image.js",
- "line": 671,
- "description": "helper method for web GL mode to figure out if the image\nhas been modified and might need to be re-uploaded to texture\nmemory between frames.
\n",
- "itemtype": "method",
- "name": "isModified",
- "access": "private",
- "tagname": "",
- "return": {
- "description": "a boolean indicating whether or not the\nimage has been updated or modified since last texture upload.",
- "type": "Boolean"
- },
- "class": "p5.Image",
- "module": "Image",
- "submodule": "Image"
+ ]
},
{
"file": "src/image/p5.Image.js",
- "line": 684,
+ "line": 785,
"description": "Saves the image to a file and force the browser to download it.\nAccepts two strings for filename and file extension\nSupports png (default) and jpg.
\n",
"itemtype": "method",
"name": "save",
@@ -9686,7 +10357,7 @@ module.exports={
}
],
"example": [
- "\n\nvar photo;\n\nfunction preload() {\n photo = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction draw() {\n image(photo, 0, 0);\n}\n\nfunction keyTyped() {\n if (key == 's') {\n photo.save(\"photo\", \"png\");\n }\n}\n"
+ "\n\nvar photo;\n\nfunction preload() {\n photo = loadImage('assets/rockies.jpg');\n}\n\nfunction draw() {\n image(photo, 0, 0);\n}\n\nfunction keyTyped() {\n if (key === 's') {\n photo.save('photo', 'png');\n }\n}\n"
],
"alt": "image of rocky mountains.",
"class": "p5.Image",
@@ -9696,12 +10367,12 @@ module.exports={
{
"file": "src/image/pixels.js",
"line": 14,
- "description": "Uint8ClampedArray\ncontaining the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh density displays will have more pixels[] (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. On a\nretina display, there will be 160,000.\n
\nThe first four values (indices 0-3) in the array will be the R, G, B, A\nvalues of the pixel at (0, 0). The second four values (indices 4-7) will\ncontain the R, G, B, A values of the pixel at (1, 0). More generally, to\nset values for a pixel at (x, y):
\nvar d = pixelDensity();\nfor (var i = 0; i < d; i++) {\n for (var j = 0; j < d; j++) {\n // loop over\n idx = 4 * ((y * d + j) * width * d + (x * d + i));\n pixels[idx] = r;\n pixels[idx+1] = g;\n pixels[idx+2] = b;\n pixels[idx+3] = a;\n }\n}\n
\nWhile the above method is complex, it is flexible enough to work with\nany pixelDensity. Note that set() will automatically take care of\nsetting all the appropriate values in pixels[] for a given (x, y) at\nany pixelDensity, but the performance may not be as fast when lots of\nmodifications are made to the pixel array.\n
\nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.\n
\nNote that this is not a standard javascript array. This means that\nstandard javascript functions such as slice() or\narrayCopy() do not\nwork.
",
+ "description": "Uint8ClampedArray\ncontaining the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh density displays will have more pixels[] (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. On a\nretina display, there will be 160,000.\n
\nThe first four values (indices 0-3) in the array will be the R, G, B, A\nvalues of the pixel at (0, 0). The second four values (indices 4-7) will\ncontain the R, G, B, A values of the pixel at (1, 0). More generally, to\nset values for a pixel at (x, y):
\nvar d = pixelDensity();\nfor (var i = 0; i < d; i++) {\n for (var j = 0; j < d; j++) {\n // loop over\n idx = 4 * ((y * d + j) * width * d + (x * d + i));\n pixels[idx] = r;\n pixels[idx+1] = g;\n pixels[idx+2] = b;\n pixels[idx+3] = a;\n }\n}\n
\nWhile the above method is complex, it is flexible enough to work with\nany pixelDensity. Note that set() will automatically take care of\nsetting all the appropriate values in pixels[] for a given (x, y) at\nany pixelDensity, but the performance may not be as fast when lots of\nmodifications are made to the pixel array.\n
\nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.\n
\nNote that this is not a standard javascript array. This means that\nstandard javascript functions such as slice() or\narrayCopy() do not\nwork.
",
"itemtype": "property",
"name": "pixels",
"type": "Number[]",
"example": [
- "\n\n\nvar pink = color(255, 102, 204);\nloadPixels();\nvar d = pixelDensity();\nvar halfImage = 4 * (width * d) * (height/2 * d);\nfor (var i = 0; i < halfImage; i+=4) {\n pixels[i] = red(pink);\n pixels[i+1] = green(pink);\n pixels[i+2] = blue(pink);\n pixels[i+3] = alpha(pink);\n}\nupdatePixels();\n\n"
+ "\n\n\nvar pink = color(255, 102, 204);\nloadPixels();\nvar d = pixelDensity();\nvar halfImage = 4 * (width * d) * (height / 2 * d);\nfor (var i = 0; i < halfImage; i += 4) {\n pixels[i] = red(pink);\n pixels[i + 1] = green(pink);\n pixels[i + 2] = blue(pink);\n pixels[i + 3] = alpha(pink);\n}\nupdatePixels();\n\n"
],
"alt": "top half of canvas pink, bottom grey",
"class": "p5",
@@ -9711,150 +10382,256 @@ module.exports={
{
"file": "src/image/pixels.js",
"line": 83,
- "description": "Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.
\nAvailable blend modes are: BLEND | DARKEST | LIGHTEST | DIFFERENCE |\nMULTIPLY| EXCLUSION | SCREEN | REPLACE | OVERLAY | HARD_LIGHT |\nSOFT_LIGHT | DODGE | BURN | ADD | NORMAL
\n",
+ "description": "Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.
\n",
"itemtype": "method",
"name": "blend",
- "params": [
- {
- "name": "srcImage",
- "description": "source image
\n",
- "type": "p5.Image|undefined"
- },
- {
- "name": "sx",
- "description": "X coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sy",
- "description": "Y coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sw",
- "description": "source image width
\n",
- "type": "Integer"
- },
- {
- "name": "sh",
- "description": "source image height
\n",
- "type": "Integer"
- },
- {
- "name": "dx",
- "description": "X coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dy",
- "description": "Y coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dw",
- "description": "destination image width
\n",
- "type": "Integer"
- },
- {
- "name": "dh",
- "description": "destination image height
\n",
- "type": "Integer"
- },
- {
- "name": "blendMode",
- "description": "the blend mode
\n",
- "type": "Integer"
- }
- ],
"example": [
- "\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage(\"assets/rockies.jpg\");\n img1 = loadImage(\"assets/bricks_third.jpg\");\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n}\n\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage(\"assets/rockies.jpg\");\n img1 = loadImage(\"assets/bricks_third.jpg\");\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n}\n\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage(\"assets/rockies.jpg\");\n img1 = loadImage(\"assets/bricks_third.jpg\");\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n}\n"
+ "\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage('assets/rockies.jpg');\n img1 = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n}\n\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage('assets/rockies.jpg');\n img1 = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n}\n\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage('assets/rockies.jpg');\n img1 = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n}\n"
],
"alt": "image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent",
"class": "p5",
"module": "Image",
- "submodule": "Pixels"
+ "submodule": "Pixels",
+ "overloads": [
+ {
+ "line": 83,
+ "params": [
+ {
+ "name": "srcImage",
+ "description": "source image
\n",
+ "type": "p5.Image"
+ },
+ {
+ "name": "sx",
+ "description": "X coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "Y coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "source image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "source image height
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "X coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "Y coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "destination image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "destination image height
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "blendMode",
+ "description": "the blend mode. either\n BLEND, DARKEST, LIGHTEST, DIFFERENCE,\n MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,\n SOFT_LIGHT, DODGE, BURN, ADD or NORMAL.
\n",
+ "type": "Constant"
+ }
+ ]
+ },
+ {
+ "line": 156,
+ "params": [
+ {
+ "name": "sx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "blendMode",
+ "description": "",
+ "type": "Constant"
+ }
+ ]
+ }
+ ]
},
{
"file": "src/image/pixels.js",
- "line": 165,
+ "line": 177,
"description": "Copies a region of the canvas to another region of the canvas\nand copies a region of pixels from an image used as the srcImg parameter\ninto the canvas srcImage is specified this is used as the source. If\nthe source and destination regions aren't the same size, it will\nautomatically resize source pixels to fit the specified\ntarget region.
\n",
"itemtype": "method",
"name": "copy",
- "params": [
- {
- "name": "srcImage",
- "description": "source image
\n",
- "type": "p5.Image|undefined"
- },
- {
- "name": "sx",
- "description": "X coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sy",
- "description": "Y coordinate of the source's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "sw",
- "description": "source image width
\n",
- "type": "Integer"
- },
- {
- "name": "sh",
- "description": "source image height
\n",
- "type": "Integer"
- },
- {
- "name": "dx",
- "description": "X coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dy",
- "description": "Y coordinate of the destination's upper left corner
\n",
- "type": "Integer"
- },
- {
- "name": "dw",
- "description": "destination image width
\n",
- "type": "Integer"
- },
- {
- "name": "dh",
- "description": "destination image height
\n",
- "type": "Integer"
- }
- ],
"example": [
- "\n\nvar img;\n\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n background(img);\n copy(img, 7, 22, 10, 10, 35, 25, 50, 50);\n stroke(255);\n noFill();\n // Rectangle shows area being copied\n rect(7, 22, 10, 10);\n}\n"
+ "\n\nvar img;\n\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n background(img);\n copy(img, 7, 22, 10, 10, 35, 25, 50, 50);\n stroke(255);\n noFill();\n // Rectangle shows area being copied\n rect(7, 22, 10, 10);\n}\n"
],
"alt": "image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent",
"class": "p5",
"module": "Image",
- "submodule": "Pixels"
+ "submodule": "Pixels",
+ "overloads": [
+ {
+ "line": 177,
+ "params": [
+ {
+ "name": "srcImage",
+ "description": "source image
\n",
+ "type": "p5.Image|p5.Element"
+ },
+ {
+ "name": "sx",
+ "description": "X coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "Y coordinate of the source's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "source image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "source image height
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "X coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "Y coordinate of the destination's upper left corner
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "destination image width
\n",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "destination image height
\n",
+ "type": "Integer"
+ }
+ ]
+ },
+ {
+ "line": 220,
+ "params": [
+ {
+ "name": "sx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "sh",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dx",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dy",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dw",
+ "description": "",
+ "type": "Integer"
+ },
+ {
+ "name": "dh",
+ "description": "",
+ "type": "Integer"
+ }
+ ]
+ }
+ ]
},
{
"file": "src/image/pixels.js",
- "line": 212,
- "description": "Applies a filter to the canvas.\n
\nThe presets options are:\n
\nTHRESHOLD\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n
\nGRAY\nConverts any colors in the image to grayscale equivalents. No parameter\nis used.\n
\nOPAQUE\nSets the alpha channel to entirely opaque. No parameter is used.\n
\nINVERT\nSets each pixel to its inverse value. No parameter is used.\n
\nPOSTERIZE\nLimits each channel of the image to the number of colors specified as the\nparameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n
\nBLUR\nExecutes a Guassian blur with the level parameter specifying the extent\nof the blurring. If no parameter is used, the blur is equivalent to\nGuassian blur of radius 1. Larger values increase the blur.\n
\nERODE\nReduces the light areas. No parameter is used.\n
\nDILATE\nIncreases the light areas. No parameter is used.
\n",
+ "line": 236,
+ "description": "Applies a filter to the canvas.\n
\nThe presets options are:\n
\nTHRESHOLD\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n
\nGRAY\nConverts any colors in the image to grayscale equivalents. No parameter\nis used.\n
\nOPAQUE\nSets the alpha channel to entirely opaque. No parameter is used.\n
\nINVERT\nSets each pixel to its inverse value. No parameter is used.\n
\nPOSTERIZE\nLimits each channel of the image to the number of colors specified as the\nparameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n
\nBLUR\nExecutes a Gaussian blur with the level parameter specifying the extent\nof the blurring. If no parameter is used, the blur is equivalent to\nGaussian blur of radius 1. Larger values increase the blur.\n
\nERODE\nReduces the light areas. No parameter is used.\n
\nDILATE\nIncreases the light areas. No parameter is used.
\n",
"itemtype": "method",
"name": "filter",
"params": [
{
"name": "filterType",
- "description": "either THRESHOLD, GRAY, OPAQUE, INVERT,\n POSTERIZE, BLUR, ERODE or DILATE
\n",
+ "description": "either THRESHOLD, GRAY, OPAQUE, INVERT,\n POSTERIZE, BLUR, ERODE, DILATE or BLUR.\n See Filters.js for docs on\n each available filter
\n",
"type": "Constant"
},
{
"name": "filterParam",
- "description": "an optional parameter unique\n to each filter, see above
\n",
- "type": "Number"
+ "description": "an optional parameter unique\n to each filter, see above
\n",
+ "type": "Number",
+ "optional": true
}
],
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(THRESHOLD);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(GRAY);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(OPAQUE);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(INVERT);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(POSTERIZE,3);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(DILATE);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(BLUR,3);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/bricks.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(ERODE);\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(THRESHOLD);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(GRAY);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(OPAQUE);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(INVERT);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(POSTERIZE, 3);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(DILATE);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(BLUR, 3);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(ERODE);\n}\n\n"
],
"alt": "black and white image of a brick wall.\ngreyscale image of a brickwall\nimage of a brickwall\njade colored image of a brickwall\nred and pink image of a brickwall\nimage of a brickwall\nblurry image of a brickwall\nimage of a brickwall\nimage of a brickwall with less detail",
"class": "p5",
@@ -9863,8 +10640,8 @@ module.exports={
},
{
"file": "src/image/pixels.js",
- "line": 390,
- "description": "Returns an array of [R,G,B,A] values for any pixel or grabs a section of\nan image. If no parameters are specified, the entire image is returned.\nUse the x and y parameters to get the value of one pixel. Get a section of\nthe display window by specifying additional w and h parameters. When\ngetting an image, the x and y parameters define the coordinates for the\nupper-left corner of the image, regardless of the current imageMode().\n
\nIf the pixel requested is outside of the image window, [0,0,0,255] is\nreturned. To get the numbers scaled according to the current color ranges\nand taking into account colorMode, use getColor instead of get.\n
\nGetting the color of a single pixel with get(x, y) is easy, but not as fast\nas grabbing the data directly from pixels[]. The equivalent statement to\nget(x, y) using pixels[] with pixel density d is\n\nvar off = (y width + x) d * 4;\n[pixels[off],\npixels[off+1],\npixels[off+2],\npixels[off+3]]\n
\nSee the reference for pixels[] for more information.
\n",
+ "line": 415,
+ "description": "Returns an array of [R,G,B,A] values for any pixel or grabs a section of\nan image. If no parameters are specified, the entire image is returned.\nUse the x and y parameters to get the value of one pixel. Get a section of\nthe display window by specifying additional w and h parameters. When\ngetting an image, the x and y parameters define the coordinates for the\nupper-left corner of the image, regardless of the current imageMode().\n
\nIf the pixel requested is outside of the image window, [0,0,0,255] is\nreturned. To get the numbers scaled according to the current color ranges\nand taking into account colorMode, use getColor instead of get.\n
\nGetting the color of a single pixel with get(x, y) is easy, but not as fast\nas grabbing the data directly from pixels[]. The equivalent statement to\nget(x, y) using pixels[] with pixel density d is\n\nvar x, y, d; // set these to the coordinates\nvar off = (y width + x) d * 4;\nvar components = [\n pixels[off],\n pixels[off + 1],\n pixels[off + 2],\n pixels[off + 3]\n];\nprint(components);\n\n
\nSee the reference for pixels[] for more information.
\nIf you want to extract an array of colors or a subimage from an p5.Image object,\ntake a look at p5.Image.get()
\n",
"itemtype": "method",
"name": "get",
"params": [
@@ -9894,11 +10671,11 @@ module.exports={
}
],
"return": {
- "description": "values of pixel at x,y in array format\n [R, G, B, A] or p5.Image",
+ "description": "values of pixel at x,y in array format\n [R, G, B, A] or p5.Image",
"type": "Number[]|p5.Image"
},
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n var c = get();\n image(c, width/2, 0);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\nfunction setup() {\n image(img, 0, 0);\n var c = get(50, 90);\n fill(c);\n noStroke();\n rect(25, 25, 50, 50);\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n var c = get();\n image(c, width / 2, 0);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n var c = get(50, 90);\n fill(c);\n noStroke();\n rect(25, 25, 50, 50);\n}\n\n"
],
"alt": "2 images of the rocky mountains, side-by-side\nImage of the rocky mountains with 50x50 green rect in center of canvas",
"class": "p5",
@@ -9907,12 +10684,12 @@ module.exports={
},
{
"file": "src/image/pixels.js",
- "line": 461,
- "description": "Loads the pixel data for the display window into the pixels[] array. This\nfunction must always be called before reading from or writing to pixels[].\nNote that only changes made with set() or direct manipulation of pixels[]\nwill occur.
\n",
+ "line": 494,
+ "description": "Loads the pixel data for the display window into the pixels[] array. This\nfunction must always be called before reading from or writing to pixels[].\nNote that only changes made with set() or direct manipulation of pixels[]\nwill occur.
\n",
"itemtype": "method",
"name": "loadPixels",
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n image(img, 0, 0);\n var d = pixelDensity();\n var halfImage = 4 * (img.width * d) *\n (img.height/2 * d);\n loadPixels();\n for (var i = 0; i < halfImage; i++) {\n pixels[i+halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n image(img, 0, 0);\n var d = pixelDensity();\n var halfImage = 4 * (img.width * d) * (img.height * d / 2);\n loadPixels();\n for (var i = 0; i < halfImage; i++) {\n pixels[i + halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n"
],
"alt": "two images of the rocky mountains. one on top, one on bottom of canvas.",
"class": "p5",
@@ -9921,8 +10698,8 @@ module.exports={
},
{
"file": "src/image/pixels.js",
- "line": 498,
- "description": "Changes the color of any pixel, or writes an image directly to the\ndisplay window.
\nThe x and y parameters specify the pixel to change and the c parameter\nspecifies the color value. This can be a p5.Color object, or [R, G, B, A]\npixel array. It can also be a single grayscale value.\nWhen setting an image, the x and y parameters define the coordinates for\nthe upper-left corner of the image, regardless of the current imageMode().\n
\n\nAfter using set(), you must call updatePixels() for your changes to appear.\nThis should be called once all pixels have been set, and must be called before\ncalling .get() or drawing the image.\n
\nSetting the color of a single pixel with set(x, y) is easy, but not as\nfast as putting the data directly into pixels[]. Setting the pixels[]\nvalues directly may be complicated when working with a retina display,\nbut will perform better when lots of pixels need to be set directly on\nevery loop.
\nSee the reference for pixels[] for more information.
",
+ "line": 531,
+ "description": "Changes the color of any pixel, or writes an image directly to the\ndisplay window.
\nThe x and y parameters specify the pixel to change and the c parameter\nspecifies the color value. This can be a p5.Color object, or [R, G, B, A]\npixel array. It can also be a single grayscale value.\nWhen setting an image, the x and y parameters define the coordinates for\nthe upper-left corner of the image, regardless of the current imageMode().\n
\n\nAfter using set(), you must call updatePixels() for your changes to appear.\nThis should be called once all pixels have been set, and must be called before\ncalling .get() or drawing the image.\n
\nSetting the color of a single pixel with set(x, y) is easy, but not as\nfast as putting the data directly into pixels[]. Setting the pixels[]\nvalues directly may be complicated when working with a retina display,\nbut will perform better when lots of pixels need to be set directly on\nevery loop.
\nSee the reference for pixels[] for more information.
",
"itemtype": "method",
"name": "set",
"params": [
@@ -9938,12 +10715,12 @@ module.exports={
},
{
"name": "c",
- "description": "insert a grayscale value | a pixel array |\n a p5.Color object | a p5.Image to copy
\n",
- "type": "Number|Array|Object"
+ "description": "insert a grayscale value | a pixel array |\n a p5.Color object | a p5.Image to copy
\n",
+ "type": "Number|Number[]|Object"
}
],
"example": [
- "\n\n\nvar black = color(0);\nset(30, 20, black);\nset(85, 20, black);\nset(85, 75, black);\nset(30, 75, black);\nupdatePixels();\n\n\n\n\n\nfor (var i = 30; i < width-15; i++) {\n for (var j = 20; j < height-25; j++) {\n var c = color(204-j, 153-i, 0);\n set(i, j, c);\n }\n}\nupdatePixels();\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n set(0, 0, img);\n updatePixels();\n line(0, 0, width, height);\n line(0, height, width, 0);\n}\n\n"
+ "\n\n\nvar black = color(0);\nset(30, 20, black);\nset(85, 20, black);\nset(85, 75, black);\nset(30, 75, black);\nupdatePixels();\n\n\n\n\n\nfor (var i = 30; i < width - 15; i++) {\n for (var j = 20; j < height - 25; j++) {\n var c = color(204 - j, 153 - i, 0);\n set(i, j, c);\n }\n}\nupdatePixels();\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n set(0, 0, img);\n updatePixels();\n line(0, 0, width, height);\n line(0, height, width, 0);\n}\n\n"
],
"alt": "4 black points in the shape of a square middle-right of canvas.\nsquare with orangey-brown gradient lightening at bottom right.\nimage of the rocky mountains. with lines like an 'x' through the center.",
"class": "p5",
@@ -9952,8 +10729,8 @@ module.exports={
},
{
"file": "src/image/pixels.js",
- "line": 572,
- "description": "Updates the display window with the data in the pixels[] array.\nUse in conjunction with loadPixels(). If you're only reading pixels from\nthe array, there's no need to call updatePixels() — updating is only\nnecessary to apply changes. updatePixels() should be called anytime the\npixels array is manipulated or set() is called, and only changes made with\nset() or direct changes to pixels[] will occur.
\n",
+ "line": 605,
+ "description": "Updates the display window with the data in the pixels[] array.\nUse in conjunction with loadPixels(). If you're only reading pixels from\nthe array, there's no need to call updatePixels() — updating is only\nnecessary to apply changes. updatePixels() should be called anytime the\npixels array is manipulated or set() is called, and only changes made with\nset() or direct changes to pixels[] will occur.
\n",
"itemtype": "method",
"name": "updatePixels",
"params": [
@@ -9983,7 +10760,7 @@ module.exports={
}
],
"example": [
- "\n\n\nvar img;\nfunction preload() {\n img = loadImage(\"assets/rockies.jpg\");\n}\n\nfunction setup() {\n image(img, 0, 0);\n var halfImage = 4 * (img.width * pixelDensity()) *\n (img.height * pixelDensity()/2);\n loadPixels();\n for (var i = 0; i < halfImage; i++) {\n pixels[i+halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n"
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n image(img, 0, 0);\n var d = pixelDensity();\n var halfImage = 4 * (img.width * d) * (img.height * d / 2);\n loadPixels();\n for (var i = 0; i < halfImage; i++) {\n pixels[i + halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n"
],
"alt": "two images of the rocky mountains. one on top, one on bottom of canvas.",
"class": "p5",
@@ -9993,56 +10770,121 @@ module.exports={
{
"file": "src/io/files.js",
"line": 19,
- "description": "Loads a JSON file from a file or a URL, and returns an Object.\nNote that even if the JSON file contains an Array, an Object will be\nreturned with index numbers as keys.
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. JSONP is supported via a polyfill and you\ncan pass in as the second argument an object with definitions of the json\ncallback following the syntax specified here.
\n",
+ "description": "Loads a JSON file from a file or a URL, and returns an Object.\nNote that even if the JSON file contains an Array, an Object will be\nreturned with index numbers as keys.
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. JSONP is supported via a polyfill and you\ncan pass in as the second argument an object with definitions of the json\ncallback following the syntax specified here.
\nThis method is suitable for fetching files up to size of 64MB.
\n",
"itemtype": "method",
"name": "loadJSON",
- "params": [
- {
- "name": "path",
- "description": "name of the file or url to load
\n",
- "type": "String"
- },
- {
- "name": "jsonpOptions",
- "description": "options object for jsonp related settings
\n",
- "type": "Object",
- "optional": true
- },
- {
- "name": "datatype",
- "description": ""json" or "jsonp"
\n",
- "type": "String",
- "optional": true
- },
- {
- "name": "callback",
- "description": "function to be executed after\n loadJSON() completes, data is passed\n in as first argument
\n",
- "type": "Function",
- "optional": true
- },
- {
- "name": "errorCallback",
- "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
- "type": "Function",
- "optional": true
- }
- ],
"return": {
"description": "JSON data",
"type": "Object|Array"
},
"example": [
- "\n\nCalling loadJSON() inside preload() guarantees to complete the\noperation before setup() and draw() are called.
\n\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\nvar earthquakes;\nfunction preload() {\n // Get the most recent earthquake in the database\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n earthquakes = loadJSON(url);\n}\n\nfunction setup() {\n noLoop();\n}\n\nfunction draw() {\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:
\n\nfunction setup() {\n noLoop();\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n loadJSON(url, drawEarthquake);\n}\n\nfunction draw() {\n background(200);\n}\n\nfunction drawEarthquake(earthquakes) {\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n"
+ "\n\nCalling loadJSON() inside preload() guarantees to complete the\noperation before setup() and draw() are called.
\n\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\nvar earthquakes;\nfunction preload() {\n // Get the most recent earthquake in the database\n var url =\n 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' +\n 'summary/all_day.geojson';\n earthquakes = loadJSON(url);\n}\n\nfunction setup() {\n noLoop();\n}\n\nfunction draw() {\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:
\n\nfunction setup() {\n noLoop();\n var url =\n 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' +\n 'summary/all_day.geojson';\n loadJSON(url, drawEarthquake);\n}\n\nfunction draw() {\n background(200);\n}\n\nfunction drawEarthquake(earthquakes) {\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n"
],
"alt": "50x50 ellipse that changes from black to white depending on the current humidity\n50x50 ellipse that changes from black to white depending on the current humidity",
"class": "p5",
"module": "IO",
- "submodule": "Input"
+ "submodule": "Input",
+ "overloads": [
+ {
+ "line": 19,
+ "params": [
+ {
+ "name": "path",
+ "description": "name of the file or url to load
\n",
+ "type": "String"
+ },
+ {
+ "name": "jsonpOptions",
+ "description": "options object for jsonp related settings
\n",
+ "type": "Object",
+ "optional": true
+ },
+ {
+ "name": "datatype",
+ "description": ""json" or "jsonp"
\n",
+ "type": "String",
+ "optional": true
+ },
+ {
+ "name": "callback",
+ "description": "function to be executed after\n loadJSON() completes, data is passed\n in as first argument
\n",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "JSON data",
+ "type": "Object|Array"
+ }
+ },
+ {
+ "line": 105,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "datatype",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Object|Array"
+ }
+ },
+ {
+ "line": 113,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function"
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Object|Array"
+ }
+ }
+ ]
},
{
"file": "src/io/files.js",
- "line": 145,
- "description": "Reads the contents of a file and creates a String array of its individual\nlines. If the name of the file is used as the parameter, as in the above\nexample, the file must be located in the sketch directory/folder.\n
\nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.\n
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed.
\n",
+ "line": 180,
+ "description": "Reads the contents of a file and creates a String array of its individual\nlines. If the name of the file is used as the parameter, as in the above\nexample, the file must be located in the sketch directory/folder.\n
\nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.\n
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed.
\nThis method is suitable for fetching files up to size of 64MB.
\n",
"itemtype": "method",
"name": "loadStrings",
"params": [
@@ -10053,7 +10895,7 @@ module.exports={
},
{
"name": "callback",
- "description": "function to be executed after loadStrings()\n completes, Array is passed in as first\n argument
\n",
+ "description": "function to be executed after loadStrings()\n completes, Array is passed in as first\n argument
\n",
"type": "Function",
"optional": true
},
@@ -10069,7 +10911,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\nCalling loadStrings() inside preload() guarantees to complete the\noperation before setup() and draw() are called.
\n\n\nvar result;\nfunction preload() {\n result = loadStrings('assets/test.txt');\n}\n\nfunction setup() {\n background(200);\n var ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:
\n\n\nfunction setup() {\n loadStrings('assets/test.txt', pickString);\n}\n\nfunction pickString(result) {\n background(200);\n var ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n"
+ "\n\nCalling loadStrings() inside preload() guarantees to complete the\noperation before setup() and draw() are called.
\n\n\nvar result;\nfunction preload() {\n result = loadStrings('assets/test.txt');\n}\n\nfunction setup() {\n background(200);\n var ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:
\n\n\nfunction setup() {\n loadStrings('assets/test.txt', pickString);\n}\n\nfunction pickString(result) {\n background(200);\n var ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n"
],
"alt": "randomly generated text from a file, for example \"i smell like butter\"\nrandomly generated text from a file, for example \"i have three feet\"",
"class": "p5",
@@ -10078,51 +10920,85 @@ module.exports={
},
{
"file": "src/io/files.js",
- "line": 237,
- "description": "Reads the contents of a file or URL and creates a p5.Table object with\nits values. If a file is specified, it must be located in the sketch's\n"data" folder. The filename parameter can also be a URL to a file found\nonline. By default, the file is assumed to be comma-separated (in CSV\nformat). Table only looks for a header row if the 'header' option is\nincluded.
\n\nPossible options include:\n
\n- csv - parse the table as comma-separated values
\n- tsv - parse the table as tab-separated values
\n- header - this table has a header (title) row
\n
\n\n\nWhen passing in multiple options, pass them in as separate parameters,\nseperated by commas. For example:\n
\n\n loadTable("my_csv_file.csv", "csv", "header")\n\n
\n\n All files loaded and saved use UTF-8 encoding.
\n\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadTable() inside preload()\nguarantees to complete the operation before setup() and draw() are called.\n
Outside of preload(), you may supply a callback function to handle the\nobject:
\n",
+ "line": 293,
+ "description": "Reads the contents of a file or URL and creates a p5.Table object with\nits values. If a file is specified, it must be located in the sketch's\n"data" folder. The filename parameter can also be a URL to a file found\nonline. By default, the file is assumed to be comma-separated (in CSV\nformat). Table only looks for a header row if the 'header' option is\nincluded.
\n\nPossible options include:\n
\n- csv - parse the table as comma-separated values
\n- tsv - parse the table as tab-separated values
\n- header - this table has a header (title) row
\n
\n\n\nWhen passing in multiple options, pass them in as separate parameters,\nseperated by commas. For example:\n
\n\nloadTable('my_csv_file.csv', 'csv', 'header');\n\n
\n\n All files loaded and saved use UTF-8 encoding.
\n\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadTable() inside preload()\nguarantees to complete the operation before setup() and draw() are called.\n
Outside of preload(), you may supply a callback function to handle the\nobject:
\n\n\nThis method is suitable for fetching files up to size of 64MB.
\n",
"itemtype": "method",
"name": "loadTable",
- "params": [
- {
- "name": "filename",
- "description": "name of the file or URL to load
\n",
- "type": "String"
- },
- {
- "name": "options",
- "description": ""header" "csv" "tsv"
\n",
- "type": "String",
- "optional": true
- },
- {
- "name": "callback",
- "description": "function to be executed after\n loadTable() completes. On success, the\n Table object is passed in as the\n first argument.
\n",
- "type": "Function",
- "optional": true
- },
- {
- "name": "errorCallback",
- "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
- "type": "Function",
- "optional": true
- }
- ],
"return": {
- "description": "Table object containing data",
+ "description": "Table object containing data",
"type": "Object"
},
"example": [
- "\n\n\n// Given the following CSV file called \"mammals.csv\"\n// located in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n //the file can be remote\n //table = loadTable(\"http://p5js.org/reference/assets/mammals.csv\",\n // \"csv\", \"header\");\n}\n\nfunction setup() {\n //count the columns\n print(table.getRowCount() + \" total rows in table\");\n print(table.getColumnCount() + \" total columns in table\");\n\n print(table.getColumn(\"name\"));\n //[\"Goat\", \"Leopard\", \"Zebra\"]\n\n //cycle through the table\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++) {\n print(table.getString(r, c));\n }\n}\n\n"
+ "\n\n\n// Given the following CSV file called \"mammals.csv\"\n// located in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n //the file can be remote\n //table = loadTable(\"http://p5js.org/reference/assets/mammals.csv\",\n // \"csv\", \"header\");\n}\n\nfunction setup() {\n //count the columns\n print(table.getRowCount() + ' total rows in table');\n print(table.getColumnCount() + ' total columns in table');\n\n print(table.getColumn('name'));\n //[\"Goat\", \"Leopard\", \"Zebra\"]\n\n //cycle through the table\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++) {\n print(table.getString(r, c));\n }\n}\n\n"
],
"alt": "randomly generated text from a file, for example \"i smell like butter\"\nrandomly generated text from a file, for example \"i have three feet\"",
"class": "p5",
"module": "IO",
- "submodule": "Input"
+ "submodule": "Input",
+ "overloads": [
+ {
+ "line": 293,
+ "params": [
+ {
+ "name": "filename",
+ "description": "name of the file or URL to load
\n",
+ "type": "String"
+ },
+ {
+ "name": "options",
+ "description": ""header" "csv" "tsv"
\n",
+ "type": "String"
+ },
+ {
+ "name": "callback",
+ "description": "function to be executed after\n loadTable() completes. On success, the\n Table object is passed in as the\n first argument.
\n",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "Table object containing data",
+ "type": "Object"
+ }
+ },
+ {
+ "line": 383,
+ "params": [
+ {
+ "name": "filename",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Object"
+ }
+ }
+ ]
},
{
"file": "src/io/files.js",
- "line": 558,
- "description": "Reads the contents of a file and creates an XML object with its values.\nIf the name of the file is used as the parameter, as in the above example,\nthe file must be located in the sketch directory/folder.
\nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadXML() inside preload()\nguarantees to complete the operation before setup() and draw() are called.
\nOutside of preload(), you may supply a callback function to handle the\nobject.
\n",
+ "line": 626,
+ "description": "Reads the contents of a file and creates an XML object with its values.\nIf the name of the file is used as the parameter, as in the above example,\nthe file must be located in the sketch directory/folder.
\nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadXML() inside preload()\nguarantees to complete the operation before setup() and draw() are called.
\nOutside of preload(), you may supply a callback function to handle the\nobject.
\nThis method is suitable for fetching files up to size of 64MB.
\n",
"itemtype": "method",
"name": "loadXML",
"params": [
@@ -10133,7 +11009,7 @@ module.exports={
},
{
"name": "callback",
- "description": "function to be executed after loadXML()\n completes, XML object is passed in as\n first argument
\n",
+ "description": "function to be executed after loadXML()\n completes, XML object is passed in as\n first argument
\n",
"type": "Function",
"optional": true
},
@@ -10149,7 +11025,7 @@ module.exports={
"type": "Object"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var children = xml.getChildren(\"animal\");\n\n for (var i = 0; i < children.length; i++) {\n var id = children[i].getNum(\"id\");\n var coloring = children[i].getString(\"species\");\n var name = children[i].getContent();\n print(id + \", \" + coloring + \", \" + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var children = xml.getChildren('animal');\n\n for (var i = 0; i < children.length; i++) {\n var id = children[i].getNum('id');\n var coloring = children[i].getString('species');\n var name = children[i].getContent();\n print(id + ', ' + coloring + ', ' + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n"
],
"alt": "no image displayed",
"class": "p5",
@@ -10158,134 +11034,81 @@ module.exports={
},
{
"file": "src/io/files.js",
- "line": 654,
- "description": "Method for executing an HTTP GET request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'GET').
\n",
- "itemtype": "method",
- "name": "httpGet",
- "params": [
- {
- "name": "path",
- "description": "name of the file or url to load
\n",
- "type": "String"
- },
- {
- "name": "datatype",
- "description": ""json", "jsonp", "xml", or "text"
\n",
- "type": "String",
- "optional": true
- },
- {
- "name": "data",
- "description": "param data passed sent with request
\n",
- "type": "Object",
- "optional": true
- },
- {
- "name": "callback",
- "description": "function to be executed after\n httpGet() completes, data is passed in\n as first argument
\n",
- "type": "Function",
- "optional": true
- },
- {
- "name": "errorCallback",
- "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
- "type": "Function",
- "optional": true
- }
- ],
- "example": [
- "\n\n // Examples use USGS Earthquake API:\n // https://earthquake.usgs.gov/fdsnws/event/1/#methods\n var earthquakes;\n function preload() {\n // Get the most recent earthquake in the database\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n httpGet(url, \"jsonp\", false, function(response) {\n // when the HTTP request completes, populate the variable that holds the\n // earthquake data used in the visualization.\n earthquakes = response;\n });\n }\n\n function draw() {\n if (!earthquakes) {\n // Wait until the earthquake data has loaded before drawing.\n return\n }\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n noLoop();\n }\n"
- ],
- "class": "p5",
- "module": "IO",
- "submodule": "Input"
- },
- {
- "file": "src/io/files.js",
- "line": 707,
- "description": "Method for executing an HTTP POST request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'POST').
\n",
+ "line": 737,
+ "description": "This method is suitable for fetching files up to size of 64MB.
\n",
"itemtype": "method",
- "name": "httpPost",
+ "name": "loadBytes",
"params": [
{
- "name": "path",
- "description": "name of the file or url to load
\n",
+ "name": "file",
+ "description": "name of the file or URL to load
\n",
"type": "String"
},
- {
- "name": "datatype",
- "description": ""json", "jsonp", "xml", or "text".\n If omitted, httpPost() will guess.
\n",
- "type": "String",
- "optional": true
- },
- {
- "name": "data",
- "description": "param data passed sent with request
\n",
- "type": "Object",
- "optional": true
- },
{
"name": "callback",
- "description": "function to be executed after\n httpPost() completes, data is passed in\n as first argument
\n",
+ "description": "function to be executed after loadBytes()\n completes
\n",
"type": "Function",
"optional": true
},
{
"name": "errorCallback",
- "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
+ "description": "function to be executed if there\n is an error
\n",
"type": "Function",
"optional": true
}
],
+ "return": {
+ "description": "an object whose 'bytes' property will be the loaded buffer",
+ "type": "Object"
+ },
"example": [
- "\n\n\n// Examples use jsonplaceholder.typicode.com for a Mock Data API\n\nvar url = 'https://jsonplaceholder.typicode.com/posts';\nvar postData = { userId: 1, title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\nfunction setup() {\n createCanvas(800, 800);\n}\n\nfunction mousePressed() {\n // Pick new random color values\n var r = random(255);\n var g = random(255);\n var b = random(255);\n\n httpPost(url, 'json',\n postData,\n function (result) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n ellipse(mouseX, mouseY, 200, 200);\n text(result.body, mouseX, mouseY);\n });\n}\n\n\n\n\n\n\n var url = 'https://invalidURL'; // A bad URL that will cause errors\n var postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\n function setup() {\n createCanvas(800, 800);\n }\n\n function mousePressed() {\n // Pick new random color values\n var r = random(255);\n var g = random(255);\n var b = random(255);\n\n httpPost(url, 'json',\n postData,\n function (result) {\n // ... won't be called\n },\n function (error) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n text(error.toString(), mouseX, mouseY);\n });\n }\n\n\n\n"
+ "\n\nvar data;\n\nfunction preload() {\n data = loadBytes('assets/mammals.xml');\n}\n\nfunction setup() {\n for (var i = 0; i < 5; i++) {\n console.log(data.bytes[i].toString(16));\n }\n}\n"
],
+ "alt": "no image displayed",
"class": "p5",
"module": "IO",
"submodule": "Input"
},
{
"file": "src/io/files.js",
- "line": 794,
- "description": "Method for executing an HTTP request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text.
\nFor more advanced use, you may also pass in the path as the first argument\nand a object as the second argument, the signature follows the one specified\nin the Fetch API specification.
\n",
+ "line": 797,
+ "description": "Method for executing an HTTP GET request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'GET'). The 'binary' datatype will return\na Blob object, and the 'arrayBuffer' datatype will return an ArrayBuffer\nwhich can be used to initialize typed arrays (such as Uint8Array).
\n",
"itemtype": "method",
- "name": "httpDo",
+ "name": "httpGet",
+ "return": {
+ "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.",
+ "type": "Promise"
+ },
"example": [
- "\n\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\n\n// displays an animation of all USGS earthquakes\nvar earthquakes;\nvar eqFeatureIndex = 0;\n\nfunction preload() {\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';\n httpDo(url,\n {\n method: 'GET',\n // Other Request options, like special headers for apis\n headers: { authorization: 'Bearer secretKey' }\n },\n function(res) {\n earthquakes = res;\n });\n}\n\nfunction draw() {\n // wait until the data is loaded\n if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {\n return;\n }\n clear();\n\n var feature = earthquakes.features[eqFeatureIndex];\n var mag = feature.properties.mag;\n var rad = mag / 11 * ((width + height) / 2);\n fill(255, 0, 0, 100);\n ellipse(\n width / 2 + random(-2, 2),\n height / 2 + random(-2, 2),\n rad, rad\n );\n\n if (eqFeatureIndex >= earthquakes.features.length) {\n eqFeatureIndex = 0;\n } else {\n eqFeatureIndex += 1;\n }\n}\n\n"
+ "\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\nvar earthquakes;\nfunction preload() {\n // Get the most recent earthquake in the database\n var url =\n 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n httpGet(url, 'jsonp', false, function(response) {\n // when the HTTP request completes, populate the variable that holds the\n // earthquake data used in the visualization.\n earthquakes = response;\n });\n}\n\nfunction draw() {\n if (!earthquakes) {\n // Wait until the earthquake data has loaded before drawing.\n return;\n }\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n noLoop();\n}\n"
],
"class": "p5",
"module": "IO",
"submodule": "Input",
"overloads": [
{
- "line": 794,
+ "line": 797,
"params": [
{
"name": "path",
"description": "name of the file or url to load
\n",
"type": "String"
},
- {
- "name": "method",
- "description": "either "GET", "POST", or "PUT",\n defaults to "GET"
\n",
- "type": "String",
- "optional": true
- },
{
"name": "datatype",
- "description": ""json", "jsonp", "xml", or "text"
\n",
+ "description": ""json", "jsonp", "binary", "arrayBuffer",\n "xml", or "text"
\n",
"type": "String",
"optional": true
},
{
"name": "data",
"description": "param data passed sent with request
\n",
- "type": "Object",
+ "type": "Object|Boolean",
"optional": true
},
{
"name": "callback",
- "description": "function to be executed after\n httpGet() completes, data is passed in\n as first argument
\n",
+ "description": "function to be executed after\n httpGet() completes, data is passed in\n as first argument
\n",
"type": "Function",
"optional": true
},
@@ -10295,10 +11118,14 @@ module.exports={
"type": "Function",
"optional": true
}
- ]
+ ],
+ "return": {
+ "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.",
+ "type": "Promise"
+ }
},
{
- "line": 865,
+ "line": 851,
"params": [
{
"name": "path",
@@ -10306,9 +11133,9 @@ module.exports={
"type": "String"
},
{
- "name": "options",
- "description": "Request object options as documented in the\n "fetch" API\nreference
\n",
- "type": "Object"
+ "name": "data",
+ "description": "",
+ "type": "Object|Boolean"
},
{
"name": "callback",
@@ -10322,139 +11149,382 @@ module.exports={
"type": "Function",
"optional": true
}
- ]
- }
- ]
- },
- {
- "file": "src/io/files.js",
- "line": 1077,
- "description": "Save an image, text, json, csv, wav, or html. Prompts download to\nthe client's computer. Note that it is not recommended to call save()\nwithin draw if it's looping, as the save() function will open a new save\ndialog every frame.
\nThe default behavior is to save the canvas as an image. You can\noptionally specify a filename.\nFor example:
\n\nsave();\nsave('myCanvas.jpg'); // save a specific canvas with a filename\n
\n\nAlternately, the first parameter can be a pointer to a canvas\np5.Element, an Array of Strings,\nan Array of JSON, a JSON object, a p5.Table, a p5.Image, or a\np5.SoundFile (requires p5.sound). The second parameter is a filename\n(including extension). The third parameter is for options specific\nto this type of object. This method will save a file that fits the\ngiven paramaters. For example:
\n\n\n\nsave('myCanvas.jpg'); // Saves canvas as an image\n\nvar cnv = createCanvas(100, 100);\nsave(cnv, 'myCanvas.jpg'); // Saves canvas as an image\n\nvar gb = createGraphics(100, 100);\nsave(gb, 'myGraphics.jpg'); // Saves p5.Renderer object as an image\n\nsave(myTable, 'myTable.html'); // Saves table as html file\nsave(myTable, 'myTable.csv',); // Comma Separated Values\nsave(myTable, 'myTable.tsv'); // Tab Separated Values\n\nsave(myJSON, 'my.json'); // Saves pretty JSON\nsave(myJSON, 'my.json', true); // Optimizes JSON filesize\n\nsave(img, 'my.png'); // Saves pImage as a png image\n\nsave(arrayOfStrings, 'my.txt'); // Saves strings to a text file with line\n // breaks after each item in the array\n
",
- "itemtype": "method",
- "name": "save",
- "params": [
- {
- "name": "objectOrFilename",
- "description": "If filename is provided, will\n save canvas as an image with\n either png or jpg extension\n depending on the filename.\n If object is provided, will\n save depending on the object\n and filename (see examples\n above).
\n",
- "type": "Object|String",
- "optional": true
+ ],
+ "return": {
+ "description": "",
+ "type": "Promise"
+ }
},
{
- "name": "filename",
- "description": "If an object is provided as the first\n parameter, then the second parameter\n indicates the filename,\n and should include an appropriate\n file extension (see examples above).
\n",
- "type": "String",
- "optional": true
+ "line": 859,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function"
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Promise"
+ }
+ }
+ ]
+ },
+ {
+ "file": "src/io/files.js",
+ "line": 874,
+ "description": "Method for executing an HTTP POST request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'POST').
\n",
+ "itemtype": "method",
+ "name": "httpPost",
+ "return": {
+ "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.",
+ "type": "Promise"
+ },
+ "example": [
+ "\n\n\n// Examples use jsonplaceholder.typicode.com for a Mock Data API\n\nvar url = 'https://jsonplaceholder.typicode.com/posts';\nvar postData = { userId: 1, title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\nfunction setup() {\n createCanvas(800, 800);\n}\n\nfunction mousePressed() {\n // Pick new random color values\n var r = random(255);\n var g = random(255);\n var b = random(255);\n\n httpPost(url, 'json', postData, function(result) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n ellipse(mouseX, mouseY, 200, 200);\n text(result.body, mouseX, mouseY);\n });\n}\n\n\n\n\n\nvar url = 'https://invalidURL'; // A bad URL that will cause errors\nvar postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\nfunction setup() {\n createCanvas(800, 800);\n}\n\nfunction mousePressed() {\n // Pick new random color values\n var r = random(255);\n var g = random(255);\n var b = random(255);\n\n httpPost(\n url,\n 'json',\n postData,\n function(result) {\n // ... won't be called\n },\n function(error) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n text(error.toString(), mouseX, mouseY);\n }\n );\n}\n\n"
+ ],
+ "class": "p5",
+ "module": "IO",
+ "submodule": "Input",
+ "overloads": [
+ {
+ "line": 874,
+ "params": [
+ {
+ "name": "path",
+ "description": "name of the file or url to load
\n",
+ "type": "String"
+ },
+ {
+ "name": "datatype",
+ "description": ""json", "jsonp", "xml", or "text".\n If omitted, httpPost() will guess.
\n",
+ "type": "String",
+ "optional": true
+ },
+ {
+ "name": "data",
+ "description": "param data passed sent with request
\n",
+ "type": "Object|Boolean",
+ "optional": true
+ },
+ {
+ "name": "callback",
+ "description": "function to be executed after\n httpPost() completes, data is passed in\n as first argument
\n",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.",
+ "type": "Promise"
+ }
},
{
- "name": "options",
- "description": "Additional options depend on\n filetype. For example, when saving JSON,\n true indicates that the\n output will be optimized for filesize,\n rather than readability.
\n",
- "type": "Boolean|String",
- "optional": true
+ "line": 956,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "data",
+ "description": "",
+ "type": "Object|Boolean"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Promise"
+ }
+ },
+ {
+ "line": 964,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function"
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Promise"
+ }
}
+ ]
+ },
+ {
+ "file": "src/io/files.js",
+ "line": 979,
+ "description": "Method for executing an HTTP request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text.
\nFor more advanced use, you may also pass in the path as the first argument\nand a object as the second argument, the signature follows the one specified\nin the Fetch API specification.\nThis method is suitable for fetching files up to size of 64MB when "GET" is used.
\n",
+ "itemtype": "method",
+ "name": "httpDo",
+ "return": {
+ "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.",
+ "type": "Promise"
+ },
+ "example": [
+ "\n\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\n\n// displays an animation of all USGS earthquakes\nvar earthquakes;\nvar eqFeatureIndex = 0;\n\nfunction preload() {\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';\n httpDo(\n url,\n {\n method: 'GET',\n // Other Request options, like special headers for apis\n headers: { authorization: 'Bearer secretKey' }\n },\n function(res) {\n earthquakes = res;\n }\n );\n}\n\nfunction draw() {\n // wait until the data is loaded\n if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {\n return;\n }\n clear();\n\n var feature = earthquakes.features[eqFeatureIndex];\n var mag = feature.properties.mag;\n var rad = mag / 11 * ((width + height) / 2);\n fill(255, 0, 0, 100);\n ellipse(width / 2 + random(-2, 2), height / 2 + random(-2, 2), rad, rad);\n\n if (eqFeatureIndex >= earthquakes.features.length) {\n eqFeatureIndex = 0;\n } else {\n eqFeatureIndex += 1;\n }\n}\n\n"
],
"class": "p5",
"module": "IO",
- "submodule": "Output"
+ "submodule": "Input",
+ "overloads": [
+ {
+ "line": 979,
+ "params": [
+ {
+ "name": "path",
+ "description": "name of the file or url to load
\n",
+ "type": "String"
+ },
+ {
+ "name": "method",
+ "description": "either "GET", "POST", or "PUT",\n defaults to "GET"
\n",
+ "type": "String",
+ "optional": true
+ },
+ {
+ "name": "datatype",
+ "description": ""json", "jsonp", "xml", or "text"
\n",
+ "type": "String",
+ "optional": true
+ },
+ {
+ "name": "data",
+ "description": "param data passed sent with request
\n",
+ "type": "Object",
+ "optional": true
+ },
+ {
+ "name": "callback",
+ "description": "function to be executed after\n httpGet() completes, data is passed in\n as first argument
\n",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "function to be executed if\n there is an error, response is passed\n in as first argument
\n",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.",
+ "type": "Promise"
+ }
+ },
+ {
+ "line": 1050,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "options",
+ "description": "Request object options as documented in the\n "fetch" API\nreference
\n",
+ "type": "Object"
+ },
+ {
+ "name": "callback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Promise"
+ }
+ }
+ ]
},
{
"file": "src/io/files.js",
- "line": 1194,
- "description": "Writes the contents of an Array or a JSON object to a .json file.\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",
+ "line": 1203,
"itemtype": "method",
- "name": "saveJSON",
+ "name": "createWriter",
"params": [
{
- "name": "json",
- "description": "",
- "type": "Array|Object"
- },
- {
- "name": "filename",
- "description": "",
+ "name": "name",
+ "description": "name of the file to be created
\n",
"type": "String"
},
{
- "name": "optimize",
- "description": "If true, removes line breaks\n and spaces from the output\n file to optimize filesize\n (but not readability).
\n",
- "type": "Boolean",
+ "name": "extension",
+ "description": "",
+ "type": "String",
"optional": true
}
],
+ "return": {
+ "description": "",
+ "type": "p5.PrintWriter"
+ },
"example": [
- "\n\nvar json;\n\nfunction setup() {\n\n json = {}; // new JSON Object\n\n json.id = 0;\n json.species = 'Panthera leo';\n json.name = 'Lion';\n\n// To save, un-comment the line below, then click 'run'\n// saveJSON(json, 'lion.json');\n}\n\n// Saves the following to a file called \"lion.json\":\n// {\n// \"id\": 0,\n// \"species\": \"Panthera leo\",\n// \"name\": \"Lion\"\n// }\n"
+ "\n\n\ncreateButton('save')\n .position(10, 10)\n .mousePressed(function() {\n var writer = createWriter('squares.txt');\n for (var i = 0; i < 10; i++) {\n writer.print(i * i);\n }\n writer.close();\n writer.clear();\n });\n\n"
],
- "alt": "no image displayed",
"class": "p5",
"module": "IO",
"submodule": "Output"
},
{
"file": "src/io/files.js",
- "line": 1248,
- "description": "Writes an array of Strings to a text file, one line per String.\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",
+ "line": 1252,
+ "description": "Writes data to the PrintWriter stream
\n",
"itemtype": "method",
- "name": "saveStrings",
+ "name": "write",
"params": [
{
- "name": "list",
- "description": "string array to be written
\n",
+ "name": "data",
+ "description": "all data to be written by the PrintWriter
\n",
"type": "Array"
- },
+ }
+ ],
+ "example": [
+ "\n\n\n// creates a file called 'newFile.txt'\nvar writer = createWriter('newFile.txt');\n// write 'Hello world!'' to the file\nwriter.write(['Hello world!']);\n// close the PrintWriter and save the file\nwriter.close();\n\n\n\n\n// creates a file called 'newFile2.txt'\nvar writer = createWriter('newFile2.txt');\n// write 'apples,bananas,123' to the file\nwriter.write(['apples', 'bananas', 123]);\n// close the PrintWriter and save the file\nwriter.close();\n\n\n\n\n// creates a file called 'newFile3.txt'\nvar writer = createWriter('newFile3.txt');\n// write 'My name is: Teddy' to the file\nwriter.write('My name is:');\nwriter.write(' Teddy');\n// close the PrintWriter and save the file\nwriter.close();\n\n"
+ ],
+ "class": "p5.PrintWriter",
+ "module": "IO",
+ "submodule": "Output"
+ },
+ {
+ "file": "src/io/files.js",
+ "line": 1292,
+ "description": "Writes data to the PrintWriter stream, and adds a new line at the end
\n",
+ "itemtype": "method",
+ "name": "print",
+ "params": [
{
- "name": "filename",
- "description": "filename for output
\n",
- "type": "String"
+ "name": "data",
+ "description": "all data to be printed by the PrintWriter
\n",
+ "type": "Array"
}
],
"example": [
- "\n\nvar words = 'apple bear cat dog';\n\n// .split() outputs an Array\nvar list = split(words, ' ');\n\n// To save the file, un-comment next line and click 'run'\n// saveStrings(list, 'nouns.txt');\n\n// Saves the following to a file called 'nouns.txt':\n//\n// apple\n// bear\n// cat\n// dog\n"
+ "\n\n\n// creates a file called 'newFile.txt'\nvar writer = createWriter('newFile.txt');\n// creates a file containing\n// My name is:\n// Teddy\nwriter.print('My name is:');\nwriter.print('Teddy');\n// close the PrintWriter and save the file\nwriter.close();\n\n\n\n\nvar writer;\n\nfunction setup() {\n createCanvas(400, 400);\n // create a PrintWriter\n writer = createWriter('newFile.txt');\n}\n\nfunction draw() {\n // print all mouseX and mouseY coordinates to the stream\n writer.print([mouseX, mouseY]);\n}\n\nfunction mouseClicked() {\n // close the PrintWriter and save the file\n writer.close();\n}\n\n"
],
- "alt": "no image displayed",
- "class": "p5",
+ "class": "p5.PrintWriter",
"module": "IO",
"submodule": "Output"
},
{
"file": "src/io/files.js",
- "line": 1306,
- "description": "Writes the contents of a Table object to a file. Defaults to a\ntext file with comma-separated-values ('csv') but can also\nuse tab separation ('tsv'), or generate an HTML table ('html').\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",
+ "line": 1335,
+ "description": "Clears the data already written to the PrintWriter object
\n",
"itemtype": "method",
- "name": "saveTable",
+ "name": "clear",
+ "example": [
+ "\n\n// create writer object\nvar writer = createWriter('newFile.txt');\nwriter.write(['clear me']);\n// clear writer object here\nwriter.clear();\n// close writer\nwriter.close();\n\n"
+ ],
+ "class": "p5.PrintWriter",
+ "module": "IO",
+ "submodule": "Output"
+ },
+ {
+ "file": "src/io/files.js",
+ "line": 1353,
+ "description": "Closes the PrintWriter
\n",
+ "itemtype": "method",
+ "name": "close",
+ "example": [
+ "\n\n\n// create a file called 'newFile.txt'\nvar writer = createWriter('newFile.txt');\n// close the PrintWriter and save the file\nwriter.close();\n\n\n\n\n// create a file called 'newFile2.txt'\nvar writer = createWriter('newFile2.txt');\n// write some data to the file\nwriter.write([100, 101, 102]);\n// close the PrintWriter and save the file\nwriter.close();\n\n"
+ ],
+ "class": "p5.PrintWriter",
+ "module": "IO",
+ "submodule": "Output"
+ },
+ {
+ "file": "src/io/files.js",
+ "line": 1402,
+ "description": "Save an image, text, json, csv, wav, or html. Prompts download to\nthe client's computer. Note that it is not recommended to call save()\nwithin draw if it's looping, as the save() function will open a new save\ndialog every frame.
\nThe default behavior is to save the canvas as an image. You can\noptionally specify a filename.\nFor example:
\n \n save();\n save('myCanvas.jpg'); // save a specific canvas with a filename\n
\n\nAlternately, the first parameter can be a pointer to a canvas\np5.Element, an Array of Strings,\nan Array of JSON, a JSON object, a p5.Table, a p5.Image, or a\np5.SoundFile (requires p5.sound). The second parameter is a filename\n(including extension). The third parameter is for options specific\nto this type of object. This method will save a file that fits the\ngiven paramaters. For example:
\n\n \n // Saves canvas as an image\n save('myCanvas.jpg');\n\n // Saves pImage as a png image\n var img = createImage(10, 10);\n save(img, 'my.png');\n\n // Saves canvas as an image\n var cnv = createCanvas(100, 100);\n save(cnv, 'myCanvas.jpg');\n\n // Saves p5.Renderer object as an image\n var gb = createGraphics(100, 100);\n save(gb, 'myGraphics.jpg');\n\n var myTable = new p5.Table();\n\n // Saves table as html file\n save(myTable, 'myTable.html');\n\n // Comma Separated Values\n save(myTable, 'myTable.csv');\n\n // Tab Separated Values\n save(myTable, 'myTable.tsv');\n\n var myJSON = { a: 1, b: true };\n\n // Saves pretty JSON\n save(myJSON, 'my.json');\n\n // Optimizes JSON filesize\n save(myJSON, 'my.json', true);\n\n // Saves array of strings to a text file with line breaks after each item\n var arrayOfStrings = ['a', 'b'];\n save(arrayOfStrings, 'my.txt');\n
",
+ "itemtype": "method",
+ "name": "save",
"params": [
{
- "name": "Table",
- "description": "the Table object to save to a file
\n",
- "type": "p5.Table"
+ "name": "objectOrFilename",
+ "description": "If filename is provided, will\n save canvas as an image with\n either png or jpg extension\n depending on the filename.\n If object is provided, will\n save depending on the object\n and filename (see examples\n above).
\n",
+ "type": "Object|String",
+ "optional": true
},
{
"name": "filename",
- "description": "the filename to which the Table should be saved
\n",
- "type": "String"
+ "description": "If an object is provided as the first\n parameter, then the second parameter\n indicates the filename,\n and should include an appropriate\n file extension (see examples above).
\n",
+ "type": "String",
+ "optional": true
},
{
"name": "options",
- "description": "can be one of "tsv", "csv", or "html"
\n",
- "type": "String",
+ "description": "Additional options depend on\n filetype. For example, when saving JSON,\n true indicates that the\n output will be optimized for filesize,\n rather than readability.
\n",
+ "type": "Boolean|String",
"optional": true
}
],
- "example": [
- "\n\nvar table;\n\nfunction setup() {\n table = new p5.Table();\n\n table.addColumn('id');\n table.addColumn('species');\n table.addColumn('name');\n\n var newRow = table.addRow();\n newRow.setNum('id', table.getRowCount() - 1);\n newRow.setString('species', 'Panthera leo');\n newRow.setString('name', 'Lion');\n\n // To save, un-comment next line then click 'run'\n // saveTable(table, 'new.csv');\n }\n\n // Saves the following to a file called 'new.csv':\n // id,species,name\n // 0,Panthera leo,Lion\n"
- ],
- "alt": "no image displayed",
"class": "p5",
"module": "IO",
"submodule": "Output"
},
{
"file": "src/io/files.js",
- "line": 1433,
- "description": "Generate a blob of file data as a url to prepare for download.\nAccepts an array of data, a filename, and an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.
\n",
+ "line": 1530,
+ "description": "Writes the contents of an Array or a JSON object to a .json file.\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",
+ "itemtype": "method",
+ "name": "saveJSON",
"params": [
{
- "name": "dataToDownload",
+ "name": "json",
"description": "",
- "type": "Array"
+ "type": "Array|Object"
},
{
"name": "filename",
@@ -10462,98 +11532,95 @@ module.exports={
"type": "String"
},
{
- "name": "extension",
- "description": "",
- "type": "[String]"
+ "name": "optimize",
+ "description": "If true, removes line breaks\n and spaces from the output\n file to optimize filesize\n (but not readability).
\n",
+ "type": "Boolean",
+ "optional": true
}
],
- "access": "private",
- "tagname": "",
+ "example": [
+ "\n \n var json = {}; // new JSON Object\n\n json.id = 0;\n json.species = 'Panthera leo';\n json.name = 'Lion';\n\n createButton('save')\n .position(10, 10)\n .mousePressed(function() {\n saveJSON(json, 'lion.json');\n });\n\n // saves the following to a file called \"lion.json\":\n // {\n // \"id\": 0,\n // \"species\": \"Panthera leo\",\n // \"name\": \"Lion\"\n // }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5",
"module": "IO",
"submodule": "Output"
},
{
"file": "src/io/files.js",
- "line": 1456,
- "description": "Forces download. Accepts a url to filedata/blob, a filename,\nand an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.
\n",
+ "line": 1582,
+ "description": "Writes an array of Strings to a text file, one line per String.\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",
+ "itemtype": "method",
+ "name": "saveStrings",
"params": [
{
- "name": "href",
- "description": "i.e. an href generated by createObjectURL
\n",
- "type": "String"
+ "name": "list",
+ "description": "string array to be written
\n",
+ "type": "String[]"
},
{
"name": "filename",
- "description": "",
- "type": "[String]"
+ "description": "filename for output
\n",
+ "type": "String"
},
{
"name": "extension",
- "description": "",
- "type": "[String]"
+ "description": "the filename's extension
\n",
+ "type": "String",
+ "optional": true
}
],
+ "example": [
+ "\n \n var words = 'apple bear cat dog';\n\n // .split() outputs an Array\n var list = split(words, ' ');\n\n createButton('save')\n .position(10, 10)\n .mousePressed(function() {\n saveStrings(list, 'nouns.txt');\n });\n\n // Saves the following to a file called 'nouns.txt':\n //\n // apple\n // bear\n // cat\n // dog\n "
+ ],
+ "alt": "no image displayed",
"class": "p5",
"module": "IO",
"submodule": "Output"
},
{
"file": "src/io/files.js",
- "line": 1496,
- "description": "Returns a file extension, or another string\nif the provided parameter has no extension.
\n",
+ "line": 1644,
+ "description": "Writes the contents of a Table object to a file. Defaults to a\ntext file with comma-separated-values ('csv') but can also\nuse tab separation ('tsv'), or generate an HTML table ('html').\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",
+ "itemtype": "method",
+ "name": "saveTable",
"params": [
+ {
+ "name": "Table",
+ "description": "the Table object to save to a file
\n",
+ "type": "p5.Table"
+ },
{
"name": "filename",
- "description": "",
+ "description": "the filename to which the Table should be saved
\n",
"type": "String"
+ },
+ {
+ "name": "options",
+ "description": "can be one of "tsv", "csv", or "html"
\n",
+ "type": "String",
+ "optional": true
}
],
- "return": {
- "description": "[fileName, fileExtension]",
- "type": "String[]"
- },
- "access": "private",
- "tagname": "",
- "class": "p5",
- "module": "IO",
- "submodule": "Output"
- },
- {
- "file": "src/io/files.js",
- "line": 1528,
- "description": "Returns true if the browser is Safari, false if not.\nSafari makes trouble for downloading files.
\n",
- "return": {
- "description": "[description]",
- "type": "Boolean"
- },
- "access": "private",
- "tagname": "",
- "class": "p5",
- "module": "IO",
- "submodule": "Output"
- },
- {
- "file": "src/io/files.js",
- "line": 1540,
- "description": "Helper function, a callback for download that deletes\nan invisible anchor element from the DOM once the file\nhas been automatically downloaded.
\n",
- "access": "private",
- "tagname": "",
+ "example": [
+ "\n\n var table;\n\n function setup() {\n table = new p5.Table();\n\n table.addColumn('id');\n table.addColumn('species');\n table.addColumn('name');\n\n var newRow = table.addRow();\n newRow.setNum('id', table.getRowCount() - 1);\n newRow.setString('species', 'Panthera leo');\n newRow.setString('name', 'Lion');\n\n // To save, un-comment next line then click 'run'\n // saveTable(table, 'new.csv');\n }\n\n // Saves the following to a file called 'new.csv':\n // id,species,name\n // 0,Panthera leo,Lion\n "
+ ],
+ "alt": "no image displayed",
"class": "p5",
"module": "IO",
"submodule": "Output"
},
{
"file": "src/io/p5.Table.js",
- "line": 12,
- "description": "Table Options
\nGeneric class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.
\nCSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.
\nFile names should end with .csv if they're comma separated.
\nA rough "spec" for CSV can be found\nhere.
\nTo load files, use the loadTable method.
\nTo save tables to your computer, use the save method\n or the saveTable method.
\n\nPossible options include:
\n\n- csv - parse the table as comma-separated values\n
- tsv - parse the table as tab-separated values\n
- header - this table has a header (title) row\n
",
+ "line": 11,
+ "description": "Table Options
\nGeneric class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.
\nCSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.
\nFile names should end with .csv if they're comma separated.
\nA rough "spec" for CSV can be found\nhere.
\nTo load files, use the loadTable method.
\nTo save tables to your computer, use the save method\n or the saveTable method.
\n\nPossible options include:
\n\n- csv - parse the table as comma-separated values\n
- tsv - parse the table as tab-separated values\n
- header - this table has a header (title) row\n
",
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 46,
+ "line": 45,
"itemtype": "property",
"name": "columns",
"type": "String[]",
@@ -10563,7 +11630,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 51,
+ "line": 50,
"itemtype": "property",
"name": "rows",
"type": "p5.TableRow[]",
@@ -10573,8 +11640,8 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 58,
- "description": "Use addRow() to add a new row of data to a p5.Table object. By default,\nan empty row is created. Typically, you would store a reference to\nthe new row in a TableRow object (see newRow in the example above),\nand then set individual values using set().
\nIf a p5.TableRow object is included as a parameter, then that row is\nduplicated and added to the table.
\n",
+ "line": 56,
+ "description": "Use addRow() to add a new row of data to a p5.Table object. By default,\nan empty row is created. Typically, you would store a reference to\nthe new row in a TableRow object (see newRow in the example above),\nand then set individual values using set().
\nIf a p5.TableRow object is included as a parameter, then that row is\nduplicated and added to the table.
\n",
"itemtype": "method",
"name": "addRow",
"params": [
@@ -10585,8 +11652,12 @@ module.exports={
"optional": true
}
],
+ "return": {
+ "description": "the row that was added",
+ "type": "p5.TableRow"
+ },
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n //add a row\n var newRow = table.addRow();\n newRow.setString(\"id\", table.getRowCount() - 1);\n newRow.setString(\"species\", \"Canis Lupus\");\n newRow.setString(\"name\", \"Wolf\");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //add a row\n var newRow = table.addRow();\n newRow.setString('id', table.getRowCount() - 1);\n newRow.setString('species', 'Canis Lupus');\n newRow.setString('name', 'Wolf');\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10595,7 +11666,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 121,
+ "line": 120,
"description": "Removes a row from the table object.
\n",
"itemtype": "method",
"name": "removeRow",
@@ -10603,11 +11674,11 @@ module.exports={
{
"name": "id",
"description": "ID number of the row to remove
\n",
- "type": "Number"
+ "type": "Integer"
}
],
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n //remove the first row\n var r = table.removeRow(0);\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n //remove the first row\n table.removeRow(0);\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10616,23 +11687,23 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 170,
- "description": "Returns a reference to the specified p5.TableRow. The reference\ncan then be used to get and set values of the selected row.
\n",
+ "line": 168,
+ "description": "Returns a reference to the specified p5.TableRow. The reference\ncan then be used to get and set values of the selected row.
\n",
"itemtype": "method",
"name": "getRow",
"params": [
{
"name": "rowID",
"description": "ID number of the row to get
\n",
- "type": "Number"
+ "type": "Integer"
}
],
"return": {
- "description": "p5.TableRow object",
+ "description": "p5.TableRow object",
"type": "p5.TableRow"
},
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n var row = table.getRow(1);\n //print it column by column\n //note: a row is an object, not an array\n for (var c = 0; c < table.getColumnCount(); c++)\n print(row.getString(c));\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n var row = table.getRow(1);\n //print it column by column\n //note: a row is an object, not an array\n for (var c = 0; c < table.getColumnCount(); c++) {\n print(row.getString(c));\n }\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10641,16 +11712,16 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 215,
- "description": "Gets all rows from the table. Returns an array of p5.TableRows.
\n",
+ "line": 214,
+ "description": "Gets all rows from the table. Returns an array of p5.TableRows.
\n",
"itemtype": "method",
"name": "getRows",
"return": {
- "description": "Array of p5.TableRows",
+ "description": "Array of p5.TableRows",
"type": "p5.TableRow[]"
},
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n var rows = table.getRows();\n\n //warning: rows is an array of objects\n for (var r = 0; r < rows.length; r++)\n rows[r].set(\"name\", \"Unicorn\");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var rows = table.getRows();\n\n //warning: rows is an array of objects\n for (var r = 0; r < rows.length; r++) {\n rows[r].set('name', 'Unicorn');\n }\n\n //print the results\n for (r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10672,7 +11743,7 @@ module.exports={
{
"name": "column",
"description": "ID number or title of the\n column to search
\n",
- "type": "Number|String"
+ "type": "Integer|String"
}
],
"return": {
@@ -10680,7 +11751,7 @@ module.exports={
"type": "p5.TableRow"
},
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n //find the animal named zebra\n var row = table.findRow(\"Zebra\", \"name\");\n //find the corresponding species\n print(row.getString(\"species\"));\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //find the animal named zebra\n var row = table.findRow('Zebra', 'name');\n //find the corresponding species\n print(row.getString('species'));\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10689,7 +11760,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 329,
+ "line": 328,
"description": "Finds the rows in the Table that contain the value\nprovided, and returns references to those rows. Returns an\nArray, so for must be used to iterate through all the rows,\nas shown in the example above. The column to search may be\nspecified by either its ID or title.
\n",
"itemtype": "method",
"name": "findRows",
@@ -10702,7 +11773,7 @@ module.exports={
{
"name": "column",
"description": "ID number or title of the\n column to search
\n",
- "type": "Number|String"
+ "type": "Integer|String"
}
],
"return": {
@@ -10710,7 +11781,7 @@ module.exports={
"type": "p5.TableRow[]"
},
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n //add another goat\n var newRow = table.addRow();\n newRow.setString(\"id\", table.getRowCount() - 1);\n newRow.setString(\"species\", \"Scape Goat\");\n newRow.setString(\"name\", \"Goat\");\n\n //find the rows containing animals named Goat\n var rows = table.findRows(\"Goat\", \"name\");\n print(rows.length + \" Goats found\");\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //add another goat\n var newRow = table.addRow();\n newRow.setString('id', table.getRowCount() - 1);\n newRow.setString('species', 'Scape Goat');\n newRow.setString('name', 'Goat');\n\n //find the rows containing animals named Goat\n var rows = table.findRows('Goat', 'name');\n print(rows.length + ' Goats found');\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10719,7 +11790,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 399,
+ "line": 397,
"description": "Finds the first row in the Table that matches the regular\nexpression provided, and returns a reference to that row.\nEven if multiple rows are possible matches, only the first\nmatching row is returned. The column to search may be\nspecified by either its ID or title.
\n",
"itemtype": "method",
"name": "matchRow",
@@ -10727,25 +11798,28 @@ module.exports={
{
"name": "regexp",
"description": "The regular expression to match
\n",
- "type": "String"
+ "type": "String|RegExp"
},
{
"name": "column",
"description": "The column ID (number) or\n title (string)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
"description": "TableRow object",
"type": "p5.TableRow"
},
+ "example": [
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n //Search using specified regex on a given column, return TableRow object\n var mammal = table.matchRow(new RegExp('ant'), 1);\n print(mammal.getString(1));\n //Output \"Panthera pardus\"\n}\n\n\n"
+ ],
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 431,
+ "line": 456,
"description": "Finds the rows in the Table that match the regular expression provided,\nand returns references to those rows. Returns an array, so for must be\nused to iterate through all the rows, as shown in the example. The\ncolumn to search may be specified by either its ID or title.
\n",
"itemtype": "method",
"name": "matchRows",
@@ -10758,7 +11832,7 @@ module.exports={
{
"name": "column",
"description": "The column ID (number) or\n title (string)
\n",
- "type": "String|Number",
+ "type": "String|Integer",
"optional": true
}
],
@@ -10767,7 +11841,7 @@ module.exports={
"type": "p5.TableRow[]"
},
"example": [
- "\nvar table;\n\nfunction setup() {\n\n table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n var newRow = table.addRow();\n newRow.setString('name', 'Lion');\n newRow.setString('type', 'Mammal');\n\n newRow = table.addRow();\n newRow.setString('name', 'Snake');\n newRow.setString('type', 'Reptile');\n\n newRow = table.addRow();\n newRow.setString('name', 'Mosquito');\n newRow.setString('type', 'Insect');\n\n newRow = table.addRow();\n newRow.setString('name', 'Lizard');\n newRow.setString('type', 'Reptile');\n\n var rows = table.matchRows('R.*', 'type');\n for (var i = 0; i < rows.length; i++) {\n print(rows[i].getString('name') + ': ' + rows[i].getString('type'));\n }\n}\n// Sketch prints:\n// Snake: Reptile\n// Lizard: Reptile"
+ "\n\n\nvar table;\n\nfunction setup() {\n table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n var newRow = table.addRow();\n newRow.setString('name', 'Lion');\n newRow.setString('type', 'Mammal');\n\n newRow = table.addRow();\n newRow.setString('name', 'Snake');\n newRow.setString('type', 'Reptile');\n\n newRow = table.addRow();\n newRow.setString('name', 'Mosquito');\n newRow.setString('type', 'Insect');\n\n newRow = table.addRow();\n newRow.setString('name', 'Lizard');\n newRow.setString('type', 'Reptile');\n\n var rows = table.matchRows('R.*', 'type');\n for (var i = 0; i < rows.length; i++) {\n print(rows[i].getString('name') + ': ' + rows[i].getString('type'));\n }\n}\n// Sketch prints:\n// Snake: Reptile\n// Lizard: Reptile\n\n"
],
"class": "p5.Table",
"module": "IO",
@@ -10775,7 +11849,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 498,
+ "line": 523,
"description": "Retrieves all values in the specified column, and returns them\nas an array. The column may be specified by either its ID or title.
\n",
"itemtype": "method",
"name": "getColumn",
@@ -10791,7 +11865,7 @@ module.exports={
"type": "Array"
},
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n //getColumn returns an array that can be printed directly\n print(table.getColumn(\"species\"));\n //outputs [\"Capra hircus\", \"Panthera pardus\", \"Equus zebra\"]\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //getColumn returns an array that can be printed directly\n print(table.getColumn('species'));\n //outputs [\"Capra hircus\", \"Panthera pardus\", \"Equus zebra\"]\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10800,12 +11874,12 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 551,
+ "line": 576,
"description": "Removes all rows from a Table. While all rows are removed,\ncolumns and column titles are maintained.
\n",
"itemtype": "method",
"name": "clearRows",
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n table.clearRows();\n print(table.getRowCount() + \" total rows in table\");\n print(table.getColumnCount() + \" total columns in table\");\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n table.clearRows();\n print(table.getRowCount() + ' total rows in table');\n print(table.getColumnCount() + ' total columns in table');\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10814,8 +11888,8 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 593,
- "description": "Use addColumn() to add a new column to a Table object.\nTypically, you will want to specify a title, so the column\nmay be easily referenced later by name. (If no title is\nspecified, the new column's title will be null.)
\n",
+ "line": 618,
+ "description": "Use addColumn() to add a new column to a Table object.\nTypically, you will want to specify a title, so the column\nmay be easily referenced later by name. (If no title is\nspecified, the new column's title will be null.)
\n",
"itemtype": "method",
"name": "addColumn",
"params": [
@@ -10827,7 +11901,7 @@ module.exports={
}
],
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n table.addColumn(\"carnivore\");\n table.set(0, \"carnivore\", \"no\");\n table.set(1, \"carnivore\", \"yes\");\n table.set(2, \"carnivore\", \"no\");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n table.addColumn('carnivore');\n table.set(0, 'carnivore', 'no');\n table.set(1, 'carnivore', 'yes');\n table.set(2, 'carnivore', 'no');\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10836,33 +11910,41 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 644,
+ "line": 669,
"description": "Returns the total number of columns in a Table.
\n",
+ "itemtype": "method",
+ "name": "getColumnCount",
"return": {
"description": "Number of columns in this table",
- "type": "Number"
+ "type": "Integer"
},
+ "example": [
+ "\n \n \n // given the cvs file \"blobs.csv\" in /assets directory\n // ID, Name, Flavor, Shape, Color\n // Blob1, Blobby, Sweet, Blob, Pink\n // Blob2, Saddy, Savory, Blob, Blue\n\n var table;\n\n function preload() {\n table = loadTable('assets/blobs.csv');\n }\n\n function setup() {\n createCanvas(200, 100);\n textAlign(CENTER);\n background(255);\n }\n\n function draw() {\n var numOfColumn = table.getColumnCount();\n text('There are ' + numOfColumn + ' columns in the table.', 100, 50);\n }\n \n "
+ ],
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 653,
+ "line": 705,
"description": "Returns the total number of rows in a Table.
\n",
"itemtype": "method",
"name": "getRowCount",
"return": {
"description": "Number of rows in this table",
- "type": "Number"
+ "type": "Integer"
},
+ "example": [
+ "\n \n \n // given the cvs file \"blobs.csv\" in /assets directory\n //\n // ID, Name, Flavor, Shape, Color\n // Blob1, Blobby, Sweet, Blob, Pink\n // Blob2, Saddy, Savory, Blob, Blue\n\n var table;\n\n function preload() {\n table = loadTable('assets/blobs.csv');\n }\n\n function setup() {\n createCanvas(200, 100);\n textAlign(CENTER);\n background(255);\n }\n\n function draw() {\n text('There are ' + table.getRowCount() + ' rows in the table.', 100, 50);\n }\n \n "
+ ],
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 664,
+ "line": 741,
"description": "Removes any of the specified characters (or "tokens").
\n\nIf no column is specified, then the values in all columns and\nrows are processed. A specific column may be referenced by\neither its ID or title.
",
"itemtype": "method",
"name": "removeTokens",
@@ -10875,17 +11957,20 @@ module.exports={
{
"name": "column",
"description": "Column ID (number)\n or name (string)
\n",
- "type": "String|Number",
+ "type": "String|Integer",
"optional": true
}
],
+ "example": [
+ "\n \n function setup() {\n var table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n var newRow = table.addRow();\n newRow.setString('name', ' $Lion ,');\n newRow.setString('type', ',,,Mammal');\n\n newRow = table.addRow();\n newRow.setString('name', '$Snake ');\n newRow.setString('type', ',,,Reptile');\n\n table.removeTokens(',$ ');\n print(table.getArray());\n }\n\n // prints:\n // 0 \"Lion\" \"Mamal\"\n // 1 \"Snake\" \"Reptile\"\n "
+ ],
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 715,
+ "line": 815,
"description": "Trims leading and trailing whitespace, such as spaces and tabs,\nfrom String table values. If no column is specified, then the\nvalues in all columns and rows are trimmed. A specific column\nmay be referenced by either its ID or title.
\n",
"itemtype": "method",
"name": "trim",
@@ -10893,28 +11978,32 @@ module.exports={
{
"name": "column",
"description": "Column ID (number)\n or name (string)
\n",
- "type": "String|Number"
+ "type": "String|Integer",
+ "optional": true
}
],
+ "example": [
+ "\n \n function setup() {\n var table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n var newRow = table.addRow();\n newRow.setString('name', ' Lion ,');\n newRow.setString('type', ' Mammal ');\n\n newRow = table.addRow();\n newRow.setString('name', ' Snake ');\n newRow.setString('type', ' Reptile ');\n\n table.trim();\n print(table.getArray());\n }\n\n // prints:\n // 0 \"Lion\" \"Mamal\"\n // 1 \"Snake\" \"Reptile\"\n "
+ ],
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 757,
- "description": "Use removeColumn() to remove an existing column from a Table\nobject. The column to be removed may be identified by either\nits title (a String) or its index value (an int).\nremoveColumn(0) would remove the first column, removeColumn(1)\nwould remove the second column, and so on.
\n",
+ "line": 879,
+ "description": "Use removeColumn() to remove an existing column from a Table\nobject. The column to be removed may be identified by either\nits title (a String) or its index value (an int).\nremoveColumn(0) would remove the first column, removeColumn(1)\nwould remove the second column, and so on.
\n",
"itemtype": "method",
"name": "removeColumn",
"params": [
{
"name": "column",
"description": "columnName (string) or ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"example": [
- "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n }\n\n function setup() {\n table.removeColumn(\"id\");\n print(table.getColumnCount());\n }\n \n "
+ "\n \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n table.removeColumn('id');\n print(table.getColumnCount());\n }\n \n "
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10923,15 +12012,20 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 826,
+ "line": 944,
"description": "Stores a value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.
\n",
"itemtype": "method",
"name": "set",
"params": [
+ {
+ "name": "row",
+ "description": "row ID
\n",
+ "type": "Integer"
+ },
{
"name": "column",
"description": "column ID (Number)\n or title (String)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
},
{
"name": "value",
@@ -10940,7 +12034,7 @@ module.exports={
}
],
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n table.set(0, \"species\", \"Canis Lupus\");\n table.set(0, \"name\", \"Wolf\");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n table.set(0, 'species', 'Canis Lupus');\n table.set(0, 'name', 'Wolf');\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10949,7 +12043,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 875,
+ "line": 994,
"description": "Stores a Float value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.
\n",
"itemtype": "method",
"name": "setNum",
@@ -10957,12 +12051,12 @@ module.exports={
{
"name": "row",
"description": "row ID
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "column",
"description": "column ID (Number)\n or title (String)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
},
{
"name": "value",
@@ -10971,7 +12065,7 @@ module.exports={
}
],
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n table.setNum(1, \"id\", 1);\n\n print(table.getColumn(0));\n //[\"0\", 1, \"2\"]\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n table.setNum(1, 'id', 1);\n\n print(table.getColumn(0));\n //[\"0\", 1, \"2\"]\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -10980,7 +12074,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 922,
+ "line": 1040,
"description": "Stores a String value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.
\n",
"itemtype": "method",
"name": "setString",
@@ -10988,12 +12082,12 @@ module.exports={
{
"name": "row",
"description": "row ID
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "column",
"description": "column ID (Number)\n or title (String)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
},
{
"name": "value",
@@ -11001,13 +12095,17 @@ module.exports={
"type": "String"
}
],
+ "example": [
+ "\n\n// Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n //add a row\n var newRow = table.addRow();\n newRow.setString('id', table.getRowCount() - 1);\n newRow.setString('species', 'Canis Lupus');\n newRow.setString('name', 'Wolf');\n\n print(table.getArray());\n}\n"
+ ],
+ "alt": "no image displayed",
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.Table.js",
- "line": 937,
+ "line": 1085,
"description": "Retrieves a value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.
\n",
"itemtype": "method",
"name": "get",
@@ -11015,12 +12113,12 @@ module.exports={
{
"name": "row",
"description": "row ID
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "column",
"description": "columnName (string) or\n ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
@@ -11028,7 +12126,7 @@ module.exports={
"type": "String|Number"
},
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n print(table.get(0, 1));\n //Capra hircus\n print(table.get(0, \"species\"));\n //Capra hircus\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n print(table.get(0, 1));\n //Capra hircus\n print(table.get(0, 'species'));\n //Capra hircus\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -11037,7 +12135,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 984,
+ "line": 1132,
"description": "Retrieves a Float value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.
\n",
"itemtype": "method",
"name": "getNum",
@@ -11045,12 +12143,12 @@ module.exports={
{
"name": "row",
"description": "row ID
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "column",
"description": "columnName (string) or\n ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
@@ -11058,7 +12156,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n print(table.getNum(1, 0) + 100);\n //id 1 + 100 = 101\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n print(table.getNum(1, 0) + 100);\n //id 1 + 100 = 101\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -11067,7 +12165,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 1029,
+ "line": 1177,
"description": "Retrieves a String value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.
\n",
"itemtype": "method",
"name": "getString",
@@ -11075,12 +12173,12 @@ module.exports={
{
"name": "row",
"description": "row ID
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "column",
"description": "columnName (string) or\n ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
@@ -11088,7 +12186,7 @@ module.exports={
"type": "String"
},
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n var tableArray = table.getArray();\n\n //output each row as array\n for (var i = 0; i < tableArray.length; i++)\n print(tableArray[i]);\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n // table is comma separated value \"CSV\"\n // and has specifiying header for column labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n print(table.getString(0, 0)); // 0\n print(table.getString(0, 1)); // Capra hircus\n print(table.getString(0, 2)); // Goat\n print(table.getString(1, 0)); // 1\n print(table.getString(1, 1)); // Panthera pardus\n print(table.getString(1, 2)); // Leopard\n print(table.getString(2, 0)); // 2\n print(table.getString(2, 1)); // Equus zebra\n print(table.getString(2, 2)); // Zebra\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -11097,7 +12195,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 1077,
+ "line": 1230,
"description": "Retrieves all table data and returns as an object. If a column name is\npassed in, each row object will be stored with that attribute as its\ntitle.
\n",
"itemtype": "method",
"name": "getObject",
@@ -11105,7 +12203,8 @@ module.exports={
{
"name": "headerColumn",
"description": "Name of the column which should be used to\n title each row object (optional)
\n",
- "type": "String"
+ "type": "String",
+ "optional": true
}
],
"return": {
@@ -11113,7 +12212,7 @@ module.exports={
"type": "Object"
},
"example": [
- "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable(\"assets/mammals.csv\", \"csv\", \"header\");\n}\n\nfunction setup() {\n var tableObject = table.getObject();\n\n print(tableObject);\n //outputs an object\n}\n\n"
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n var tableObject = table.getObject();\n\n print(tableObject);\n //outputs an object\n}\n\n"
],
"alt": "no image displayed",
"class": "p5.Table",
@@ -11122,7 +12221,7 @@ module.exports={
},
{
"file": "src/io/p5.Table.js",
- "line": 1141,
+ "line": 1296,
"description": "Retrieves all table data and returns it as a multidimensional array.
\n",
"itemtype": "method",
"name": "getArray",
@@ -11130,13 +12229,17 @@ module.exports={
"description": "",
"type": "Array"
},
+ "example": [
+ "\n\n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leoperd\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n // table is comma separated value \"CSV\"\n // and has specifiying header for column labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n var tableArray = table.getArray();\n for (var i = 0; i < tableArray.length; i++) {\n print(tableArray[i]);\n }\n}\n\n"
+ ],
+ "alt": "no image displayed",
"class": "p5.Table",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.TableRow.js",
- "line": 43,
+ "line": 42,
"description": "Stores a value in the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",
"itemtype": "method",
"name": "set",
@@ -11144,7 +12247,7 @@ module.exports={
{
"name": "column",
"description": "Column ID (Number)\n or Title (String)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
},
{
"name": "value",
@@ -11152,13 +12255,17 @@ module.exports={
"type": "String|Number"
}
],
+ "example": [
+ "\n \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var rows = table.getRows();\n for (var r = 0; r < rows.length; r++) {\n rows[r].set('name', 'Unicorn');\n }\n\n //print the results\n print(table.getArray());\n }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5.TableRow",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.TableRow.js",
- "line": 79,
+ "line": 106,
"description": "Stores a Float value in the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",
"itemtype": "method",
"name": "setNum",
@@ -11166,21 +12273,25 @@ module.exports={
{
"name": "column",
"description": "Column ID (Number)\n or Title (String)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
},
{
"name": "value",
"description": "The value to be stored\n as a Float
\n",
- "type": "Number"
+ "type": "Number|String"
}
],
+ "example": [
+ "\n \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var rows = table.getRows();\n for (var r = 0; r < rows.length; r++) {\n rows[r].setNum('id', r + 10);\n }\n\n print(table.getArray());\n }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5.TableRow",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.TableRow.js",
- "line": 95,
+ "line": 150,
"description": "Stores a String value in the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",
"itemtype": "method",
"name": "setString",
@@ -11188,21 +12299,25 @@ module.exports={
{
"name": "column",
"description": "Column ID (Number)\n or Title (String)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
},
{
"name": "value",
"description": "The value to be stored\n as a String
\n",
- "type": "String"
+ "type": "String|Number|Boolean|Object"
}
],
+ "example": [
+ "\n \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var rows = table.getRows();\n for (var r = 0; r < rows.length; r++) {\n var name = rows[r].getString('name');\n rows[r].setString('name', 'A ' + name + ' named George');\n }\n\n print(table.getArray());\n }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5.TableRow",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.TableRow.js",
- "line": 110,
+ "line": 195,
"description": "Retrieves a value from the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",
"itemtype": "method",
"name": "get",
@@ -11210,20 +12325,24 @@ module.exports={
{
"name": "column",
"description": "columnName (string) or\n ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
"description": "",
"type": "String|Number"
},
+ "example": [
+ "\n \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var names = [];\n var rows = table.getRows();\n for (var r = 0; r < rows.length; r++) {\n names.push(rows[r].get('name'));\n }\n\n print(names);\n }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5.TableRow",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.TableRow.js",
- "line": 127,
+ "line": 243,
"description": "Retrieves a Float value from the TableRow's specified\ncolumn. The column may be specified by either its ID or\ntitle.
\n",
"itemtype": "method",
"name": "getNum",
@@ -11231,20 +12350,24 @@ module.exports={
{
"name": "column",
"description": "columnName (string) or\n ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
"description": "Float Floating point number",
"type": "Number"
},
+ "example": [
+ "\n \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var rows = table.getRows();\n var minId = Infinity;\n var maxId = -Infinity;\n for (var r = 0; r < rows.length; r++) {\n var id = rows[r].getNum('id');\n minId = min(minId, id);\n maxId = min(maxId, id);\n }\n print('minimum id = ' + minId + ', maximum id = ' + maxId);\n }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5.TableRow",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.TableRow.js",
- "line": 151,
+ "line": 299,
"description": "Retrieves an String value from the TableRow's specified\ncolumn. The column may be specified by either its ID or\ntitle.
\n",
"itemtype": "method",
"name": "getString",
@@ -11252,21 +12375,25 @@ module.exports={
{
"name": "column",
"description": "columnName (string) or\n ID (number)
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
"description": "String",
"type": "String"
},
+ "example": [
+ "\n \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n var rows = table.getRows();\n var longest = '';\n for (var r = 0; r < rows.length; r++) {\n var species = rows[r].getString('species');\n if (longest.length < species.length) {\n longest = species;\n }\n }\n\n print('longest: ' + longest);\n }\n "
+ ],
+ "alt": "no image displayed",
"class": "p5.TableRow",
"module": "IO",
"submodule": "Table"
},
{
"file": "src/io/p5.XML.js",
- "line": 66,
- "description": "Gets a copy of the element's parent. Returns the parent as another\np5.XML object.
\n",
+ "line": 64,
+ "description": "Gets a copy of the element's parent. Returns the parent as another\np5.XML object.
\n",
"itemtype": "method",
"name": "getParent",
"return": {
@@ -11274,7 +12401,7 @@ module.exports={
"type": "p5.XML"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var children = xml.getChildren(\"animal\");\n var parent = children[1].getParent();\n print(parent.getName());\n}\n\n// Sketch prints:\n// mammals\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var children = xml.getChildren('animal');\n var parent = children[1].getParent();\n print(parent.getName());\n}\n\n// Sketch prints:\n// mammals\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11282,7 +12409,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 104,
+ "line": 102,
"description": "Gets the element's full name, which is returned as a String.
\n",
"itemtype": "method",
"name": "getName",
@@ -11291,7 +12418,7 @@ module.exports={
"type": "String"
},
"example": [
- "<animal\n \n // The following short XML file called \"mammals.xml\" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n // <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n // <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n // </mammals>\n\n var xml;\n\n function preload() {\n xml = loadXML(\"assets/mammals.xml\");\n }\n\n function setup() {\n print(xml.getName());\n }\n\n // Sketch prints:\n // mammals\n "
+ "<animal\n \n // The following short XML file called \"mammals.xml\" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n // <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n // <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n // </mammals>\n\n var xml;\n\n function preload() {\n xml = loadXML('assets/mammals.xml');\n }\n\n function setup() {\n print(xml.getName());\n }\n\n // Sketch prints:\n // mammals\n "
],
"class": "p5.XML",
"module": "IO",
@@ -11299,7 +12426,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 139,
+ "line": 137,
"description": "Sets the element's name, which is specified as a String.
\n",
"itemtype": "method",
"name": "setName",
@@ -11311,7 +12438,7 @@ module.exports={
}
],
"example": [
- "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n print(xml.getName());\n xml.setName(\"fish\");\n print(xml.getName());\n}\n\n// Sketch prints:\n// mammals\n// fish\n"
+ "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.getName());\n xml.setName('fish');\n print(xml.getName());\n}\n\n// Sketch prints:\n// mammals\n// fish\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11319,7 +12446,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 177,
+ "line": 175,
"description": "Checks whether or not the element has any children, and returns the result\nas a boolean.
\n",
"itemtype": "method",
"name": "hasChildren",
@@ -11328,7 +12455,7 @@ module.exports={
"type": "Boolean"
},
"example": [
- "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n print(xml.hasChildren());\n}\n\n// Sketch prints:\n// true\n"
+ "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.hasChildren());\n}\n\n// Sketch prints:\n// true\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11336,8 +12463,8 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 213,
- "description": "Get the names of all of the element's children, and returns the names as an\narray of Strings. This is the same as looping through and calling getName()\non each child element individually.
\n",
+ "line": 211,
+ "description": "Get the names of all of the element's children, and returns the names as an\narray of Strings. This is the same as looping through and calling getName()\non each child element individually.
\n",
"itemtype": "method",
"name": "listChildren",
"return": {
@@ -11345,7 +12472,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n print(xml.listChildren());\n}\n\n// Sketch prints:\n// [\"animal\", \"animal\", \"animal\"]\n"
+ "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.listChildren());\n}\n\n// Sketch prints:\n// [\"animal\", \"animal\", \"animal\"]\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11354,7 +12481,7 @@ module.exports={
{
"file": "src/io/p5.XML.js",
"line": 250,
- "description": "Returns all of the element's children as an array of p5.XML objects. When\nthe name parameter is specified, then it will return all children that match\nthat name.
\n",
+ "description": "Returns all of the element's children as an array of p5.XML objects. When\nthe name parameter is specified, then it will return all children that match\nthat name.
\n",
"itemtype": "method",
"name": "getChildren",
"params": [
@@ -11370,7 +12497,7 @@ module.exports={
"type": "p5.XML[]"
},
"example": [
- "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var animals = xml.getChildren(\"animal\");\n\n for (var i = 0; i < animals.length; i++) {\n print(animals[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Leopard\"\n// \"Zebra\"\n"
+ "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var animals = xml.getChildren('animal');\n\n for (var i = 0; i < animals.length; i++) {\n print(animals[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Leopard\"\n// \"Zebra\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11378,7 +12505,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 299,
+ "line": 300,
"description": "Returns the first of the element's children that matches the name parameter\nor the child of the given index.It returns undefined if no matching\nchild is found.
\n",
"itemtype": "method",
"name": "getChild",
@@ -11386,7 +12513,7 @@ module.exports={
{
"name": "name",
"description": "element name or index
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"return": {
@@ -11394,7 +12521,7 @@ module.exports={
"type": "p5.XML"
},
"example": [
- "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var secondChild = xml.getChild(1);\n print(secondChild.getContent());\n}\n\n// Sketch prints:\n// \"Leopard\"\n"
+ "<animal\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var secondChild = xml.getChild(1);\n print(secondChild.getContent());\n}\n\n// Sketch prints:\n// \"Leopard\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11402,24 +12529,27 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 360,
- "description": "Appends a new child to the element. The child can be specified with\neither a String, which will be used as the new tag's name, or as a\nreference to an existing p5.XML object.\nA reference to the newly created child is returned as an p5.XML object.
\n",
+ "line": 361,
+ "description": "Appends a new child to the element. The child can be specified with\neither a String, which will be used as the new tag's name, or as a\nreference to an existing p5.XML object.\nA reference to the newly created child is returned as an p5.XML object.
\n",
"itemtype": "method",
"name": "addChild",
"params": [
{
- "name": "a",
- "description": "p5.XML Object which will be the child to be added
\n",
+ "name": "node",
+ "description": "a p5.XML Object which will be the child to be added
\n",
"type": "p5.XML"
}
],
+ "example": [
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var child = new p5.XML();\n child.setAttribute('id', '3');\n child.setAttribute('species', 'Ornithorhynchus anatinus');\n child.setContent('Platypus');\n xml.addChild(child);\n\n var animals = xml.getChildren('animal');\n print(animals[animals.length - 1].getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Leopard\"\n// \"Zebra\"\n"
+ ],
"class": "p5.XML",
"module": "IO",
"submodule": "XML"
},
{
"file": "src/io/p5.XML.js",
- "line": 377,
+ "line": 412,
"description": "Removes the element specified by name or index.
\n",
"itemtype": "method",
"name": "removeChild",
@@ -11427,11 +12557,11 @@ module.exports={
{
"name": "name",
"description": "element name or index
\n",
- "type": "String|Number"
+ "type": "String|Integer"
}
],
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n xml.removeChild(\"animal\");\n var children = xml.getChildren();\n for (var i=0; i\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n xml.removeChild(1);\n var children = xml.getChildren();\n for (var i=0; i"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n xml.removeChild('animal');\n var children = xml.getChildren();\n for (var i = 0; i < children.length; i++) {\n print(children[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Leopard\"\n// \"Zebra\"\n\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n xml.removeChild(1);\n var children = xml.getChildren();\n for (var i = 0; i < children.length; i++) {\n print(children[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Zebra\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11439,16 +12569,16 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 450,
+ "line": 484,
"description": "Counts the specified element's number of attributes, returned as an Number.
\n",
"itemtype": "method",
"name": "getAttributeCount",
"return": {
"description": "",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getAttributeCount());\n}\n\n// Sketch prints:\n// 2\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getAttributeCount());\n}\n\n// Sketch prints:\n// 2\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11456,7 +12586,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 486,
+ "line": 520,
"description": "Gets all of the specified element's attributes, and returns them as an\narray of Strings.
\n",
"itemtype": "method",
"name": "listAttributes",
@@ -11465,7 +12595,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.listAttributes());\n}\n\n// Sketch prints:\n// [\"id\", \"species\"]\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.listAttributes());\n}\n\n// Sketch prints:\n// [\"id\", \"species\"]\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11473,7 +12603,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 523,
+ "line": 557,
"description": "Checks whether or not an element has the specified attribute.
\n",
"itemtype": "method",
"name": "hasAttribute",
@@ -11489,7 +12619,7 @@ module.exports={
"type": "Boolean"
},
"example": [
- "\n \n // The following short XML file called \"mammals.xml\" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n // <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n // <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n // </mammals>\n\n var xml;\n\n function preload() {\n xml = loadXML(\"assets/mammals.xml\");\n }\n\n function setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.hasAttribute(\"species\"));\n print(firstChild.hasAttribute(\"color\"));\n }\n\n // Sketch prints:\n // true\n // false\n "
+ "\n \n // The following short XML file called \"mammals.xml\" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n // <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n // <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n // </mammals>\n\n var xml;\n\n function preload() {\n xml = loadXML('assets/mammals.xml');\n }\n\n function setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.hasAttribute('species'));\n print(firstChild.hasAttribute('color'));\n }\n\n // Sketch prints:\n // true\n // false\n "
],
"class": "p5.XML",
"module": "IO",
@@ -11497,7 +12627,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 562,
+ "line": 596,
"description": "Returns an attribute value of the element as an Number. If the defaultValue\nparameter is specified and the attribute doesn't exist, then defaultValue\nis returned. If no defaultValue is specified and the attribute doesn't\nexist, the value 0 is returned.
\n",
"itemtype": "method",
"name": "getNum",
@@ -11519,7 +12649,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getNum(\"id\"));\n}\n\n// Sketch prints:\n// 0\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getNum('id'));\n}\n\n// Sketch prints:\n// 0\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11527,7 +12657,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 603,
+ "line": 637,
"description": "Returns an attribute value of the element as an String. If the defaultValue\nparameter is specified and the attribute doesn't exist, then defaultValue\nis returned. If no defaultValue is specified and the attribute doesn't\nexist, null is returned.
\n",
"itemtype": "method",
"name": "getString",
@@ -11546,10 +12676,10 @@ module.exports={
],
"return": {
"description": "",
- "type": "Number"
+ "type": "String"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getString(\"species\"));\n}\n\n// Sketch prints:\n// \"Capra hircus\"\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getString('species'));\n}\n\n// Sketch prints:\n// \"Capra hircus\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11557,7 +12687,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 644,
+ "line": 678,
"description": "Sets the content of an element's attribute. The first parameter specifies\nthe attribute name, while the second specifies the new content.
\n",
"itemtype": "method",
"name": "setAttribute",
@@ -11570,11 +12700,11 @@ module.exports={
{
"name": "value",
"description": "the value of the attribute
\n",
- "type": "Number"
+ "type": "Number|String|Boolean"
}
],
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getString(\"species\"));\n firstChild.setAttribute(\"species\", \"Jamides zebra\");\n print(firstChild.getString(\"species\"));\n}\n\n// Sketch prints:\n// \"Capra hircus\"\n// \"Jamides zebra\"\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getString('species'));\n firstChild.setAttribute('species', 'Jamides zebra');\n print(firstChild.getString('species'));\n}\n\n// Sketch prints:\n// \"Capra hircus\"\n// \"Jamides zebra\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11582,7 +12712,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 687,
+ "line": 721,
"description": "Returns the content of an element. If there is no such content,\ndefaultValue is returned if specified, otherwise null is returned.
\n",
"itemtype": "method",
"name": "getContent",
@@ -11599,7 +12729,7 @@ module.exports={
"type": "String"
},
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11607,7 +12737,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 725,
+ "line": 759,
"description": "Sets the element's content.
\n",
"itemtype": "method",
"name": "setContent",
@@ -11619,7 +12749,7 @@ module.exports={
}
],
"example": [
- "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML(\"assets/mammals.xml\");\n}\n\nfunction setup() {\n var firstChild = xml.getChild(\"animal\");\n print(firstChild.getContent());\n firstChild.setContent(\"Mountain Goat\");\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Mountain Goat\"\n"
+ "\n\n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n var firstChild = xml.getChild('animal');\n print(firstChild.getContent());\n firstChild.setContent('Mountain Goat');\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Mountain Goat\"\n"
],
"class": "p5.XML",
"module": "IO",
@@ -11627,7 +12757,7 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 767,
+ "line": 801,
"description": "This method is called while the parsing of XML (when loadXML() is\ncalled). The difference between this method and the setContent()\nmethod defined later is that this one is used to set the content\nwhen the node in question has more nodes under it and so on and\nnot directly text content. While in the other one is used when\nthe node in question directly has text inside it.
\n",
"class": "p5.XML",
"module": "IO",
@@ -11635,8 +12765,8 @@ module.exports={
},
{
"file": "src/io/p5.XML.js",
- "line": 784,
- "description": "This method is called while the parsing of XML (when loadXML() is\ncalled). The XML node is passed and its attributes are stored in the\np5.XML's attribute Object.
\n",
+ "line": 818,
+ "description": "This method is called while the parsing of XML (when loadXML() is\ncalled). The XML node is passed and its attributes are stored in the\np5.XML's attribute Object.
\n",
"class": "p5.XML",
"module": "IO",
"submodule": "XML"
@@ -11681,10 +12811,10 @@ module.exports={
],
"return": {
"description": "rounded up number",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n // map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n //Get the ceiling of the mapped number.\n var bx = ceil(map(mouseX, 0, 100, 0,5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2,2), ax, ay - 5);\n text(nfc(bx,1,1), bx, by - 5);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n // map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n //Get the ceiling of the mapped number.\n var bx = ceil(map(mouseX, 0, 100, 0, 5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2), ax, ay - 5);\n text(nfc(bx, 1), bx, by - 5);\n}\n"
],
"alt": "2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals",
"class": "p5",
@@ -11719,7 +12849,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n\n var leftWall = 25;\n var rightWall = 75;\n\n // xm is just the mouseX, while\n // xc is the mouseX, but constrained\n // between the leftWall and rightWall!\n var xm = mouseX;\n var xc = constrain(mouseX, leftWall, rightWall);\n\n // Draw the walls.\n stroke(150);\n line(leftWall, 0, leftWall, height);\n line(rightWall, 0, rightWall, height);\n\n // Draw xm and xc as circles.\n noStroke();\n fill(150);\n ellipse(xm, 33, 9,9); // Not Constrained\n fill(0);\n ellipse(xc, 66, 9,9); // Constrained\n}\n"
+ "\n\nfunction draw() {\n background(200);\n\n var leftWall = 25;\n var rightWall = 75;\n\n // xm is just the mouseX, while\n // xc is the mouseX, but constrained\n // between the leftWall and rightWall!\n var xm = mouseX;\n var xc = constrain(mouseX, leftWall, rightWall);\n\n // Draw the walls.\n stroke(150);\n line(leftWall, 0, leftWall, height);\n line(rightWall, 0, rightWall, height);\n\n // Draw xm and xc as circles.\n noStroke();\n fill(150);\n ellipse(xm, 33, 9, 9); // Not Constrained\n fill(0);\n ellipse(xc, 66, 9, 9); // Constrained\n}\n"
],
"alt": "2 vertical lines. 2 ellipses move with mouse X 1 does not move passed lines",
"class": "p5",
@@ -11728,7 +12858,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 120,
+ "line": 121,
"description": "Calculates the distance between two points.
\n",
"itemtype": "method",
"name": "dist",
@@ -11736,12 +12866,16 @@ module.exports={
"description": "distance between the two points",
"type": "Number"
},
+ "example": [
+ "\n\n// Move your mouse inside the canvas to see the\n// change in distance between two points!\nfunction draw() {\n background(200);\n fill(0);\n\n var x1 = 10;\n var y1 = 90;\n var x2 = mouseX;\n var y2 = mouseY;\n\n line(x1, y1, x2, y2);\n ellipse(x1, y1, 7, 7);\n ellipse(x2, y2, 7, 7);\n\n // d is the length of the line\n // the distance from point 1 to point 2.\n var d = int(dist(x1, y1, x2, y2));\n\n // Let's write d along the line we are drawing!\n push();\n translate((x1 + x2) / 2, (y1 + y2) / 2);\n rotate(atan2(y2 - y1, x2 - x1));\n text(nfc(d, 1), 0, -5);\n pop();\n // Fancy!\n}\n"
+ ],
+ "alt": "2 ellipses joined by line. 1 ellipse moves with mouse X&Y. Distance displayed.",
"class": "p5",
"module": "Math",
"submodule": "Calculation",
"overloads": [
{
- "line": 120,
+ "line": 121,
"params": [
{
"name": "x1",
@@ -11770,7 +12904,7 @@ module.exports={
}
},
{
- "line": 130,
+ "line": 165,
"params": [
{
"name": "x1",
@@ -11812,7 +12946,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 184,
+ "line": 190,
"description": "Returns Euler's number e (2.71828...) raised to the power of the n\nparameter. Maps to Math.exp().
\n",
"itemtype": "method",
"name": "exp",
@@ -11828,7 +12962,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n\n // Compute the exp() function with a value between 0 and 2\n var xValue = map(mouseX, 0, width, 0, 2);\n var yValue = exp(xValue);\n\n var y = map(yValue, 0, 8, height, 0);\n\n var legend = \"exp (\" + nfc(xValue, 3) +\")\\n= \" + nf(yValue, 1, 4);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text(legend, 5, 15);\n noStroke();\n ellipse (mouseX,y, 7, 7);\n\n // Draw the exp(x) curve,\n // over the domain of x from 0 to 2\n noFill();\n stroke(0);\n beginShape();\n for (var x = 0; x < width; x++) {\n xValue = map(x, 0, width, 0, 2);\n yValue = exp(xValue);\n y = map(yValue, 0, 8, height, 0);\n vertex(x, y);\n }\n\n endShape();\n line(0, 0, 0, height);\n line(0, height-1, width, height-1);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n\n // Compute the exp() function with a value between 0 and 2\n var xValue = map(mouseX, 0, width, 0, 2);\n var yValue = exp(xValue);\n\n var y = map(yValue, 0, 8, height, 0);\n\n var legend = 'exp (' + nfc(xValue, 3) + ')\\n= ' + nf(yValue, 1, 4);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text(legend, 5, 15);\n noStroke();\n ellipse(mouseX, y, 7, 7);\n\n // Draw the exp(x) curve,\n // over the domain of x from 0 to 2\n noFill();\n stroke(0);\n beginShape();\n for (var x = 0; x < width; x++) {\n xValue = map(x, 0, width, 0, 2);\n yValue = exp(xValue);\n y = map(yValue, 0, 8, height, 0);\n vertex(x, y);\n }\n\n endShape();\n line(0, 0, 0, height);\n line(0, height - 1, width, height - 1);\n}\n"
],
"alt": "ellipse moves along a curve with mouse x. e^n displayed.",
"class": "p5",
@@ -11837,7 +12971,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 234,
+ "line": 240,
"description": "Calculates the closest int value that is less than or equal to the\nvalue of the parameter. Maps to Math.floor().
\n",
"itemtype": "method",
"name": "floor",
@@ -11850,10 +12984,10 @@ module.exports={
],
"return": {
"description": "rounded down number",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n //Get the floor of the mapped number.\n var bx = floor(map(mouseX, 0, 100, 0,5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2,2), ax, ay - 5);\n text(nfc(bx,1,1), bx, by - 5);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n //Get the floor of the mapped number.\n var bx = floor(map(mouseX, 0, 100, 0, 5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2), ax, ay - 5);\n text(nfc(bx, 1), bx, by - 5);\n}\n"
],
"alt": "2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals",
"class": "p5",
@@ -11862,7 +12996,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 273,
+ "line": 279,
"description": "Calculates a number between two numbers at a specific increment. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first point, 0.1 is very near the first point, 0.5 is\nhalf-way in between, etc. The lerp function is convenient for creating\nmotion along a straight path and for drawing dotted lines.
\n",
"itemtype": "method",
"name": "lerp",
@@ -11888,7 +13022,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n background(200);\n var a = 20;\n var b = 80;\n var c = lerp(a,b, .2);\n var d = lerp(a,b, .5);\n var e = lerp(a,b, .8);\n\n var y = 50\n\n strokeWeight(5);\n stroke(0); // Draw the original points in black\n point(a, y);\n point(b, y);\n\n stroke(100); // Draw the lerp points in gray\n point(c, y);\n point(d, y);\n point(e, y);\n}\n"
+ "\n\nfunction setup() {\n background(200);\n var a = 20;\n var b = 80;\n var c = lerp(a, b, 0.2);\n var d = lerp(a, b, 0.5);\n var e = lerp(a, b, 0.8);\n\n var y = 50;\n\n strokeWeight(5);\n stroke(0); // Draw the original points in black\n point(a, y);\n point(b, y);\n\n stroke(100); // Draw the lerp points in gray\n point(c, y);\n point(d, y);\n point(e, y);\n}\n"
],
"alt": "5 points horizontally staggered mid-canvas. mid 3 are grey, outer black",
"class": "p5",
@@ -11897,7 +13031,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 317,
+ "line": 324,
"description": "Calculates the natural logarithm (the base-e logarithm) of a number. This\nfunction expects the n parameter to be a value greater than 0.0. Maps to\nMath.log().
\n",
"itemtype": "method",
"name": "log",
@@ -11913,7 +13047,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n var maxX = 2.8;\n var maxY = 1.5;\n\n // Compute the natural log of a value between 0 and maxX\n var xValue = map(mouseX, 0, width, 0, maxX);\n if (xValue > 0) { // Cannot take the log of a negative number.\n var yValue = log(xValue);\n var y = map(yValue, -maxY, maxY, height, 0);\n\n // Display the calculation occurring.\n var legend = \"log(\" + nf(xValue, 1, 2) + \")\\n= \" + nf(yValue, 1, 3);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text (legend, 5, 15);\n noStroke();\n ellipse (mouseX, y, 7, 7);\n }\n\n // Draw the log(x) curve,\n // over the domain of x from 0 to maxX\n noFill();\n stroke(0);\n beginShape();\n for(var x=0; x < width; x++) {\n xValue = map(x, 0, width, 0, maxX);\n yValue = log(xValue);\n y = map(yValue, -maxY, maxY, height, 0);\n vertex(x, y);\n }\n endShape();\n line(0,0,0,height);\n line(0,height/2,width, height/2);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n var maxX = 2.8;\n var maxY = 1.5;\n\n // Compute the natural log of a value between 0 and maxX\n var xValue = map(mouseX, 0, width, 0, maxX);\n if (xValue > 0) {\n // Cannot take the log of a negative number.\n var yValue = log(xValue);\n var y = map(yValue, -maxY, maxY, height, 0);\n\n // Display the calculation occurring.\n var legend = 'log(' + nf(xValue, 1, 2) + ')\\n= ' + nf(yValue, 1, 3);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text(legend, 5, 15);\n noStroke();\n ellipse(mouseX, y, 7, 7);\n }\n\n // Draw the log(x) curve,\n // over the domain of x from 0 to maxX\n noFill();\n stroke(0);\n beginShape();\n for (var x = 0; x < width; x++) {\n xValue = map(x, 0, width, 0, maxX);\n yValue = log(xValue);\n y = map(yValue, -maxY, maxY, height, 0);\n vertex(x, y);\n }\n endShape();\n line(0, 0, 0, height);\n line(0, height / 2, width, height / 2);\n}\n"
],
"alt": "ellipse moves along a curve with mouse x. natural logarithm of n displayed.",
"class": "p5",
@@ -11922,8 +13056,8 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 371,
- "description": "Calculates the magnitude (or length) of a vector. A vector is a direction\nin space commonly used in computer graphics and linear algebra. Because it\nhas no "start" position, the magnitude of a vector can be thought of as\nthe distance from the coordinate 0,0 to its x,y value. Therefore, mag() is\na shortcut for writing dist(0, 0, x, y).
\n",
+ "line": 379,
+ "description": "Calculates the magnitude (or length) of a vector. A vector is a direction\nin space commonly used in computer graphics and linear algebra. Because it\nhas no "start" position, the magnitude of a vector can be thought of as\nthe distance from the coordinate 0,0 to its x,y value. Therefore, mag() is\na shortcut for writing dist(0, 0, x, y).
\n",
"itemtype": "method",
"name": "mag",
"params": [
@@ -11943,7 +13077,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n var x1 = 20;\n var x2 = 80;\n var y1 = 30;\n var y2 = 70;\n\n line(0, 0, x1, y1);\n print(mag(x1, y1)); // Prints \"36.05551275463989\"\n line(0, 0, x2, y1);\n print(mag(x2, y1)); // Prints \"85.44003745317531\"\n line(0, 0, x1, y2);\n print(mag(x1, y2)); // Prints \"72.80109889280519\"\n line(0, 0, x2, y2);\n print(mag(x2, y2)); // Prints \"106.3014581273465\"\n}\n"
+ "\n\nfunction setup() {\n var x1 = 20;\n var x2 = 80;\n var y1 = 30;\n var y2 = 70;\n\n line(0, 0, x1, y1);\n print(mag(x1, y1)); // Prints \"36.05551275463989\"\n line(0, 0, x2, y1);\n print(mag(x2, y1)); // Prints \"85.44003745317531\"\n line(0, 0, x1, y2);\n print(mag(x1, y2)); // Prints \"72.80109889280519\"\n line(0, 0, x2, y2);\n print(mag(x2, y2)); // Prints \"106.3014581273465\"\n}\n"
],
"alt": "4 lines of different length radiate from top left of canvas.",
"class": "p5",
@@ -11952,7 +13086,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 409,
+ "line": 418,
"description": "Re-maps a number from one range to another.\n
\nIn the first example above, the number 25 is converted from a value in the\nrange of 0 to 100 into a value that ranges from the left edge of the\nwindow (0) to the right edge (width).
\n",
"itemtype": "method",
"name": "map",
@@ -11994,7 +13128,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n \n var value = 25;\n var m = map(value, 0, 100, 0, width);\n ellipse(m, 50, 10, 10);\n \n\n \n function setup() {\n noStroke();\n }\n\n function draw() {\n background(204);\n var x1 = map(mouseX, 0, width, 25, 75);\n ellipse(x1, 25, 25, 25);\n //This ellipse is constrained to the 0-100 range\n //after setting withinBounds to true\n var x2 = map(mouseX, 0, width, 0, 100, true);\n ellipse(x2, 75, 25, 25);\n }\n "
+ "\n \nvar value = 25;\nvar m = map(value, 0, 100, 0, width);\nellipse(m, 50, 10, 10);\n\n\n \nfunction setup() {\n noStroke();\n}\n\nfunction draw() {\n background(204);\n var x1 = map(mouseX, 0, width, 25, 75);\n ellipse(x1, 25, 25, 25);\n //This ellipse is constrained to the 0-100 range\n //after setting withinBounds to true\n var x2 = map(mouseX, 0, width, 0, 100, true);\n ellipse(x2, 75, 25, 25);\n}\n"
],
"alt": "10 by 10 white ellipse with in mid left canvas\n2 25 by 25 white ellipses move with mouse x. Bottom has more range from X",
"class": "p5",
@@ -12003,57 +13137,113 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 464,
- "description": "Determines the largest value in a sequence of numbers, and then returns\nthat value. max() accepts any number of Number parameters, or an Array\nof any length.
\n",
+ "line": 474,
+ "description": "Determines the largest value in a sequence of numbers, and then returns\nthat value. max() accepts any number of Number parameters, or an Array\nof any length.
\n",
"itemtype": "method",
"name": "max",
- "params": [
- {
- "name": "n0",
- "description": "Numbers to compare
\n",
- "type": "Number|Array"
- }
- ],
"return": {
"description": "maximum Number",
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how max() works!\n numArray = new Array(2,1,5,4,8,9);\n fill(0);\n noStroke();\n text(\"Array Elements\", 0, 10);\n // Draw all numbers in the array\n var spacing = 15;\n var elemsY = 25;\n for(var i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n maxX = 33;\n maxY = 80;\n // Draw the Maximum value in the array.\n textSize(32);\n text(max(numArray), maxX, maxY);\n}\n"
+ "\n\nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how max() works!\n var numArray = [2, 1, 5, 4, 8, 9];\n fill(0);\n noStroke();\n text('Array Elements', 0, 10);\n // Draw all numbers in the array\n var spacing = 15;\n var elemsY = 25;\n for (var i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n var maxX = 33;\n var maxY = 80;\n // Draw the Maximum value in the array.\n textSize(32);\n text(max(numArray), maxX, maxY);\n}\n"
],
"alt": "Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 9",
"class": "p5",
"module": "Math",
- "submodule": "Calculation"
+ "submodule": "Calculation",
+ "overloads": [
+ {
+ "line": 474,
+ "params": [
+ {
+ "name": "n0",
+ "description": "Number to compare
\n",
+ "type": "Number"
+ },
+ {
+ "name": "n1",
+ "description": "Number to compare
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "maximum Number",
+ "type": "Number"
+ }
+ },
+ {
+ "line": 510,
+ "params": [
+ {
+ "name": "nums",
+ "description": "Numbers to compare
\n",
+ "type": "Number[]"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Number"
+ }
+ }
+ ]
},
{
"file": "src/math/calculation.js",
- "line": 507,
- "description": "Determines the smallest value in a sequence of numbers, and then returns\nthat value. min() accepts any number of Number parameters, or an Array\nof any length.
\n",
+ "line": 524,
+ "description": "Determines the smallest value in a sequence of numbers, and then returns\nthat value. min() accepts any number of Number parameters, or an Array\nof any length.
\n",
"itemtype": "method",
"name": "min",
- "params": [
- {
- "name": "n0",
- "description": "Numbers to compare
\n",
- "type": "Number|Array"
- }
- ],
"return": {
"description": "minimum Number",
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how min() works!\n numArray = new Array(2,1,5,4,8,9);\n fill(0);\n noStroke();\n text(\"Array Elements\", 0, 10);\n // Draw all numbers in the array\n var spacing = 15;\n var elemsY = 25;\n for(var i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n maxX = 33;\n maxY = 80;\n // Draw the Minimum value in the array.\n textSize(32);\n text(min(numArray), maxX, maxY);\n}\n"
+ "\n\nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how min() works!\n var numArray = [2, 1, 5, 4, 8, 9];\n fill(0);\n noStroke();\n text('Array Elements', 0, 10);\n // Draw all numbers in the array\n var spacing = 15;\n var elemsY = 25;\n for (var i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n var maxX = 33;\n var maxY = 80;\n // Draw the Minimum value in the array.\n textSize(32);\n text(min(numArray), maxX, maxY);\n}\n"
],
"alt": "Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 1",
"class": "p5",
"module": "Math",
- "submodule": "Calculation"
+ "submodule": "Calculation",
+ "overloads": [
+ {
+ "line": 524,
+ "params": [
+ {
+ "name": "n0",
+ "description": "Number to compare
\n",
+ "type": "Number"
+ },
+ {
+ "name": "n1",
+ "description": "Number to compare
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "minimum Number",
+ "type": "Number"
+ }
+ },
+ {
+ "line": 560,
+ "params": [
+ {
+ "name": "nums",
+ "description": "Numbers to compare
\n",
+ "type": "Number[]"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Number"
+ }
+ }
+ ]
},
{
"file": "src/math/calculation.js",
- "line": 550,
+ "line": 574,
"description": "Normalizes a number from another range into a value between 0 and 1.\nIdentical to map(value, low, high, 0, 1).\nNumbers outside of the range are not clamped to 0 and 1, because\nout-of-range values are often intentional and useful. (See the second\nexample above.)
\n",
"itemtype": "method",
"name": "norm",
@@ -12079,7 +13269,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n currentNum = mouseX;\n lowerBound = 0;\n upperBound = width; //100;\n normalized = norm(currentNum, lowerBound, upperBound);\n lineY = 70\n line(0, lineY, width, lineY);\n //Draw an ellipse mapped to the non-normalized value.\n noStroke();\n fill(50)\n var s = 7; // ellipse size\n ellipse(currentNum, lineY, s, s);\n\n // Draw the guide\n guideY = lineY + 15;\n text(\"0\", 0, guideY);\n textAlign(RIGHT);\n text(\"100\", width, guideY);\n\n // Draw the normalized value\n textAlign(LEFT);\n fill(0);\n textSize(32);\n normalY = 40;\n normalX = 20;\n text(normalized, normalX, normalY);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n var currentNum = mouseX;\n var lowerBound = 0;\n var upperBound = width; //100;\n var normalized = norm(currentNum, lowerBound, upperBound);\n var lineY = 70;\n line(0, lineY, width, lineY);\n //Draw an ellipse mapped to the non-normalized value.\n noStroke();\n fill(50);\n var s = 7; // ellipse size\n ellipse(currentNum, lineY, s, s);\n\n // Draw the guide\n var guideY = lineY + 15;\n text('0', 0, guideY);\n textAlign(RIGHT);\n text('100', width, guideY);\n\n // Draw the normalized value\n textAlign(LEFT);\n fill(0);\n textSize(32);\n var normalY = 40;\n var normalX = 20;\n text(normalized, normalX, normalY);\n}\n"
],
"alt": "ellipse moves with mouse. 0 shown left & 100 right and updating values center",
"class": "p5",
@@ -12088,8 +13278,8 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 602,
- "description": "Facilitates exponential expressions. The pow() function is an efficient\nway of multiplying numbers by themselves (or their reciprocals) in large\nquantities. For example, pow(3, 5) is equivalent to the expression\n33333 and pow(3, -5) is equivalent to 1 / 33333. Maps to\nMath.pow().
\n",
+ "line": 627,
+ "description": "Facilitates exponential expressions. The pow() function is an efficient\nway of multiplying numbers by themselves (or their reciprocals) in large\nquantities. For example, pow(3, 5) is equivalent to the expression\n33333 and pow(3, -5) is equivalent to 1 / 33333. Maps to\nMath.pow().
\n",
"itemtype": "method",
"name": "pow",
"params": [
@@ -12109,7 +13299,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n //Exponentially increase the size of an ellipse.\n eSize = 3; // Original Size\n eLoc = 10; // Original Location\n\n ellipse(eLoc, eLoc, eSize, eSize);\n\n ellipse(eLoc*2, eLoc*2, pow(eSize, 2), pow(eSize, 2));\n\n ellipse(eLoc*4, eLoc*4, pow(eSize, 3), pow(eSize, 3));\n\n ellipse(eLoc*8, eLoc*8, pow(eSize, 4), pow(eSize, 4));\n}\n"
+ "\n\nfunction setup() {\n //Exponentially increase the size of an ellipse.\n var eSize = 3; // Original Size\n var eLoc = 10; // Original Location\n\n ellipse(eLoc, eLoc, eSize, eSize);\n\n ellipse(eLoc * 2, eLoc * 2, pow(eSize, 2), pow(eSize, 2));\n\n ellipse(eLoc * 4, eLoc * 4, pow(eSize, 3), pow(eSize, 3));\n\n ellipse(eLoc * 8, eLoc * 8, pow(eSize, 4), pow(eSize, 4));\n}\n"
],
"alt": "small to large ellipses radiating from top left of canvas",
"class": "p5",
@@ -12118,7 +13308,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 636,
+ "line": 661,
"description": "Calculates the integer closest to the n parameter. For example,\nround(133.8) returns the value 134. Maps to Math.round().
\n",
"itemtype": "method",
"name": "round",
@@ -12131,10 +13321,10 @@ module.exports={
],
"return": {
"description": "rounded number",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n // Round the mapped number.\n var bx = round(map(mouseX, 0, 100, 0,5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2,2), ax, ay - 5);\n text(nfc(bx,1,1), bx, by - 5);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n // Round the mapped number.\n var bx = round(map(mouseX, 0, 100, 0, 5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2), ax, ay - 5);\n text(nfc(bx, 1), bx, by - 5);\n}\n"
],
"alt": "horizontal center line squared values displayed on top and regular on bottom.",
"class": "p5",
@@ -12143,7 +13333,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 675,
+ "line": 700,
"description": "Squares a number (multiplies a number by itself). The result is always a\npositive number, as multiplying two negative numbers always yields a\npositive result. For example, -1 * -1 = 1.
\n",
"itemtype": "method",
"name": "sq",
@@ -12159,7 +13349,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n eSize = 7;\n x1 = map(mouseX, 0, width, 0, 10);\n y1 = 80;\n x2 = sq(x1);\n y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100)\n line(0, height/2, width, height/2);\n\n // Draw text.\n var spacing = 15;\n noStroke();\n fill(0);\n text(\"x = \" + x1, 0, y1 + spacing);\n text(\"sq(x) = \" + x2, 0, y2 + spacing);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n var eSize = 7;\n var x1 = map(mouseX, 0, width, 0, 10);\n var y1 = 80;\n var x2 = sq(x1);\n var y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100);\n line(0, height / 2, width, height / 2);\n\n // Draw text.\n var spacing = 15;\n noStroke();\n fill(0);\n text('x = ' + x1, 0, y1 + spacing);\n text('sq(x) = ' + x2, 0, y2 + spacing);\n}\n"
],
"alt": "horizontal center line squared values displayed on top and regular on bottom.",
"class": "p5",
@@ -12168,7 +13358,7 @@ module.exports={
},
{
"file": "src/math/calculation.js",
- "line": 720,
+ "line": 747,
"description": "Calculates the square root of a number. The square root of a number is\nalways positive, even though there may be a valid negative root. The\nsquare root s of number a is such that s*s = a. It is the opposite of\nsquaring. Maps to Math.sqrt().
\n",
"itemtype": "method",
"name": "sqrt",
@@ -12184,7 +13374,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction draw() {\n background(200);\n eSize = 7;\n x1 = mouseX;\n y1 = 80;\n x2 = sqrt(x1);\n y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100)\n line(0, height/2, width, height/2);\n\n // Draw text.\n noStroke();\n fill(0);\n var spacing = 15;\n text(\"x = \" + x1, 0, y1 + spacing);\n text(\"sqrt(x) = \" + x2, 0, y2 + spacing);\n}\n"
+ "\n\nfunction draw() {\n background(200);\n var eSize = 7;\n var x1 = mouseX;\n var y1 = 80;\n var x2 = sqrt(x1);\n var y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100);\n line(0, height / 2, width, height / 2);\n\n // Draw text.\n noStroke();\n fill(0);\n var spacing = 15;\n text('x = ' + x1, 0, y1 + spacing);\n text('sqrt(x) = ' + x2, 0, y2 + spacing);\n}\n"
],
"alt": "horizontal center line squareroot values displayed on top and regular on bottom.",
"class": "p5",
@@ -12193,8 +13383,8 @@ module.exports={
},
{
"file": "src/math/math.js",
- "line": 13,
- "description": "Creates a new p5.Vector (the datatype for storing vectors). This provides a\ntwo or three dimensional vector, specifically a Euclidean (also known as\ngeometric) vector. A vector is an entity that has both magnitude and\ndirection.
\n",
+ "line": 12,
+ "description": "Creates a new p5.Vector (the datatype for storing vectors). This provides a\ntwo or three dimensional vector, specifically a Euclidean (also known as\ngeometric) vector. A vector is an entity that has both magnitude and\ndirection.
\n",
"itemtype": "method",
"name": "createVector",
"params": [
@@ -12221,14 +13411,18 @@ module.exports={
"description": "",
"type": "p5.Vector"
},
+ "example": [
+ "\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noStroke();\n fill(255, 102, 204);\n}\n\nfunction draw() {\n background(255);\n pointLight(color(255), createVector(sin(millis() / 1000) * 20, -40, -10));\n scale(0.75);\n sphere();\n}\n"
+ ],
+ "alt": "a purple sphere lit by a point light oscillating horizontally",
"class": "p5",
"module": "Math",
"submodule": "Math"
},
{
"file": "src/math/noise.js",
- "line": 41,
- "description": "Returns the Perlin noise value at specified coordinates. Perlin noise is\na random sequence generator producing a more natural ordered, harmonic\nsuccession of numbers compared to the standard random() function.\nIt was invented by Ken Perlin in the 1980s and been used since in\ngraphical applications to produce procedural textures, natural motion,\nshapes, terrains etc.
The main difference to the\nrandom() function is that Perlin noise is defined in an infinite\nn-dimensional space where each pair of coordinates corresponds to a\nfixed semi-random value (fixed only for the lifespan of the program; see\nthe noiseSeed() function). p5.js can compute 1D, 2D and 3D noise,\ndepending on the number of coordinates given. The resulting value will\nalways be between 0.0 and 1.0. The noise value can be animated by moving\nthrough the noise space as demonstrated in the example above. The 2nd\nand 3rd dimension can also be interpreted as time.
The actual\nnoise is structured similar to an audio signal, in respect to the\nfunction's use of frequencies. Similar to the concept of harmonics in\nphysics, perlin noise is computed over several octaves which are added\ntogether for the final result.
Another way to adjust the\ncharacter of the resulting sequence is the scale of the input\ncoordinates. As the function works within an infinite space the value of\nthe coordinates doesn't matter as such, only the distance between\nsuccessive coordinates does (eg. when using noise() within a\nloop). As a general rule the smaller the difference between coordinates,\nthe smoother the resulting noise sequence will be. Steps of 0.005-0.03\nwork best for most applications, but this will differ depending on use.
\n",
+ "line": 40,
+ "description": "Returns the Perlin noise value at specified coordinates. Perlin noise is\na random sequence generator producing a more natural ordered, harmonic\nsuccession of numbers compared to the standard random() function.\nIt was invented by Ken Perlin in the 1980s and been used since in\ngraphical applications to produce procedural textures, natural motion,\nshapes, terrains etc.
The main difference to the\nrandom() function is that Perlin noise is defined in an infinite\nn-dimensional space where each pair of coordinates corresponds to a\nfixed semi-random value (fixed only for the lifespan of the program; see\nthe noiseSeed() function). p5.js can compute 1D, 2D and 3D noise,\ndepending on the number of coordinates given. The resulting value will\nalways be between 0.0 and 1.0. The noise value can be animated by moving\nthrough the noise space as demonstrated in the example above. The 2nd\nand 3rd dimension can also be interpreted as time.
The actual\nnoise is structured similar to an audio signal, in respect to the\nfunction's use of frequencies. Similar to the concept of harmonics in\nphysics, perlin noise is computed over several octaves which are added\ntogether for the final result.
Another way to adjust the\ncharacter of the resulting sequence is the scale of the input\ncoordinates. As the function works within an infinite space the value of\nthe coordinates doesn't matter as such, only the distance between\nsuccessive coordinates does (eg. when using noise() within a\nloop). As a general rule the smaller the difference between coordinates,\nthe smoother the resulting noise sequence will be. Steps of 0.005-0.03\nwork best for most applications, but this will differ depending on use.
\n",
"itemtype": "method",
"name": "noise",
"params": [
@@ -12255,7 +13449,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nvar xoff = 0.0;\n\nfunction draw() {\n background(204);\n xoff = xoff + .01;\n var n = noise(xoff) * width;\n line(n, 0, n, height);\n}\n\n\n\nvar noiseScale=0.02;\n\nfunction draw() {\n background(0);\n for (var x=0; x < width; x++) {\n var noiseVal = noise((mouseX+x)*noiseScale, mouseY*noiseScale);\n stroke(noiseVal*255);\n line(x, mouseY+noiseVal*80, x, height);\n }\n}\n\n"
+ "\n\n\nvar xoff = 0.0;\n\nfunction draw() {\n background(204);\n xoff = xoff + 0.01;\n var n = noise(xoff) * width;\n line(n, 0, n, height);\n}\n\n\n\nvar noiseScale=0.02;\n\nfunction draw() {\n background(0);\n for (var x=0; x < width; x++) {\n var noiseVal = noise((mouseX+x)*noiseScale, mouseY*noiseScale);\n stroke(noiseVal*255);\n line(x, mouseY+noiseVal*80, x, height);\n }\n}\n\n"
],
"alt": "vertical line moves left to right with updating noise values.\nhorizontal wave pattern effected by mouse x-position & updating noise values.",
"class": "p5",
@@ -12264,7 +13458,7 @@ module.exports={
},
{
"file": "src/math/noise.js",
- "line": 171,
+ "line": 187,
"description": "Adjusts the character and level of detail produced by the Perlin noise\n function. Similar to harmonics in physics, noise is computed over\n several octaves. Lower octaves contribute more to the output signal and\n as such define the overall intensity of the noise, whereas higher octaves\n create finer grained details in the noise sequence.\n
\n By default, noise is computed over 4 octaves with each octave contributing\n exactly half than its predecessor, starting at 50% strength for the 1st\n octave. This falloff amount can be changed by adding an additional function\n parameter. Eg. a falloff factor of 0.75 means each octave will now have\n 75% impact (25% less) of the previous lower octave. Any value between\n 0.0 and 1.0 is valid, however note that values greater than 0.5 might\n result in greater than 1.0 values returned by noise().\n
\n By changing these parameters, the signal created by the noise()\n function can be adapted to fit very specific needs and characteristics.
\n",
"itemtype": "method",
"name": "noiseDetail",
@@ -12281,7 +13475,7 @@ module.exports={
}
],
"example": [
- "\n \n \nvar noiseVal;\n var noiseScale=0.02;\nfunction setup() {\n createCanvas(100,100);\n }\nfunction draw() {\n background(0);\n for (var y = 0; y < height; y++) {\n for (var x = 0; x < width/2; x++) {\n noiseDetail(2,0.2);\n noiseVal = noise((mouseX+x) * noiseScale,\n (mouseY+y) * noiseScale);\n stroke(noiseVal*255);\n point(x,y);\n noiseDetail(8,0.65);\n noiseVal = noise((mouseX + x + width/2) * noiseScale,\n (mouseY + y) * noiseScale);\n stroke(noiseVal*255);\n point(x + width/2, y);\n }\n }\n }\n \n "
+ "\n \n \n var noiseVal;\n var noiseScale = 0.02;\nfunction setup() {\n createCanvas(100, 100);\n }\nfunction draw() {\n background(0);\n for (var y = 0; y < height; y++) {\n for (var x = 0; x < width / 2; x++) {\n noiseDetail(2, 0.2);\n noiseVal = noise((mouseX + x) * noiseScale, (mouseY + y) * noiseScale);\n stroke(noiseVal * 255);\n point(x, y);\n noiseDetail(8, 0.65);\n noiseVal = noise(\n (mouseX + x + width / 2) * noiseScale,\n (mouseY + y) * noiseScale\n );\n stroke(noiseVal * 255);\n point(x + width / 2, y);\n }\n }\n }\n \n "
],
"alt": "2 vertical grey smokey patterns affected my mouse x-position and noise.",
"class": "p5",
@@ -12290,7 +13484,7 @@ module.exports={
},
{
"file": "src/math/noise.js",
- "line": 233,
+ "line": 253,
"description": "Sets the seed value for noise(). By default, noise()\nproduces different results each time the program is run. Set the\nvalue parameter to a constant to return the same pseudo-random\nnumbers each time the software is run.
\n",
"itemtype": "method",
"name": "noiseSeed",
@@ -12311,7 +13505,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 69,
+ "line": 67,
"description": "The x component of the vector
\n",
"itemtype": "property",
"name": "x",
@@ -12322,7 +13516,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 74,
+ "line": 72,
"description": "The y component of the vector
\n",
"itemtype": "property",
"name": "y",
@@ -12333,7 +13527,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 79,
+ "line": 77,
"description": "The z component of the vector
\n",
"itemtype": "property",
"name": "z",
@@ -12344,12 +13538,16 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 87,
+ "line": 84,
"description": "Returns a string representation of a vector v by calling String(v)\nor v.toString(). This method is useful for logging vectors in the\nconsole.
\n",
"itemtype": "method",
"name": "toString",
+ "return": {
+ "description": "",
+ "type": "String"
+ },
"example": [
- "\n\nfunction setup() {\n var v = createVector(20,30);\n print(String(v)); // prints \"p5.Vector Object : [20, 30, 0]\"\n}\n\n"
+ "\n\n\nfunction setup() {\n var v = createVector(20, 30);\n print(String(v)); // prints \"p5.Vector Object : [20, 30, 0]\"\n}\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n var v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'black');\n\n noStroke();\n text(v1.toString(), 10, 25, 90, 75);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -12357,50 +13555,67 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 105,
- "description": "Sets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Vector, or the values from a float array.
\n",
+ "line": 134,
+ "description": "Sets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Vector, or the values from a float array.
\n",
"itemtype": "method",
"name": "set",
- "params": [
- {
- "name": "x",
- "description": "the x component of the vector or a\n p5.Vector or an Array
\n",
- "type": "Number|p5.Vector|Array",
- "optional": true
- },
- {
- "name": "y",
- "description": "the y component of the vector
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "z",
- "description": "the z component of the vector
\n",
- "type": "Number",
- "optional": true
- }
- ],
"chainable": 1,
"example": [
- "\n\n\nfunction setup() {\n var v = createVector(1, 2, 3);\n v.set(4,5,6); // Sets vector to [4, 5, 6]\n\n var v1 = createVector(0, 0, 0);\n var arr = [1, 2, 3];\n v1.set(arr); // Sets vector to [1, 2, 3]\n}\n\n"
+ "\n\n\nfunction setup() {\n var v = createVector(1, 2, 3);\n v.set(4, 5, 6); // Sets vector to [4, 5, 6]\n\n var v1 = createVector(0, 0, 0);\n var arr = [1, 2, 3];\n v1.set(arr); // Sets vector to [1, 2, 3]\n}\n\n\n\n\n\nvar v0, v1;\nfunction setup() {\n createCanvas(100, 100);\n\n v0 = createVector(0, 0);\n v1 = createVector(50, 50);\n}\n\nfunction draw() {\n background(240);\n\n drawArrow(v0, v1, 'black');\n v1.set(v1.x + random(-1, 1), v1.y + random(-1, 1));\n\n noStroke();\n text('x: ' + round(v1.x) + ' y: ' + round(v1.y), 20, 90);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
- "submodule": "Math"
+ "submodule": "Math",
+ "overloads": [
+ {
+ "line": 134,
+ "params": [
+ {
+ "name": "x",
+ "description": "the x component of the vector
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "y",
+ "description": "the y component of the vector
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "z",
+ "description": "the z component of the vector
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 193,
+ "params": [
+ {
+ "name": "value",
+ "description": "the vector to set
\n",
+ "type": "p5.Vector|Number[]"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "src/math/p5.Vector.js",
- "line": 147,
- "description": "Gets a copy of the vector, returns a p5.Vector object.
\n",
+ "line": 217,
+ "description": "Gets a copy of the vector, returns a p5.Vector object.
\n",
"itemtype": "method",
"name": "copy",
"return": {
- "description": "the copy of the p5.Vector object",
+ "description": "the copy of the p5.Vector object",
"type": "p5.Vector"
},
"example": [
- "\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = v1.copy();\nprint(v1.x == v2.x && v1.y == v2.y && v1.z == v2.z);\n// Prints \"true\"\n\n"
+ "\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = v1.copy();\nprint(v1.x === v2.x && v1.y === v2.y && v1.z === v2.z);\n// Prints \"true\"\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -12408,35 +13623,35 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 170,
- "description": "Adds x, y, and z components to a vector, adds one vector to another, or\nadds two independent vectors together. The version of the method that adds\ntwo vectors together is a static method and returns a p5.Vector, the others\nacts directly on the vector. See the examples for more context.
\n",
+ "line": 240,
+ "description": "Adds x, y, and z components to a vector, adds one vector to another, or\nadds two independent vectors together. The version of the method that adds\ntwo vectors together is a static method and returns a p5.Vector, the others\nacts directly on the vector. See the examples for more context.
\n",
"itemtype": "method",
"name": "add",
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(1, 2, 3);\nv.add(4,5,6);\n// v's components are set to [5, 7, 9]\n\n\n\n\n// Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(2, 3, 4);\n\nvar v3 = p5.Vector.add(v1, v2);\n// v3 has components [3, 5, 7]\n\n"
+ "\n\n\nvar v = createVector(1, 2, 3);\nv.add(4, 5, 6);\n// v's components are set to [5, 7, 9]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(2, 3, 4);\n\nvar v3 = p5.Vector.add(v1, v2);\n// v3 has components [3, 5, 7]\nprint(v3);\n\n\n\n\n\n// red vector + blue vector = purple vector\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n var v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'red');\n\n var v2 = createVector(-30, 20);\n drawArrow(v1, v2, 'blue');\n\n var v3 = p5.Vector.add(v1, v2);\n drawArrow(v0, v3, 'purple');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 170,
+ "line": 240,
"params": [
{
"name": "x",
- "description": "the x component of the vector to be\n added or a p5.Vector or an Array
\n",
- "type": "Number|p5.Vector|Array"
+ "description": "the x component of the vector to be added
\n",
+ "type": "Number"
},
{
"name": "y",
- "description": "the y component of the vector to be\n added
\n",
+ "description": "the y component of the vector to be added
\n",
"type": "Number",
"optional": true
},
{
"name": "z",
- "description": "the z component of the vector to be\n added
\n",
+ "description": "the z component of the vector to be added
\n",
"type": "Number",
"optional": true
}
@@ -12444,16 +13659,27 @@ module.exports={
"chainable": 1
},
{
- "line": 907,
+ "line": 306,
+ "params": [
+ {
+ "name": "value",
+ "description": "the vector to add
\n",
+ "type": "p5.Vector|Number[]"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 1556,
"params": [
{
"name": "v1",
- "description": "a p5.Vector to add
\n",
+ "description": "a p5.Vector to add
\n",
"type": "p5.Vector"
},
{
"name": "v2",
- "description": "a p5.Vector to add
\n",
+ "description": "a p5.Vector to add
\n",
"type": "p5.Vector"
},
{
@@ -12465,7 +13691,7 @@ module.exports={
"static": 1
},
{
- "line": 914,
+ "line": 1563,
"params": [
{
"name": "v1",
@@ -12480,7 +13706,7 @@ module.exports={
],
"static": 1,
"return": {
- "description": "the resulting p5.Vector",
+ "description": "the resulting p5.Vector",
"type": "p5.Vector"
}
}
@@ -12488,35 +13714,35 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 222,
- "description": "Subtracts x, y, and z components from a vector, subtracts one vector from\nanother, or subtracts two independent vectors. The version of the method\nthat subtracts two vectors is a static method and returns a p5.Vector, the\nother acts directly on the vector. See the examples for more context.
\n",
+ "line": 330,
+ "description": "Subtracts x, y, and z components from a vector, subtracts one vector from\nanother, or subtracts two independent vectors. The version of the method\nthat subtracts two vectors is a static method and returns a p5.Vector, the\nother acts directly on the vector. See the examples for more context.
\n",
"itemtype": "method",
"name": "sub",
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(4, 5, 6);\nv.sub(1, 1, 1);\n// v's components are set to [3, 4, 5]\n\n\n\n\n\n// Static method\nvar v1 = createVector(2, 3, 4);\nvar v2 = createVector(1, 2, 3);\n\nvar v3 = p5.Vector.sub(v1, v2);\n// v3 has components [1, 1, 1]\n\n"
+ "\n\n\nvar v = createVector(4, 5, 6);\nv.sub(1, 1, 1);\n// v's components are set to [3, 4, 5]\n\n\n\n\n\n// Static method\nvar v1 = createVector(2, 3, 4);\nvar v2 = createVector(1, 2, 3);\n\nvar v3 = p5.Vector.sub(v1, v2);\n// v3 has components [1, 1, 1]\nprint(v3);\n\n\n\n\n\n// red vector - blue vector = purple vector\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n var v1 = createVector(70, 50);\n drawArrow(v0, v1, 'red');\n\n var v2 = createVector(mouseX, mouseY);\n drawArrow(v0, v2, 'blue');\n\n var v3 = p5.Vector.sub(v1, v2);\n drawArrow(v2, v3, 'purple');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 222,
+ "line": 330,
"params": [
{
"name": "x",
- "description": "the x component of the vector or a\n p5.Vector or an Array
\n",
- "type": "Number|p5.Vector|Array"
+ "description": "the x component of the vector to subtract
\n",
+ "type": "Number"
},
{
"name": "y",
- "description": "the y component of the vector
\n",
+ "description": "the y component of the vector to subtract
\n",
"type": "Number",
"optional": true
},
{
"name": "z",
- "description": "the z component of the vector
\n",
+ "description": "the z component of the vector to subtract
\n",
"type": "Number",
"optional": true
}
@@ -12524,16 +13750,27 @@ module.exports={
"chainable": 1
},
{
- "line": 937,
+ "line": 396,
+ "params": [
+ {
+ "name": "value",
+ "description": "the vector to subtract
\n",
+ "type": "p5.Vector|Number[]"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 1586,
"params": [
{
"name": "v1",
- "description": "a p5.Vector to subtract from
\n",
+ "description": "a p5.Vector to subtract from
\n",
"type": "p5.Vector"
},
{
"name": "v2",
- "description": "a p5.Vector to subtract
\n",
+ "description": "a p5.Vector to subtract
\n",
"type": "p5.Vector"
},
{
@@ -12545,7 +13782,7 @@ module.exports={
"static": 1
},
{
- "line": 944,
+ "line": 1593,
"params": [
{
"name": "v1",
@@ -12560,7 +13797,7 @@ module.exports={
],
"static": 1,
"return": {
- "description": "the resulting p5.Vector",
+ "description": "the resulting p5.Vector",
"type": "p5.Vector"
}
}
@@ -12568,20 +13805,20 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 273,
- "description": "Multiply the vector by a scalar. The static version of this method\ncreates a new p5.Vector while the non static version acts on the vector\ndirectly. See the examples for more context.
\n",
+ "line": 420,
+ "description": "Multiply the vector by a scalar. The static version of this method\ncreates a new p5.Vector while the non static version acts on the vector\ndirectly. See the examples for more context.
\n",
"itemtype": "method",
"name": "mult",
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(1, 2, 3);\nv.mult(2);\n// v's components are set to [2, 4, 6]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = p5.Vector.mult(v1, 2);\n// v2 has components [2, 4, 6]\n\n"
+ "\n\n\nvar v = createVector(1, 2, 3);\nv.mult(2);\n// v's components are set to [2, 4, 6]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = p5.Vector.mult(v1, 2);\n// v2 has components [2, 4, 6]\nprint(v2);\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(50, 50);\n var v1 = createVector(25, -25);\n drawArrow(v0, v1, 'red');\n\n var num = map(mouseX, 0, width, -2, 2, true);\n var v2 = p5.Vector.mult(v1, num);\n drawArrow(v0, v2, 'blue');\n\n noStroke();\n text('multiplied by ' + num.toFixed(2), 5, 90);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 273,
+ "line": 420,
"params": [
{
"name": "n",
@@ -12592,7 +13829,7 @@ module.exports={
"chainable": 1
},
{
- "line": 966,
+ "line": 1614,
"params": [
{
"name": "v",
@@ -12613,7 +13850,7 @@ module.exports={
"static": 1
},
{
- "line": 973,
+ "line": 1621,
"params": [
{
"name": "v",
@@ -12628,7 +13865,7 @@ module.exports={
],
"static": 1,
"return": {
- "description": "the resulting new p5.Vector",
+ "description": "the resulting new p5.Vector",
"type": "p5.Vector"
}
}
@@ -12636,20 +13873,20 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 306,
- "description": "Divide the vector by a scalar. The static version of this method creates a\nnew p5.Vector while the non static version acts on the vector directly.\nSee the examples for more context.
\n",
+ "line": 495,
+ "description": "Divide the vector by a scalar. The static version of this method creates a\nnew p5.Vector while the non static version acts on the vector directly.\nSee the examples for more context.
\n",
"itemtype": "method",
"name": "div",
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(6, 4, 2);\nv.div(2); //v's components are set to [3, 2, 1]\n\n\n\n\n\n// Static method\nvar v1 = createVector(6, 4, 2);\nvar v2 = p5.Vector.div(v, 2);\n// v2 has components [3, 2, 1]\n\n"
+ "\n\n\nvar v = createVector(6, 4, 2);\nv.div(2); //v's components are set to [3, 2, 1]\n\n\n\n\n\n// Static method\nvar v1 = createVector(6, 4, 2);\nvar v2 = p5.Vector.div(v1, 2);\n// v2 has components [3, 2, 1]\nprint(v2);\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 100);\n var v1 = createVector(50, -50);\n drawArrow(v0, v1, 'red');\n\n var num = map(mouseX, 0, width, 10, 0.5, true);\n var v2 = p5.Vector.div(v1, num);\n drawArrow(v0, v2, 'blue');\n\n noStroke();\n text('divided by ' + num.toFixed(2), 10, 90);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 306,
+ "line": 495,
"params": [
{
"name": "n",
@@ -12660,7 +13897,7 @@ module.exports={
"chainable": 1
},
{
- "line": 993,
+ "line": 1641,
"params": [
{
"name": "v",
@@ -12681,7 +13918,7 @@ module.exports={
"static": 1
},
{
- "line": 1000,
+ "line": 1648,
"params": [
{
"name": "v",
@@ -12696,7 +13933,7 @@ module.exports={
],
"static": 1,
"return": {
- "description": "the resulting new p5.Vector",
+ "description": "the resulting new p5.Vector",
"type": "p5.Vector"
}
}
@@ -12704,7 +13941,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 338,
+ "line": 573,
"description": "Calculates the magnitude (length) of the vector and returns the result as\na float (this is simply the equation sqrt(xx + yy + z*z).)
\n",
"itemtype": "method",
"name": "mag",
@@ -12713,14 +13950,14 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar v = createVector(20.0, 30.0, 40.0);\nvar m = v.mag();\nprint(m); // Prints \"53.85164807134504\"\n\n"
+ "\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n var v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'black');\n\n noStroke();\n text('vector length: ' + v1.mag().toFixed(2), 10, 70, 90, 30);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n\n\n\nvar v = createVector(20.0, 30.0, 40.0);\nvar m = v.mag();\nprint(m); // Prints \"53.85164807134504\"\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 338,
+ "line": 573,
"params": [],
"return": {
"description": "magnitude of the vector",
@@ -12728,7 +13965,7 @@ module.exports={
}
},
{
- "line": 1091,
+ "line": 1738,
"params": [
{
"name": "vecT",
@@ -12746,7 +13983,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 357,
+ "line": 621,
"description": "Calculates the squared magnitude of the vector and returns the result\nas a float (this is simply the equation (xx + yy + z*z).)\nFaster if the real length is not required in the\ncase of comparing vectors, etc.
\n",
"itemtype": "method",
"name": "magSq",
@@ -12755,7 +13992,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\n// Static method\nvar v1 = createVector(6, 4, 2);\nprint(v1.magSq()); // Prints \"56\"\n\n"
+ "\n\n\n// Static method\nvar v1 = createVector(6, 4, 2);\nprint(v1.magSq()); // Prints \"56\"\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n var v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'black');\n\n noStroke();\n text('vector length squared: ' + v1.magSq().toFixed(2), 10, 45, 90, 55);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -12763,7 +14000,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 379,
+ "line": 675,
"description": "Calculates the dot product of two vectors. The version of the method\nthat computes the dot product of two independent vectors is a static\nmethod. See the examples for more context.
\n",
"itemtype": "method",
"name": "dot",
@@ -12772,19 +14009,19 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(2, 3, 4);\n\nprint(v1.dot(v2)); // Prints \"20\"\n\n\n\n\n\n//Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(3, 2, 1);\nprint (p5.Vector.dot(v1, v2)); // Prints \"10\"\n\n"
+ "\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(2, 3, 4);\n\nprint(v1.dot(v2)); // Prints \"20\"\n\n\n\n\n\n//Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(3, 2, 1);\nprint(p5.Vector.dot(v1, v2)); // Prints \"10\"\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 379,
+ "line": 675,
"params": [
{
"name": "x",
- "description": "x component of the vector or a p5.Vector
\n",
- "type": "Number|p5.Vector"
+ "description": "x component of the vector
\n",
+ "type": "Number"
},
{
"name": "y",
@@ -12805,16 +14042,30 @@ module.exports={
}
},
{
- "line": 1021,
+ "line": 706,
+ "params": [
+ {
+ "name": "value",
+ "description": "value component of the vector or a p5.Vector
\n",
+ "type": "p5.Vector"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Number"
+ }
+ },
+ {
+ "line": 1668,
"params": [
{
"name": "v1",
- "description": "the first p5.Vector
\n",
+ "description": "the first p5.Vector
\n",
"type": "p5.Vector"
},
{
"name": "v2",
- "description": "the second p5.Vector
\n",
+ "description": "the second p5.Vector
\n",
"type": "p5.Vector"
}
],
@@ -12828,46 +14079,46 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 419,
- "description": "Calculates and returns a vector composed of the cross product between\ntwo vectors. Both the static and non static methods return a new p5.Vector.\nSee the examples for more context.
\n",
+ "line": 718,
+ "description": "Calculates and returns a vector composed of the cross product between\ntwo vectors. Both the static and non static methods return a new p5.Vector.\nSee the examples for more context.
\n",
"itemtype": "method",
"name": "cross",
"return": {
- "description": "p5.Vector composed of cross product",
+ "description": "p5.Vector composed of cross product",
"type": "p5.Vector"
},
"example": [
- "\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(1, 2, 3);\n\nv1.cross(v2); // v's components are [0, 0, 0]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar crossProduct = p5.Vector.cross(v1, v2);\n// crossProduct has components [0, 0, 1]\n\n"
+ "\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(1, 2, 3);\n\nv1.cross(v2); // v's components are [0, 0, 0]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar crossProduct = p5.Vector.cross(v1, v2);\n// crossProduct has components [0, 0, 1]\nprint(crossProduct);\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 419,
+ "line": 718,
"params": [
{
"name": "v",
- "description": "p5.Vector to be crossed
\n",
+ "description": "p5.Vector to be crossed
\n",
"type": "p5.Vector"
}
],
"return": {
- "description": "p5.Vector composed of cross product",
+ "description": "p5.Vector composed of cross product",
"type": "p5.Vector"
}
},
{
- "line": 1035,
+ "line": 1682,
"params": [
{
"name": "v1",
- "description": "the first p5.Vector
\n",
+ "description": "the first p5.Vector
\n",
"type": "p5.Vector"
},
{
"name": "v2",
- "description": "the second p5.Vector
\n",
+ "description": "the second p5.Vector
\n",
"type": "p5.Vector"
}
],
@@ -12881,7 +14132,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 459,
+ "line": 759,
"description": "Calculates the Euclidean distance between two points (considering a\npoint as a vector object).
\n",
"itemtype": "method",
"name": "dist",
@@ -12890,18 +14141,18 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar distance = v1.dist(v2); // distance is 1.4142...\n\n\n\n\n// Static method\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar distance = p5.Vector.dist(v1,v2);\n// distance is 1.4142...\n\n"
+ "\n\n\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar distance = v1.dist(v2); // distance is 1.4142...\nprint(distance);\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar distance = p5.Vector.dist(v1, v2);\n// distance is 1.4142...\nprint(distance);\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n\n var v1 = createVector(70, 50);\n drawArrow(v0, v1, 'red');\n\n var v2 = createVector(mouseX, mouseY);\n drawArrow(v0, v2, 'blue');\n\n noStroke();\n text('distance between vectors: ' + v2.dist(v1).toFixed(2), 5, 50, 95, 50);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 459,
+ "line": 759,
"params": [
{
"name": "v",
- "description": "the x, y, and z coordinates of a p5.Vector
\n",
+ "description": "the x, y, and z coordinates of a p5.Vector
\n",
"type": "p5.Vector"
}
],
@@ -12911,16 +14162,16 @@ module.exports={
}
},
{
- "line": 1050,
+ "line": 1697,
"params": [
{
"name": "v1",
- "description": "the first p5.Vector
\n",
+ "description": "the first p5.Vector
\n",
"type": "p5.Vector"
},
{
"name": "v2",
- "description": "the second p5.Vector
\n",
+ "description": "the second p5.Vector
\n",
"type": "p5.Vector"
}
],
@@ -12934,16 +14185,16 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 491,
+ "line": 830,
"description": "Normalize the vector to length 1 (make it a unit vector).
\n",
"itemtype": "method",
"name": "normalize",
"return": {
- "description": "normalized p5.Vector",
+ "description": "normalized p5.Vector",
"type": "p5.Vector"
},
"example": [
- "\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.normalize();\n// v's components are set to\n// [0.4454354, 0.8908708, 0.089087084]\n\n\n"
+ "\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.normalize();\n// v's components are set to\n// [0.4454354, 0.8908708, 0.089087084]\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(50, 50);\n var v1 = createVector(mouseX - 50, mouseY - 50);\n\n drawArrow(v0, v1, 'red');\n v1.normalize();\n drawArrow(v0, v1.mult(35), 'blue');\n\n noFill();\n ellipse(50, 50, 35 * 2);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -12951,7 +14202,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 512,
+ "line": 886,
"description": "Limit the magnitude of this vector to the value used for the max\nparameter.
\n",
"itemtype": "method",
"name": "limit",
@@ -12964,7 +14215,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.limit(5);\n// v's components are set to\n// [2.2271771, 4.4543543, 0.4454354]\n\n"
+ "\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.limit(5);\n// v's components are set to\n// [2.2271771, 4.4543543, 0.4454354]\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(50, 50);\n var v1 = createVector(mouseX - 50, mouseY - 50);\n\n drawArrow(v0, v1, 'red');\n drawArrow(v0, v1.limit(35), 'blue');\n\n noFill();\n ellipse(50, 50, 35 * 2);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -12972,7 +14223,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 539,
+ "line": 944,
"description": "Set the magnitude of this vector to the value used for the len\nparameter.
\n",
"itemtype": "method",
"name": "setMag",
@@ -12985,7 +14236,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.setMag(10);\n// v's components are set to [6.0, 8.0, 0.0]\n\n"
+ "\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.setMag(10);\n// v's components are set to [6.0, 8.0, 0.0]\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(0, 0);\n var v1 = createVector(50, 50);\n\n drawArrow(v0, v1, 'red');\n\n var length = map(mouseX, 0, width, 0, 141, true);\n v1.setMag(length);\n drawArrow(v0, v1, 'blue');\n\n noStroke();\n text('magnitude set to: ' + length.toFixed(2), 10, 70, 90, 30);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -12993,7 +14244,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 560,
+ "line": 1000,
"description": "Calculate the angle of rotation for this vector (only 2D vectors)
\n",
"itemtype": "method",
"name": "heading",
@@ -13002,7 +14253,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n var v1 = createVector(30,50);\n print(v1.heading()); // 1.0303768265243125\n\n var v1 = createVector(40,50);\n print(v1.heading()); // 0.8960553845713439\n\n var v1 = createVector(30,70);\n print(v1.heading()); // 1.1659045405098132\n}\n"
+ "\n\n\nfunction setup() {\n var v1 = createVector(30, 50);\n print(v1.heading()); // 1.0303768265243125\n\n v1 = createVector(40, 50);\n print(v1.heading()); // 0.8960553845713439\n\n v1 = createVector(30, 70);\n print(v1.heading()); // 1.1659045405098132\n}\n\n\n\n\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(50, 50);\n var v1 = createVector(mouseX - 50, mouseY - 50);\n\n drawArrow(v0, v1, 'black');\n\n var myHeading = v1.heading();\n noStroke();\n text(\n 'vector heading: ' +\n myHeading.toFixed(2) +\n ' radians or ' +\n degrees(myHeading).toFixed(2) +\n ' degrees',\n 10,\n 50,\n 90,\n 50\n );\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13010,7 +14261,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 592,
+ "line": 1069,
"description": "Rotate the vector by an angle (only 2D vectors), magnitude remains the\nsame
\n",
"itemtype": "method",
"name": "rotate",
@@ -13023,7 +14274,7 @@ module.exports={
],
"chainable": 1,
"example": [
- "\n\n\nvar v = createVector(10.0, 20.0);\n// v has components [10.0, 20.0, 0.0]\nv.rotate(HALF_PI);\n// v's components are set to [-20.0, 9.999999, 0.0]\n\n"
+ "\n\n\nvar v = createVector(10.0, 20.0);\n// v has components [10.0, 20.0, 0.0]\nv.rotate(HALF_PI);\n// v's components are set to [-20.0, 9.999999, 0.0]\n\n\n\n\n\nvar angle = 0;\nfunction draw() {\n background(240);\n\n var v0 = createVector(50, 50);\n var v1 = createVector(50, 0);\n\n drawArrow(v0, v1.rotate(angle), 'black');\n angle += 0.01;\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13031,14 +14282,14 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 622,
+ "line": 1125,
"description": "Calculates and returns the angle (in radians) between two vectors.
\n",
"itemtype": "method",
"name": "angleBetween",
"params": [
{
"name": "the",
- "description": "x, y, and z components of a p5.Vector
\n",
+ "description": "x, y, and z components of a p5.Vector
\n",
"type": "p5.Vector"
}
],
@@ -13047,7 +14298,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar angle = v1.angleBetween(v2);\n// angle is PI/2\n\n"
+ "\n\n\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar angle = v1.angleBetween(v2);\n// angle is PI/2\nprint(angle);\n\n\n\n\n\nfunction draw() {\n background(240);\n var v0 = createVector(50, 50);\n\n var v1 = createVector(50, 0);\n drawArrow(v0, v1, 'red');\n\n var v2 = createVector(mouseX - 50, mouseY - 50);\n drawArrow(v0, v2, 'blue');\n\n var angleBetween = v1.angleBetween(v2);\n noStroke();\n text(\n 'angle between: ' +\n angleBetween.toFixed(2) +\n ' radians or ' +\n degrees(angleBetween).toFixed(2) +\n ' degrees',\n 10,\n 50,\n 90,\n 50\n );\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13055,32 +14306,35 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 654,
+ "line": 1198,
"description": "Linear interpolate the vector to another vector
\n",
"itemtype": "method",
"name": "lerp",
"chainable": 1,
+ "example": [
+ "\n\n\nvar v = createVector(1, 1, 0);\n\nv.lerp(3, 3, 0, 0.5); // v now has components [2,2,0]\n\n\n\n\n\nvar v1 = createVector(0, 0, 0);\nvar v2 = createVector(100, 100, 0);\n\nvar v3 = p5.Vector.lerp(v1, v2, 0.5);\n// v3 has components [50,50,0]\nprint(v3);\n\n\n\n\n\nvar step = 0.01;\nvar amount = 0;\n\nfunction draw() {\n background(240);\n var v0 = createVector(0, 0);\n\n var v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'red');\n\n var v2 = createVector(90, 90);\n drawArrow(v0, v2, 'blue');\n\n if (amount > 1 || amount < 0) {\n step *= -1;\n }\n amount += step;\n var v3 = p5.Vector.lerp(v1, v2, amount);\n\n drawArrow(v0, v3, 'purple');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
+ ],
"class": "p5.Vector",
"module": "Math",
"submodule": "Math",
"overloads": [
{
- "line": 654,
+ "line": 1198,
"params": [
{
"name": "x",
"description": "the x component
\n",
- "type": "p5.Vector"
+ "type": "Number"
},
{
"name": "y",
"description": "the y component
\n",
- "type": "p5.Vector"
+ "type": "Number"
},
{
"name": "z",
"description": "the z component
\n",
- "type": "p5.Vector"
+ "type": "Number"
},
{
"name": "amt",
@@ -13091,11 +14345,11 @@ module.exports={
"chainable": 1
},
{
- "line": 666,
+ "line": 1271,
"params": [
{
"name": "v",
- "description": "the p5.Vector to lerp to
\n",
+ "description": "the p5.Vector to lerp to
\n",
"type": "p5.Vector"
},
{
@@ -13107,7 +14361,7 @@ module.exports={
"chainable": 1
},
{
- "line": 1065,
+ "line": 1712,
"params": [
{
"name": "v1",
@@ -13133,7 +14387,7 @@ module.exports={
"static": 1
},
{
- "line": 1073,
+ "line": 1720,
"params": [
{
"name": "v1",
@@ -13161,8 +14415,8 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 701,
- "description": "Return a representation of this vector as a float array. This is only\nfor temporary use. If used in any other fashion, the contents should be\ncopied by using the p5.Vector.copy() method to copy into your own\narray.
\n",
+ "line": 1287,
+ "description": "Return a representation of this vector as a float array. This is only\nfor temporary use. If used in any other fashion, the contents should be\ncopied by using the p5.Vector.copy() method to copy into your own\narray.
\n",
"itemtype": "method",
"name": "array",
"return": {
@@ -13170,7 +14424,7 @@ module.exports={
"type": "Number[]"
},
"example": [
- "\n\nfunction setup() {\n var v = createVector(20,30);\n print(v.array()); // Prints : Array [20, 30, 0]\n}\n\n\n\nvar v = createVector(10.0, 20.0, 30.0);\nvar f = v.array();\nprint(f[0]); // Prints \"10.0\"\nprint(f[1]); // Prints \"20.0\"\nprint(f[2]); // Prints \"30.0\"\n\n"
+ "\n\n\nfunction setup() {\n var v = createVector(20, 30);\n print(v.array()); // Prints : Array [20, 30, 0]\n}\n\n\n\n\n\nvar v = createVector(10.0, 20.0, 30.0);\nvar f = v.array();\nprint(f[0]); // Prints \"10.0\"\nprint(f[1]); // Prints \"20.0\"\nprint(f[2]); // Prints \"30.0\"\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13178,36 +14432,90 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 730,
- "description": "Equality check against a p5.Vector
\n",
+ "line": 1319,
+ "description": "Equality check against a p5.Vector
\n",
"itemtype": "method",
"name": "equals",
- "params": [
+ "return": {
+ "description": "whether the vectors are equals",
+ "type": "Boolean"
+ },
+ "example": [
+ "\n\n\nvar v1 = createVector(5, 10, 20);\nvar v2 = createVector(5, 10, 20);\nvar v3 = createVector(13, 10, 19);\n\nprint(v1.equals(v2.x, v2.y, v2.z)); // true\nprint(v1.equals(v3.x, v3.y, v3.z)); // false\n\n\n\n\n\nvar v1 = createVector(10.0, 20.0, 30.0);\nvar v2 = createVector(10.0, 20.0, 30.0);\nvar v3 = createVector(0.0, 0.0, 0.0);\nprint(v1.equals(v2)); // true\nprint(v1.equals(v3)); // false\n\n"
+ ],
+ "class": "p5.Vector",
+ "module": "Math",
+ "submodule": "Math",
+ "overloads": [
{
- "name": "x",
- "description": "the x component of the vector or a\n p5.Vector or an Array
\n",
- "type": "Number|p5.Vector|Array",
- "optional": true
+ "line": 1319,
+ "params": [
+ {
+ "name": "x",
+ "description": "the x component of the vector
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "y",
+ "description": "the y component of the vector
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "z",
+ "description": "the z component of the vector
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "whether the vectors are equals",
+ "type": "Boolean"
+ }
},
{
- "name": "y",
- "description": "the y component of the vector
\n",
- "type": "Number",
- "optional": true
+ "line": 1349,
+ "params": [
+ {
+ "name": "value",
+ "description": "the vector to compare
\n",
+ "type": "p5.Vector|Array"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Boolean"
+ }
+ }
+ ]
+ },
+ {
+ "file": "src/math/p5.Vector.js",
+ "line": 1374,
+ "description": "Make a new 2D vector from an angle
\n",
+ "itemtype": "method",
+ "name": "fromAngle",
+ "static": 1,
+ "params": [
+ {
+ "name": "angle",
+ "description": "the desired angle, in radians
\n",
+ "type": "Number"
},
{
- "name": "z",
- "description": "the z component of the vector
\n",
+ "name": "length",
+ "description": "the length of the new vector (defaults to 1)
\n",
"type": "Number",
"optional": true
}
],
"return": {
- "description": "whether the vectors are equals",
- "type": "Boolean"
+ "description": "the new p5.Vector object",
+ "type": "p5.Vector"
},
"example": [
- "\n\nv1 = createVector(5,10,20);\nv2 = createVector(5,10,20);\nv3 = createVector(13,10,19);\n\nprint(v1.equals(v2.x,v2.y,v2.z)); // true\nprint(v1.equals(v3.x,v3.y,v3.z)); // false\n\n\n\nvar v1 = createVector(10.0, 20.0, 30.0);\nvar v2 = createVector(10.0, 20.0, 30.0);\nvar v3 = createVector(0.0, 0.0, 0.0);\nprint (v1.equals(v2)) // true\nprint (v1.equals(v3)) // false\n\n"
+ "\n\n\nfunction draw() {\n background(200);\n\n // Create a variable, proportional to the mouseX,\n // varying from 0-360, to represent an angle in degrees.\n angleMode(DEGREES);\n var myDegrees = map(mouseX, 0, width, 0, 360);\n\n // Display that variable in an onscreen text.\n // (Note the nfc() function to truncate additional decimal places,\n // and the \"\\xB0\" character for the degree symbol.)\n var readout = 'angle = ' + nfc(myDegrees, 1) + '\\xB0';\n noStroke();\n fill(0);\n text(readout, 5, 15);\n\n // Create a p5.Vector using the fromAngle function,\n // and extract its x and y components.\n var v = p5.Vector.fromAngle(radians(myDegrees), 30);\n var vx = v.x;\n var vy = v.y;\n\n push();\n translate(width / 2, height / 2);\n noFill();\n stroke(150);\n line(0, 0, 30, 0);\n stroke(0);\n line(0, 0, vx, vy);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13215,24 +14523,35 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 780,
- "description": "Make a new 2D unit vector from an angle
\n",
+ "line": 1426,
+ "description": "Make a new 3D vector from a pair of ISO spherical angles
\n",
"itemtype": "method",
- "name": "fromAngle",
+ "name": "fromAngles",
"static": 1,
"params": [
{
- "name": "angle",
- "description": "the desired angle
\n",
+ "name": "theta",
+ "description": "the polar angle, in radians (zero is up)
\n",
"type": "Number"
+ },
+ {
+ "name": "phi",
+ "description": "the azimuthal angle, in radians\n (zero is out of the screen)
\n",
+ "type": "Number"
+ },
+ {
+ "name": "length",
+ "description": "the length of the new vector (defaults to 1)
\n",
+ "type": "Number",
+ "optional": true
}
],
"return": {
- "description": "the new p5.Vector object",
+ "description": "the new p5.Vector object",
"type": "p5.Vector"
},
"example": [
- "\n\n\nfunction draw() {\n background (200);\n\n // Create a variable, proportional to the mouseX,\n // varying from 0-360, to represent an angle in degrees.\n angleMode(DEGREES);\n var myDegrees = map(mouseX, 0,width, 0,360);\n\n // Display that variable in an onscreen text.\n // (Note the nfc() function to truncate additional decimal places,\n // and the \"\\xB0\" character for the degree symbol.)\n var readout = \"angle = \" + nfc(myDegrees,1,1) + \"\\xB0\"\n noStroke();\n fill (0);\n text (readout, 5, 15);\n\n // Create a p5.Vector using the fromAngle function,\n // and extract its x and y components.\n var v = p5.Vector.fromAngle(radians(myDegrees));\n var vx = v.x;\n var vy = v.y;\n\n push();\n translate (width/2, height/2);\n noFill();\n stroke (150);\n line (0,0, 30,0);\n stroke (0);\n line (0,0, 30*vx, 30*vy);\n pop()\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n fill(255);\n noStroke();\n}\nfunction draw() {\n background(255);\n\n var t = millis() / 1000;\n\n // add three point lights\n pointLight(color('#f00'), p5.Vector.fromAngles(t * 1.0, t * 1.3, 100));\n pointLight(color('#0f0'), p5.Vector.fromAngles(t * 1.1, t * 1.2, 100));\n pointLight(color('#00f'), p5.Vector.fromAngles(t * 1.2, t * 1.1, 100));\n\n sphere(35);\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13240,17 +14559,17 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 837,
+ "line": 1475,
"description": "Make a new 2D unit vector from a random angle
\n",
"itemtype": "method",
"name": "random2D",
"static": 1,
"return": {
- "description": "the new p5.Vector object",
+ "description": "the new p5.Vector object",
"type": "p5.Vector"
},
"example": [
- "\n\n\nvar v = p5.Vector.random2D();\n// May make v's attributes something like:\n// [0.61554617, -0.51195765, 0.0] or\n// [-0.4695841, -0.14366731, 0.0] or\n// [0.6091097, -0.22805278, 0.0]\n\n"
+ "\n\n\nvar v = p5.Vector.random2D();\n// May make v's attributes something like:\n// [0.61554617, -0.51195765, 0.0] or\n// [-0.4695841, -0.14366731, 0.0] or\n// [0.6091097, -0.22805278, 0.0]\nprint(v);\n\n\n\n\n\nfunction setup() {\n frameRate(1);\n}\n\nfunction draw() {\n background(240);\n\n var v0 = createVector(50, 50);\n var v1 = p5.Vector.random2D();\n drawArrow(v0, v1.mult(50), 'black');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n var arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13258,17 +14577,17 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 870,
+ "line": 1528,
"description": "Make a new random 3D unit vector.
\n",
"itemtype": "method",
"name": "random3D",
"static": 1,
"return": {
- "description": "the new p5.Vector object",
+ "description": "the new p5.Vector object",
"type": "p5.Vector"
},
"example": [
- "\n\n\nvar v = p5.Vector.random3D();\n// May make v's attributes something like:\n// [0.61554617, -0.51195765, 0.599168] or\n// [-0.4695841, -0.14366731, -0.8711202] or\n// [0.6091097, -0.22805278, -0.7595902]\n\n"
+ "\n\n\nvar v = p5.Vector.random3D();\n// May make v's attributes something like:\n// [0.61554617, -0.51195765, 0.599168] or\n// [-0.4695841, -0.14366731, -0.8711202] or\n// [0.6091097, -0.22805278, -0.7595902]\nprint(v);\n\n"
],
"class": "p5.Vector",
"module": "Math",
@@ -13276,7 +14595,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 963,
+ "line": 1611,
"description": "Multiplies a vector by a scalar and returns a new vector.
\n",
"class": "p5.Vector",
"module": "Math",
@@ -13284,7 +14603,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 990,
+ "line": 1638,
"description": "Divides a vector by a scalar and returns a new vector.
\n",
"class": "p5.Vector",
"module": "Math",
@@ -13292,7 +14611,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 1018,
+ "line": 1665,
"description": "Calculates the dot product of two vectors.
\n",
"class": "p5.Vector",
"module": "Math",
@@ -13300,7 +14619,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 1032,
+ "line": 1679,
"description": "Calculates the cross product of two vectors.
\n",
"class": "p5.Vector",
"module": "Math",
@@ -13308,7 +14627,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 1046,
+ "line": 1693,
"description": "Calculates the Euclidean distance between two points (considering a\npoint as a vector object).
\n",
"class": "p5.Vector",
"module": "Math",
@@ -13316,7 +14635,7 @@ module.exports={
},
{
"file": "src/math/p5.Vector.js",
- "line": 1061,
+ "line": 1708,
"description": "Linear interpolate a vector to another vector and return the result as a\nnew vector.
\n",
"class": "p5.Vector",
"module": "Math",
@@ -13324,8 +14643,8 @@ module.exports={
},
{
"file": "src/math/random.js",
- "line": 47,
- "description": "Sets the seed value for random().
\nBy default, random() produces different results each time the program\nis run. Set the seed parameter to a constant to return the same\npseudo-random numbers each time the software is run.
\n",
+ "line": 48,
+ "description": "Sets the seed value for random().
\nBy default, random() produces different results each time the program\nis run. Set the seed parameter to a constant to return the same\npseudo-random numbers each time the software is run.
\n",
"itemtype": "method",
"name": "randomSeed",
"params": [
@@ -13336,7 +14655,7 @@ module.exports={
}
],
"example": [
- "\n\n\nrandomSeed(99);\nfor (var i=0; i < 100; i++) {\n var r = random(0, 255);\n stroke(r);\n line(i, 0, i, 100);\n}\n\n"
+ "\n\n\nrandomSeed(99);\nfor (var i = 0; i < 100; i++) {\n var r = random(0, 255);\n stroke(r);\n line(i, 0, i, 100);\n}\n\n"
],
"alt": "many vertical lines drawn in white, black or grey.",
"class": "p5",
@@ -13345,7 +14664,7 @@ module.exports={
},
{
"file": "src/math/random.js",
- "line": 78,
+ "line": 79,
"description": "Return a random floating-point number.
\nTakes either 0, 1 or 2 arguments.
\nIf no argument is given, returns a random number from 0\nup to (but not including) 1.
\nIf one argument is given and it is a number, returns a random number from 0\nup to (but not including) the number.
\nIf one argument is given and it is an array, returns a random element from\nthat array.
\nIf two arguments are given, returns a random number from the\nfirst argument up to (but not including) the second argument.
\n",
"itemtype": "method",
"name": "random",
@@ -13354,7 +14673,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfor (var i = 0; i < 100; i++) {\n var r = random(50);\n stroke(r*5);\n line(50, i, 50+r, i);\n}\n\n\n\n\nfor (var i = 0; i < 100; i++) {\n var r = random(-50, 50);\n line(50,i,50+r,i);\n}\n\n\n\n\n// Get a random element from an array using the random(Array) syntax\nvar words = [ \"apple\", \"bear\", \"cat\", \"dog\" ];\nvar word = random(words); // select random word\ntext(word,10,50); // draw the word\n\n"
+ "\n\n\nfor (var i = 0; i < 100; i++) {\n var r = random(50);\n stroke(r * 5);\n line(50, i, 50 + r, i);\n}\n\n\n\n\nfor (var i = 0; i < 100; i++) {\n var r = random(-50, 50);\n line(50, i, 50 + r, i);\n}\n\n\n\n\n// Get a random element from an array using the random(Array) syntax\nvar words = ['apple', 'bear', 'cat', 'dog'];\nvar word = random(words); // select random word\ntext(word, 10, 50); // draw the word\n\n"
],
"alt": "100 horizontal lines from center canvas to right. size+fill change each time\n100 horizontal lines from center of canvas. height & side change each render\nword displayed at random. Either apple, bear, cat, or dog",
"class": "p5",
@@ -13362,7 +14681,7 @@ module.exports={
"submodule": "Random",
"overloads": [
{
- "line": 78,
+ "line": 79,
"params": [
{
"name": "min",
@@ -13383,7 +14702,7 @@ module.exports={
}
},
{
- "line": 132,
+ "line": 133,
"params": [
{
"name": "choices",
@@ -13400,8 +14719,8 @@ module.exports={
},
{
"file": "src/math/random.js",
- "line": 168,
- "description": "Returns a random number fitting a Gaussian, or\n normal, distribution. There is theoretically no minimum or maximum\n value that randomGaussian() might return. Rather, there is\n just a very low probability that values far from the mean will be\n returned; and a higher probability that numbers near the mean will\n be returned.\n
\n Takes either 0, 1 or 2 arguments.
\n If no args, returns a mean of 0 and standard deviation of 1.
\n If one arg, that arg is the mean (standard deviation is 1).
\n If two args, first is mean, second is standard deviation.
\n",
+ "line": 166,
+ "description": "Returns a random number fitting a Gaussian, or\n normal, distribution. There is theoretically no minimum or maximum\n value that randomGaussian() might return. Rather, there is\n just a very low probability that values far from the mean will be\n returned; and a higher probability that numbers near the mean will\n be returned.\n
\n Takes either 0, 1 or 2 arguments.
\n If no args, returns a mean of 0 and standard deviation of 1.
\n If one arg, that arg is the mean (standard deviation is 1).
\n If two args, first is mean, second is standard deviation.
\n",
"itemtype": "method",
"name": "randomGaussian",
"params": [
@@ -13421,7 +14740,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n \n for (var y = 0; y < 100; y++) {\n var x = randomGaussian(50,15);\n line(50, y, x, y);\n}\n \n \n \n \nvar distribution = new Array(360);\n\nfunction setup() {\n createCanvas(100, 100);\n for (var i = 0; i < distribution.length; i++) {\n distribution[i] = floor(randomGaussian(0,15));\n }\n}\n\nfunction draw() {\n background(204);\n translate(width/2, width/2);\n for (var i = 0; i < distribution.length; i++) {\n rotate(TWO_PI/distribution.length);\n stroke(0);\n var dist = abs(distribution[i]);\n line(0, 0, dist, 0);\n }\n}\n \n "
+ "\n \n \n for (var y = 0; y < 100; y++) {\n var x = randomGaussian(50, 15);\n line(50, y, x, y);\n }\n \n \n \n \n var distribution = new Array(360);\nfunction setup() {\n createCanvas(100, 100);\n for (var i = 0; i < distribution.length; i++) {\n distribution[i] = floor(randomGaussian(0, 15));\n }\n }\nfunction draw() {\n background(204);\n translate(width / 2, width / 2);\n for (var i = 0; i < distribution.length; i++) {\n rotate(TWO_PI / distribution.length);\n stroke(0);\n var dist = abs(distribution[i]);\n line(0, 0, dist, 0);\n }\n }\n \n "
],
"alt": "100 horizontal lines from center of canvas. height & side change each render\n black lines radiate from center of canvas. size determined each render",
"class": "p5",
@@ -13430,8 +14749,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 18,
- "description": "The inverse of cos(), returns the arc cosine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned in\nthe range 0 to PI (3.1415927).
\n",
+ "line": 20,
+ "description": "The inverse of cos(), returns the arc cosine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned in\nthe range 0 to PI (3.1415927).
\n",
"itemtype": "method",
"name": "acos",
"params": [
@@ -13446,7 +14765,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar a = PI;\nvar c = cos(a);\nvar ac = acos(c);\n// Prints: \"3.1415927 : -1.0 : 3.1415927\"\nprint(a + \" : \" + c + \" : \" + ac);\n\n\n\n\n\nvar a = PI + PI/4.0;\nvar c = cos(a);\nvar ac = acos(c);\n// Prints: \"3.926991 : -0.70710665 : 2.3561943\"\nprint(a + \" : \" + c + \" : \" + ac);\n\n"
+ "\n\n\nvar a = PI;\nvar c = cos(a);\nvar ac = acos(c);\n// Prints: \"3.1415927 : -1.0 : 3.1415927\"\nprint(a + ' : ' + c + ' : ' + ac);\n\n\n\n\n\nvar a = PI + PI / 4.0;\nvar c = cos(a);\nvar ac = acos(c);\n// Prints: \"3.926991 : -0.70710665 : 2.3561943\"\nprint(a + ' : ' + c + ' : ' + ac);\n\n"
],
"class": "p5",
"module": "Math",
@@ -13454,8 +14773,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 56,
- "description": "The inverse of sin(), returns the arc sine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned\nin the range -PI/2 to PI/2.
\n",
+ "line": 54,
+ "description": "The inverse of sin(), returns the arc sine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned\nin the range -PI/2 to PI/2.
\n",
"itemtype": "method",
"name": "asin",
"params": [
@@ -13470,7 +14789,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar a = PI + PI/3;\nvar s = sin(a);\nvar as = asin(s);\n// Prints: \"1.0471976 : 0.86602545 : 1.0471976\"\nprint(a + \" : \" + s + \" : \" + as);\n\n\n\n\n\nvar a = PI + PI/3.0;\nvar s = sin(a);\nvar as = asin(s);\n// Prints: \"4.1887903 : -0.86602545 : -1.0471976\"\nprint(a + \" : \" + s + \" : \" + as);\n\n\n"
+ "\n\n\nvar a = PI + PI / 3;\nvar s = sin(a);\nvar as = asin(s);\n// Prints: \"1.0471976 : 0.86602545 : 1.0471976\"\nprint(a + ' : ' + s + ' : ' + as);\n\n\n\n\n\nvar a = PI + PI / 3.0;\nvar s = sin(a);\nvar as = asin(s);\n// Prints: \"4.1887903 : -0.86602545 : -1.0471976\"\nprint(a + ' : ' + s + ' : ' + as);\n\n\n"
],
"class": "p5",
"module": "Math",
@@ -13478,8 +14797,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 95,
- "description": "The inverse of tan(), returns the arc tangent of a value. This function\nexpects the values in the range of -Infinity to Infinity (exclusive) and\nvalues are returned in the range -PI/2 to PI/2.
\n",
+ "line": 89,
+ "description": "The inverse of tan(), returns the arc tangent of a value. This function\nexpects the values in the range of -Infinity to Infinity (exclusive) and\nvalues are returned in the range -PI/2 to PI/2.
\n",
"itemtype": "method",
"name": "atan",
"params": [
@@ -13494,7 +14813,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar a = PI + PI/3;\nvar t = tan(a);\nvar at = atan(t);\n// Prints: \"1.0471976 : 1.7320509 : 1.0471976\"\nprint(a + \" : \" + t + \" : \" + at);\n\n\n\n\n\nvar a = PI + PI/3.0;\nvar t = tan(a);\nvar at = atan(t);\n// Prints: \"4.1887903 : 1.7320513 : 1.0471977\"\nprint(a + \" : \" + t + \" : \" + at);\n\n\n"
+ "\n\n\nvar a = PI + PI / 3;\nvar t = tan(a);\nvar at = atan(t);\n// Prints: \"1.0471976 : 1.7320509 : 1.0471976\"\nprint(a + ' : ' + t + ' : ' + at);\n\n\n\n\n\nvar a = PI + PI / 3.0;\nvar t = tan(a);\nvar at = atan(t);\n// Prints: \"4.1887903 : 1.7320513 : 1.0471977\"\nprint(a + ' : ' + t + ' : ' + at);\n\n\n"
],
"class": "p5",
"module": "Math",
@@ -13502,8 +14821,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 134,
- "description": "Calculates the angle (in radians) from a specified point to the coordinate\norigin as measured from the positive x-axis. Values are returned as a\nfloat in the range from PI to -PI. The atan2() function is most often used\nfor orienting geometry to the position of the cursor.\n
\nNote: The y-coordinate of the point is the first parameter, and the\nx-coordinate is the second parameter, due the the structure of calculating\nthe tangent.
\n",
+ "line": 124,
+ "description": "Calculates the angle (in radians) from a specified point to the coordinate\norigin as measured from the positive x-axis. Values are returned as a\nfloat in the range from PI to -PI. The atan2() function is most often used\nfor orienting geometry to the position of the cursor.\n
\nNote: The y-coordinate of the point is the first parameter, and the\nx-coordinate is the second parameter, due the the structure of calculating\nthe tangent.
\n",
"itemtype": "method",
"name": "atan2",
"params": [
@@ -13523,7 +14842,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nfunction draw() {\n background(204);\n translate(width/2, height/2);\n var a = atan2(mouseY-height/2, mouseX-width/2);\n rotate(a);\n rect(-30, -5, 60, 10);\n}\n\n"
+ "\n\n\nfunction draw() {\n background(204);\n translate(width / 2, height / 2);\n var a = atan2(mouseY - height / 2, mouseX - width / 2);\n rotate(a);\n rect(-30, -5, 60, 10);\n}\n\n"
],
"alt": "60 by 10 rect at center of canvas rotates with mouse movements",
"class": "p5",
@@ -13532,8 +14851,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 174,
- "description": "Calculates the cosine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.
\n",
+ "line": 160,
+ "description": "Calculates the cosine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.
\n",
"itemtype": "method",
"name": "cos",
"params": [
@@ -13548,7 +14867,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar a = 0.0;\nvar inc = TWO_PI/25.0;\nfor (var i = 0; i < 25; i++) {\n line(i*4, 50, i*4, 50+cos(a)*40.0);\n a = a + inc;\n}\n\n"
+ "\n\n\nvar a = 0.0;\nvar inc = TWO_PI / 25.0;\nfor (var i = 0; i < 25; i++) {\n line(i * 4, 50, i * 4, 50 + cos(a) * 40.0);\n a = a + inc;\n}\n\n"
],
"alt": "vertical black lines form wave patterns, extend-down on left and right side",
"class": "p5",
@@ -13557,8 +14876,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 206,
- "description": "Calculates the sine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.
\n",
+ "line": 188,
+ "description": "Calculates the sine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.
\n",
"itemtype": "method",
"name": "sin",
"params": [
@@ -13573,7 +14892,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar a = 0.0;\nvar inc = TWO_PI/25.0;\nfor (var i = 0; i < 25; i++) {\n line(i*4, 50, i*4, 50+sin(a)*40.0);\n a = a + inc;\n}\n\n"
+ "\n\n\nvar a = 0.0;\nvar inc = TWO_PI / 25.0;\nfor (var i = 0; i < 25; i++) {\n line(i * 4, 50, i * 4, 50 + sin(a) * 40.0);\n a = a + inc;\n}\n\n"
],
"alt": "vertical black lines extend down and up from center to form wave pattern",
"class": "p5",
@@ -13582,8 +14901,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 238,
- "description": "Calculates the tangent of an angle. This function takes into account\nthe current angleMode. Values are returned in the range -1 to 1.
\n",
+ "line": 216,
+ "description": "Calculates the tangent of an angle. This function takes into account\nthe current angleMode. Values are returned in the range -1 to 1.
\n",
"itemtype": "method",
"name": "tan",
"params": [
@@ -13598,7 +14917,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\n var a = 0.0;\n var inc = TWO_PI/50.0;\n for (var i = 0; i < 100; i = i+2) {\n line(i, 50, i, 50+tan(a)*2.0);\n a = a + inc;\n }\n"
+ "\n\n\nvar a = 0.0;\nvar inc = TWO_PI / 50.0;\nfor (var i = 0; i < 100; i = i + 2) {\n line(i, 50, i, 50 + tan(a) * 2.0);\n a = a + inc;\n}\n"
],
"alt": "vertical black lines end down and up from center to form spike pattern",
"class": "p5",
@@ -13607,8 +14926,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 270,
- "description": "Converts a radian measurement to its corresponding value in degrees.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964.
\n",
+ "line": 244,
+ "description": "Converts a radian measurement to its corresponding value in degrees.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964. This function does not take into account the\ncurrent angleMode.
\n",
"itemtype": "method",
"name": "degrees",
"params": [
@@ -13623,7 +14942,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar rad = PI/4;\nvar deg = degrees(rad);\nprint(rad + \" radians is \" + deg + \" degrees\");\n// Prints: 0.7853981633974483 radians is 45 degrees\n\n\n"
+ "\n\n\nvar rad = PI / 4;\nvar deg = degrees(rad);\nprint(rad + ' radians is ' + deg + ' degrees');\n// Prints: 0.7853981633974483 radians is 45 degrees\n\n\n"
],
"class": "p5",
"module": "Math",
@@ -13631,8 +14950,8 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 296,
- "description": "Converts a degree measurement to its corresponding value in radians.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964.
\n",
+ "line": 271,
+ "description": "Converts a degree measurement to its corresponding value in radians.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964. This function does not take into account the\ncurrent angleMode.
\n",
"itemtype": "method",
"name": "radians",
"params": [
@@ -13647,7 +14966,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar deg = 45.0;\nvar rad = radians(deg);\nprint(deg + \" degrees is \" + rad + \" radians\");\n// Prints: 45 degrees is 0.7853981633974483 radians\n\n"
+ "\n\n\nvar deg = 45.0;\nvar rad = radians(deg);\nprint(deg + ' degrees is ' + rad + ' radians');\n// Prints: 45 degrees is 0.7853981633974483 radians\n\n"
],
"class": "p5",
"module": "Math",
@@ -13655,7 +14974,7 @@ module.exports={
},
{
"file": "src/math/trigonometry.js",
- "line": 320,
+ "line": 296,
"description": "Sets the current mode of p5 to given mode. Default mode is RADIANS.
\n",
"itemtype": "method",
"name": "angleMode",
@@ -13667,7 +14986,7 @@ module.exports={
}
],
"example": [
- "\n\n\nfunction draw(){\n background(204);\n angleMode(DEGREES); // Change the mode to DEGREES\n var a = atan2(mouseY-height/2, mouseX-width/2);\n translate(width/2, height/2);\n push();\n rotate(a);\n rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees\n pop();\n angleMode(RADIANS); // Change the mode to RADIANS\n rotate(a); // var a stays the same\n rect(-40, -5, 20, 10); // Smaller rectangle is rotating in radians\n}\n\n"
+ "\n\n\nfunction draw() {\n background(204);\n angleMode(DEGREES); // Change the mode to DEGREES\n var a = atan2(mouseY - height / 2, mouseX - width / 2);\n translate(width / 2, height / 2);\n push();\n rotate(a);\n rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees\n pop();\n angleMode(RADIANS); // Change the mode to RADIANS\n rotate(a); // var a stays the same\n rect(-40, -5, 20, 10); // Smaller rectangle is rotating in radians\n}\n\n"
],
"alt": "40 by 10 rect in center rotates with mouse moves. 20 by 10 rect moves faster.",
"class": "p5",
@@ -13677,47 +14996,62 @@ module.exports={
{
"file": "src/typography/attributes.js",
"line": 13,
- "description": "Sets the current alignment for drawing text. Accepts two\narguments: horizAlign (LEFT, CENTER, or RIGHT) and\nvertAlign (TOP, BOTTOM, CENTER, or BASELINE).
\nThe horizAlign parameter is in reference to the x value\nof the text() function, while the vertAlign parameter is\nin reference to the y value.
\nSo if you write textAlign(LEFT), you are aligning the left\nedge of your text to the x value you give in text(). If you\nwrite textAlign(RIGHT, TOP), you are aligning the right edge\nof your text to the x value and the top of edge of the text\nto the y value.
\n",
+ "description": "Sets the current alignment for drawing text. Accepts two\narguments: horizAlign (LEFT, CENTER, or RIGHT) and\nvertAlign (TOP, BOTTOM, CENTER, or BASELINE).
\nThe horizAlign parameter is in reference to the x value\nof the text() function, while the vertAlign parameter is\nin reference to the y value.
\nSo if you write textAlign(LEFT), you are aligning the left\nedge of your text to the x value you give in text(). If you\nwrite textAlign(RIGHT, TOP), you are aligning the right edge\nof your text to the x value and the top of edge of the text\nto the y value.
\n",
"itemtype": "method",
"name": "textAlign",
- "params": [
- {
- "name": "horizAlign",
- "description": "horizontal alignment, either LEFT,\n CENTER, or RIGHT
\n",
- "type": "Constant"
- },
- {
- "name": "vertAlign",
- "description": "vertical alignment, either TOP,\n BOTTOM, CENTER, or BASELINE
\n",
- "type": "Constant",
- "optional": true
- }
- ],
- "return": {
- "description": "",
- "type": "Number"
- },
+ "chainable": 1,
"example": [
- "\n\n\ntextSize(16);\ntextAlign(RIGHT);\ntext(\"ABCD\", 50, 30);\ntextAlign(CENTER);\ntext(\"EFGH\", 50, 50);\ntextAlign(LEFT);\ntext(\"IJKL\", 50, 70);\n\n"
+ "\n\n\ntextSize(16);\ntextAlign(RIGHT);\ntext('ABCD', 50, 30);\ntextAlign(CENTER);\ntext('EFGH', 50, 50);\ntextAlign(LEFT);\ntext('IJKL', 50, 70);\n\n\n\n\n\ntextSize(16);\nstrokeWeight(0.5);\n\nline(0, 12, width, 12);\ntextAlign(CENTER, TOP);\ntext('TOP', 0, 12, width);\n\nline(0, 37, width, 37);\ntextAlign(CENTER, CENTER);\ntext('CENTER', 0, 37, width);\n\nline(0, 62, width, 62);\ntextAlign(CENTER, BASELINE);\ntext('BASELINE', 0, 62, width);\n\nline(0, 87, width, 87);\ntextAlign(CENTER, BOTTOM);\ntext('BOTTOM', 0, 87, width);\n\n"
],
- "alt": "Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left.",
+ "alt": "Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left.\nThe names of the four vertical alignments rendered each showing that alignment's placement relative to a horizontal line.",
"class": "p5",
"module": "Typography",
- "submodule": "Attributes"
+ "submodule": "Attributes",
+ "overloads": [
+ {
+ "line": 13,
+ "params": [
+ {
+ "name": "horizAlign",
+ "description": "horizontal alignment, either LEFT,\n CENTER, or RIGHT
\n",
+ "type": "Constant"
+ },
+ {
+ "name": "vertAlign",
+ "description": "vertical alignment, either TOP,\n BOTTOM, CENTER, or BASELINE
\n",
+ "type": "Constant",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 75,
+ "params": [],
+ "return": {
+ "description": "",
+ "type": "Object"
+ }
+ }
+ ]
},
{
"file": "src/typography/attributes.js",
- "line": 55,
- "description": "Sets/gets the spacing, in pixels, between lines of text. This\nsetting will be used in all subsequent calls to the text() function.
\n",
+ "line": 84,
+ "description": "Sets/gets the spacing, in pixels, between lines of text. This\nsetting will be used in all subsequent calls to the text() function.
\n",
"itemtype": "method",
"name": "textLeading",
"chainable": 1,
+ "example": [
+ "\n\n\n// Text to display. The \"\\n\" is a \"new line\" character\nvar lines = 'L1\\nL2\\nL3';\ntextSize(12);\n\ntextLeading(10); // Set leading to 10\ntext(lines, 10, 25);\n\ntextLeading(20); // Set leading to 20\ntext(lines, 40, 25);\n\ntextLeading(30); // Set leading to 30\ntext(lines, 70, 25);\n\n"
+ ],
+ "alt": "set L1 L2 & L3 displayed vertically 3 times. spacing increases for each set",
"class": "p5",
"module": "Typography",
"submodule": "Attributes",
"overloads": [
{
- "line": 55,
+ "line": 84,
"params": [
{
"name": "leading",
@@ -13728,7 +15062,7 @@ module.exports={
"chainable": 1
},
{
- "line": 63,
+ "line": 113,
"params": [],
"return": {
"description": "",
@@ -13739,17 +15073,21 @@ module.exports={
},
{
"file": "src/typography/attributes.js",
- "line": 92,
- "description": "Sets/gets the current font size. This size will be used in all subsequent\ncalls to the text() function. Font size is measured in pixels.
\n",
+ "line": 122,
+ "description": "Sets/gets the current font size. This size will be used in all subsequent\ncalls to the text() function. Font size is measured in pixels.
\n",
"itemtype": "method",
"name": "textSize",
"chainable": 1,
+ "example": [
+ "\n\n\ntextSize(12);\ntext('Font Size 12', 10, 30);\ntextSize(14);\ntext('Font Size 14', 10, 60);\ntextSize(16);\ntext('Font Size 16', 10, 90);\n\n"
+ ],
+ "alt": "Font Size 12 displayed small, Font Size 14 medium & Font Size 16 large",
"class": "p5",
"module": "Typography",
"submodule": "Attributes",
"overloads": [
{
- "line": 92,
+ "line": 122,
"params": [
{
"name": "theSize",
@@ -13760,7 +15098,7 @@ module.exports={
"chainable": 1
},
{
- "line": 100,
+ "line": 145,
"params": [],
"return": {
"description": "",
@@ -13771,17 +15109,21 @@ module.exports={
},
{
"file": "src/typography/attributes.js",
- "line": 123,
+ "line": 154,
"description": "Sets/gets the style of the text for system fonts to NORMAL, ITALIC, or BOLD.\nNote: this may be is overridden by CSS styling. For non-system fonts\n(opentype, truetype, etc.) please load styled fonts instead.
\n",
"itemtype": "method",
"name": "textStyle",
"chainable": 1,
+ "example": [
+ "\n\n\nstrokeWeight(0);\ntextSize(12);\ntextStyle(NORMAL);\ntext('Font Style Normal', 10, 30);\ntextStyle(ITALIC);\ntext('Font Style Italic', 10, 60);\ntextStyle(BOLD);\ntext('Font Style Bold', 10, 90);\n\n"
+ ],
+ "alt": "words Font Style Normal displayed normally, Italic in italic and bold in bold",
"class": "p5",
"module": "Typography",
"submodule": "Attributes",
"overloads": [
{
- "line": 123,
+ "line": 154,
"params": [
{
"name": "theStyle",
@@ -13792,7 +15134,7 @@ module.exports={
"chainable": 1
},
{
- "line": 133,
+ "line": 180,
"params": [],
"return": {
"description": "",
@@ -13803,7 +15145,7 @@ module.exports={
},
{
"file": "src/typography/attributes.js",
- "line": 158,
+ "line": 189,
"description": "Calculates and returns the width of any character or text string.
\n",
"itemtype": "method",
"name": "textWidth",
@@ -13819,7 +15161,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\ntextSize(28);\n\nvar aChar = 'P';\nvar cWidth = textWidth(aChar);\ntext(aChar, 0, 40);\nline(cWidth, 0, cWidth, 50);\n\nvar aString = \"p5.js\";\nvar sWidth = textWidth(aString);\ntext(aString, 0, 85);\nline(sWidth, 50, sWidth, 100);\n\n"
+ "\n\n\ntextSize(28);\n\nvar aChar = 'P';\nvar cWidth = textWidth(aChar);\ntext(aChar, 0, 40);\nline(cWidth, 0, cWidth, 50);\n\nvar aString = 'p5.js';\nvar sWidth = textWidth(aString);\ntext(aString, 0, 85);\nline(sWidth, 50, sWidth, 100);\n\n"
],
"alt": "Letter P and p5.js are displayed with vertical lines at end. P is wide",
"class": "p5",
@@ -13828,7 +15170,7 @@ module.exports={
},
{
"file": "src/typography/attributes.js",
- "line": 192,
+ "line": 224,
"description": "Returns the ascent of the current font at its current size. The ascent\nrepresents the distance, in pixels, of the tallest character above\nthe baseline.
\n",
"itemtype": "method",
"name": "textAscent",
@@ -13837,7 +15179,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar base = height * 0.75;\nvar scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nvar asc = textAscent() * scalar; // Calc ascent\nline(0, base - asc, width, base - asc);\ntext(\"dp\", 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\nasc = textAscent() * scalar; // Recalc ascent\nline(40, base - asc, width, base - asc);\ntext(\"dp\", 40, base); // Draw text on baseline\n\n"
+ "\n\n\nvar base = height * 0.75;\nvar scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nvar asc = textAscent() * scalar; // Calc ascent\nline(0, base - asc, width, base - asc);\ntext('dp', 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\nasc = textAscent() * scalar; // Recalc ascent\nline(40, base - asc, width, base - asc);\ntext('dp', 40, base); // Draw text on baseline\n\n"
],
"class": "p5",
"module": "Typography",
@@ -13845,7 +15187,7 @@ module.exports={
},
{
"file": "src/typography/attributes.js",
- "line": 220,
+ "line": 253,
"description": "Returns the descent of the current font at its current size. The descent\nrepresents the distance, in pixels, of the character with the longest\ndescender below the baseline.
\n",
"itemtype": "method",
"name": "textDescent",
@@ -13854,7 +15196,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar base = height * 0.75;\nvar scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nvar desc = textDescent() * scalar; // Calc ascent\nline(0, base+desc, width, base+desc);\ntext(\"dp\", 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\ndesc = textDescent() * scalar; // Recalc ascent\nline(40, base + desc, width, base + desc);\ntext(\"dp\", 40, base); // Draw text on baseline\n\n"
+ "\n\n\nvar base = height * 0.75;\nvar scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nvar desc = textDescent() * scalar; // Calc ascent\nline(0, base + desc, width, base + desc);\ntext('dp', 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\ndesc = textDescent() * scalar; // Recalc ascent\nline(40, base + desc, width, base + desc);\ntext('dp', 40, base); // Draw text on baseline\n\n"
],
"class": "p5",
"module": "Typography",
@@ -13862,7 +15204,7 @@ module.exports={
},
{
"file": "src/typography/attributes.js",
- "line": 248,
+ "line": 282,
"description": "Helper function to measure ascent and descent.
\n",
"class": "p5",
"module": "Typography",
@@ -13882,17 +15224,23 @@ module.exports={
},
{
"name": "callback",
- "description": "function to be executed after\n loadFont()\n completes
\n",
+ "description": "function to be executed after\n loadFont() completes
\n",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "onError",
+ "description": "function to be executed if\n an error occurs
\n",
"type": "Function",
"optional": true
}
],
"return": {
- "description": "p5.Font object",
+ "description": "p5.Font object",
"type": "p5.Font"
},
"example": [
- "\n\nCalling loadFont() inside preload() guarantees that the load\noperation will have completed before setup() and draw() are called.
\n\n\nvar myFont;\nfunction preload() {\n myFont = loadFont('assets/AvenirNextLTPro-Demi.otf');\n}\n\nfunction setup() {\n fill('#ED225D');\n textFont(myFont);\n textSize(36);\n text('p5*js', 10, 50);\n}\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:\n\n\nfunction setup() {\n loadFont('assets/AvenirNextLTPro-Demi.otf', drawText);\n}\n\nfunction drawText(font) {\n fill('#ED225D');\n textFont(font, 36);\n text('p5*js', 10, 50);\n}\n\n\n\nYou can also use the string name of the font to style other HTML\nelements.
\n\n\nvar myFont;\n\nfunction preload() {\n myFont = loadFont('assets/Avenir.otf');\n}\n\nfunction setup() {\n var myDiv = createDiv('hello there');\n myDiv.style('font-family', 'Avenir');\n}\n"
+ "\n\nCalling loadFont() inside preload() guarantees that the load\noperation will have completed before setup() and draw() are called.
\n\n\nvar myFont;\nfunction preload() {\n myFont = loadFont('assets/AvenirNextLTPro-Demi.otf');\n}\n\nfunction setup() {\n fill('#ED225D');\n textFont(myFont);\n textSize(36);\n text('p5*js', 10, 50);\n}\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:\n\n\nfunction setup() {\n loadFont('assets/AvenirNextLTPro-Demi.otf', drawText);\n}\n\nfunction drawText(font) {\n fill('#ED225D');\n textFont(font, 36);\n text('p5*js', 10, 50);\n}\n\n\nYou can also use the string name of the font to style other HTML\nelements.
\n\n\nfunction preload() {\n loadFont('assets/Avenir.otf');\n}\n\nfunction setup() {\n var myDiv = createDiv('hello there');\n myDiv.style('font-family', 'Avenir');\n}\n"
],
"alt": "p5*js in p5's theme dark pink\np5*js in p5's theme dark pink",
"class": "p5",
@@ -13901,15 +15249,15 @@ module.exports={
},
{
"file": "src/typography/loading_displaying.js",
- "line": 135,
- "description": "Draws text to the screen. Displays the information specified in the first\nparameter on the screen in the position specified by the additional\nparameters. A default font will be used unless a font is set with the\ntextFont() function and a default size will be used unless a font is set\nwith textSize(). Change the color of the text with the fill() function.\nChange the outline of the text with the stroke() and strokeWeight()\nfunctions.\n
\nThe text displays in relation to the textAlign() function, which gives the\noption to draw to the left, right, and center of the coordinates.\n
\nThe x2 and y2 parameters define a rectangular area to display within and\nmay only be used with string data. When these parameters are specified,\nthey are interpreted based on the current rectMode() setting. Text that\ndoes not fit completely within the rectangle specified will not be drawn\nto the screen.
\n",
+ "line": 143,
+ "description": "Draws text to the screen. Displays the information specified in the first\nparameter on the screen in the position specified by the additional\nparameters. A default font will be used unless a font is set with the\ntextFont() function and a default size will be used unless a font is set\nwith textSize(). Change the color of the text with the fill() function.\nChange the outline of the text with the stroke() and strokeWeight()\nfunctions.\n
\nThe text displays in relation to the textAlign() function, which gives the\noption to draw to the left, right, and center of the coordinates.\n
\nThe x2 and y2 parameters define a rectangular area to display within and\nmay only be used with string data. When these parameters are specified,\nthey are interpreted based on the current rectMode() setting. Text that\ndoes not fit completely within the rectangle specified will not be drawn\nto the screen. If x2 and y2 are not specified, the baseline alignment is the\ndefault, which means that the text will be drawn upwards from x and y.\n
\nWEBGL: Only opentype/truetype fonts are supported. You must load a font using the\nloadFont() method (see the example above).\nstroke() currently has no effect in webgl mode.
\n",
"itemtype": "method",
"name": "text",
"params": [
{
"name": "str",
- "description": "the alphanumeric symbols to be displayed
\n",
- "type": "String"
+ "description": "the alphanumeric\n symbols to be displayed
\n",
+ "type": "String|Object|Array|Number|Boolean"
},
{
"name": "x",
@@ -13923,45 +15271,46 @@ module.exports={
},
{
"name": "x2",
- "description": "by default, the width of the text box,\n see rectMode() for more info
\n",
+ "description": "by default, the width of the text box,\n see rectMode() for more info
\n",
"type": "Number",
"optional": true
},
{
"name": "y2",
- "description": "by default, the height of the text box,\n see rectMode() for more info
\n",
+ "description": "by default, the height of the text box,\n see rectMode() for more info
\n",
"type": "Number",
"optional": true
}
],
- "return": {
- "description": "this",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
- "\n\n\ntextSize(32);\ntext(\"word\", 10, 30);\nfill(0, 102, 153);\ntext(\"word\", 10, 60);\nfill(0, 102, 153, 51);\ntext(\"word\", 10, 90);\n\n\n\n\ns = \"The quick brown fox jumped over the lazy dog.\";\nfill(50);\ntext(s, 10, 10, 70, 80); // Text wraps within text box\n\n"
+ "\n\n\ntextSize(32);\ntext('word', 10, 30);\nfill(0, 102, 153);\ntext('word', 10, 60);\nfill(0, 102, 153, 51);\ntext('word', 10, 90);\n\n\n\n\nvar s = 'The quick brown fox jumped over the lazy dog.';\nfill(50);\ntext(s, 10, 10, 70, 80); // Text wraps within text box\n\n\n\n\n\nvar avenir;\nfunction preload() {\n avenir = loadFont('assets/Avenir.otf');\n}\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n textFont(avenir);\n textSize(width / 3);\n textAlign(CENTER, CENTER);\n}\nfunction draw() {\n background(0);\n var time = millis();\n rotateX(time / 1000);\n rotateZ(time / 1234);\n text('p5.js', 0, 0);\n}\n\n"
],
- "alt": "'word' displayed 3 times going from black, blue to translucent blue\nThe quick brown fox jumped over the lazy dog.",
+ "alt": "'word' displayed 3 times going from black, blue to translucent blue\nThe quick brown fox jumped over the lazy dog.\nthe text 'p5.js' spinning in 3d",
"class": "p5",
"module": "Typography",
"submodule": "Loading & Displaying"
},
{
"file": "src/typography/loading_displaying.js",
- "line": 191,
- "description": "Sets the current font that will be drawn with the text() function.
\n",
+ "line": 230,
+ "description": "Sets the current font that will be drawn with the text() function.\n
\nWEBGL: Only fonts loaded via loadFont() are supported.
\n",
"itemtype": "method",
"name": "textFont",
"return": {
"description": "the current font",
"type": "Object"
},
+ "example": [
+ "\n\n\nfill(0);\ntextSize(12);\ntextFont('Georgia');\ntext('Georgia', 12, 30);\ntextFont('Helvetica');\ntext('Helvetica', 12, 60);\n\n\n\n\nvar fontRegular, fontItalic, fontBold;\nfunction preload() {\n fontRegular = loadFont('assets/Regular.otf');\n fontItalic = loadFont('assets/Italic.ttf');\n fontBold = loadFont('assets/Bold.ttf');\n}\nfunction setup() {\n background(210);\n fill(0)\n .strokeWeight(0)\n .textSize(10);\n textFont(fontRegular);\n text('Font Style Normal', 10, 30);\n textFont(fontItalic);\n text('Font Style Italic', 10, 50);\n textFont(fontBold);\n text('Font Style Bold', 10, 70);\n}\n\n"
+ ],
+ "alt": "words Font Style Normal displayed normally, Italic in italic and bold in bold",
"class": "p5",
"module": "Typography",
"submodule": "Loading & Displaying",
"overloads": [
{
- "line": 191,
+ "line": 230,
"params": [],
"return": {
"description": "the current font",
@@ -13969,11 +15318,11 @@ module.exports={
}
},
{
- "line": 197,
+ "line": 275,
"params": [
{
"name": "font",
- "description": "a font loaded via loadFont(), or a String\nrepresenting a web safe font (a font\nthat is generally available across all systems)
\n",
+ "description": "a font loaded via loadFont(), or a String\nrepresenting a web safe font (a font\nthat is generally available across all systems)
\n",
"type": "Object|String"
},
{
@@ -13989,7 +15338,7 @@ module.exports={
},
{
"file": "src/typography/p5.Font.js",
- "line": 33,
+ "line": 31,
"description": "Underlying opentype font implementation
\n",
"itemtype": "property",
"name": "font",
@@ -13999,7 +15348,7 @@ module.exports={
},
{
"file": "src/typography/p5.Font.js",
- "line": 47,
+ "line": 43,
"description": "Returns a tight bounding box for the given text string using this\nfont (currently only supports single lines)
\n",
"itemtype": "method",
"name": "textBounds",
@@ -14022,12 +15371,14 @@ module.exports={
{
"name": "fontSize",
"description": "font size to use (optional)
\n",
- "type": "Number"
+ "type": "Number",
+ "optional": true
},
{
"name": "options",
"description": "opentype options (optional)
\n",
- "type": "Object"
+ "type": "Object",
+ "optional": true
}
],
"return": {
@@ -14035,7 +15386,7 @@ module.exports={
"type": "Object"
},
"example": [
- "\n\n\nvar font;\nvar textString = 'Lorem ipsum dolor sit amet.';\nfunction preload() {\n font = loadFont('./assets/Regular.otf');\n};\nfunction setup() {\n background(210);\n\n var bbox = font.textBounds(textString, 10, 30, 12);\n fill(255);\n stroke(0);\n rect(bbox.x, bbox.y, bbox.w, bbox.h);\n fill(0);\n noStroke();\n\n textFont(font);\n textSize(12);\n text(textString, 10, 30);\n};\n\n"
+ "\n\n\nvar font;\nvar textString = 'Lorem ipsum dolor sit amet.';\nfunction preload() {\n font = loadFont('./assets/Regular.otf');\n}\nfunction setup() {\n background(210);\n\n var bbox = font.textBounds(textString, 10, 30, 12);\n fill(255);\n stroke(0);\n rect(bbox.x, bbox.y, bbox.w, bbox.h);\n fill(0);\n noStroke();\n\n textFont(font);\n textSize(12);\n text(textString, 10, 30);\n}\n\n"
],
"alt": "words Lorem ipsum dol go off canvas and contained by white bounding box",
"class": "p5.Font",
@@ -14044,7 +15395,7 @@ module.exports={
},
{
"file": "src/typography/p5.Font.js",
- "line": 148,
+ "line": 157,
"description": "Computes an array of points following the path for specified text
\n",
"itemtype": "method",
"name": "textToPoints",
@@ -14072,66 +15423,17 @@ module.exports={
{
"name": "options",
"description": "an (optional) object that can contain:
\n
sampleFactor - the ratio of path-length to number of samples\n(default=.25); higher values yield more points and are therefore\nmore precise
\n
simplifyThreshold - if set to a non-zero value, collinear points will be\nbe removed from the polygon; the value represents the threshold angle to use\nwhen determining whether two edges are collinear
\n",
- "type": "Object"
+ "type": "Object",
+ "optional": true
}
],
"return": {
"description": "an array of points, each with x, y, alpha (the path angle)",
"type": "Array"
},
- "class": "p5.Font",
- "module": "Typography",
- "submodule": "Font"
- },
- {
- "file": "src/typography/p5.Font.js",
- "line": 206,
- "description": "Returns the set of opentype glyphs for the supplied string.
\nNote that there is not a strict one-to-one mapping between characters\nand glyphs, so the list of returned glyphs can be larger or smaller\n than the length of the given string.
\n",
- "params": [
- {
- "name": "str",
- "description": "the string to be converted
\n",
- "type": "String"
- }
- ],
- "return": {
- "description": "the opentype glyphs",
- "type": "Array"
- },
- "class": "p5.Font",
- "module": "Typography",
- "submodule": "Font"
- },
- {
- "file": "src/typography/p5.Font.js",
- "line": 221,
- "description": "Returns an opentype path for the supplied string and position.
\n",
- "params": [
- {
- "name": "line",
- "description": "a line of text
\n",
- "type": "String"
- },
- {
- "name": "x",
- "description": "x-position
\n",
- "type": "Number"
- },
- {
- "name": "y",
- "description": "y-position
\n",
- "type": "Number"
- },
- {
- "name": "options",
- "description": "opentype options (optional)
\n",
- "type": "Object"
- }
+ "example": [
+ "\n\n\nvar font;\nfunction preload() {\n font = loadFont('./assets/Avenir.otf');\n}\n\nvar points;\nvar bounds;\nfunction setup() {\n createCanvas(100, 100);\n stroke(0);\n fill(255, 104, 204);\n\n points = font.textToPoints('p5', 0, 0, 10, {\n sampleFactor: 5,\n simplifyThreshold: 0\n });\n bounds = font.textBounds(' p5 ', 0, 0, 10);\n}\n\nfunction draw() {\n background(255);\n beginShape();\n translate(-bounds.x * width / bounds.w, -bounds.y * height / bounds.h);\n for (var i = 0; i < points.length; i++) {\n var p = points[i];\n vertex(\n p.x * width / bounds.w +\n sin(20 * p.y / bounds.h + millis() / 1000) * width / 30,\n p.y * height / bounds.h\n );\n }\n endShape(CLOSE);\n}\n\n\n"
],
- "return": {
- "description": "the opentype path",
- "type": "Object"
- },
"class": "p5.Font",
"module": "Typography",
"submodule": "Font"
@@ -14142,6 +15444,8 @@ module.exports={
"description": "Adds a value to the end of an array. Extends the length of\nthe array by one. Maps to Array.push().
\n",
"itemtype": "method",
"name": "append",
+ "deprecated": true,
+ "deprecationMessage": "Use array.push(value) instead.",
"params": [
{
"name": "array",
@@ -14154,8 +15458,12 @@ module.exports={
"type": "Any"
}
],
+ "return": {
+ "description": "the array that was appended to",
+ "type": "Array"
+ },
"example": [
- "\n\nfunction setup() {\n\nvar myArray = new Array(\"Mango\", \"Apple\", \"Papaya\")\nprint(myArray) // [\"Mango\", \"Apple\", \"Papaya\"]\n\nappend(myArray, \"Peach\")\nprint(myArray) // [\"Mango\", \"Apple\", \"Papaya\", \"Peach\"]\n\n}\n"
+ "\n\nfunction setup() {\n var myArray = ['Mango', 'Apple', 'Papaya'];\n print(myArray); // ['Mango', 'Apple', 'Papaya']\n\n append(myArray, 'Peach');\n print(myArray); // ['Mango', 'Apple', 'Papaya', 'Peach']\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14164,9 +15472,13 @@ module.exports={
{
"file": "src/utilities/array_functions.js",
"line": 37,
- "description": "Copies an array (or part of an array) to another array. The src array is\ncopied to the dst array, beginning at the position specified by\nsrcPosition and into the position specified by dstPosition. The number of\nelements to copy is determined by length. Note that copying values\noverwrites existing values in the destination array. To append values\ninstead of overwriting them, use concat().\n
\nThe simplified version with only two arguments, arrayCopy(src, dst),\ncopies an entire array to another of the same size. It is equivalent to\narrayCopy(src, 0, dst, 0, src.length).\n
\nUsing this function is far more efficient for copying array data than\niterating through a for() loop and copying each element individually.
\n",
+ "description": "Copies an array (or part of an array) to another array. The src array is\ncopied to the dst array, beginning at the position specified by\nsrcPosition and into the position specified by dstPosition. The number of\nelements to copy is determined by length. Note that copying values\noverwrites existing values in the destination array. To append values\ninstead of overwriting them, use concat().\n
\nThe simplified version with only two arguments, arrayCopy(src, dst),\ncopies an entire array to another of the same size. It is equivalent to\narrayCopy(src, 0, dst, 0, src.length).\n
\nUsing this function is far more efficient for copying array data than\niterating through a for() loop and copying each element individually.
\n",
"itemtype": "method",
"name": "arrayCopy",
+ "deprecated": true,
+ "example": [
+ "\n\nvar src = ['A', 'B', 'C'];\nvar dst = [1, 2, 3];\nvar srcPosition = 1;\nvar dstPosition = 0;\nvar length = 2;\n\nprint(src); // ['A', 'B', 'C']\nprint(dst); // [ 1 , 2 , 3 ]\n\narrayCopy(src, srcPosition, dst, dstPosition, length);\nprint(dst); // ['B', 'C', 3]\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Array Functions",
@@ -14182,7 +15494,7 @@ module.exports={
{
"name": "srcPosition",
"description": "starting position in the source Array
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "dst",
@@ -14192,17 +15504,17 @@ module.exports={
{
"name": "dstPosition",
"description": "starting position in the destination Array
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "length",
"description": "number of Array elements to be copied
\n",
- "type": "Number"
+ "type": "Integer"
}
]
},
{
- "line": 59,
+ "line": 75,
"params": [
{
"name": "src",
@@ -14217,7 +15529,7 @@ module.exports={
{
"name": "length",
"description": "",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
]
@@ -14226,10 +15538,12 @@ module.exports={
},
{
"file": "src/utilities/array_functions.js",
- "line": 124,
+ "line": 114,
"description": "Concatenates two arrays, maps to Array.concat(). Does not modify the\ninput arrays.
\n",
"itemtype": "method",
"name": "concat",
+ "deprecated": true,
+ "deprecationMessage": "Use arr1.concat(arr2) instead.",
"params": [
{
"name": "a",
@@ -14247,7 +15561,7 @@ module.exports={
"type": "Array"
},
"example": [
- "\n\nfunction setup() {\n var arr1 = new Array(\"A\", \"B\", \"C\");\n var arr2 = new Array( 1 , 2 , 3 );\n\n print(arr1); // [\"A\",\"B\",\"C\"]\n print(arr2); // [1,2,3]\n\n var arr3 = concat(arr1, arr2);\n\n print(arr1); // [\"A\",\"B\",\"C\"]\n print(arr2); // [1,2,3]\n print(arr3); // [\"A\",\"B\",\"C\",1,2,3]\n\n}\n"
+ "\n\nfunction setup() {\n var arr1 = ['A', 'B', 'C'];\n var arr2 = [1, 2, 3];\n\n print(arr1); // ['A','B','C']\n print(arr2); // [1,2,3]\n\n var arr3 = concat(arr1, arr2);\n\n print(arr1); // ['A','B','C']\n print(arr2); // [1, 2, 3]\n print(arr3); // ['A','B','C', 1, 2, 3]\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14255,10 +15569,12 @@ module.exports={
},
{
"file": "src/utilities/array_functions.js",
- "line": 155,
+ "line": 145,
"description": "Reverses the order of an array, maps to Array.reverse()
\n",
"itemtype": "method",
"name": "reverse",
+ "deprecated": true,
+ "deprecationMessage": "Use array.reverse() instead.",
"params": [
{
"name": "list",
@@ -14266,8 +15582,12 @@ module.exports={
"type": "Array"
}
],
+ "return": {
+ "description": "the reversed list",
+ "type": "Array"
+ },
"example": [
- "\n\nfunction setup() {\n var myArray = new Array(\"A\", \"B\", \"C\");\n print(myArray); // [\"A\",\"B\",\"C\"]\n\n reverse(myArray);\n print(myArray); // [\"C\",\"B\",\"A\"]\n}\n"
+ "\n\nfunction setup() {\n var myArray = ['A', 'B', 'C'];\n print(myArray); // ['A','B','C']\n\n reverse(myArray);\n print(myArray); // ['C','B','A']\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14275,10 +15595,12 @@ module.exports={
},
{
"file": "src/utilities/array_functions.js",
- "line": 175,
+ "line": 167,
"description": "Decreases an array by one element and returns the shortened array,\nmaps to Array.pop().
\n",
"itemtype": "method",
"name": "shorten",
+ "deprecated": true,
+ "deprecationMessage": "Use array.pop() instead.",
"params": [
{
"name": "list",
@@ -14291,7 +15613,7 @@ module.exports={
"type": "Array"
},
"example": [
- "\n\nfunction setup() {\n var myArray = new Array(\"A\", \"B\", \"C\");\n print(myArray); // [\"A\",\"B\",\"C\"]\n\n var newArray = shorten(myArray);\n print(myArray); // [\"A\",\"B\",\"C\"]\n print(newArray); // [\"A\",\"B\"]\n}\n"
+ "\n\nfunction setup() {\n var myArray = ['A', 'B', 'C'];\n print(myArray); // ['A', 'B', 'C']\n var newArray = shorten(myArray);\n print(myArray); // ['A','B','C']\n print(newArray); // ['A','B']\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14299,10 +15621,12 @@ module.exports={
},
{
"file": "src/utilities/array_functions.js",
- "line": 199,
- "description": "Randomizes the order of the elements of an array. Implements\n\nFisher-Yates Shuffle Algorithm.
\n",
+ "line": 191,
+ "description": "Randomizes the order of the elements of an array. Implements\n\nFisher-Yates Shuffle Algorithm.
\n",
"itemtype": "method",
"name": "shuffle",
+ "deprecated": true,
+ "deprecationMessage": "See shuffling an array with JS instead.",
"params": [
{
"name": "array",
@@ -14329,10 +15653,12 @@ module.exports={
},
{
"file": "src/utilities/array_functions.js",
- "line": 239,
+ "line": 234,
"description": "Sorts an array of numbers from smallest to largest, or puts an array of\nwords in alphabetical order. The original array is not modified; a\nre-ordered array is returned. The count parameter states the number of\nelements to sort. For example, if there are 12 elements in an array and\ncount is set to 5, only the first 5 elements in the array will be sorted.
\n",
"itemtype": "method",
"name": "sort",
+ "deprecated": true,
+ "deprecationMessage": "Use array.sort() instead.",
"params": [
{
"name": "list",
@@ -14342,12 +15668,16 @@ module.exports={
{
"name": "count",
"description": "number of elements to sort, starting from 0
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
],
+ "return": {
+ "description": "the sorted list",
+ "type": "Array"
+ },
"example": [
- "\n\nfunction setup() {\n var words = new Array(\"banana\", \"apple\", \"pear\",\"lime\");\n print(words); // [\"banana\", \"apple\", \"pear\", \"lime\"]\n var count = 4; // length of array\n\n words = sort(words, count);\n print(words); // [\"apple\", \"banana\", \"lime\", \"pear\"]\n}\n\n\nfunction setup() {\n var numbers = new Array(2,6,1,5,14,9,8,12);\n print(numbers); // [2,6,1,5,14,9,8,12]\n var count = 5; // Less than the length of the array\n\n numbers = sort(numbers, count);\n print(numbers); // [1,2,5,6,14,9,8,12]\n}\n"
+ "\n\nfunction setup() {\n var words = ['banana', 'apple', 'pear', 'lime'];\n print(words); // ['banana', 'apple', 'pear', 'lime']\n var count = 4; // length of array\n\n words = sort(words, count);\n print(words); // ['apple', 'banana', 'lime', 'pear']\n}\n\n\nfunction setup() {\n var numbers = [2, 6, 1, 5, 14, 9, 8, 12];\n print(numbers); // [2, 6, 1, 5, 14, 9, 8, 12]\n var count = 5; // Less than the length of the array\n\n numbers = sort(numbers, count);\n print(numbers); // [1,2,5,6,14,9,8,12]\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14355,10 +15685,12 @@ module.exports={
},
{
"file": "src/utilities/array_functions.js",
- "line": 283,
+ "line": 282,
"description": "Inserts a value or an array of values into an existing array. The first\nparameter specifies the initial array to be modified, and the second\nparameter defines the data to be inserted. The third parameter is an index\nvalue which specifies the array position from which to insert data.\n(Remember that array index numbering starts at zero, so the first position\nis 0, the second position is 1, and so on.)
\n",
"itemtype": "method",
"name": "splice",
+ "deprecated": true,
+ "deprecationMessage": "Use array.splice() instead.",
"params": [
{
"name": "list",
@@ -14373,11 +15705,15 @@ module.exports={
{
"name": "position",
"description": "in the array from which to insert data
\n",
- "type": "Number"
+ "type": "Integer"
}
],
+ "return": {
+ "description": "the list",
+ "type": "Array"
+ },
"example": [
- "\n\nfunction setup() {\n var myArray = new Array(0,1,2,3,4);\n var insArray = new Array(\"A\",\"B\",\"C\");\n print(myArray); // [0,1,2,3,4]\n print(insArray); // [\"A\",\"B\",\"C\"]\n\n splice(myArray, insArray, 3);\n print(myArray); // [0,1,2,\"A\",\"B\",\"C\",3,4]\n}\n"
+ "\n\nfunction setup() {\n var myArray = [0, 1, 2, 3, 4];\n var insArray = ['A', 'B', 'C'];\n print(myArray); // [0, 1, 2, 3, 4]\n print(insArray); // ['A','B','C']\n\n splice(myArray, insArray, 3);\n print(myArray); // [0,1,2,'A','B','C',3,4]\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14389,6 +15725,8 @@ module.exports={
"description": "Extracts an array of elements from an existing array. The list parameter\ndefines the array from which the elements will be copied, and the start\nand count parameters specify which elements to extract. If no count is\ngiven, elements will be extracted from the start to the end of the array.\nWhen specifying the start, remember that the first array element is 0.\nThis function does not change the source array.
\n",
"itemtype": "method",
"name": "subset",
+ "deprecated": true,
+ "deprecationMessage": "Use array.slice() instead.",
"params": [
{
"name": "list",
@@ -14398,12 +15736,12 @@ module.exports={
{
"name": "start",
"description": "position to begin
\n",
- "type": "Number"
+ "type": "Integer"
},
{
"name": "count",
"description": "number of values to extract
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
],
@@ -14412,7 +15750,7 @@ module.exports={
"type": "Array"
},
"example": [
- "\n\nfunction setup() {\n var myArray = new Array(1,2,3,4,5);\n print(myArray); // [1,2,3,4,5]\n\n var sub1 = subset(myArray, 0, 3);\n var sub2 = subset(myArray, 2, 2);\n print(sub1); // [1,2,3]\n print(sub2); // [3,4]\n}\n"
+ "\n\nfunction setup() {\n var myArray = [1, 2, 3, 4, 5];\n print(myArray); // [1, 2, 3, 4, 5]\n\n var sub1 = subset(myArray, 0, 3);\n var sub2 = subset(myArray, 2, 2);\n print(sub1); // [1,2,3]\n print(sub2); // [3,4]\n}\n"
],
"class": "p5",
"module": "Data",
@@ -14436,7 +15774,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nvar str = '20';\nvar diameter = float(str);\nellipse(width/2, height/2, diameter, diameter);\n"
+ "\n\nvar str = '20';\nvar diameter = float(str);\nellipse(width / 2, height / 2, diameter, diameter);\n"
],
"alt": "20 by 20 white ellipse in the center of the canvas",
"class": "p5",
@@ -14453,6 +15791,9 @@ module.exports={
"description": "integer representation of value",
"type": "Number"
},
+ "example": [
+ "\n\nprint(int('10')); // 10\nprint(int(10.31)); // 10\nprint(int(-10)); // -10\nprint(int(true)); // 1\nprint(int(false)); // 0\nprint(int([false, true, '10.3', 9.8])); // [0, 1, 10, 9]\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Conversion",
@@ -14464,6 +15805,12 @@ module.exports={
"name": "n",
"description": "value to parse
\n",
"type": "String|Boolean|Number"
+ },
+ {
+ "name": "radix",
+ "description": "the radix to convert to (default: 10)
\n",
+ "type": "Integer",
+ "optional": true
}
],
"return": {
@@ -14472,7 +15819,7 @@ module.exports={
}
},
{
- "line": 51,
+ "line": 62,
"params": [
{
"name": "ns",
@@ -14489,7 +15836,7 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 79,
+ "line": 82,
"description": "Converts a boolean, string or number to its string representation.\nWhen an array of values is passed in, then an array of strings of the same\nlength is returned.
\n",
"itemtype": "method",
"name": "str",
@@ -14505,7 +15852,7 @@ module.exports={
"type": "String"
},
"example": [
- "\n\nprint(str(\"10\")); // \"10\"\nprint(str(10.31)); // \"10.31\"\nprint(str(-10)); // \"-10\"\nprint(str(true)); // \"true\"\nprint(str(false)); // \"false\"\nprint(str([true, \"10.3\", 9.8])); // [ \"true\", \"10.3\", \"9.8\" ]\n"
+ "\n\nprint(str('10')); // \"10\"\nprint(str(10.31)); // \"10.31\"\nprint(str(-10)); // \"-10\"\nprint(str(true)); // \"true\"\nprint(str(false)); // \"false\"\nprint(str([true, '10.3', 9.8])); // [ \"true\", \"10.3\", \"9.8\" ]\n"
],
"class": "p5",
"module": "Data",
@@ -14513,7 +15860,7 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 105,
+ "line": 108,
"description": "Converts a number or string to its boolean representation.\nFor a number, any non-zero value (positive or negative) evaluates to true,\nwhile zero evaluates to false. For a string, the value "true" evaluates to\ntrue, while any other value evaluates to false. When an array of number or\nstring values is passed in, then a array of booleans of the same length is\nreturned.
\n",
"itemtype": "method",
"name": "boolean",
@@ -14529,7 +15876,7 @@ module.exports={
"type": "Boolean"
},
"example": [
- "\n\nprint(boolean(0)); // false\nprint(boolean(1)); // true\nprint(boolean(\"true\")); // true\nprint(boolean(\"abcd\")); // false\nprint(boolean([0, 12, \"true\"])); // [false, true, false]\n"
+ "\n\nprint(boolean(0)); // false\nprint(boolean(1)); // true\nprint(boolean('true')); // true\nprint(boolean('abcd')); // false\nprint(boolean([0, 12, 'true'])); // [false, true, false]\n"
],
"class": "p5",
"module": "Data",
@@ -14537,20 +15884,23 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 137,
- "description": "Converts a number, string or boolean to its byte representation.\nA byte can be only a whole number between -128 and 127, so when a value\noutside of this range is converted, it wraps around to the corresponding\nbyte representation. When an array of number, string or boolean values is\npassed in, then an array of bytes the same length is returned.
\n",
+ "line": 140,
+ "description": "Converts a number, string representation of a number, or boolean to its byte\nrepresentation. A byte can be only a whole number between -128 and 127, so\nwhen a value outside of this range is converted, it wraps around to the\ncorresponding byte representation. When an array of number, string or boolean\nvalues is passed in, then an array of bytes the same length is returned.
\n",
"itemtype": "method",
"name": "byte",
"return": {
"description": "byte representation of value",
"type": "Number"
},
+ "example": [
+ "\n\nprint(byte(127)); // 127\nprint(byte(128)); // -128\nprint(byte(23.4)); // 23\nprint(byte('23.4')); // 23\nprint(byte('hello')); // NaN\nprint(byte(true)); // 1\nprint(byte([0, 255, '100'])); // [0, -1, 100]\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Conversion",
"overloads": [
{
- "line": 137,
+ "line": 140,
"params": [
{
"name": "n",
@@ -14564,7 +15914,7 @@ module.exports={
}
},
{
- "line": 148,
+ "line": 162,
"params": [
{
"name": "ns",
@@ -14581,7 +15931,7 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 171,
+ "line": 176,
"description": "Converts a number or string to its corresponding single-character\nstring representation. If a string parameter is provided, it is first\nparsed as an integer and then translated into a single-character string.\nWhen an array of number or string values is passed in, then an array of\nsingle-character strings of the same length is returned.
\n",
"itemtype": "method",
"name": "char",
@@ -14589,12 +15939,15 @@ module.exports={
"description": "string representation of value",
"type": "String"
},
+ "example": [
+ "\n\nprint(char(65)); // \"A\"\nprint(char('65')); // \"A\"\nprint(char([65, 66, 67])); // [ \"A\", \"B\", \"C\" ]\nprint(join(char([65, 66, 67]), '')); // \"ABC\"\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Conversion",
"overloads": [
{
- "line": 171,
+ "line": 176,
"params": [
{
"name": "n",
@@ -14608,7 +15961,7 @@ module.exports={
}
},
{
- "line": 182,
+ "line": 195,
"params": [
{
"name": "ns",
@@ -14625,7 +15978,7 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 204,
+ "line": 210,
"description": "Converts a single-character string to its corresponding integer\nrepresentation. When an array of single-character string values is passed\nin, then an array of integers of the same length is returned.
\n",
"itemtype": "method",
"name": "unchar",
@@ -14633,12 +15986,15 @@ module.exports={
"description": "integer representation of value",
"type": "Number"
},
+ "example": [
+ "\n\nprint(unchar('A')); // 65\nprint(unchar(['A', 'B', 'C'])); // [ 65, 66, 67 ]\nprint(unchar(split('ABC', ''))); // [ 65, 66, 67 ]\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Conversion",
"overloads": [
{
- "line": 204,
+ "line": 210,
"params": [
{
"name": "n",
@@ -14652,7 +16008,7 @@ module.exports={
}
},
{
- "line": 213,
+ "line": 226,
"params": [
{
"name": "ns",
@@ -14669,7 +16025,7 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 232,
+ "line": 239,
"description": "Converts a number to a string in its equivalent hexadecimal notation. If a\nsecond parameter is passed, it is used to set the number of characters to\ngenerate in the hexadecimal notation. When an array is passed in, an\narray of strings in hexadecimal notation of the same length is returned.
\n",
"itemtype": "method",
"name": "hex",
@@ -14677,12 +16033,15 @@ module.exports={
"description": "hexadecimal string representation of value",
"type": "String"
},
+ "example": [
+ "\n\nprint(hex(255)); // \"000000FF\"\nprint(hex(255, 6)); // \"0000FF\"\nprint(hex([0, 127, 255], 6)); // [ \"000000\", \"00007F\", \"0000FF\" ]\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Conversion",
"overloads": [
{
- "line": 232,
+ "line": 239,
"params": [
{
"name": "n",
@@ -14702,7 +16061,7 @@ module.exports={
}
},
{
- "line": 243,
+ "line": 257,
"params": [
{
"name": "ns",
@@ -14725,7 +16084,7 @@ module.exports={
},
{
"file": "src/utilities/conversion.js",
- "line": 274,
+ "line": 286,
"description": "Converts a string representation of a hexadecimal number to its equivalent\ninteger value. When an array of strings in hexadecimal notation is passed\nin, an array of integers of the same length is returned.
\n",
"itemtype": "method",
"name": "unhex",
@@ -14733,12 +16092,15 @@ module.exports={
"description": "integer representation of hexadecimal value",
"type": "Number"
},
+ "example": [
+ "\n\nprint(unhex('A')); // 10\nprint(unhex('FF')); // 255\nprint(unhex(['FF', 'AA', '00'])); // [ 255, 170, 0 ]\n"
+ ],
"class": "p5",
"module": "Data",
"submodule": "Conversion",
"overloads": [
{
- "line": 274,
+ "line": 286,
"params": [
{
"name": "n",
@@ -14752,7 +16114,7 @@ module.exports={
}
},
{
- "line": 283,
+ "line": 302,
"params": [
{
"name": "ns",
@@ -14770,7 +16132,7 @@ module.exports={
{
"file": "src/utilities/string_functions.js",
"line": 15,
- "description": "Combines an array of Strings into one String, each separated by the\ncharacter(s) used for the separator parameter. To join arrays of ints or\nfloats, it's necessary to first convert them to Strings using nf() or\nnfs().
\n",
+ "description": "Combines an array of Strings into one String, each separated by the\ncharacter(s) used for the separator parameter. To join arrays of ints or\nfloats, it's necessary to first convert them to Strings using nf() or\nnfs().
\n",
"itemtype": "method",
"name": "join",
"params": [
@@ -14790,7 +16152,7 @@ module.exports={
"type": "String"
},
"example": [
- "\n\n\nvar array = [\"Hello\", \"world!\"]\nvar separator = \" \"\nvar message = join(array, separator);\ntext(message, 5, 50);\n\n"
+ "\n\n\nvar array = ['Hello', 'world!'];\nvar separator = ' ';\nvar message = join(array, separator);\ntext(message, 5, 50);\n\n"
],
"alt": "\"hello world!\" displayed middle left of canvas.",
"class": "p5",
@@ -14820,7 +16182,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\n\nvar string = \"Hello p5js*!\"\nvar regexp = \"p5js\\\\*\"\nvar match = match(string, regexp);\ntext(match, 5, 50);\n\n"
+ "\n\n\nvar string = 'Hello p5js*!';\nvar regexp = 'p5js\\\\*';\nvar m = match(string, regexp);\ntext(m, 5, 50);\n\n"
],
"alt": "\"p5js*\" displayed middle left of canvas.",
"class": "p5",
@@ -14850,7 +16212,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\n\nvar string = \"Hello p5js*! Hello world!\"\nvar regexp = \"Hello\"\nmatchAll(string, regexp);\n\n"
+ "\n\n\nvar string = 'Hello p5js*! Hello world!';\nvar regexp = 'Hello';\nmatchAll(string, regexp);\n\n"
],
"class": "p5",
"module": "Data",
@@ -14866,6 +16228,10 @@ module.exports={
"description": "formatted String",
"type": "String"
},
+ "example": [
+ "\n\n\nfunction setup() {\n background(200);\n var num = 112.53106115;\n\n noStroke();\n fill(0);\n textSize(14);\n // Draw formatted numbers\n text(nf(num, 5, 2), 10, 20);\n\n text(nf(num, 4, 3), 10, 55);\n\n text(nf(num, 3, 6), 10, 85);\n\n // Draw dividing lines\n stroke(120);\n line(0, 30, width, 30);\n line(0, 65, width, 65);\n}\n\n"
+ ],
+ "alt": "\"0011253\" top left, \"0112.531\" mid left, \"112.531061\" bottom left canvas",
"class": "p5",
"module": "Data",
"submodule": "String Functions",
@@ -14881,13 +16247,13 @@ module.exports={
{
"name": "left",
"description": "number of digits to the left of the\n decimal point
\n",
- "type": "Number|String",
+ "type": "Integer|String",
"optional": true
},
{
"name": "right",
"description": "number of digits to the right of the\n decimal point
\n",
- "type": "Number|String",
+ "type": "Integer|String",
"optional": true
}
],
@@ -14897,7 +16263,7 @@ module.exports={
}
},
{
- "line": 146,
+ "line": 174,
"params": [
{
"name": "nums",
@@ -14907,26 +16273,26 @@ module.exports={
{
"name": "left",
"description": "",
- "type": "Number|String",
+ "type": "Integer|String",
"optional": true
},
{
"name": "right",
"description": "",
- "type": "Number|String",
+ "type": "Integer|String",
"optional": true
}
],
"return": {
- "description": "formatted Strings\\",
- "type": "Array"
+ "description": "formatted Strings",
+ "type": "String[]"
}
}
]
},
{
"file": "src/utilities/string_functions.js",
- "line": 245,
+ "line": 237,
"description": "Utility function for formatting numbers into strings and placing\nappropriate commas to mark units of 1000. There are two versions: one\nfor formatting ints, and one for formatting an array of ints. The value\nfor the right parameter should always be a positive integer.
\n",
"itemtype": "method",
"name": "nfc",
@@ -14934,12 +16300,16 @@ module.exports={
"description": "formatted String",
"type": "String"
},
+ "example": [
+ "\n\n\nfunction setup() {\n background(200);\n var num = 11253106.115;\n var numArr = [1, 1, 2];\n\n noStroke();\n fill(0);\n textSize(12);\n\n // Draw formatted numbers\n text(nfc(num, 4), 10, 30);\n text(nfc(numArr, 2), 10, 80);\n\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n"
+ ],
+ "alt": "\"11,253,106.115\" top middle and \"1.00,1.00,2.00\" displayed bottom mid",
"class": "p5",
"module": "Data",
"submodule": "String Functions",
"overloads": [
{
- "line": 245,
+ "line": 237,
"params": [
{
"name": "num",
@@ -14949,7 +16319,7 @@ module.exports={
{
"name": "right",
"description": "number of digits to the right of the\n decimal point
\n",
- "type": "Number|String",
+ "type": "Integer|String",
"optional": true
}
],
@@ -14959,7 +16329,7 @@ module.exports={
}
},
{
- "line": 257,
+ "line": 275,
"params": [
{
"name": "nums",
@@ -14969,33 +16339,37 @@ module.exports={
{
"name": "right",
"description": "",
- "type": "Number|String",
+ "type": "Integer|String",
"optional": true
}
],
"return": {
"description": "formatted Strings",
- "type": "Array"
+ "type": "String[]"
}
}
]
},
{
"file": "src/utilities/string_functions.js",
- "line": 324,
- "description": "Utility function for formatting numbers into strings. Similar to nf() but\nputs a "+" in front of positive numbers and a "-" in front of negative\nnumbers. There are two versions: one for formatting floats, and one for\nformatting ints. The values for left, and right parameters\nshould always be positive integers.
\n",
+ "line": 313,
+ "description": "Utility function for formatting numbers into strings. Similar to nf() but\nputs a "+" in front of positive numbers and a "-" in front of negative\nnumbers. There are two versions: one for formatting floats, and one for\nformatting ints. The values for left, and right parameters\nshould always be positive integers.
\n",
"itemtype": "method",
"name": "nfp",
"return": {
"description": "formatted String",
"type": "String"
},
+ "example": [
+ "\n\n\nfunction setup() {\n background(200);\n var num1 = 11253106.115;\n var num2 = -11253106.115;\n\n noStroke();\n fill(0);\n textSize(12);\n\n // Draw formatted numbers\n text(nfp(num1, 4, 2), 10, 30);\n text(nfp(num2, 4, 2), 10, 80);\n\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n"
+ ],
+ "alt": "\"+11253106.11\" top middle and \"-11253106.11\" displayed bottom middle",
"class": "p5",
"module": "Data",
"submodule": "String Functions",
"overloads": [
{
- "line": 324,
+ "line": 313,
"params": [
{
"name": "num",
@@ -15005,13 +16379,13 @@ module.exports={
{
"name": "left",
"description": "number of digits to the left of the decimal\n point
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
},
{
"name": "right",
"description": "number of digits to the right of the\n decimal point
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
],
@@ -15021,7 +16395,7 @@ module.exports={
}
},
{
- "line": 339,
+ "line": 354,
"params": [
{
"name": "nums",
@@ -15031,13 +16405,13 @@ module.exports={
{
"name": "left",
"description": "",
- "type": "Number",
+ "type": "Integer",
"optional": true
},
{
"name": "right",
"description": "",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
],
@@ -15050,20 +16424,24 @@ module.exports={
},
{
"file": "src/utilities/string_functions.js",
- "line": 389,
- "description": "Utility function for formatting numbers into strings. Similar to nf() but\nputs a " " (space) in front of positive numbers and a "-" in front of\nnegative numbers. There are two versions: one for formatting floats, and\none for formatting ints. The values for the digits, left, and right\nparameters should always be positive integers.
\n",
+ "line": 375,
+ "description": "Utility function for formatting numbers into strings. Similar to nf() but\nputs a " " (space) in front of positive numbers and a "-" in front of\nnegative numbers. There are two versions: one for formatting floats, and\none for formatting ints. The values for the digits, left, and right\nparameters should always be positive integers.
\n",
"itemtype": "method",
"name": "nfs",
"return": {
"description": "formatted String",
"type": "String"
},
+ "example": [
+ "\n\n\nfunction setup() {\n background(200);\n var num1 = 11253106.115;\n var num2 = -11253106.115;\n\n noStroke();\n fill(0);\n textSize(12);\n // Draw formatted numbers\n text(nfs(num1, 4, 2), 10, 30);\n\n text(nfs(num2, 4, 2), 10, 80);\n\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n"
+ ],
+ "alt": "\"11253106.11\" top middle and \"-11253106.11\" displayed bottom middle",
"class": "p5",
"module": "Data",
"submodule": "String Functions",
"overloads": [
{
- "line": 389,
+ "line": 375,
"params": [
{
"name": "num",
@@ -15073,13 +16451,13 @@ module.exports={
{
"name": "left",
"description": "number of digits to the left of the decimal\n point
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
},
{
"name": "right",
"description": "number of digits to the right of the\n decimal point
\n",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
],
@@ -15089,7 +16467,7 @@ module.exports={
}
},
{
- "line": 404,
+ "line": 416,
"params": [
{
"name": "nums",
@@ -15099,27 +16477,27 @@ module.exports={
{
"name": "left",
"description": "",
- "type": "Number",
+ "type": "Integer",
"optional": true
},
{
"name": "right",
"description": "",
- "type": "Number",
+ "type": "Integer",
"optional": true
}
],
"return": {
"description": "formatted Strings",
- "type": "Array"
+ "type": "String[]"
}
}
]
},
{
"file": "src/utilities/string_functions.js",
- "line": 454,
- "description": "The split() function maps to String.split(), it breaks a String into\npieces using a character or string as the delimiter. The delim parameter\nspecifies the character or characters that mark the boundaries between\neach piece. A String[] array is returned that contains each of the pieces.
\nThe splitTokens() function works in a similar fashion, except that it\nsplits using a range of characters instead of a specific character or\nsequence.
\n",
+ "line": 437,
+ "description": "The split() function maps to String.split(), it breaks a String into\npieces using a character or string as the delimiter. The delim parameter\nspecifies the character or characters that mark the boundaries between\neach piece. A String[] array is returned that contains each of the pieces.
\nThe splitTokens() function works in a similar fashion, except that it\nsplits using a range of characters instead of a specific character or\nsequence.
\n",
"itemtype": "method",
"name": "split",
"params": [
@@ -15139,7 +16517,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\n\nvar names = \"Pat,Xio,Alex\"\nvar splitString = split(names, \",\");\ntext(splitString[0], 5, 30);\ntext(splitString[1], 5, 50);\ntext(splitString[2], 5, 70);\n\n"
+ "\n\n\nvar names = 'Pat,Xio,Alex';\nvar splitString = split(names, ',');\ntext(splitString[0], 5, 30);\ntext(splitString[1], 5, 50);\ntext(splitString[2], 5, 70);\n\n"
],
"alt": "\"pat\" top left, \"Xio\" mid left and \"Alex\" displayed bottom left",
"class": "p5",
@@ -15148,8 +16526,8 @@ module.exports={
},
{
"file": "src/utilities/string_functions.js",
- "line": 488,
- "description": "The splitTokens() function splits a String at one or many character\ndelimiters or "tokens." The delim parameter specifies the character or\ncharacters to be used as a boundary.\n
\nIf no delim characters are specified, any whitespace character is used to\nsplit. Whitespace characters include tab (\\t), line feed (\\n), carriage\nreturn (\\r), form feed (\\f), and space.
\n",
+ "line": 471,
+ "description": "The splitTokens() function splits a String at one or many character\ndelimiters or "tokens." The delim parameter specifies the character or\ncharacters to be used as a boundary.\n
\nIf no delim characters are specified, any whitespace character is used to\nsplit. Whitespace characters include tab (\\t), line feed (\\n), carriage\nreturn (\\r), form feed (\\f), and space.
\n",
"itemtype": "method",
"name": "splitTokens",
"params": [
@@ -15170,7 +16548,7 @@ module.exports={
"type": "String[]"
},
"example": [
- "\n\n\nfunction setup() {\n var myStr = \"Mango, Banana, Lime\";\n var myStrArr = splitTokens(myStr, \",\");\n\n print(myStrArr); // prints : [\"Mango\",\" Banana\",\" Lime\"]\n}\n\n"
+ "\n\n\nfunction setup() {\n var myStr = 'Mango, Banana, Lime';\n var myStrArr = splitTokens(myStr, ',');\n\n print(myStrArr); // prints : [\"Mango\",\" Banana\",\" Lime\"]\n}\n\n"
],
"class": "p5",
"module": "Data",
@@ -15178,7 +16556,7 @@ module.exports={
},
{
"file": "src/utilities/string_functions.js",
- "line": 541,
+ "line": 526,
"description": "Removes whitespace characters from the beginning and end of a String. In\naddition to standard whitespace characters such as space, carriage return,\nand tab, this function also removes the Unicode "nbsp" character.
\n",
"itemtype": "method",
"name": "trim",
@@ -15186,12 +16564,16 @@ module.exports={
"description": "a trimmed String",
"type": "String"
},
+ "example": [
+ "\n\n\nvar string = trim(' No new lines\\n ');\ntext(string + ' here', 2, 50);\n\n"
+ ],
+ "alt": "\"No new lines here\" displayed center canvas",
"class": "p5",
"module": "Data",
"submodule": "String Functions",
"overloads": [
{
- "line": 541,
+ "line": 526,
"params": [
{
"name": "str",
@@ -15205,7 +16587,7 @@ module.exports={
}
},
{
- "line": 550,
+ "line": 546,
"params": [
{
"name": "strs",
@@ -15215,7 +16597,7 @@ module.exports={
],
"return": {
"description": "an Array of trimmed Strings",
- "type": "Array"
+ "type": "String[]"
}
}
]
@@ -15223,15 +16605,15 @@ module.exports={
{
"file": "src/utilities/time_date.js",
"line": 12,
- "description": "p5.js communicates with the clock on your computer. The day() function\nreturns the current day as a value from 1 - 31.
\n",
+ "description": "p5.js communicates with the clock on your computer. The day() function\nreturns the current day as a value from 1 - 31.
\n",
"itemtype": "method",
"name": "day",
"return": {
"description": "the current day",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n\nvar d = day();\ntext(\"Current day: \\n\" + d, 5, 50);\n\n"
+ "\n\n\nvar d = day();\ntext('Current day: \\n' + d, 5, 50);\n\n"
],
"alt": "Current day is displayed",
"class": "p5",
@@ -15241,15 +16623,15 @@ module.exports={
{
"file": "src/utilities/time_date.js",
"line": 34,
- "description": "p5.js communicates with the clock on your computer. The hour() function\nreturns the current hour as a value from 0 - 23.
\n",
+ "description": "p5.js communicates with the clock on your computer. The hour() function\nreturns the current hour as a value from 0 - 23.
\n",
"itemtype": "method",
"name": "hour",
"return": {
"description": "the current hour",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n\nvar h = hour();\ntext(\"Current hour:\\n\" + h, 5, 50);\n\n"
+ "\n\n\nvar h = hour();\ntext('Current hour:\\n' + h, 5, 50);\n\n"
],
"alt": "Current hour is displayed",
"class": "p5",
@@ -15259,15 +16641,15 @@ module.exports={
{
"file": "src/utilities/time_date.js",
"line": 56,
- "description": "p5.js communicates with the clock on your computer. The minute() function\nreturns the current minute as a value from 0 - 59.
\n",
+ "description": "p5.js communicates with the clock on your computer. The minute() function\nreturns the current minute as a value from 0 - 59.
\n",
"itemtype": "method",
"name": "minute",
"return": {
"description": "the current minute",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n\nvar m = minute();\ntext(\"Current minute: \\n\" + m, 5, 50);\n\n"
+ "\n\n\nvar m = minute();\ntext('Current minute: \\n' + m, 5, 50);\n\n"
],
"alt": "Current minute is displayed",
"class": "p5",
@@ -15285,7 +16667,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\nvar millisecond = millis();\ntext(\"Milliseconds \\nrunning: \\n\" + millisecond, 5, 40);\n\n"
+ "\n\n\nvar millisecond = millis();\ntext('Milliseconds \\nrunning: \\n' + millisecond, 5, 40);\n\n"
],
"alt": "number of milliseconds since program has started displayed",
"class": "p5",
@@ -15295,15 +16677,15 @@ module.exports={
{
"file": "src/utilities/time_date.js",
"line": 101,
- "description": "p5.js communicates with the clock on your computer. The month() function\nreturns the current month as a value from 1 - 12.
\n",
+ "description": "p5.js communicates with the clock on your computer. The month() function\nreturns the current month as a value from 1 - 12.
\n",
"itemtype": "method",
"name": "month",
"return": {
"description": "the current month",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n\nvar m = month();\ntext(\"Current month: \\n\" + m, 5, 50);\n\n"
+ "\n\n\nvar m = month();\ntext('Current month: \\n' + m, 5, 50);\n\n"
],
"alt": "Current month is displayed",
"class": "p5",
@@ -15313,15 +16695,15 @@ module.exports={
{
"file": "src/utilities/time_date.js",
"line": 123,
- "description": "p5.js communicates with the clock on your computer. The second() function\nreturns the current second as a value from 0 - 59.
\n",
+ "description": "p5.js communicates with the clock on your computer. The second() function\nreturns the current second as a value from 0 - 59.
\n",
"itemtype": "method",
"name": "second",
"return": {
"description": "the current second",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n\nvar s = second();\ntext(\"Current second: \\n\" + s, 5, 50);\n\n"
+ "\n\n\nvar s = second();\ntext('Current second: \\n' + s, 5, 50);\n\n"
],
"alt": "Current second is displayed",
"class": "p5",
@@ -15331,15 +16713,15 @@ module.exports={
{
"file": "src/utilities/time_date.js",
"line": 145,
- "description": "p5.js communicates with the clock on your computer. The year() function\nreturns the current year as an integer (2014, 2015, 2016, etc).
\n",
+ "description": "p5.js communicates with the clock on your computer. The year() function\nreturns the current year as an integer (2014, 2015, 2016, etc).
\n",
"itemtype": "method",
"name": "year",
"return": {
"description": "the current year",
- "type": "Number"
+ "type": "Integer"
},
"example": [
- "\n\n\nvar y = year();\ntext(\"Current year: \\n\" + y, 5, 50);\n\n"
+ "\n\n\nvar y = year();\ntext('Current year: \\n' + y, 5, 50);\n\n"
],
"alt": "Current year is displayed",
"class": "p5",
@@ -15347,1606 +16729,1652 @@ module.exports={
"submodule": "Time & Date"
},
{
- "file": "src/webgl/camera.js",
- "line": 12,
- "description": "Sets camera position for a 3D sketch. The function behaves similarly\ngluLookAt, except that it replaces the existing modelview matrix instead\nof applying any transformations calculated here on top of the existing\nmodel view.\nWhen called with no arguments, this function\nsets a default camera equivalent to calling\ncamera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0);
\n",
+ "file": "src/webgl/3d_primitives.js",
+ "line": 15,
+ "description": "Draw a plane with given a width and height
\n",
"itemtype": "method",
- "name": "camera",
+ "name": "plane",
"params": [
{
- "name": "x",
- "description": "camera position value on x axis
\n",
+ "name": "width",
+ "description": "width of the plane
\n",
"type": "Number",
"optional": true
},
{
- "name": "y",
- "description": "camera position value on y axis
\n",
+ "name": "height",
+ "description": "height of the plane
\n",
"type": "Number",
"optional": true
},
{
- "name": "z",
- "description": "camera position value on z axis
\n",
- "type": "Number",
+ "name": "detailX",
+ "description": "Optional number of triangle\n subdivisions in x-dimension
\n",
+ "type": "Integer",
"optional": true
},
{
- "name": "centerX",
- "description": "x coordinate representing center of the sketch
\n",
- "type": "Number",
+ "name": "detailY",
+ "description": "Optional number of triangle\n subdivisions in y-dimension
\n",
+ "type": "Integer",
"optional": true
- },
+ }
+ ],
+ "chainable": 1,
+ "example": [
+ "\n\n\n//draw a plane with width 50 and height 50\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n plane(50, 50);\n}\n\n"
+ ],
+ "alt": "Nothing displayed on canvas\nRotating interior view of a box with sides that change color.\n3d red and green gradient.\nRotating interior view of a cylinder with sides that change color.\nRotating view of a cylinder with sides that change color.\n3d red and green gradient.\nrotating view of a multi-colored cylinder with concave sides.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "3D Primitives"
+ },
+ {
+ "file": "src/webgl/3d_primitives.js",
+ "line": 98,
+ "description": "Draw a box with given width, height and depth
\n",
+ "itemtype": "method",
+ "name": "box",
+ "params": [
{
- "name": "centerY",
- "description": "y coordinate representing center of the sketch
\n",
+ "name": "width",
+ "description": "width of the box
\n",
"type": "Number",
"optional": true
},
{
- "name": "centerZ",
- "description": "z coordinate representing center of the sketch
\n",
+ "name": "Height",
+ "description": "height of the box
\n",
"type": "Number",
"optional": true
},
{
- "name": "upX",
- "description": "x component of direction 'up' from camera
\n",
+ "name": "depth",
+ "description": "depth of the box
\n",
"type": "Number",
"optional": true
},
{
- "name": "upY",
- "description": "y component of direction 'up' from camera
\n",
- "type": "Number",
+ "name": "detailX",
+ "description": "Optional number of triangle\n subdivisions in x-dimension
\n",
+ "type": "Integer",
"optional": true
},
{
- "name": "upZ",
- "description": "z component of direction 'up' from camera
\n",
- "type": "Number",
+ "name": "detailY",
+ "description": "Optional number of triangle\n subdivisions in y-dimension
\n",
+ "type": "Integer",
"optional": true
}
],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n //move the camera away from the plane by a sin wave\n camera(0, 0, sin(frameCount * 0.01) * 100, 0, 0, 0, 0, 1, 0);\n plane(120, 120);\n}\n\n"
+ "\n\n\n//draw a spinning box with width, height and depth 200\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(50);\n}\n\n"
],
- "alt": "blue square shrinks in size grows to fill canvas. disappears then loops.",
"class": "p5",
- "module": "Lights, Camera",
- "submodule": "Camera"
+ "module": "Shape",
+ "submodule": "3D Primitives"
},
{
- "file": "src/webgl/camera.js",
- "line": 160,
- "description": "Sets perspective camera. When called with no arguments, the defaults\nprovided are equivalent to\nperspective(PI/3.0, width/height, cameraZ/10.0, cameraZ10.0)\nwhere cameraZ is ((height/2.0) / tan(PI60.0/360.0));
\n",
+ "file": "src/webgl/3d_primitives.js",
+ "line": 215,
+ "description": "Draw a sphere with given radius
\n",
"itemtype": "method",
- "name": "perspective",
+ "name": "sphere",
"params": [
{
- "name": "fovy",
- "description": "camera frustum vertical field of view,\n from bottom to top of view, in degrees
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "aspect",
- "description": "camera frustum aspect ratio
\n",
+ "name": "radius",
+ "description": "radius of circle
\n",
"type": "Number",
"optional": true
},
{
- "name": "near",
- "description": "frustum near plane length
\n",
- "type": "Number",
+ "name": "detailX",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 24
\n",
+ "type": "Integer",
"optional": true
},
{
- "name": "far",
- "description": "frustum far plane length
\n",
- "type": "Number",
+ "name": "detailY",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 16
\n",
+ "type": "Integer",
"optional": true
}
],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
- "\n\n\n//drag mouse to toggle the world!\n//you will see there's a vanish point\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n var fov = 60 / 180 * PI;\n var cameraZ = (height/2.0) / tan(fov/2.0);\n perspective(60 / 180 * PI, width/height, cameraZ * 0.1, cameraZ * 10);\n}\nfunction draw(){\n background(200);\n orbitControl();\n for(var i = -1; i < 2; i++){\n for(var j = -2; j < 3; j++){\n push();\n translate(i*160, 0, j*160);\n box(40, 40, 40);\n pop();\n }\n }\n}\n\n"
+ "\n\n\n// draw a sphere with radius 200\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n sphere(40);\n}\n\n"
],
- "alt": "colored 3d boxes toggleable with mouse position",
"class": "p5",
- "module": "Lights, Camera",
- "submodule": "Camera"
+ "module": "Shape",
+ "submodule": "3D Primitives"
},
{
- "file": "src/webgl/camera.js",
- "line": 232,
- "description": "Setup ortho camera
\n",
+ "file": "src/webgl/3d_primitives.js",
+ "line": 393,
+ "description": "Draw a cylinder with given radius and height
\n",
"itemtype": "method",
- "name": "ortho",
+ "name": "cylinder",
"params": [
{
- "name": "left",
- "description": "camera frustum left plane
\n",
- "type": "Number"
+ "name": "radius",
+ "description": "radius of the surface
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "right",
- "description": "camera frustum right plane
\n",
- "type": "Number"
+ "name": "height",
+ "description": "height of the cylinder
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "bottom",
- "description": "camera frustum bottom plane
\n",
- "type": "Number"
+ "name": "detailX",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 24
\n",
+ "type": "Integer",
+ "optional": true
},
{
- "name": "top",
- "description": "camera frustum top plane
\n",
- "type": "Number"
+ "name": "detailY",
+ "description": "number of segments in y-dimension,\n the more segments the smoother geometry\n default is 1
\n",
+ "type": "Integer",
+ "optional": true
},
{
- "name": "near",
- "description": "camera frustum near plane
\n",
- "type": "Number"
+ "name": "bottomCap",
+ "description": "whether to draw the bottom of the cylinder
\n",
+ "type": "Boolean",
+ "optional": true
},
{
- "name": "far",
- "description": "camera frustum far plane
\n",
- "type": "Number"
+ "name": "topCap",
+ "description": "whether to draw the top of the cylinder
\n",
+ "type": "Boolean",
+ "optional": true
}
],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
- "\n\n\n//drag mouse to toggle the world!\n//there's no vanish point\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n ortho(-width/2, width/2, height/2, -height/2, 0, 500);\n}\nfunction draw(){\n background(200);\n orbitControl();\n for(var i = -1; i < 2; i++){\n for(var j = -2; j < 3; j++){\n push();\n translate(i*160, 0, j*160);\n box(40, 40, 40);\n pop();\n }\n }\n}\n\n"
+ "\n\n\n//draw a spinning cylinder with radius 20 and height 50\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cylinder(20, 50);\n}\n\n"
],
- "alt": "3 3d boxes, reveal several more boxes on 3d plane when mouse used to toggle",
- "class": "p5",
- "module": "Lights, Camera",
- "submodule": "Camera"
- },
- {
- "file": "src/webgl/light.js",
- "line": 12,
- "description": "Creates an ambient light with a color
\n",
- "itemtype": "method",
- "name": "ambientLight",
- "chainable": 1,
"class": "p5",
- "module": "Lights, Camera",
- "submodule": "Lights",
- "overloads": [
- {
- "line": 12,
- "params": [
- {
- "name": "v1",
- "description": "red or hue value relative to\n the current color range
\n",
- "type": "Number"
- },
- {
- "name": "v2",
- "description": "green or saturation value\n relative to the current color range
\n",
- "type": "Number"
- },
- {
- "name": "v3",
- "description": "blue or brightness value\n relative to the current color range
\n",
- "type": "Number"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1
- },
- {
- "line": 26,
- "params": [
- {
- "name": "value",
- "description": "a color string
\n",
- "type": "String"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1
- },
- {
- "line": 33,
- "params": [
- {
- "name": "values",
- "description": "an array containing the red,green,blue &\n and alpha components of the color
\n",
- "type": "Number[]"
- }
- ],
- "chainable": 1
- },
- {
- "line": 40,
- "params": [
- {
- "name": "color",
- "description": "the ambient light color
\n",
- "type": "p5.Color"
- },
- {
- "name": "alpha",
- "description": "",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1
- }
- ]
+ "module": "Shape",
+ "submodule": "3D Primitives"
},
{
- "file": "src/webgl/light.js",
- "line": 89,
- "description": "Creates a directional light with a color and a direction
\n",
+ "file": "src/webgl/3d_primitives.js",
+ "line": 484,
+ "description": "Draw a cone with given radius and height
\n",
"itemtype": "method",
- "name": "directionalLight",
+ "name": "cone",
"params": [
{
- "name": "v1",
- "description": "gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",
- "type": "Number|Array|String|p5.Color"
- },
- {
- "name": "v2",
- "description": "green or saturation value
\n",
+ "name": "radius",
+ "description": "radius of the bottom surface
\n",
"type": "Number",
"optional": true
},
{
- "name": "v3",
- "description": "blue or brightness value
\n",
+ "name": "height",
+ "description": "height of the cone
\n",
"type": "Number",
"optional": true
},
{
- "name": "a",
- "description": "opacity
\n",
- "type": "Number",
+ "name": "detailX",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 24
\n",
+ "type": "Integer",
"optional": true
},
{
- "name": "x",
- "description": "x axis direction or a p5.Vector
\n",
- "type": "Number|p5.Vector"
- },
- {
- "name": "y",
- "description": "y axis direction
\n",
- "type": "Number",
+ "name": "detailY",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 1
\n",
+ "type": "Integer",
"optional": true
},
{
- "name": "z",
- "description": "z axis direction
\n",
- "type": "Number",
+ "name": "cap",
+ "description": "whether to draw the base of the cone
\n",
+ "type": "Boolean",
"optional": true
}
],
"chainable": 1,
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n //move your mouse to change light direction\n var dirX = (mouseX / width - 0.5) *2;\n var dirY = (mouseY / height - 0.5) *(-2);\n directionalLight(250, 250, 250, dirX, dirY, 0.25);\n ambientMaterial(250);\n sphere(50);\n}\n\n"
+ "\n\n\n//draw a spinning cone with radius 40 and height 70\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cone(40, 70);\n}\n\n"
],
- "alt": "light source on canvas changeable with mouse position",
"class": "p5",
- "module": "Lights, Camera",
- "submodule": "Lights"
+ "module": "Shape",
+ "submodule": "3D Primitives"
},
{
- "file": "src/webgl/light.js",
- "line": 168,
- "description": "Creates a point light with a color and a light position
\n",
+ "file": "src/webgl/3d_primitives.js",
+ "line": 555,
+ "description": "Draw an ellipsoid with given radius
\n",
"itemtype": "method",
- "name": "pointLight",
+ "name": "ellipsoid",
"params": [
{
- "name": "v1",
- "description": "gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",
- "type": "Number|Array|String|p5.Color"
+ "name": "radiusx",
+ "description": "xradius of circle
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "v2",
- "description": "green or saturation value
\n",
+ "name": "radiusy",
+ "description": "yradius of circle
\n",
"type": "Number",
"optional": true
},
{
- "name": "v3",
- "description": "blue or brightness value
\n",
+ "name": "radiusz",
+ "description": "zradius of circle
\n",
"type": "Number",
"optional": true
},
{
- "name": "a",
- "description": "opacity
\n",
+ "name": "detailX",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 24. Avoid detail number above\n 150, it may crash the browser.
\n",
+ "type": "Integer",
+ "optional": true
+ },
+ {
+ "name": "detailY",
+ "description": "number of segments,\n the more segments the smoother geometry\n default is 16. Avoid detail number above\n 150, it may crash the browser.
\n",
+ "type": "Integer",
+ "optional": true
+ }
+ ],
+ "chainable": 1,
+ "example": [
+ "\n\n\n// draw an ellipsoid with radius 20, 30 and 40.\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n ellipsoid(20, 30, 40);\n}\n\n"
+ ],
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "3D Primitives"
+ },
+ {
+ "file": "src/webgl/3d_primitives.js",
+ "line": 645,
+ "description": "Draw a torus with given radius and tube radius
\n",
+ "itemtype": "method",
+ "name": "torus",
+ "params": [
+ {
+ "name": "radius",
+ "description": "radius of the whole ring
\n",
"type": "Number",
"optional": true
},
{
- "name": "x",
- "description": "x axis position or a p5.Vector
\n",
- "type": "Number|p5.Vector"
+ "name": "tubeRadius",
+ "description": "radius of the tube
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "y",
- "description": "y axis position
\n",
+ "name": "detailX",
+ "description": "number of segments in x-dimension,\n the more segments the smoother geometry\n default is 24
\n",
+ "type": "Integer",
+ "optional": true
+ },
+ {
+ "name": "detailY",
+ "description": "number of segments in y-dimension,\n the more segments the smoother geometry\n default is 16
\n",
+ "type": "Integer",
+ "optional": true
+ }
+ ],
+ "chainable": 1,
+ "example": [
+ "\n\n\n//draw a spinning torus with radius 200 and tube radius 60\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n torus(50, 15);\n}\n\n"
+ ],
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "3D Primitives"
+ },
+ {
+ "file": "src/webgl/interaction.js",
+ "line": 13,
+ "description": "Allows movement around a 3D sketch using a mouse or trackpad. Left-clicking\nand dragging will rotate the camera position about the center of the sketch,\nright-clicking and dragging will pan the camera position without rotation,\nand using the mouse wheel (scrolling) will move the camera closer or further\nfrom the center of the sketch. This function can be called with parameters\ndictating sensitivity to mouse movement along the X and Y axes. Calling\nthis function without parameters is equivalent to calling orbitControl(1,1).\nTo reverse direction of movement in either axis, enter a negative number\nfor sensitivity.
\n",
+ "itemtype": "method",
+ "name": "orbitControl",
+ "params": [
+ {
+ "name": "sensitivityX",
+ "description": "sensitivity to mouse movement along X axis
\n",
"type": "Number",
"optional": true
},
{
- "name": "z",
- "description": "z axis position
\n",
+ "name": "sensitivityY",
+ "description": "sensitivity to mouse movement along Y axis
\n",
"type": "Number",
"optional": true
}
],
"chainable": 1,
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n //move your mouse to change light position\n var locY = (mouseY / height - 0.5) *(-2);\n var locX = (mouseX / width - 0.5) *2;\n //to set the light position,\n //think of the world's coordinate as:\n // -1,1 -------- 1,1\n // | |\n // | |\n // | |\n // -1,-1---------1,-1\n pointLight(250, 250, 250, locX, locY, 0);\n ambientMaterial(250);\n sphere(50);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n}\nfunction draw() {\n background(200);\n orbitControl();\n rotateY(0.5);\n box(30, 50);\n}\n\n"
],
- "alt": "spot light on canvas changes position with mouse",
+ "alt": "Camera orbits around a box when mouse is hold-clicked & then moved.",
"class": "p5",
"module": "Lights, Camera",
- "submodule": "Lights"
+ "submodule": "Interaction"
},
{
- "file": "src/webgl/loading.js",
- "line": 14,
- "description": "Load a 3d model from an OBJ file.\n
\nOne of the limitations of the OBJ format is that it doesn't have a built-in\nsense of scale. This means that models exported from different programs might\nbe very different sizes. If your model isn't displaying, try calling\nloadModel() with the normalized parameter set to true. This will resize the\nmodel to a scale appropriate for p5. You can also make additional changes to\nthe final size of your model with the scale() function.
\n",
+ "file": "src/webgl/interaction.js",
+ "line": 146,
+ "description": "debugMode() helps visualize 3D space by adding a grid to indicate where the\n‘ground’ is in a sketch and an axes icon which indicates the +X, +Y, and +Z\ndirections. This function can be called without parameters to create a\ndefault grid and axes icon, or it can be called according to the examples\nabove to customize the size and position of the grid and/or axes icon. The\ngrid is drawn using the most recently set stroke color and weight. To\nspecify these parameters, add a call to stroke() and strokeWeight()\njust before the end of the draw() loop.
\nBy default, the grid will run through the origin (0,0,0) of the sketch\nalong the XZ plane\nand the axes icon will be offset from the origin. Both the grid and axes\nicon will be sized according to the current canvas size. Note that because the\ngrid runs parallel to the default camera view, it is often helpful to use\ndebugMode along with orbitControl to allow full view of the grid.
\n",
"itemtype": "method",
- "name": "loadModel",
- "return": {
- "description": "the p5.Geometry object",
- "type": "p5.Geometry"
- },
+ "name": "debugMode",
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode();\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n // Press the spacebar to turn debugMode off!\n if (keyIsDown(32)) {\n noDebugMode();\n }\n}\n\n",
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(GRID);\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n}\n\n",
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(AXES);\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n}\n\n",
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(GRID, 100, 10, 0, 0, 0);\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n}\n\n",
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(100, 10, 0, 0, 0, 20, 0, -40, 0);\n}\n\nfunction draw() {\n noStroke();\n background(200);\n orbitControl();\n box(15, 30);\n // set the stroke color and weight for the grid!\n stroke(255, 0, 150);\n strokeWeight(0.8);\n}\n\n"
+ ],
+ "alt": "a 3D box is centered on a grid in a 3D sketch. an icon\nindicates the direction of each axis: a red line points +X,\na green line +Y, and a blue line +Z.",
"class": "p5",
- "module": "Shape",
- "submodule": "3D Models",
+ "module": "Lights, Camera",
+ "submodule": "Interaction",
"overloads": [
{
- "line": 14,
+ "line": 146,
+ "params": []
+ },
+ {
+ "line": 279,
"params": [
{
- "name": "path",
- "description": "Path of the model to be loaded
\n",
- "type": "String"
+ "name": "mode",
+ "description": "either GRID or AXES
\n",
+ "type": "Constant"
+ }
+ ]
+ },
+ {
+ "line": 284,
+ "params": [
+ {
+ "name": "mode",
+ "description": "",
+ "type": "Constant"
},
{
- "name": "normalize",
- "description": "If true, scale the model to a\n standardized size when loading
\n",
- "type": "Boolean"
+ "name": "gridSize",
+ "description": "size of one side of the grid
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "successCallback",
- "description": "Function to be called\n once the model is loaded. Will be passed\n the 3D model object.
\n",
- "type": "function(p5.Geometry)",
+ "name": "gridDivisions",
+ "description": "number of divisions in the grid
\n",
+ "type": "Number",
"optional": true
},
{
- "name": "failureCallback",
- "description": "called with event error if\n the image fails to load.
\n",
- "type": "Function(Event)",
+ "name": "xOff",
+ "description": "X axis offset from origin (0,0,0)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "yOff",
+ "description": "Y axis offset from origin (0,0,0)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "zOff",
+ "description": "Z axis offset from origin (0,0,0)
\n",
+ "type": "Number",
"optional": true
}
- ],
- "return": {
- "description": "the p5.Geometry object",
- "type": "p5.Geometry"
- }
+ ]
},
{
- "line": 35,
+ "line": 294,
"params": [
{
- "name": "path",
+ "name": "mode",
"description": "",
- "type": "String"
+ "type": "Constant"
},
{
- "name": "successCallback",
+ "name": "axesSize",
+ "description": "size of axes icon
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "xOff",
"description": "",
- "type": "function(p5.Geometry)",
+ "type": "Number",
"optional": true
},
{
- "name": "failureCallback",
+ "name": "yOff",
"description": "",
- "type": "Function(Event)",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "zOff",
+ "description": "",
+ "type": "Number",
"optional": true
}
- ],
- "return": {
- "description": "the p5.Geometry object",
- "type": "p5.Geometry"
- }
- }
- ]
- },
- {
- "file": "src/webgl/loading.js",
- "line": 98,
- "description": "Parse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:
\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5
\nf 4 3 2 1
\n",
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Models"
- },
- {
- "file": "src/webgl/loading.js",
- "line": 197,
- "description": "Render a 3d model to the screen.
\n",
- "itemtype": "method",
- "name": "model",
- "params": [
- {
- "name": "model",
- "description": "Loaded 3d model to be rendered
\n",
- "type": "p5.Geometry"
- }
- ],
- "example": [
- "\n\n\n//draw a spinning teapot\nvar teapot;\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n\n teapot = loadModel('assets/teapot.obj');\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n model(teapot);\n}\n\n"
- ],
- "alt": "Vertically rotating 3-d teapot with red, green and blue gradient.",
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Models"
- },
- {
- "file": "src/webgl/material.js",
- "line": 15,
- "description": "Loads a custom shader from the provided vertex and fragment\nshader paths. The shader files are loaded asynchronously in the\nbackground, so this method should be used in preload().
\nFor now, there are three main types of shaders. p5 will automatically\nsupply appropriate vertices, normals, colors, and lighting attributes\nif the parameters defined in the shader match the names.
\n",
- "itemtype": "method",
- "name": "loadShader",
- "params": [
- {
- "name": "vertFilename",
- "description": "path to file containing vertex shader\nsource code
\n",
- "type": "String",
- "optional": true
+ ]
},
{
- "name": "fragFilename",
- "description": "path to file containing fragment shader\nsource code
\n",
- "type": "String",
- "optional": true
- }
- ],
- "return": {
- "description": "a shader object created from the provided\nvertex and fragment shader files.",
- "type": "p5.Shader"
- },
- "class": "p5",
- "module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/material.js",
- "line": 58,
- "description": "The shader() function lets the user provide a custom shader\nto fill in shapes in WEBGL mode. Users can create their\nown shaders by loading vertex and fragment shaders with\nloadShader().
\n",
- "itemtype": "method",
- "name": "shader",
- "chainable": 1,
- "params": [
- {
- "name": "s",
- "description": "the desired p5.Shader to use for rendering\nshapes.
\n",
- "type": "p5.Shader",
- "optional": true
+ "line": 303,
+ "params": [
+ {
+ "name": "gridSize",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "gridDivisions",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "xOff",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "yOff",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "zOff",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "axesSize",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "xOff",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "yOff",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "zOff",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ }
+ ]
}
- ],
- "class": "p5",
- "module": "Lights, Camera",
- "submodule": "Material"
+ ]
},
{
- "file": "src/webgl/material.js",
- "line": 81,
- "description": "Normal material for geometry. You can view all\npossible materials in this\nexample.
\n",
+ "file": "src/webgl/interaction.js",
+ "line": 380,
+ "description": "Turns off debugMode() in a 3D sketch.
\n",
"itemtype": "method",
- "name": "normalMaterial",
- "chainable": 1,
+ "name": "noDebugMode",
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n normalMaterial();\n sphere(50);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode();\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n // Press the spacebar to turn debugMode off!\n if (keyIsDown(32)) {\n noDebugMode();\n }\n}\n\n"
],
- "alt": "Red, green and blue gradient.",
+ "alt": "a 3D box is centered on a grid in a 3D sketch. an icon\nindicates the direction of each axis: a red line points +X,\na green line +Y, and a blue line +Z. the grid and icon disappear when the\nspacebar is pressed.",
"class": "p5",
"module": "Lights, Camera",
- "submodule": "Material"
+ "submodule": "Interaction"
},
{
- "file": "src/webgl/material.js",
- "line": 113,
- "description": "Texture for geometry. You can view other possible materials in this\nexample.
\n",
+ "file": "src/webgl/light.js",
+ "line": 12,
+ "description": "Creates an ambient light with a color
\n",
"itemtype": "method",
- "name": "texture",
- "params": [
- {
- "name": "tex",
- "description": "2-dimensional graphics\n to render as texture
\n",
- "type": "p5.Image|p5.MediaElement|p5.Graphics"
- }
- ],
+ "name": "ambientLight",
"chainable": 1,
"example": [
- "\n\n\nvar img;\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n img = loadImage(\"assets/laDefense.jpg\");\n}\n\nfunction draw(){\n background(0);\n rotateZ(frameCount * 0.01);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n //pass image as texture\n texture(img);\n box(200, 200, 200);\n}\n\n\n\n\n\nvar pg;\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n pg = createGraphics(200, 200);\n pg.textSize(100);\n}\n\nfunction draw(){\n background(0);\n pg.background(255);\n pg.text('hello!', 0, 100);\n //pass image as texture\n texture(pg);\n plane(200);\n}\n\n\n\n\n\nvar vid;\nfunction preload(){\n vid = createVideo(\"assets/fingers.mov\");\n vid.hide();\n vid.loop();\n}\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(0);\n //pass video frame as texture\n texture(vid);\n plane(200);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n ambientLight(150);\n ambientMaterial(250);\n noStroke();\n sphere(25);\n}\n\n"
],
- "alt": "Rotating view of many images umbrella and grid roof on a 3d plane\nblack canvas\nblack canvas",
+ "alt": "evenly distributed light across a sphere",
"class": "p5",
"module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/material.js",
- "line": 210,
- "description": "Ambient material for geometry with a given color. You can view all\npossible materials in this\nexample.
\n",
- "itemtype": "method",
- "name": "ambientMaterial",
- "params": [
+ "submodule": "Lights",
+ "overloads": [
{
- "name": "v1",
- "description": "gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",
- "type": "Number|Array|String|p5.Color"
+ "line": 12,
+ "params": [
+ {
+ "name": "v1",
+ "description": "red or hue value relative to\n the current color range
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "green or saturation value\n relative to the current color range
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v3",
+ "description": "blue or brightness value\n relative to the current color range
\n",
+ "type": "Number"
+ },
+ {
+ "name": "alpha",
+ "description": "the alpha value
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
},
{
- "name": "v2",
- "description": "green or saturation value
\n",
- "type": "Number",
- "optional": true
+ "line": 46,
+ "params": [
+ {
+ "name": "value",
+ "description": "a color string
\n",
+ "type": "String"
+ }
+ ],
+ "chainable": 1
},
{
- "name": "v3",
- "description": "blue or brightness value
\n",
- "type": "Number",
- "optional": true
+ "line": 52,
+ "params": [
+ {
+ "name": "gray",
+ "description": "a gray value
\n",
+ "type": "Number"
+ },
+ {
+ "name": "alpha",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
},
{
- "name": "a",
- "description": "opacity
\n",
- "type": "Number",
- "optional": true
+ "line": 59,
+ "params": [
+ {
+ "name": "values",
+ "description": "an array containing the red,green,blue &\n and alpha components of the color
\n",
+ "type": "Number[]"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 66,
+ "params": [
+ {
+ "name": "color",
+ "description": "the ambient light color
\n",
+ "type": "p5.Color"
+ }
+ ],
+ "chainable": 1
}
- ],
- "chainable": 1,
- "example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n ambientLight(100);\n pointLight(250, 250, 250, 100, 100, 0);\n ambientMaterial(250);\n sphere(50);\n}\n\n"
- ],
- "alt": "radiating light source from top right of canvas",
- "class": "p5",
- "module": "Lights, Camera",
- "submodule": "Material"
+ ]
},
{
- "file": "src/webgl/material.js",
- "line": 253,
- "description": "Specular material for geometry with a given color. You can view all\npossible materials in this\nexample.
\n",
+ "file": "src/webgl/light.js",
+ "line": 101,
+ "description": "Creates a directional light with a color and a direction
\n",
"itemtype": "method",
- "name": "specularMaterial",
- "params": [
- {
- "name": "v1",
- "description": "gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",
- "type": "Number|Array|String|p5.Color"
- },
- {
- "name": "v2",
- "description": "green or saturation value
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "v3",
- "description": "blue or brightness value
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "a",
- "description": "opacity
\n",
- "type": "Number",
- "optional": true
- }
- ],
+ "name": "directionalLight",
"chainable": 1,
"example": [
- "\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n ambientLight(100);\n pointLight(250, 250, 250, 100, 100, 0);\n specularMaterial(250);\n sphere(50);\n}\n\n"
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n //move your mouse to change light direction\n var dirX = (mouseX / width - 0.5) * 2;\n var dirY = (mouseY / height - 0.5) * 2;\n directionalLight(250, 250, 250, -dirX, -dirY, 0.25);\n ambientMaterial(250);\n noStroke();\n sphere(25);\n}\n\n"
],
- "alt": "diffused radiating light source from top right of canvas",
+ "alt": "light source on canvas changeable with mouse position",
"class": "p5",
"module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/material.js",
- "line": 297,
- "access": "private",
- "tagname": "blends colors according to color components.\nIf alpha value is less than 1, we need to enable blending\non our gl context. Otherwise opaque objects need to a depthMask.",
- "params": [
+ "submodule": "Lights",
+ "overloads": [
{
- "name": "v1",
- "description": "[description]
\n",
- "type": "Number"
+ "line": 101,
+ "params": [
+ {
+ "name": "v1",
+ "description": "red or hue value (depending on the current\ncolor mode),
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "green or saturation value
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v3",
+ "description": "blue or brightness value
\n",
+ "type": "Number"
+ },
+ {
+ "name": "position",
+ "description": "the direction of the light
\n",
+ "type": "p5.Vector"
+ }
+ ],
+ "chainable": 1
},
{
- "name": "v2",
- "description": "[description]
\n",
- "type": "Number"
+ "line": 134,
+ "params": [
+ {
+ "name": "color",
+ "description": "color Array, CSS color string,\n or p5.Color value
\n",
+ "type": "Number[]|String|p5.Color"
+ },
+ {
+ "name": "x",
+ "description": "x axis direction
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "y axis direction
\n",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "z axis direction
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
},
{
- "name": "v3",
- "description": "[description]
\n",
- "type": "Number"
+ "line": 144,
+ "params": [
+ {
+ "name": "color",
+ "description": "",
+ "type": "Number[]|String|p5.Color"
+ },
+ {
+ "name": "position",
+ "description": "",
+ "type": "p5.Vector"
+ }
+ ],
+ "chainable": 1
},
{
- "name": "a",
- "description": "[description]
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "Normalized numbers array",
- "type": "[Number]"
- },
- "class": "p5",
- "module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/p5.Geometry.js",
- "line": 86,
- "description": "computes smooth normals per vertex as an average of each\nface.
\n",
- "chainable": 1,
- "class": "p5.Geometry",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Geometry.js",
- "line": 111,
- "description": "Averages the vertex normals. Used in curved\nsurfaces
\n",
- "chainable": 1,
- "class": "p5.Geometry",
- "module": "Lights, Camera"
+ "line": 151,
+ "params": [
+ {
+ "name": "v1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "v3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "x",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
- "file": "src/webgl/p5.Geometry.js",
- "line": 130,
- "description": "Averages pole normals. Used in spherical primitives
\n",
+ "file": "src/webgl/light.js",
+ "line": 212,
+ "description": "Creates a point light with a color and a light position
\n",
+ "itemtype": "method",
+ "name": "pointLight",
"chainable": 1,
- "class": "p5.Geometry",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Geometry.js",
- "line": 161,
- "description": "Create a 2D array for establishing stroke connections
\n",
- "return": {
- "description": "",
- "type": "p5.Geometry"
- },
- "class": "p5.Geometry",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n //move your mouse to change light position\n var locX = mouseX - width / 2;\n var locY = mouseY - height / 2;\n // to set the light position,\n // think of the world's coordinate as:\n // -width/2,-height/2 -------- width/2,-height/2\n // | |\n // | 0,0 |\n // | |\n // -width/2,height/2--------width/2,height/2\n pointLight(250, 250, 250, locX, locY, 50);\n ambientMaterial(250);\n noStroke();\n sphere(25);\n}\n\n"
+ ],
+ "alt": "spot light on canvas changes position with mouse",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Lights",
+ "overloads": [
+ {
+ "line": 212,
+ "params": [
+ {
+ "name": "v1",
+ "description": "red or hue value (depending on the current\ncolor mode),
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "green or saturation value
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v3",
+ "description": "blue or brightness value
\n",
+ "type": "Number"
+ },
+ {
+ "name": "x",
+ "description": "x axis position
\n",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "y axis position
\n",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "z axis position
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 254,
+ "params": [
+ {
+ "name": "v1",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "v3",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "position",
+ "description": "the position of the light
\n",
+ "type": "p5.Vector"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 263,
+ "params": [
+ {
+ "name": "color",
+ "description": "color Array, CSS color string,\nor p5.Color value
\n",
+ "type": "Number[]|String|p5.Color"
+ },
+ {
+ "name": "x",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "y",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "z",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 273,
+ "params": [
+ {
+ "name": "color",
+ "description": "",
+ "type": "Number[]|String|p5.Color"
+ },
+ {
+ "name": "position",
+ "description": "",
+ "type": "p5.Vector"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
- "file": "src/webgl/p5.Geometry.js",
- "line": 182,
- "description": "Create 4 vertices for each stroke line, two at the beginning position\nand two at the end position. These vertices are displaced relative to\nthat line's normal on the GPU
\n",
+ "file": "src/webgl/loading.js",
+ "line": 14,
+ "description": "Load a 3d model from an OBJ file.\n
\nOne of the limitations of the OBJ format is that it doesn't have a built-in\nsense of scale. This means that models exported from different programs might\nbe very different sizes. If your model isn't displaying, try calling\nloadModel() with the normalized parameter set to true. This will resize the\nmodel to a scale appropriate for p5. You can also make additional changes to\nthe final size of your model with the scale() function.
\n",
+ "itemtype": "method",
+ "name": "loadModel",
"return": {
- "description": "",
+ "description": "the p5.Geometry object",
"type": "p5.Geometry"
},
- "class": "p5.Geometry",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Geometry.js",
- "line": 209,
- "description": "Modifies all vertices to be centered within the range -100 to 100.
\n",
- "chainable": 1,
- "class": "p5.Geometry",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\n//draw a spinning octahedron\nvar octahedron;\n\nfunction preload() {\n octahedron = loadModel('assets/octahedron.obj');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n model(octahedron);\n}\n\n",
+ "\n\n\n//draw a spinning teapot\nvar teapot;\n\nfunction preload() {\n // Load model with normalise parameter set to true\n teapot = loadModel('assets/teapot.obj', true);\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n scale(0.4); // Scaled to make model fit into canvas\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n normalMaterial(); // For effect\n model(teapot);\n}\n\n"
+ ],
+ "alt": "Vertically rotating 3-d teapot with red, green and blue gradient.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "3D Models",
+ "overloads": [
+ {
+ "line": 14,
+ "params": [
+ {
+ "name": "path",
+ "description": "Path of the model to be loaded
\n",
+ "type": "String"
+ },
+ {
+ "name": "normalize",
+ "description": "If true, scale the model to a\n standardized size when loading
\n",
+ "type": "Boolean"
+ },
+ {
+ "name": "successCallback",
+ "description": "Function to be called\n once the model is loaded. Will be passed\n the 3D model object.
\n",
+ "type": "function(p5.Geometry)",
+ "optional": true
+ },
+ {
+ "name": "failureCallback",
+ "description": "called with event error if\n the image fails to load.
\n",
+ "type": "Function(Event)",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "the p5.Geometry object",
+ "type": "p5.Geometry"
+ }
+ },
+ {
+ "line": 90,
+ "params": [
+ {
+ "name": "path",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "successCallback",
+ "description": "",
+ "type": "function(p5.Geometry)",
+ "optional": true
+ },
+ {
+ "name": "failureCallback",
+ "description": "",
+ "type": "Function(Event)",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "the p5.Geometry object",
+ "type": "p5.Geometry"
+ }
+ }
+ ]
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 1,
- "requires": [
- "constants"
- ],
- "todo": [
- "see methods below needing further implementation.\nfuture consideration: implement SIMD optimizations\nwhen browser compatibility becomes available\nhttps://developer.mozilla.org/en-US/docs/Web/JavaScript/\n Reference/Global_Objects/SIMD"
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "file": "src/webgl/loading.js",
+ "line": 135,
+ "description": "Parse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:
\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5
\nf 4 3 2 1
\n",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "3D Models"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 19,
- "description": "A class to describe a 4x4 matrix\nfor model and view matrix manipulation in the p5js webgl renderer.\nclass p5.Matrix
\n",
- "is_constructor": 1,
+ "file": "src/webgl/loading.js",
+ "line": 244,
+ "description": "Render a 3d model to the screen.
\n",
+ "itemtype": "method",
+ "name": "model",
"params": [
{
- "name": "mat4",
- "description": "array literal of our 4x4 matrix
\n",
- "type": "Array",
- "optional": true
+ "name": "model",
+ "description": "Loaded 3d model to be rendered
\n",
+ "type": "p5.Geometry"
}
],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\n//draw a spinning octahedron\nvar octahedron;\n\nfunction preload() {\n octahedron = loadModel('assets/octahedron.obj');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n model(octahedron);\n}\n\n"
+ ],
+ "alt": "Vertically rotating 3-d octahedron.",
+ "class": "p5",
+ "module": "Shape",
+ "submodule": "3D Models"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 75,
- "description": "Sets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Matrix, or the values from a float array.
\n",
+ "file": "src/webgl/material.js",
+ "line": 14,
+ "description": "Loads a custom shader from the provided vertex and fragment\nshader paths. The shader files are loaded asynchronously in the\nbackground, so this method should be used in preload().
\nFor now, there are three main types of shaders. p5 will automatically\nsupply appropriate vertices, normals, colors, and lighting attributes\nif the parameters defined in the shader match the names.
\n",
+ "itemtype": "method",
+ "name": "loadShader",
"params": [
{
- "name": "inMatrix",
- "description": "the input p5.Matrix or\n an Array of length 16
\n",
- "type": "p5.Matrix|Float32Array|Array",
+ "name": "vertFilename",
+ "description": "path to file containing vertex shader\nsource code
\n",
+ "type": "String",
"optional": true
},
{
- "name": "n00..n33",
- "description": "16 numbers passed by value to avoid\n array copying.
\n",
- "type": "Number",
+ "name": "fragFilename",
+ "description": "path to file containing fragment shader\nsource code
\n",
+ "type": "String",
"optional": true
}
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 113,
- "description": "Gets a copy of the vector, returns a p5.Matrix object.
\n",
- "return": {
- "description": "the copy of the p5.Matrix object",
- "type": "p5.Matrix"
- },
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 122,
- "description": "return a copy of a matrix
\n",
- "return": {
- "description": "the result matrix",
- "type": "p5.Matrix"
- },
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 147,
- "description": "return an identity matrix
\n",
"return": {
- "description": "the result matrix",
- "type": "p5.Matrix"
+ "description": "a shader object created from the provided\nvertex and fragment shader files.",
+ "type": "p5.Shader"
},
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 155,
- "description": "transpose according to a given matrix
\n",
- "params": [
- {
- "name": "a",
- "description": "the matrix to be based on to transpose
\n",
- "type": "p5.Matrix|Float32Array|Array"
- }
+ "example": [
+ "\n\n\nvar mandel;\nfunction preload() {\n // load the shader definitions from files\n mandel = loadShader('assets/shader.vert', 'assets/shader.frag');\n}\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n // use the shader\n shader(mandel);\n noStroke();\n mandel.setUniform('p', [-0.74364388703, 0.13182590421]);\n}\n\nfunction draw() {\n mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000))));\n quad(-1, -1, 1, -1, 1, 1, -1, 1);\n}\n\n"
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "zooming Mandelbrot set. a colorful, infinitely detailed fractal.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 215,
- "description": "invert matrix according to a give matrix
\n",
+ "file": "src/webgl/material.js",
+ "line": 83,
+ "itemtype": "method",
+ "name": "createShader",
"params": [
{
- "name": "a",
- "description": "the matrix to be based on to invert
\n",
- "type": "p5.Matrix|Float32Array|Array"
+ "name": "vertSrc",
+ "description": "source code for the vertex shader
\n",
+ "type": "String"
+ },
+ {
+ "name": "fragSrc",
+ "description": "source code for the fragment shader
\n",
+ "type": "String"
}
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "return": {
+ "description": "a shader object created from the provided\nvertex and fragment shaders.",
+ "type": "p5.Shader"
+ },
+ "example": [
+ "\n\n\n// the 'varying's are shared between both vertex & fragment shaders\nvar varying = 'precision highp float; varying vec2 vPos;';\n\n// the vertex shader is called for each vertex\nvar vs =\n varying +\n 'attribute vec3 aPosition;' +\n 'void main() { vPos = (gl_Position = vec4(aPosition,1.0)).xy; }';\n\n// the fragment shader is called for each pixel\nvar fs =\n varying +\n 'uniform vec2 p;' +\n 'uniform float r;' +\n 'const int I = 500;' +\n 'void main() {' +\n ' vec2 c = p + vPos * r, z = c;' +\n ' float n = 0.0;' +\n ' for (int i = I; i > 0; i --) {' +\n ' if(z.x*z.x+z.y*z.y > 4.0) {' +\n ' n = float(i)/float(I);' +\n ' break;' +\n ' }' +\n ' z = vec2(z.x*z.x-z.y*z.y, 2.0*z.x*z.y) + c;' +\n ' }' +\n ' gl_FragColor = vec4(0.5-cos(n*17.0)/2.0,0.5-cos(n*13.0)/2.0,0.5-cos(n*23.0)/2.0,1.0);' +\n '}';\n\nvar mandel;\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n\n // create and initialize the shader\n mandel = createShader(vs, fs);\n shader(mandel);\n noStroke();\n\n // 'p' is the center point of the Mandelbrot image\n mandel.setUniform('p', [-0.74364388703, 0.13182590421]);\n}\n\nfunction draw() {\n // 'r' is the size of the image in Mandelbrot-space\n mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000))));\n quad(-1, -1, 1, -1, 1, 1, -1, 1);\n}\n\n"
+ ],
+ "alt": "zooming Mandelbrot set. a colorful, infinitely detailed fractal.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 300,
- "description": "Inverts a 3x3 matrix
\n",
+ "file": "src/webgl/material.js",
+ "line": 151,
+ "description": "The shader() function lets the user provide a custom shader\nto fill in shapes in WEBGL mode. Users can create their\nown shaders by loading vertex and fragment shaders with\nloadShader().
\n",
+ "itemtype": "method",
+ "name": "shader",
"chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 336,
- "description": "transposes a 3x3 p5.Matrix by a mat3
\n",
"params": [
{
- "name": "mat3",
- "description": "1-dimensional array
\n",
- "type": "[Number]"
+ "name": "s",
+ "description": "the desired p5.Shader to use for rendering\nshapes.
\n",
+ "type": "p5.Shader",
+ "optional": true
}
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 352,
- "description": "converts a 4x4 matrix to its 3x3 inverse tranform\ncommonly used in MVMatrix to NMatrix conversions.
\n",
- "params": [
- {
- "name": "mat4",
- "description": "the matrix to be based on to invert
\n",
- "type": "p5.Matrix"
- }
- ],
+ "file": "src/webgl/material.js",
+ "line": 176,
+ "description": "Normal material for geometry. You can view all\npossible materials in this\nexample.
\n",
+ "itemtype": "method",
+ "name": "normalMaterial",
"chainable": 1,
- "todo": [
- "finish implementation"
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n normalMaterial();\n sphere(50);\n}\n\n"
],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 380,
- "description": "inspired by Toji's mat4 determinant
\n",
- "return": {
- "description": "Determinant of our 4x4 matrix",
- "type": "Number"
- },
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "Red, green and blue gradient.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 403,
- "description": "multiply two mat4s
\n",
+ "file": "src/webgl/material.js",
+ "line": 211,
+ "description": "Texture for geometry. You can view other possible materials in this\nexample.
\n",
+ "itemtype": "method",
+ "name": "texture",
"params": [
{
- "name": "multMatrix",
- "description": "The matrix\n we want to multiply by
\n",
- "type": "p5.Matrix|Float32Array|Array"
+ "name": "tex",
+ "description": "2-dimensional graphics\n to render as texture
\n",
+ "type": "p5.Image|p5.MediaElement|p5.Graphics"
}
],
"chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 460,
- "description": "scales a p5.Matrix by scalars or a vector
\n",
- "params": [
- {
- "name": "s",
- "description": "vector to scale by
\n",
- "type": "p5.Vector|Float32Array|Array"
- }
+ "example": [
+ "\n\n\nvar img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n rotateZ(frameCount * 0.01);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n //pass image as texture\n texture(img);\n box(200, 200, 200);\n}\n\n\n\n\n\nvar pg;\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n pg = createGraphics(200, 200);\n pg.textSize(100);\n}\n\nfunction draw() {\n background(0);\n pg.background(255);\n pg.text('hello!', 0, 100);\n //pass image as texture\n texture(pg);\n plane(200);\n}\n\n\n\n\n\nvar vid;\nfunction preload() {\n vid = createVideo('assets/fingers.mov');\n vid.hide();\n vid.loop();\n}\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n //pass video frame as texture\n texture(vid);\n plane(200);\n}\n\n"
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "Rotating view of many images umbrella and grid roof on a 3d plane\nblack canvas\nblack canvas",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material"
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 505,
- "description": "rotate our Matrix around an axis by the given angle.
\n",
- "params": [
+ "file": "src/webgl/material.js",
+ "line": 301,
+ "description": "Ambient material for geometry with a given color. You can view all\npossible materials in this\nexample.
\n",
+ "itemtype": "method",
+ "name": "ambientMaterial",
+ "chainable": 1,
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n ambientLight(100);\n pointLight(250, 250, 250, 100, 100, 0);\n ambientMaterial(250);\n sphere(50);\n}\n\n"
+ ],
+ "alt": "radiating light source from top right of canvas",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material",
+ "overloads": [
{
- "name": "a",
- "description": "The angle of rotation in radians
\n",
- "type": "Number"
+ "line": 301,
+ "params": [
+ {
+ "name": "v1",
+ "description": "gray value, red or hue value\n (depending on the current color mode),
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "green or saturation value
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "v3",
+ "description": "blue or brightness value
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "a",
+ "description": "opacity
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
},
{
- "name": "axis",
- "description": "the axis(es) to rotate around
\n",
- "type": "p5.Vector|Array"
+ "line": 332,
+ "params": [
+ {
+ "name": "color",
+ "description": "color, color Array, or CSS color string
\n",
+ "type": "Number[]|String|p5.Color"
+ }
+ ],
+ "chainable": 1
}
- ],
- "chainable": "inspired by Toji's gl-matrix lib, mat4 rotation",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ ]
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 584,
- "todo": [
- "finish implementing this method!\ntranslates"
+ "file": "src/webgl/material.js",
+ "line": 350,
+ "description": "Specular material for geometry with a given color. You can view all\npossible materials in this\nexample.
\n",
+ "itemtype": "method",
+ "name": "specularMaterial",
+ "chainable": 1,
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n ambientLight(100);\n pointLight(250, 250, 250, 100, 100, 0);\n specularMaterial(250);\n sphere(50);\n}\n\n"
],
- "params": [
+ "alt": "diffused radiating light source from top right of canvas",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Material",
+ "overloads": [
{
- "name": "v",
- "description": "vector to translate by
\n",
- "type": "Number[]"
+ "line": 350,
+ "params": [
+ {
+ "name": "v1",
+ "description": "gray value, red or hue value\n (depending on the current color mode),
\n",
+ "type": "Number"
+ },
+ {
+ "name": "v2",
+ "description": "green or saturation value
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "v3",
+ "description": "blue or brightness value
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "a",
+ "description": "opacity
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ },
+ {
+ "line": 381,
+ "params": [
+ {
+ "name": "color",
+ "description": "color Array, or CSS color string
\n",
+ "type": "Number[]|String|p5.Color"
+ }
+ ],
+ "chainable": 1
}
- ],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ ]
},
{
- "file": "src/webgl/p5.Matrix.js",
- "line": 614,
- "description": "sets the perspective matrix
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 15,
+ "description": "Sets the camera position for a 3D sketch. Parameters for this function define\nthe position for the camera, the center of the sketch (where the camera is\npointing), and an up direction (the orientation of the camera).
\nWhen called with no arguments, this function creates a default camera\nequivalent to\ncamera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0);
\n",
+ "itemtype": "method",
+ "name": "camera",
"params": [
{
- "name": "fovy",
- "description": "[description]
\n",
- "type": "Number"
+ "name": "x",
+ "description": "camera position value on x axis
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "aspect",
- "description": "[description]
\n",
- "type": "Number"
+ "name": "y",
+ "description": "camera position value on y axis
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "near",
- "description": "near clipping plane
\n",
- "type": "Number"
+ "name": "z",
+ "description": "camera position value on z axis
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "far",
- "description": "far clipping plane
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 648,
- "description": "sets the ortho matrix
\n",
- "params": [
- {
- "name": "left",
- "description": "[description]
\n",
- "type": "Number"
+ "name": "centerX",
+ "description": "x coordinate representing center of the sketch
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "right",
- "description": "[description]
\n",
- "type": "Number"
+ "name": "centerY",
+ "description": "y coordinate representing center of the sketch
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "bottom",
- "description": "[description]
\n",
- "type": "Number"
+ "name": "centerZ",
+ "description": "z coordinate representing center of the sketch
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "top",
- "description": "[description]
\n",
- "type": "Number"
+ "name": "upX",
+ "description": "x component of direction 'up' from camera
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "near",
- "description": "near clipping plane
\n",
- "type": "Number"
+ "name": "upY",
+ "description": "y component of direction 'up' from camera
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "far",
- "description": "far clipping plane
\n",
- "type": "Number"
+ "name": "upZ",
+ "description": "z component of direction 'up' from camera
\n",
+ "type": "Number",
+ "optional": true
}
],
"chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.Matrix.js",
- "line": 683,
- "description": "PRIVATE
\n",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.Immediate.js",
- "line": 1,
- "description": "Welcome to RendererGL Immediate Mode.\nImmediate mode is used for drawing custom shapes\nfrom a set of vertices. Immediate Mode is activated\nwhen you call beginShape() & de-activated when you call endShape().\nImmediate mode is a style of programming borrowed\nfrom OpenGL's (now-deprecated) immediate mode.\nIt differs from p5.js' default, Retained Mode, which caches\ngeometries and buffers on the CPU to reduce the number of webgl\ndraw calls. Retained mode is more efficient & performative,\nhowever, Immediate Mode is useful for sketching quick\ngeometric ideas.
\n",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.Immediate.js",
- "line": 19,
- "description": "Begin shape drawing. This is a helpful way of generating\ncustom shapes quickly. However in WEBGL mode, application\nperformance will likely drop as a result of too many calls to\nbeginShape() / endShape(). As a high performance alternative,\nplease use p5.js geometry primitives.
\n",
- "params": [
- {
- "name": "mode",
- "description": "webgl primitives mode. beginShape supports the\n following modes:\n POINTS,LINES,LINE_STRIP,LINE_LOOP,TRIANGLES,\n TRIANGLE_STRIP,and TRIANGLE_FAN.
\n",
- "type": "Number"
- }
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(204);\n //move the camera away from the plane by a sin wave\n camera(0, 0, 20 + sin(frameCount * 0.01) * 10, 0, 0, 0, 0, 1, 0);\n plane(10, 10);\n}\n\n"
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "White square repeatedly grows to fill canvas and then shrinks.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.Immediate.js",
- "line": 60,
- "description": "adds a vertex to be drawn in a custom Shape.
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 61,
+ "description": "Sets a perspective projection for the camera in a 3D sketch. This projection\nrepresents depth through foreshortening: objects that are close to the camera\nappear their actual size while those that are further away from the camera\nappear smaller. The parameters to this function define the viewing frustum\n(the truncated pyramid within which objects are seen by the camera) through\nvertical field of view, aspect ratio (usually width/height), and near and far\nclipping planes.
\nWhen called with no arguments, the defaults\nprovided are equivalent to\nperspective(PI/3.0, width/height, eyeZ/10.0, eyeZ10.0), where eyeZ\nis equal to ((height/2.0) / tan(PI60.0/360.0));
\n",
+ "itemtype": "method",
+ "name": "perspective",
"params": [
{
- "name": "x",
- "description": "x-coordinate of vertex
\n",
- "type": "Number"
+ "name": "fovy",
+ "description": "camera frustum vertical field of view,\n from bottom to top of view, in angleMode units
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "y",
- "description": "y-coordinate of vertex
\n",
- "type": "Number"
+ "name": "aspect",
+ "description": "camera frustum aspect ratio
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "z",
- "description": "z-coordinate of vertex
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "todo": [
- "implement handling of p5.Vector args"
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.Immediate.js",
- "line": 103,
- "description": "End shape drawing and render vertices to screen.
\n",
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.Retained.js",
- "line": 8,
- "description": "initializes buffer defaults. runs each time a new geometry is\nregistered
\n",
- "params": [
- {
- "name": "gId",
- "description": "key of the geometry object
\n",
- "type": "String"
- }
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.Retained.js",
- "line": 33,
- "description": "createBuffers description
\n",
- "params": [
- {
- "name": "gId",
- "description": "key of the geometry object
\n",
- "type": "String"
+ "name": "near",
+ "description": "frustum near plane length
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "obj",
- "description": "contains geometry data
\n",
- "type": "p5.Geometry"
- }
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.Retained.js",
- "line": 84,
- "description": "Draws buffers given a geometry key ID
\n",
- "params": [
- {
- "name": "gId",
- "description": "ID in our geom hash
\n",
- "type": "String"
+ "name": "far",
+ "description": "frustum far plane length
\n",
+ "type": "Number",
+ "optional": true
}
],
"chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 69,
- "description": "model view, projection, & normal\nmatrices
\n",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\n//drag the mouse to look around!\n//you will see there's a vanishing point\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n perspective(PI / 3.0, width / height, 0.1, 500);\n}\nfunction draw() {\n background(200);\n orbitControl();\n normalMaterial();\n\n rotateX(-0.3);\n rotateY(-0.2);\n translate(0, 0, -50);\n\n push();\n translate(-15, 0, sin(frameCount / 30) * 95);\n box(30);\n pop();\n push();\n translate(15, 0, sin(frameCount / 30 + PI) * 95);\n box(30);\n pop();\n}\n\n"
+ ],
+ "alt": "two colored 3D boxes move back and forth, rotating as mouse is dragged.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 184,
- "description": "Set attributes for the WebGL Drawing context.\n This is a way of adjusting ways that the WebGL\n renderer works to fine-tune the display and performance.\n This should be put in setup().\n The available attributes are:\n
\n alpha - indicates if the canvas contains an alpha buffer\n default is true\n
\n depth - indicates whether the drawing buffer has a depth buffer\n of at least 16 bits - default is true\n
\n stencil - indicates whether the drawing buffer has a stencil buffer\n of at least 8 bits\n
\n antialias - indicates whether or not to perform anti-aliasing\n default is false\n
\n premultipliedAlpha - indicates that the page compositor will assume\n the drawing buffer contains colors with pre-multiplied alpha\n default is false\n
\n preserveDrawingBuffer - if true the buffers will not be cleared and\n and will preserve their values until cleared or overwritten by author\n (note that p5 clears automatically on draw loop)\n default is true\n
\n\n \n function setup() {\n createCanvas(150,150,WEBGL);\n }\n function draw() {\n background(255);\n push();\n rotateZ(frameCount 0.02);\n rotateX(frameCount 0.02);\n rotateY(frameCount 0.02);\n fill(0,0,0);\n box(50);\n pop();\n }\n \n \n
\n Now with the antialias attribute set to true.\n
\n \n \n function setup() {\n createCanvas(150,150,WEBGL);\n setAttributes('antialias', true);\n }\n function draw() {\n background(255);\n push();\n rotateZ(frameCount 0.02);\n rotateX(frameCount 0.02);\n rotateY(frameCount 0.02);\n fill(0,0,0);\n box(50);\n pop();\n }\n \n ",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 126,
+ "description": "Sets an orthographic projection for the camera in a 3D sketch and defines a\nbox-shaped viewing frustum within which objects are seen. In this projection,\nall objects with the same dimension appear the same size, regardless of\nwhether they are near or far from the camera. The parameters to this\nfunction specify the viewing frustum where left and right are the minimum and\nmaximum x values, top and bottom are the minimum and maximum y values, and near\nand far are the minimum and maximum z values. If no parameters are given, the\ndefault is used: ortho(-width/2, width/2, -height/2, height/2).
\n",
"itemtype": "method",
- "name": "setAttributes",
+ "name": "ortho",
"params": [
{
- "name": "String",
- "description": "name of attribute or object with key-value pairs
\n",
- "type": "String|Object"
+ "name": "left",
+ "description": "camera frustum left plane
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "New",
- "description": "value of named attribute
\n",
- "type": "Boolean"
- }
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 331,
- "description": "[background description]
\n",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 352,
- "description": "Basic fill material for geometry with a given color
\n",
- "itemtype": "method",
- "name": "fill",
- "params": [
+ "name": "right",
+ "description": "camera frustum right plane
\n",
+ "type": "Number",
+ "optional": true
+ },
{
- "name": "v1",
- "description": "gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",
- "type": "Number|Array|String|p5.Color"
+ "name": "bottom",
+ "description": "camera frustum bottom plane
\n",
+ "type": "Number",
+ "optional": true
},
{
- "name": "v2",
- "description": "green or saturation value
\n",
+ "name": "top",
+ "description": "camera frustum top plane
\n",
"type": "Number",
"optional": true
},
{
- "name": "v3",
- "description": "blue or brightness value
\n",
+ "name": "near",
+ "description": "camera frustum near plane
\n",
"type": "Number",
"optional": true
},
{
- "name": "a",
- "description": "opacity
\n",
+ "name": "far",
+ "description": "camera frustum far plane
\n",
"type": "Number",
"optional": true
}
],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
+ "chainable": 1,
"example": [
- "\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n noStroke();\n fill(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"
+ "\n\n\n//drag the mouse to look around!\n//there's no vanishing point\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n ortho(-width / 2, width / 2, height / 2, -height / 2, 0, 500);\n}\nfunction draw() {\n background(200);\n orbitControl();\n normalMaterial();\n\n rotateX(0.2);\n rotateY(-0.2);\n push();\n translate(-15, 0, sin(frameCount / 30) * 65);\n box(30);\n pop();\n push();\n translate(15, 0, sin(frameCount / 30 + PI) * 65);\n box(30);\n pop();\n}\n\n"
],
- "alt": "black canvas with purple cube spinning",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "two 3D boxes move back and forth along same plane, rotating as mouse is dragged.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 400,
- "description": "Does not render fill material
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 187,
+ "description": "Creates a new p5.Camera object and tells the\nrenderer to use that camera.\nReturns the p5.Camera object.
\n",
"itemtype": "method",
- "name": "noFill",
- "example": [
- "\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n noFill();\n stroke(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"
- ],
- "alt": "black canvas with purple cube wireframe spinning",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "name": "createCamera",
+ "return": {
+ "description": "The newly created camera object.",
+ "type": "p5.Camera"
+ },
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 431,
- "description": "Does not render stroke
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 298,
+ "description": "Sets a perspective projection for a p5.Camera object and sets parameters\nfor that projection according to perspective()\nsyntax.
\n",
"itemtype": "method",
- "name": "noStroke",
- "example": [
- "\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n noStroke();\n fill(240, 150, 150);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"
- ],
- "alt": "black canvas with pink cube spinning",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "name": "perspective",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 460,
- "description": "Basic stroke material for geometry with a given color
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 380,
+ "description": "Sets an orthographic projection for a p5.Camera object and sets parameters\nfor that projection according to ortho() syntax.
\n",
"itemtype": "method",
- "name": "stroke",
- "params": [
- {
- "name": "v1",
- "description": "gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",
- "type": "Number|Array|String|p5.Color"
- },
- {
- "name": "v2",
- "description": "green or saturation value
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "v3",
- "description": "blue or brightness value
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "a",
- "description": "opacity
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "example": [
- "\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n stroke(240, 150, 150);\n fill(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"
- ],
- "alt": "black canvas with purple cube with pink outline spinning",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "name": "ortho",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 505,
- "description": "Change weight of stroke
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 487,
+ "description": "Panning rotates the camera view to the left and right.
\n",
"itemtype": "method",
- "name": "strokeWeight",
+ "name": "pan",
"params": [
{
- "name": "stroke",
- "description": "weight to be used for drawing
\n",
+ "name": "angle",
+ "description": "amount to rotate camera in current\nangleMode units.\nGreater than 0 values rotate counterclockwise (to the left).
\n",
"type": "Number"
}
],
"example": [
- "\n\n\nfunction setup(){\n createCanvas(200, 400, WEBGL);\n setAttributes('antialias', true);\n}\n\nfunction draw(){\n background(0);\n noStroke();\n translate(0,-100,0);\n stroke(240,150,150);\n fill(100,100,240);\n push();\n strokeWeight(8);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n sphere(75);\n pop();\n push();\n translate(0,200,0);\n strokeWeight(1);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n sphere(75);\n pop();\n}\n\n\n"
+ "\n\n\nvar cam;\nvar delta = 0.01;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n // set initial pan angle\n cam.pan(-0.8);\n}\n\nfunction draw() {\n background(200);\n\n // pan camera according to angle 'delta'\n cam.pan(delta);\n\n // every 160 frames, switch direction\n if (frameCount % 160 === 0) {\n delta *= -1;\n }\n\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n"
],
- "alt": "black canvas with two purple rotating spheres with pink\noutlines the sphere on top has much heavier outlines,",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "camera view pans left and right across a series of rotating 3D boxes.",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 569,
- "description": "Returns an array of [R,G,B,A] values for any pixel or grabs a section of\nan image. If no parameters are specified, the entire image is returned.\nUse the x and y parameters to get the value of one pixel. Get a section of\nthe display window by specifying additional w and h parameters. When\ngetting an image, the x and y parameters define the coordinates for the\nupper-left corner of the image, regardless of the current imageMode().\n
\nIf the pixel requested is outside of the image window, [0,0,0,255] is\nreturned.\n
\nGetting the color of a single pixel with get(x, y) is easy, but not as fast\nas grabbing the data directly from pixels[]. The equivalent statement to\nget(x, y) is using pixels[] with pixel density d
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 546,
+ "description": "Tilting rotates the camera view up and down.
\n",
"itemtype": "method",
- "name": "get",
+ "name": "tilt",
"params": [
{
- "name": "x",
- "description": "x-coordinate of the pixel
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "y",
- "description": "y-coordinate of the pixel
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "w",
- "description": "width
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "h",
- "description": "height
\n",
- "type": "Number",
- "optional": true
+ "name": "angle",
+ "description": "amount to rotate camera in current\nangleMode units.\nGreater than 0 values rotate counterclockwise (to the left).
\n",
+ "type": "Number"
}
],
- "return": {
- "description": "color of pixel at x,y in array format\n [R, G, B, A] or p5.Image",
- "type": "Array|Color|p5.Image"
- },
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\nvar cam;\nvar delta = 0.01;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n // set initial tilt\n cam.tilt(-0.8);\n}\n\nfunction draw() {\n background(200);\n\n // pan camera according to angle 'delta'\n cam.tilt(delta);\n\n // every 160 frames, switch direction\n if (frameCount % 160 === 0) {\n delta *= -1;\n }\n\n rotateY(frameCount * 0.01);\n translate(0, -100, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n}\n\n"
+ ],
+ "alt": "camera view tilts up and down across a series of rotating 3D boxes.",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 597,
- "description": "Loads the pixels data for this canvas into the pixels[] attribute.\nNote that updatePixels() and set() do not work.\nAny pixel manipulation must be done directly to the pixels[] array.
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 604,
+ "description": "Reorients the camera to look at a position in world space.
\n",
"itemtype": "method",
- "name": "loadPixels",
+ "name": "lookAt",
"params": [
{
"name": "x",
- "description": "starting pixel x position, defaults to 0
\n",
- "type": "Number",
- "optional": true
+ "description": "x position of a point in world space
\n",
+ "type": "Number"
},
{
"name": "y",
- "description": "starting pixel y position, defaults to 0
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "w",
- "description": "width of pixels to load, defaults to sketch width
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "h",
- "description": "height of pixels to load, defaults to sketch height
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 642,
- "description": "[resize description]
\n",
- "params": [
- {
- "name": "w",
- "description": "[description]
\n",
+ "description": "y position of a point in world space
\n",
"type": "Number"
},
{
- "name": "h",
- "description": "[description]
\n",
+ "name": "z",
+ "description": "z position of a point in world space
\n",
"type": "Number"
}
],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\nvar cam;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n}\n\nfunction draw() {\n background(200);\n\n // look at a new random point every 60 frames\n if (frameCount % 60 === 0) {\n cam.lookAt(random(-100, 100), random(-50, 50), 0);\n }\n\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n"
+ ],
+ "alt": "camera view of rotating 3D cubes changes to look at a new random\npoint every second .",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 659,
- "description": "clears color and depth buffers\nwith r,g,b,a
\n",
- "params": [
- {
- "name": "r",
- "description": "normalized red val.
\n",
- "type": "Number"
- },
- {
- "name": "g",
- "description": "normalized green val.
\n",
- "type": "Number"
- },
- {
- "name": "b",
- "description": "normalized blue val.
\n",
- "type": "Number"
- },
- {
- "name": "a",
- "description": "normalized alpha val.
\n",
- "type": "Number"
- }
- ],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "file": "src/webgl/p5.Camera.js",
+ "line": 671,
+ "description": "Sets a camera's position and orientation. This is equivalent to calling\ncamera() on a p5.Camera object.
\n",
+ "itemtype": "method",
+ "name": "camera",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 675,
- "description": "[translate description]
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 752,
+ "description": "Move camera along its local axes while maintaining current camera orientation.
\n",
+ "itemtype": "method",
+ "name": "move",
"params": [
{
"name": "x",
- "description": "[description]
\n",
+ "description": "amount to move along camera's left-right axis
\n",
"type": "Number"
},
{
"name": "y",
- "description": "[description]
\n",
+ "description": "amount to move along camera's up-down axis
\n",
"type": "Number"
},
{
"name": "z",
- "description": "[description]
\n",
+ "description": "amount to move along camera's forward-backward axis
\n",
"type": "Number"
}
],
- "chainable": 1,
- "todo": [
- "implement handle for components or vector as args"
+ "example": [
+ "\n\n\n// see the camera move along its own axes while maintaining its orientation\nvar cam;\nvar delta = 0.5;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n}\n\nfunction draw() {\n background(200);\n\n // move the camera along its local axes\n cam.move(delta, delta, 0);\n\n // every 100 frames, switch direction\n if (frameCount % 150 === 0) {\n delta *= -1;\n }\n\n translate(-10, -10, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n}\n\n"
],
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "camera view moves along a series of 3D boxes, maintaining the same\norientation throughout the move",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 693,
- "description": "Scales the Model View Matrix by a vector
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 824,
+ "description": "Set camera position in world-space while maintaining current camera\norientation.
\n",
+ "itemtype": "method",
+ "name": "setPosition",
"params": [
{
"name": "x",
- "description": "[description]
\n",
- "type": "Number | p5.Vector | Array"
+ "description": "x position of a point in world space
\n",
+ "type": "Number"
},
{
"name": "y",
- "description": "y-axis scalar
\n",
- "type": "Number",
- "optional": true
+ "description": "y position of a point in world space
\n",
+ "type": "Number"
},
{
"name": "z",
- "description": "z-axis scalar
\n",
- "type": "Number",
- "optional": true
+ "description": "z position of a point in world space
\n",
+ "type": "Number"
}
],
- "chainable": 1,
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 725,
- "description": "pushes a copy of the model view matrix onto the\nMV Matrix stack.
\n",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 734,
- "description": "[pop description]
\n",
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
- },
- {
- "file": "src/webgl/p5.RendererGL.js",
- "line": 904,
- "description": "turn a two dimensional array into one dimensional array
\n",
- "params": [
- {
- "name": "arr",
- "description": "2-dimensional array
\n",
- "type": "Array"
- }
+ "example": [
+ "\n\n\n// press '1' '2' or '3' keys to set camera position\n\nvar cam;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n}\n\nfunction draw() {\n background(200);\n\n // '1' key\n if (keyIsDown(49)) {\n cam.setPosition(30, 0, 80);\n }\n // '2' key\n if (keyIsDown(50)) {\n cam.setPosition(0, 0, 80);\n }\n // '3' key\n if (keyIsDown(51)) {\n cam.setPosition(-30, 0, 80);\n }\n\n box(20);\n}\n\n"
],
- "return": {
- "description": "1-dimensional array\n[[1, 2, 3],[4, 5, 6]] -> [1, 2, 3, 4, 5, 6]",
- "type": "Array"
- },
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "alt": "camera position changes as the user presses keys, altering view of a 3D box",
+ "class": "p5.Camera",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.RendererGL.js",
- "line": 918,
- "description": "turn a p5.Vector Array into a one dimensional number array
\n",
+ "file": "src/webgl/p5.Camera.js",
+ "line": 1089,
+ "description": "Sets rendererGL's current camera to a p5.Camera object. Allows switching\nbetween multiple cameras.
\n",
+ "itemtype": "method",
+ "name": "setCamera",
"params": [
{
- "name": "arr",
- "description": "an array of p5.Vector
\n",
- "type": "Array"
+ "name": "cam",
+ "description": "p5.Camera object
\n",
+ "type": "p5.Camera"
}
],
- "return": {
- "description": "a one dimensional array of numbers\n[p5.Vector(1, 2, 3), p5.Vector(4, 5, 6)] ->\n[1, 2, 3, 4, 5, 6]",
- "type": "Array]"
- },
- "class": "p5.RendererGL",
- "module": "Lights, Camera"
+ "example": [
+ "\n\n\nvar cam1, cam2;\nvar currentCamera;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n\n cam1 = createCamera();\n cam2 = createCamera();\n cam2.setPosition(30, 0, 50);\n cam2.lookAt(0, 0, 0);\n cam2.ortho();\n\n // set variable for previously active camera:\n currentCamera = 1;\n}\n\nfunction draw() {\n background(200);\n\n // camera 1:\n cam1.lookAt(0, 0, 0);\n cam1.setPosition(sin(frameCount / 60) * 200, 0, 100);\n\n // every 100 frames, switch between the two cameras\n if (frameCount % 100 === 0) {\n if (currentCamera === 1) {\n setCamera(cam1);\n currentCamera = 0;\n } else {\n setCamera(cam2);\n currentCamera = 1;\n }\n }\n\n drawBoxes();\n}\n\nfunction drawBoxes() {\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n"
+ ],
+ "alt": "Canvas switches between two camera views, each showing a series of spinning\n3D boxes.",
+ "class": "p5",
+ "module": "Lights, Camera",
+ "submodule": "Camera"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 40,
- "description": "Creates, compiles, and links the shader based on its\nsources for the vertex and fragment shaders (provided\nto the constructor). Populates known attributes and\nuniforms from the shader.
\n",
+ "file": "src/webgl/p5.Geometry.js",
+ "line": 50,
"itemtype": "method",
- "name": "init",
+ "name": "computeFaces",
"chainable": 1,
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
+ "class": "p5.Geometry",
+ "module": "Lights, Camera"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 98,
- "description": "Queries the active attributes for this shader and loads\ntheir names and locations into the attributes array.
\n",
+ "file": "src/webgl/p5.Geometry.js",
+ "line": 92,
+ "description": "computes smooth normals per vertex as an average of each\nface.
\n",
"itemtype": "method",
- "name": "_loadAttributes",
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
+ "name": "computeNormals",
+ "chainable": 1,
+ "class": "p5.Geometry",
+ "module": "Lights, Camera"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 130,
- "description": "Queries the active uniforms for this shader and loads\ntheir names and locations into the uniforms array.
\n",
+ "file": "src/webgl/p5.Geometry.js",
+ "line": 131,
+ "description": "Averages the vertex normals. Used in curved\nsurfaces
\n",
"itemtype": "method",
- "name": "_loadUniforms",
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
+ "name": "averageNormals",
+ "chainable": 1,
+ "class": "p5.Geometry",
+ "module": "Lights, Camera"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 179,
- "description": "initializes (if needed) and binds the shader program.
\n",
+ "file": "src/webgl/p5.Geometry.js",
+ "line": 152,
+ "description": "Averages pole normals. Used in spherical primitives
\n",
"itemtype": "method",
- "name": "bindShader",
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
+ "name": "averagePoleNormals",
+ "chainable": 1,
+ "class": "p5.Geometry",
+ "module": "Lights, Camera"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 202,
+ "file": "src/webgl/p5.Geometry.js",
+ "line": 245,
+ "description": "Modifies all vertices to be centered within the range -100 to 100.
\n",
"itemtype": "method",
- "name": "unbindShader",
+ "name": "normalize",
"chainable": 1,
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
+ "class": "p5.Geometry",
+ "module": "Lights, Camera"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 253,
+ "file": "src/webgl/p5.RendererGL.js",
+ "line": 215,
+ "description": "Set attributes for the WebGL Drawing context.\nThis is a way of adjusting ways that the WebGL\nrenderer works to fine-tune the display and performance.\nThis should be put in setup().\nThe available attributes are:\n
\nalpha - indicates if the canvas contains an alpha buffer\ndefault is true\n
\ndepth - indicates whether the drawing buffer has a depth buffer\nof at least 16 bits - default is true\n
\nstencil - indicates whether the drawing buffer has a stencil buffer\nof at least 8 bits\n
\nantialias - indicates whether or not to perform anti-aliasing\ndefault is false\n
\npremultipliedAlpha - indicates that the page compositor will assume\nthe drawing buffer contains colors with pre-multiplied alpha\ndefault is false\n
\npreserveDrawingBuffer - if true the buffers will not be cleared and\nand will preserve their values until cleared or overwritten by author\n(note that p5 clears automatically on draw loop)\ndefault is true\n
\nperPixelLighting - if true, per-pixel lighting will be used in the\nlighting shader.\ndefault is false\n
\n",
"itemtype": "method",
- "name": "useProgram",
- "chainable": 1,
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
+ "name": "setAttributes",
+ "example": [
+ "\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(255);\n push();\n rotateZ(frameCount * 0.02);\n rotateX(frameCount * 0.02);\n rotateY(frameCount * 0.02);\n fill(0, 0, 0);\n box(50);\n pop();\n}\n\n\n
\nNow with the antialias attribute set to true.\n
\n\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n setAttributes('antialias', true);\n}\n\nfunction draw() {\n background(255);\n push();\n rotateZ(frameCount * 0.02);\n rotateX(frameCount * 0.02);\n rotateY(frameCount * 0.02);\n fill(0, 0, 0);\n box(50);\n pop();\n}\n\n\n\n\n\n// press the mouse button to enable perPixelLighting\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noStroke();\n fill(255);\n}\n\nvar lights = [\n { c: '#f00', t: 1.12, p: 1.91, r: 0.2 },\n { c: '#0f0', t: 1.21, p: 1.31, r: 0.2 },\n { c: '#00f', t: 1.37, p: 1.57, r: 0.2 },\n { c: '#ff0', t: 1.12, p: 1.91, r: 0.7 },\n { c: '#0ff', t: 1.21, p: 1.31, r: 0.7 },\n { c: '#f0f', t: 1.37, p: 1.57, r: 0.7 }\n];\n\nfunction draw() {\n var t = millis() / 1000 + 1000;\n background(0);\n directionalLight(color('#222'), 1, 1, 1);\n\n for (var i = 0; i < lights.length; i++) {\n var light = lights[i];\n pointLight(\n color(light.c),\n p5.Vector.fromAngles(t * light.t, t * light.p, width * light.r)\n );\n }\n\n specularMaterial(255);\n sphere(width * 0.1);\n\n rotateX(t * 0.77);\n rotateY(t * 0.83);\n rotateZ(t * 0.91);\n torus(width * 0.3, width * 0.07, 30, 10);\n}\n\nfunction mousePressed() {\n setAttributes('perPixelLighting', true);\n noStroke();\n fill(255);\n}\nfunction mouseReleased() {\n setAttributes('perPixelLighting', false);\n noStroke();\n fill(255);\n}\n\n"
+ ],
+ "alt": "a rotating cube with smoother edges",
+ "class": "p5",
+ "module": "Rendering",
+ "submodule": "Rendering",
+ "overloads": [
+ {
+ "line": 215,
+ "params": [
+ {
+ "name": "key",
+ "description": "Name of attribute
\n",
+ "type": "String"
+ },
+ {
+ "name": "value",
+ "description": "New value of named attribute
\n",
+ "type": "Boolean"
+ }
+ ]
+ },
+ {
+ "line": 348,
+ "params": [
+ {
+ "name": "obj",
+ "description": "object with key-value pairs
\n",
+ "type": "Object"
+ }
+ ]
+ }
+ ]
},
{
"file": "src/webgl/p5.Shader.js",
- "line": 264,
+ "line": 274,
"description": "Wrapper around gl.uniform functions.\nAs we store uniform info in the shader we can use that\nto do type checking on the supplied data and call\nthe appropriate function.
\n",
"itemtype": "method",
"name": "setUniform",
@@ -16959,8 +18387,8 @@ module.exports={
},
{
"name": "data",
- "description": "the data to be associated with that uniform; type\nvaries (could be a single numerical value, array, matrix, or\ntexture / sampler reference)
\n",
- "type": "Object"
+ "description": "the data to be associated\nwith that uniform; type varies (could be a single numerical value, array,\nmatrix, or texture / sampler reference)
\n",
+ "type": "Object|Number|Boolean|Number[]"
}
],
"class": "p5.Shader",
@@ -16968,423 +18396,39 @@ module.exports={
"submodule": "Shaders"
},
{
- "file": "src/webgl/p5.Shader.js",
- "line": 394,
- "itemtype": "method",
- "name": "enableAttrib",
- "chainable": 1,
- "access": "private",
- "tagname": "",
- "class": "p5.Shader",
- "module": "Lights, Camera",
- "submodule": "Shaders"
- },
- {
- "file": "src/webgl/p5.Texture.js",
- "line": 66,
- "description": "Initializes common texture parameters, creates a gl texture,\ntries to upload the texture for the first time if data is\nalready available.
\n",
- "access": "private",
- "tagname": "",
- "itemtype": "method",
- "name": "init",
- "class": "p5.Texture",
- "module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/p5.Texture.js",
- "line": 98,
- "description": "Checks if the source data for this texture has changed (if it's\neasy to do so) and reuploads the texture if necessary. If it's not\npossible or to expensive to do a calculation to determine wheter or\nnot the data has occurred, this method simply re-uploads the texture.
\n",
- "itemtype": "method",
- "name": "update",
- "class": "p5.Texture",
- "module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/p5.Texture.js",
- "line": 185,
- "description": "Binds the texture to the appropriate GL target.
\n",
- "itemtype": "method",
- "name": "bindTexture",
- "class": "p5.Texture",
- "module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/p5.Texture.js",
- "line": 199,
- "description": "Unbinds the texture from the appropriate GL target.
\n",
- "itemtype": "method",
- "name": "unbindTexture",
- "class": "p5.Texture",
- "module": "Lights, Camera",
- "submodule": "Material"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 13,
- "description": "Draw a plane with given a width and height
\n",
+ "file": "lib/addons/p5.dom.js",
+ "line": 40,
+ "description": "Searches the page for an element with the given ID, class, or tag name (using the '#' or '.'\nprefixes to specify an ID or class respectively, and none for a tag) and returns it as\na p5.Element. If a class or tag name is given with more than 1 element,\nonly the first element will be returned.\nThe DOM node itself can be accessed with .elt.\nReturns null if none found. You can also specify a container to search within.
\n",
"itemtype": "method",
- "name": "plane",
+ "name": "select",
"params": [
{
- "name": "width",
- "description": "width of the plane
\n",
- "type": "Number"
- },
- {
- "name": "height",
- "description": "height of the plane
\n",
- "type": "Number"
- },
- {
- "name": "detailX",
- "description": "Optional number of triangle\n subdivisions in x-dimension
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "Optional number of triangle\n subdivisions in y-dimension
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "return": {
- "description": "the p5 object",
- "type": "P5"
- },
- "example": [
- "\n\n\n//draw a plane with width 200 and height 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n plane(50, 50);\n}\n\n"
- ],
- "alt": "Nothing displayed on canvas\nRotating interior view of a box with sides that change color.\n3d red and green gradient.\nRotating interior view of a cylinder with sides that change color.\nRotating view of a cylinder with sides that change color.\n3d red and green gradient.\nrotating view of a multi-colored cylinder with concave sides.",
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 93,
- "description": "Draw a box with given width, height and depth
\n",
- "itemtype": "method",
- "name": "box",
- "params": [
- {
- "name": "width",
- "description": "width of the box
\n",
- "type": "Number"
- },
- {
- "name": "Height",
- "description": "height of the box
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "depth",
- "description": "depth of the box
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailX",
- "description": "Optional number of triangle\n subdivisions in x-dimension
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "Optional number of triangle\n subdivisions in y-dimension
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n//draw a spinning box with width, height and depth 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(200, 200, 200);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 190,
- "description": "Draw a sphere with given radius
\n",
- "itemtype": "method",
- "name": "sphere",
- "params": [
- {
- "name": "radius",
- "description": "radius of circle
\n",
- "type": "Number"
- },
- {
- "name": "detailX",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 24
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 16
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n// draw a sphere with radius 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n sphere(50);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 265,
- "access": "private",
- "tagname": "helper function for creating both cones and cyllinders",
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 343,
- "description": "Draw a cylinder with given radius and height
\n",
- "itemtype": "method",
- "name": "cylinder",
- "params": [
- {
- "name": "radius",
- "description": "radius of the surface
\n",
- "type": "Number"
- },
- {
- "name": "height",
- "description": "height of the cylinder
\n",
- "type": "Number"
- },
- {
- "name": "detailX",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 24
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "number of segments in y-dimension,\n the more segments the smoother geometry\n default is 16
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n//draw a spinning cylinder with radius 200 and height 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cylinder(200, 200);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 409,
- "description": "Draw a cone with given radius and height
\n",
- "itemtype": "method",
- "name": "cone",
- "params": [
- {
- "name": "radius",
- "description": "radius of the bottom surface
\n",
- "type": "Number"
- },
- {
- "name": "height",
- "description": "height of the cone
\n",
- "type": "Number"
- },
- {
- "name": "detailX",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 24
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 16
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n//draw a spinning cone with radius 200 and height 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cone(200, 200);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 475,
- "description": "Draw an ellipsoid with given radius
\n",
- "itemtype": "method",
- "name": "ellipsoid",
- "params": [
- {
- "name": "radiusx",
- "description": "xradius of circle
\n",
- "type": "Number"
- },
- {
- "name": "radiusy",
- "description": "yradius of circle
\n",
- "type": "Number"
- },
- {
- "name": "radiusz",
- "description": "zradius of circle
\n",
- "type": "Number"
- },
- {
- "name": "detailX",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 24. Avoid detail number above\n 150, it may crash the browser.
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "number of segments,\n the more segments the smoother geometry\n default is 16. Avoid detail number above\n 150, it may crash the browser.
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n// draw an ellipsoid with radius 20, 30 and 40.\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n ellipsoid(20, 30, 40);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 556,
- "description": "Draw a torus with given radius and tube radius
\n",
- "itemtype": "method",
- "name": "torus",
- "params": [
- {
- "name": "radius",
- "description": "radius of the whole ring
\n",
- "type": "Number"
- },
- {
- "name": "tubeRadius",
- "description": "radius of the tube
\n",
- "type": "Number"
- },
- {
- "name": "detailX",
- "description": "number of segments in x-dimension,\n the more segments the smoother geometry\n default is 24
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "detailY",
- "description": "number of segments in y-dimension,\n the more segments the smoother geometry\n default is 16
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n//draw a spinning torus with radius 200 and tube radius 60\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n torus(200, 60);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "src/webgl/primitives.js",
- "line": 860,
- "description": "Draw a line given two points
\n",
- "params": [
- {
- "name": "x0",
- "description": "x-coordinate of first vertex
\n",
- "type": "Number"
- },
- {
- "name": "y0",
- "description": "y-coordinate of first vertex
\n",
- "type": "Number"
- },
- {
- "name": "z0",
- "description": "z-coordinate of first vertex
\n",
- "type": "Number"
- },
- {
- "name": "x1",
- "description": "x-coordinate of second vertex
\n",
- "type": "Number"
- },
- {
- "name": "y1",
- "description": "y-coordinate of second vertex
\n",
- "type": "Number"
- },
- {
- "name": "z1",
- "description": "z-coordinate of second vertex
\n",
- "type": "Number"
- }
- ],
- "chainable": 1,
- "example": [
- "\n\n\n//draw a line\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n // Use fill instead of stroke to change the color of shape.\n fill(255, 0, 0);\n line(10, 10, 0, 60, 60, 20);\n}\n\n"
- ],
- "class": "p5",
- "module": "Shape",
- "submodule": "3D Primitives"
- },
- {
- "file": "lib/addons/p5.dom.js",
- "line": 41,
- "description": "Searches the page for an element with the given ID, class, or tag name (using the '#' or '.'\nprefixes to specify an ID or class respectively, and none for a tag) and returns it as\na p5.Element. If a class or tag name is given with more than 1 element,\nonly the first element will be returned.\nThe DOM node itself can be accessed with .elt.\nReturns null if none found. You can also specify a container to search within.
\n",
- "itemtype": "method",
- "name": "select",
- "params": [
- {
- "name": "name",
- "description": "id, class, or tag name of element to search for
\n",
- "type": "String"
+ "name": "name",
+ "description": "id, class, or tag name of element to search for
\n",
+ "type": "String"
},
{
"name": "container",
- "description": "id, p5.Element, or HTML element to search within
\n",
- "type": "String",
+ "description": "id, p5.Element, or\n HTML element to search within
\n",
+ "type": "String|p5.Element|HTMLElement",
"optional": true
}
],
"return": {
- "description": "p5.Element containing node found",
- "type": "Object|p5.Element|Null"
+ "description": "p5.Element containing node found",
+ "type": "p5.Element|null"
},
"example": [
- "\n\nfunction setup() {\n createCanvas(100,100);\n //translates canvas 50px down\n select('canvas').position(100, 100);\n}\n\n\n// these are all valid calls to select()\nvar a = select('#moo');\nvar b = select('#blah', '#myContainer');\nvar c = select('#foo', b);\nvar d = document.getElementById('beep');\nvar e = select('p', d);\n\n"
+ "\n\nfunction setup() {\n createCanvas(100, 100);\n //translates canvas 50px down\n select('canvas').position(100, 100);\n}\n\n\n// these are all valid calls to select()\nvar a = select('#moo');\nvar b = select('#blah', '#myContainer');\nvar c, e;\nif (b) {\n c = select('#foo', b);\n}\nvar d = document.getElementById('beep');\nif (d) {\n e = select('p', d);\n}\n[a, b, c, d, e]; // unused\n\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 100,
- "description": "Searches the page for elements with the given class or tag name (using the '.' prefix\nto specify a class and no prefix for a tag) and returns them as p5.Elements\nin an array.\nThe DOM node itself can be accessed with .elt.\nReturns an empty array if none found.\nYou can also specify a container to search within.
\n",
+ "line": 107,
+ "description": "Searches the page for elements with the given class or tag name (using the '.' prefix\nto specify a class and no prefix for a tag) and returns them as p5.Elements\nin an array.\nThe DOM node itself can be accessed with .elt.\nReturns an empty array if none found.\nYou can also specify a container to search within.
\n",
"itemtype": "method",
"name": "selectAll",
"params": [
@@ -17395,62 +18439,62 @@ module.exports={
},
{
"name": "container",
- "description": "id, p5.Element, or HTML element to search within
\n",
+ "description": "id, p5.Element, or HTML element to search within
\n",
"type": "String",
"optional": true
}
],
"return": {
- "description": "Array of p5.Elements containing nodes found",
- "type": "Array"
+ "description": "Array of p5.Elements containing nodes found",
+ "type": "p5.Element[]"
},
"example": [
- "\n\nfunction setup() {\n createButton('btn');\n createButton('2nd btn');\n createButton('3rd btn');\n var buttons = selectAll('button');\n\n for (var i = 0; i < buttons.length; i++){\n buttons[i].size(100,100);\n }\n}\n\n\n// these are all valid calls to selectAll()\nvar a = selectAll('.moo');\nvar b = selectAll('div');\nvar c = selectAll('button', '#myContainer');\nvar d = select('#container');\nvar e = selectAll('p', d);\nvar f = document.getElementById('beep');\nvar g = select('.blah', f);\n\n"
+ "\n\nfunction setup() {\n createButton('btn');\n createButton('2nd btn');\n createButton('3rd btn');\n var buttons = selectAll('button');\n\n for (var i = 0; i < buttons.length; i++) {\n buttons[i].size(100, 100);\n }\n}\n\n\n// these are all valid calls to selectAll()\nvar a = selectAll('.moo');\na = selectAll('div');\na = selectAll('button', '#myContainer');\n\nvar d = select('#container');\na = selectAll('p', d);\n\nvar f = document.getElementById('beep');\na = select('.blah', f);\n\na; // unused\n\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 156,
+ "line": 168,
"description": "Helper function for select and selectAll
\n",
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 172,
+ "line": 184,
"description": "Helper function for getElement and getElements.
\n",
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 199,
- "description": "Removes all elements created by p5, except any canvas / graphics\nelements created by createCanvas or createGraphics.\nEvent handlers are removed, and element is removed from the DOM.
\n",
+ "line": 218,
+ "description": "Removes all elements created by p5, except any canvas / graphics\nelements created by createCanvas or createGraphics.\nEvent handlers are removed, and element is removed from the DOM.
\n",
"itemtype": "method",
"name": "removeElements",
"example": [
"\n\nfunction setup() {\n createCanvas(100, 100);\n createDiv('this is some text');\n createP('this is a paragraph');\n}\nfunction mousePressed() {\n removeElements(); // this will remove the div and p, not canvas\n}\n\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 225,
+ "line": 245,
"description": "Helpers for create methods.
\n",
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 236,
+ "line": 258,
"description": "Creates a <div></div> element in the DOM with given inner HTML.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createDiv",
@@ -17463,19 +18507,19 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar myDiv;\nfunction setup() {\n myDiv = createDiv('this is some text');\n}\n"
+ "\n\ncreateDiv('this is some text');\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 253,
+ "line": 272,
"description": "Creates a <p></p> element in the DOM with given inner HTML. Used\nfor paragraph length text.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createP",
@@ -17488,19 +18532,19 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar myP;\nfunction setup() {\n myP = createP('this is some text');\n}\n"
+ "\n\ncreateP('this is some text');\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 271,
+ "line": 287,
"description": "Creates a <span></span> element in the DOM with given inner HTML.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createSpan",
@@ -17513,55 +18557,83 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar mySpan;\nfunction setup() {\n mySpan = createSpan('this is some text');\n}\n"
+ "\n\ncreateSpan('this is some text');\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 297,
+ "line": 310,
"description": "Creates an <img> element in the DOM with given src and\nalternate text.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createImg",
- "params": [
- {
- "name": "src",
- "description": "src path or url for image
\n",
- "type": "String"
- },
- {
- "name": "alt",
- "description": "alternate text to be used if image does not load
\n",
- "type": "String",
- "optional": true
- },
- {
- "name": "successCallback",
- "description": "callback to be called once image data is loaded
\n",
- "type": "Function",
- "optional": true
- }
- ],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar img;\nfunction setup() {\n img = createImg('http://p5js.org/img/asterisk-01.png');\n}\n"
+ "\n\ncreateImg('http://p5js.org/img/asterisk-01.png');\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 310,
+ "params": [
+ {
+ "name": "src",
+ "description": "src path or url for image
\n",
+ "type": "String"
+ },
+ {
+ "name": "alt",
+ "description": "alternate text to be used if image does not load
\n",
+ "type": "String",
+ "optional": true
+ },
+ {
+ "name": "successCallback",
+ "description": "callback to be called once image data is loaded
\n",
+ "type": "Function",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
+ }
+ },
+ {
+ "line": 326,
+ "params": [
+ {
+ "name": "src",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "successCallback",
+ "description": "",
+ "type": "Function"
+ }
+ ],
+ "return": {
+ "description": "",
+ "type": "Object|p5.Element"
+ }
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 342,
+ "line": 359,
"description": "Creates an <a></a> element in the DOM for including a hyperlink.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createA",
@@ -17584,26 +18656,26 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar myLink;\nfunction setup() {\n myLink = createA('http://p5js.org/', 'this is a link');\n}\n"
+ "\n\ncreateA('http://p5js.org/', 'this is a link');\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 369,
- "class": "p5.dom",
+ "line": 384,
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 372,
+ "line": 386,
"description": "Creates a slider <input></input> element in the DOM.\nUse .size() to set the display length of the slider.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createSlider",
@@ -17632,19 +18704,19 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
"\n\nvar slider;\nfunction setup() {\n slider = createSlider(0, 255, 100);\n slider.position(10, 10);\n slider.style('width', '80px');\n}\n\nfunction draw() {\n var val = slider.value();\n background(val);\n}\n\n\n\nvar slider;\nfunction setup() {\n colorMode(HSB);\n slider = createSlider(0, 360, 60, 40);\n slider.position(10, 10);\n slider.style('width', '80px');\n}\n\nfunction draw() {\n var val = slider.value();\n background(val, 100, 100, 1);\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 428,
+ "line": 443,
"description": "Creates a <button></button> element in the DOM.\nUse .size() to set the display size of the button.\nUse .mousePressed() to specify behavior on press.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createButton",
@@ -17662,19 +18734,19 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
"\n\nvar button;\nfunction setup() {\n createCanvas(100, 100);\n background(0);\n button = createButton('click me');\n button.position(19, 19);\n button.mousePressed(changeBG);\n}\n\nfunction changeBG() {\n var val = random(255);\n background(val);\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 463,
+ "line": 479,
"description": "Creates a checkbox <input></input> element in the DOM.\nCalling .checked() on a checkbox returns if it is checked or not
\n",
"itemtype": "method",
"name": "createCheckbox",
@@ -17687,26 +18759,26 @@ module.exports={
},
{
"name": "value",
- "description": "value of the checkbox; checked is true, unchecked is false.Unchecked if no value given
\n",
+ "description": "value of the checkbox; checked is true, unchecked is false
\n",
"type": "Boolean",
"optional": true
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar checkbox;\n\nfunction setup() {\n checkbox = createCheckbox('label', false);\n checkbox.changed(myCheckedEvent);\n}\n\nfunction myCheckedEvent() {\n if (this.checked()) {\n console.log(\"Checking!\");\n } else {\n console.log(\"Unchecking!\");\n }\n}\n"
+ "\n\nvar checkbox;\n\nfunction setup() {\n checkbox = createCheckbox('label', false);\n checkbox.changed(myCheckedEvent);\n}\n\nfunction myCheckedEvent() {\n if (this.checked()) {\n console.log('Checking!');\n } else {\n console.log('Unchecking!');\n }\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 528,
- "description": "Creates a dropdown menu <select></select> element in the DOM.\nIt also helps to assign select-box methods to p5.Element when selecting existing select box
\n",
+ "line": 547,
+ "description": "Creates a dropdown menu <select></select> element in the DOM.\nIt also helps to assign select-box methods to p5.Element when selecting existing select box
\n",
"itemtype": "method",
"name": "createSelect",
"return": {
@@ -17714,14 +18786,14 @@ module.exports={
"type": "p5.Element"
},
"example": [
- "\n\nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text(\"it's a \"+item+\"!\", 50, 50);\n}\n"
+ "\n\nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text('it is a' + item + '!', 50, 50);\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom",
"overloads": [
{
- "line": 528,
+ "line": 547,
"params": [
{
"name": "multiple",
@@ -17736,7 +18808,7 @@ module.exports={
}
},
{
- "line": 556,
+ "line": 575,
"params": [
{
"name": "existing",
@@ -17753,7 +18825,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 633,
+ "line": 651,
"description": "Creates a radio button <input></input> element in the DOM.\nThe .option() method can be used to set options for the radio after it is\ncreated. The .value() method will return the currently selected option.
\n",
"itemtype": "method",
"name": "createRadio",
@@ -17766,27 +18838,52 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option(\"black\");\n radio.option(\"white\");\n radio.option(\"gray\");\n radio.style('width', '60px');\n textAlign(CENTER);\n fill(255, 0, 0);\n}\n\nfunction draw() {\n var val = radio.value();\n background(val);\n text(val, width/2, height/2);\n}\n\n\nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option('apple', 1);\n radio.option('bread', 2);\n radio.option('juice', 3);\n radio.style('width', '60px');\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(200);\n var val = radio.value();\n if (val) {\n text('item cost is $'+val, width/2, height/2);\n }\n}\n"
+ "\n\nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option('black');\n radio.option('white');\n radio.option('gray');\n radio.style('width', '60px');\n textAlign(CENTER);\n fill(255, 0, 0);\n}\n\nfunction draw() {\n var val = radio.value();\n background(val);\n text(val, width / 2, height / 2);\n}\n\n\nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option('apple', 1);\n radio.option('bread', 2);\n radio.option('juice', 3);\n radio.style('width', '60px');\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(200);\n var val = radio.value();\n if (val) {\n text('item cost is $' + val, width / 2, height / 2);\n }\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 759,
- "description": "Creates an <input></input> element in the DOM for text input.\nUse .size() to set the display length of the box.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
+ "line": 789,
+ "description": "Creates a colorPicker element in the DOM for color input.\nThe .value() method will return a hex string (#rrggbb) of the color.\nThe .color() method will return a p5.Color object with the current chosen color.
\n",
+ "itemtype": "method",
+ "name": "createColorPicker",
+ "params": [
+ {
+ "name": "value",
+ "description": "default color of element
\n",
+ "type": "String|p5.Color",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
+ },
+ "example": [
+ "\n\n\nvar inp1, inp2;\nfunction setup() {\n createCanvas(100, 100);\n background('grey');\n inp1 = createColorPicker('#ff0000');\n inp2 = createColorPicker(color('yellow'));\n inp1.input(setShade1);\n inp2.input(setShade2);\n setMidShade();\n}\n\nfunction setMidShade() {\n // Finding a shade between the two\n var commonShade = lerpColor(inp1.color(), inp2.color(), 0.5);\n fill(commonShade);\n rect(20, 20, 60, 60);\n}\n\nfunction setShade1() {\n setMidShade();\n console.log('You are choosing shade 1 to be : ', this.value());\n}\nfunction setShade2() {\n setMidShade();\n console.log('You are choosing shade 2 to be : ', this.value());\n}\n\n"
+ ],
+ "class": "p5",
+ "module": "p5.dom",
+ "submodule": "p5.dom"
+ },
+ {
+ "file": "lib/addons/p5.dom.js",
+ "line": 863,
+ "description": "Creates an <input></input> element in the DOM for text input.\nUse .size() to set the display length of the box.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createInput",
"params": [
{
"name": "value",
"description": "default value of the input box
\n",
- "type": "Number",
+ "type": "String",
"optional": true
},
{
@@ -17797,19 +18894,19 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nfunction setup(){\n var inp = createInput('');\n inp.input(myInputEvent);\n}\n\nfunction myInputEvent(){\n console.log('you are typing: ', this.value());\n}\n\n"
+ "\n\nfunction setup() {\n var inp = createInput('');\n inp.input(myInputEvent);\n}\n\nfunction myInputEvent() {\n console.log('you are typing: ', this.value());\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 789,
+ "line": 893,
"description": "Creates an <input></input> element in the DOM of type 'file'.\nThis allows users to select local files for use in a sketch.
\n",
"itemtype": "method",
"name": "createFileInput",
@@ -17828,123 +18925,159 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created DOM element",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created DOM element",
+ "type": "p5.Element"
},
"example": [
- "\nvar input;\nvar img;\n\nfunction setup() {\n input = createFileInput(handleFile);\n input.position(0, 0);\n}\n\nfunction draw() {\n if (img) {\n image(img, 0, 0, width, height);\n }\n}\n\nfunction handleFile(file) {\n print(file);\n if (file.type === 'image') {\n img = createImg(file.data);\n img.hide();\n }\n}"
+ "\n\nvar input;\nvar img;\n\nfunction setup() {\n input = createFileInput(handleFile);\n input.position(0, 0);\n}\n\nfunction draw() {\n if (img) {\n image(img, 0, 0, width, height);\n }\n}\n\nfunction handleFile(file) {\n print(file);\n if (file.type === 'image') {\n img = createImg(file.data);\n img.hide();\n }\n}\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 874,
- "class": "p5.dom",
+ "line": 981,
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 911,
- "description": "Creates an HTML5 <video> element in the DOM for simple playback\nof audio/video. Shown by default, can be hidden with .hide()\nand drawn into canvas using video(). Appends to the container\nnode if one is specified, otherwise appends to body. The first parameter\ncan be either a single string path to a video file, or an array of string\npaths to different formats of the same video. This is useful for ensuring\nthat your video can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.
\n",
+ "line": 1023,
+ "description": "Creates an HTML5 <video> element in the DOM for simple playback\nof audio/video. Shown by default, can be hidden with .hide()\nand drawn into canvas using video(). Appends to the container\nnode if one is specified, otherwise appends to body. The first parameter\ncan be either a single string path to a video file, or an array of string\npaths to different formats of the same video. This is useful for ensuring\nthat your video can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.
\n",
"itemtype": "method",
"name": "createVideo",
"params": [
{
"name": "src",
"description": "path to a video file, or array of paths for\n supporting different browsers
\n",
- "type": "String|Array"
+ "type": "String|String[]"
},
{
"name": "callback",
"description": "callback function to be called upon\n 'canplaythrough' event fire, that is, when the\n browser can play the media, and estimates that\n enough data has been loaded to play the media\n up to its end without having to stop for\n further buffering of content
\n",
- "type": "Object",
+ "type": "Function",
"optional": true
}
],
"return": {
- "description": "pointer to video p5.Element",
- "type": "p5.MediaElement|p5.Element"
+ "description": "pointer to video p5.Element",
+ "type": "p5.MediaElement"
},
- "class": "p5.dom",
+ "example": [
+ "\n\nvar vid;\nfunction setup() {\n vid = createVideo(['small.mp4', 'small.ogv', 'small.webm'], vidLoad);\n}\n\n// This function is called when the video loads\nfunction vidLoad() {\n vid.play();\n}\n"
+ ],
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 937,
- "class": "p5.dom",
+ "line": 1062,
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 939,
- "description": "Creates a hidden HTML5 <audio> element in the DOM for simple audio\nplayback. Appends to the container node if one is specified,\notherwise appends to body. The first parameter\ncan be either a single string path to a audio file, or an array of string\npaths to different formats of the same audio. This is useful for ensuring\nthat your audio can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.
\n",
+ "line": 1064,
+ "description": "Creates a hidden HTML5 <audio> element in the DOM for simple audio\nplayback. Appends to the container node if one is specified,\notherwise appends to body. The first parameter\ncan be either a single string path to a audio file, or an array of string\npaths to different formats of the same audio. This is useful for ensuring\nthat your audio can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.
\n",
"itemtype": "method",
"name": "createAudio",
"params": [
{
"name": "src",
- "description": "path to an audio file, or array of paths for\n supporting different browsers
\n",
- "type": "String|Array"
+ "description": "path to an audio file, or array of paths\n for supporting different browsers
\n",
+ "type": "String|String[]",
+ "optional": true
},
{
"name": "callback",
"description": "callback function to be called upon\n 'canplaythrough' event fire, that is, when the\n browser can play the media, and estimates that\n enough data has been loaded to play the media\n up to its end without having to stop for\n further buffering of content
\n",
- "type": "Object",
+ "type": "Function",
"optional": true
}
],
"return": {
- "description": "pointer to audio p5.Element",
- "type": "p5.MediaElement|p5.Element"
+ "description": "pointer to audio p5.Element",
+ "type": "p5.MediaElement"
},
- "class": "p5.dom",
+ "example": [
+ "\n\nvar ele;\nfunction setup() {\n ele = createAudio('assets/beat.mp3');\n\n // here we set the element to autoplay\n // The element will play as soon\n // as it is able to do so.\n ele.autoplay(true);\n}\n"
+ ],
+ "class": "p5",
+ "module": "p5.dom",
+ "submodule": "p5.dom"
+ },
+ {
+ "file": "lib/addons/p5.dom.js",
+ "line": 1102,
+ "class": "p5",
+ "module": "p5.dom",
+ "submodule": "p5.dom"
+ },
+ {
+ "file": "lib/addons/p5.dom.js",
+ "line": 1104,
+ "itemtype": "property",
+ "name": "VIDEO",
+ "type": "String",
+ "final": 1,
+ "category": [
+ "Constants"
+ ],
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 965,
- "class": "p5.dom",
+ "line": 1110,
+ "itemtype": "property",
+ "name": "AUDIO",
+ "type": "String",
+ "final": 1,
+ "category": [
+ "Constants"
+ ],
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 998,
- "description": "Creates a new <video> element that contains the audio/video feed\nfrom a webcam. This can be drawn onto the canvas using video().
\nMore specific properties of the feed can be passing in a Constraints object.\nSee the\n W3C\nspec for possible properties. Note that not all of these are supported\nby all browsers.
\nSecurity note: A new browser security specification requires that getUserMedia,\nwhich is behind createCapture(), only works when you're running the code locally,\nor on HTTPS. Learn more here\nand here.
",
+ "line": 1147,
+ "description": "Creates a new HTML5 <video> element that contains the audio/video\nfeed from a webcam. The element is separate from the canvas and is\ndisplayed by default. The element can be hidden using .hide(). The feed\ncan be drawn onto the canvas using image(). The loadedmetadata property can\nbe used to detect when the element has fully loaded (see second example).
\nMore specific properties of the feed can be passing in a Constraints object.\nSee the\n W3C\nspec for possible properties. Note that not all of these are supported\nby all browsers.
\nSecurity note: A new browser security specification requires that getUserMedia,\nwhich is behind createCapture(), only works when you're running the code locally,\nor on HTTPS. Learn more here\nand here.
",
"itemtype": "method",
"name": "createCapture",
"params": [
{
"name": "type",
- "description": "type of capture, either VIDEO or\n AUDIO if none specified, default both,\n or a Constraints object
\n",
+ "description": "type of capture, either VIDEO or\n AUDIO if none specified, default both,\n or a Constraints object
\n",
"type": "String|Constant|Object"
},
{
"name": "callback",
- "description": "function to be called once\n stream has loaded
\n",
- "type": "Function"
+ "description": "function to be called once\n stream has loaded
\n",
+ "type": "Function",
+ "optional": true
}
],
"return": {
- "description": "capture video p5.Element",
- "type": "Object|p5.Element"
+ "description": "capture video p5.Element",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar capture;\n\nfunction setup() {\n createCanvas(480, 120);\n capture = createCapture(VIDEO);\n}\n\nfunction draw() {\n image(capture, 0, 0, width, width*capture.height/capture.width);\n filter(INVERT);\n}\n\n\nfunction setup() {\n createCanvas(480, 120);\n var constraints = {\n video: {\n mandatory: {\n minWidth: 1280,\n minHeight: 720\n },\n optional: [\n { maxFrameRate: 10 }\n ]\n },\n audio: true\n };\n createCapture(constraints, function(stream) {\n console.log(stream);\n });\n}\n"
+ "\n\nvar capture;\n\nfunction setup() {\n createCanvas(480, 480);\n capture = createCapture(VIDEO);\n capture.hide();\n}\n\nfunction draw() {\n image(capture, 0, 0, width, width * capture.height / capture.width);\n filter(INVERT);\n}\n\n\nfunction setup() {\n createCanvas(480, 120);\n var constraints = {\n video: {\n mandatory: {\n minWidth: 1280,\n minHeight: 720\n },\n optional: [{ maxFrameRate: 10 }]\n },\n audio: true\n };\n createCapture(constraints, function(stream) {\n console.log(stream);\n });\n}\n\n\nvar capture;\n\nfunction setup() {\n createCanvas(640, 480);\n capture = createCapture(VIDEO);\n}\nfunction draw() {\n background(0);\n if (capture.loadedmetadata) {\n var c = capture.get(0, 0, 100, 100);\n image(c, 0, 0);\n }\n}"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1111,
+ "line": 1283,
"description": "Creates element with given tag in the DOM with given content.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",
"itemtype": "method",
"name": "createElement",
@@ -17962,19 +19095,19 @@ module.exports={
}
],
"return": {
- "description": "pointer to p5.Element holding created node",
- "type": "Object|p5.Element"
+ "description": "pointer to p5.Element holding created node",
+ "type": "p5.Element"
},
"example": [
- "\n\nvar h2 = createElement('h2','im an h2 p5.element!');\n"
+ "\n\ncreateElement('h2', 'im an h2 p5.element!');\n"
],
- "class": "p5.dom",
+ "class": "p5",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1137,
+ "line": 1309,
"description": "Adds specified class to the element.
\n",
"itemtype": "method",
"name": "addClass",
@@ -17985,10 +19118,7 @@ module.exports={
"type": "String"
}
],
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
"\n \n var div = createDiv('div');\n div.addClass('myClass');\n "
],
@@ -17998,7 +19128,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1164,
+ "line": 1336,
"description": "Removes specified class from the element.
\n",
"itemtype": "method",
"name": "removeClass",
@@ -18009,56 +19139,70 @@ module.exports={
"type": "String"
}
],
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
+ "example": [
+ "\n \n // In this example, a class is set when the div is created\n // and removed when mouse is pressed. This could link up\n // with a CSS style rule to toggle style properties.\nvar div;\nfunction setup() {\n div = createDiv('div');\n div.addClass('myClass');\n }\nfunction mousePressed() {\n div.removeClass('myClass');\n }\n "
+ ],
"class": "p5.Element",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1179,
- "description": "Attaches the element as a child to the parent specified.\n Accepts either a string ID, DOM node, or p5.Element.\n If no argument is specified, an array of children DOM nodes is returned.
\n",
+ "line": 1368,
+ "description": "Attaches the element as a child to the parent specified.\n Accepts either a string ID, DOM node, or p5.Element.\n If no argument is specified, an array of children DOM nodes is returned.
\n",
"itemtype": "method",
"name": "child",
- "params": [
- {
- "name": "child",
- "description": "the ID, DOM node, or p5.Element\n to add to the current element
\n",
- "type": "String|Object|p5.Element",
- "optional": true
- }
- ],
"return": {
- "description": "",
- "type": "p5.Element"
+ "description": "an array of child nodes",
+ "type": "Node[]"
},
"example": [
- "\n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div0.child(div1); // use p5.Element\n \n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div1.id('apples');\n div0.child('apples'); // use id\n \n \n var div0 = createDiv('this is the parent');\n var elt = document.getElementById('myChildDiv');\n div0.child(elt); // use element from page\n "
+ "\n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div0.child(div1); // use p5.Element\n \n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div1.id('apples');\n div0.child('apples'); // use id\n \n \n var div0 = createDiv('this is the parent');\n var elt = document.getElementById('myChildDiv');\n div0.child(elt); // use element from page\n "
],
"class": "p5.Element",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 1368,
+ "params": [],
+ "return": {
+ "description": "an array of child nodes",
+ "type": "Node[]"
+ }
+ },
+ {
+ "line": 1394,
+ "params": [
+ {
+ "name": "child",
+ "description": "the ID, DOM node, or p5.Element\n to add to the current element
\n",
+ "type": "String|p5.Element",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1223,
+ "line": 1416,
"description": "Centers a p5 Element either vertically, horizontally,\nor both, relative to its parent or according to\nthe body if the Element has no parent. If no argument is passed\nthe Element is aligned both vertically and horizontally.
\n",
+ "itemtype": "method",
+ "name": "center",
"params": [
{
"name": "align",
"description": "passing 'vertical', 'horizontal' aligns element accordingly
\n",
- "type": "String"
+ "type": "String",
+ "optional": true
}
],
- "return": {
- "description": "pointer to p5.Element",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n\nfunction setup() {\n var div = createDiv('').size(10,10);\n div.style('background-color','orange');\n div.center();\n\n}\n"
+ "\n\nfunction setup() {\n var div = createDiv('').size(10, 10);\n div.style('background-color', 'orange');\n div.center();\n}\n"
],
"class": "p5.Element",
"module": "p5.dom",
@@ -18066,129 +19210,201 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1276,
+ "line": 1470,
"description": "If an argument is given, sets the inner HTML of the element,\n replacing any existing html. If true is included as a second\n argument, html is appended instead of replacing existing html.\n If no arguments are given, returns\n the inner HTML of the element.
\n",
"itemtype": "method",
"name": "html",
- "params": [
+ "return": {
+ "description": "the inner HTML of the element",
+ "type": "String"
+ },
+ "example": [
+ "\n \n var div = createDiv('').size(100, 100);\n div.html('hi');\n \n \n var div = createDiv('Hello ').size(100, 100);\n div.html('World', true);\n "
+ ],
+ "class": "p5.Element",
+ "module": "p5.dom",
+ "submodule": "p5.dom",
+ "overloads": [
{
- "name": "html",
- "description": "the HTML to be placed inside the element
\n",
- "type": "String",
- "optional": true
+ "line": 1470,
+ "params": [],
+ "return": {
+ "description": "the inner HTML of the element",
+ "type": "String"
+ }
},
{
- "name": "append",
- "description": "whether to append HTML to existing
\n",
- "type": "Boolean",
- "optional": true
+ "line": 1491,
+ "params": [
+ {
+ "name": "html",
+ "description": "the HTML to be placed inside the element
\n",
+ "type": "String",
+ "optional": true
+ },
+ {
+ "name": "append",
+ "description": "whether to append HTML to existing
\n",
+ "type": "Boolean",
+ "optional": true
+ }
+ ],
+ "chainable": 1
}
- ],
- "return": {
- "description": "",
- "type": "Object|p5.Element|String"
- },
- "example": [
- "\n \n var div = createDiv('').size(100,100);\n div.html('hi');\n \n \n var div = createDiv('Hello ').size(100,100);\n div.html('World', true);\n "
- ],
- "class": "p5.Element",
- "module": "p5.dom",
- "submodule": "p5.dom"
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1311,
+ "line": 1509,
"description": "Sets the position of the element relative to (0, 0) of the\n window. Essentially, sets position:absolute and left and top\n properties of style. If no arguments given returns the x and y position\n of the element in an object.
\n",
"itemtype": "method",
"name": "position",
- "params": [
- {
- "name": "x",
- "description": "x-position relative to upper left of window
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "y",
- "description": "y-position relative to upper left of window
\n",
- "type": "Number",
- "optional": true
- }
- ],
"return": {
- "description": "",
- "type": "Object|p5.Element"
+ "description": "the x and y position of the element in an object",
+ "type": "Object"
},
"example": [
"\n \n function setup() {\n var cnv = createCanvas(100, 100);\n // positions canvas 50px to the right and 100px\n // below upper left corner of the window\n cnv.position(50, 100);\n }\n "
],
"class": "p5.Element",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 1509,
+ "params": [],
+ "return": {
+ "description": "the x and y position of the element in an object",
+ "type": "Object"
+ }
+ },
+ {
+ "line": 1528,
+ "params": [
+ {
+ "name": "x",
+ "description": "x-position relative to upper left of window
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "y",
+ "description": "y-position relative to upper left of window
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1392,
+ "line": 1603,
"description": "Sets the given style (css) property (1st arg) of the element with the\ngiven value (2nd arg). If a single argument is given, .style()\nreturns the value of the given property; however, if the single argument\nis given in css syntax ('text-align:center'), .style() sets the css\nappropriatly. .style() also handles 2d and 3d css transforms. If\nthe 1st arg is 'rotate', 'translate', or 'position', the following arguments\naccept Numbers as values. ('translate', 10, 100, 50);
\n",
"itemtype": "method",
"name": "style",
- "params": [
- {
- "name": "property",
- "description": "property to be set
\n",
- "type": "String"
- },
- {
- "name": "value",
- "description": "value to assign to property (only String|Number for rotate/translate)
\n",
- "type": "String|Number|p5.Color",
- "optional": true
- }
- ],
"return": {
- "description": "value of property, if no value is specified\nor p5.Element",
- "type": "String|Object|p5.Element"
+ "description": "value of property",
+ "type": "String"
},
"example": [
- "\n\nvar myDiv = createDiv(\"I like pandas.\");\nmyDiv.style(\"font-size\", \"18px\");\nmyDiv.style(\"color\", \"#ff0000\");\n\n\nvar col = color(25,23,200,50);\nvar button = createButton(\"button\");\nbutton.style(\"background-color\", col);\nbutton.position(10, 10);\n\n\nvar myDiv = createDiv(\"I like lizards.\");\nmyDiv.style(\"position\", 20, 20);\nmyDiv.style(\"rotate\", 45);\n\n\nvar myDiv;\nfunction setup() {\n background(200);\n myDiv = createDiv(\"I like gray.\");\n myDiv.position(20, 20);\n}\n\nfunction draw() {\n myDiv.style(\"font-size\", mouseX+\"px\");\n}\n"
+ "\n\nvar myDiv = createDiv('I like pandas.');\nmyDiv.style('font-size', '18px');\nmyDiv.style('color', '#ff0000');\n\n\nvar col = color(25, 23, 200, 50);\nvar button = createButton('button');\nbutton.style('background-color', col);\nbutton.position(10, 10);\n\n\nvar myDiv = createDiv('I like lizards.');\nmyDiv.style('position', 20, 20);\nmyDiv.style('rotate', 45);\n\n\nvar myDiv;\nfunction setup() {\n background(200);\n myDiv = createDiv('I like gray.');\n myDiv.position(20, 20);\n}\n\nfunction draw() {\n myDiv.style('font-size', mouseX + 'px');\n}\n"
],
"class": "p5.Element",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 1603,
+ "params": [
+ {
+ "name": "property",
+ "description": "property to be set
\n",
+ "type": "String"
+ }
+ ],
+ "return": {
+ "description": "value of property",
+ "type": "String"
+ }
+ },
+ {
+ "line": 1645,
+ "params": [
+ {
+ "name": "property",
+ "description": "",
+ "type": "String"
+ },
+ {
+ "name": "value",
+ "description": "value to assign to property (only String|Number for rotate/translate)
\n",
+ "type": "String|Number|p5.Color"
+ },
+ {
+ "name": "value2",
+ "description": "position can take a 2nd value
\n",
+ "type": "String|Number|p5.Color",
+ "optional": true
+ },
+ {
+ "name": "value3",
+ "description": "translate can take a 2nd & 3rd value
\n",
+ "type": "String|Number|p5.Color",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1474,
+ "line": 1704,
"description": "Adds a new attribute or changes the value of an existing attribute\n on the specified element. If no value is specified, returns the\n value of the given attribute, or null if attribute is not set.
\n",
"itemtype": "method",
"name": "attribute",
- "params": [
- {
- "name": "attr",
- "description": "attribute to set
\n",
- "type": "String"
- },
- {
- "name": "value",
- "description": "value to assign to attribute
\n",
- "type": "String",
- "optional": true
- }
- ],
"return": {
- "description": "value of attribute, if no value is\n specified or p5.Element",
- "type": "String|Object|p5.Element"
+ "description": "value of attribute",
+ "type": "String"
},
"example": [
- "\n \n var myDiv = createDiv(\"I like pandas.\");\n myDiv.attribute(\"align\", \"center\");\n "
+ "\n \n var myDiv = createDiv('I like pandas.');\n myDiv.attribute('align', 'center');\n "
],
"class": "p5.Element",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 1704,
+ "params": [],
+ "return": {
+ "description": "value of attribute",
+ "type": "String"
+ }
+ },
+ {
+ "line": 1719,
+ "params": [
+ {
+ "name": "attr",
+ "description": "attribute to set
\n",
+ "type": "String"
+ },
+ {
+ "name": "value",
+ "description": "value to assign to attribute
\n",
+ "type": "String"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1514,
+ "line": 1748,
"description": "Removes an attribute on the specified element.
\n",
"itemtype": "method",
"name": "removeAttribute",
@@ -18199,12 +19415,9 @@ module.exports={
"type": "String"
}
],
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n \n var button;\n var checkbox;\nfunction setup() {\n checkbox = createCheckbox('enable', true);\n checkbox.changed(enableButton);\n button = createButton('button');\n button.position(10, 10);\n }\nfunction enableButton() {\n if( this.checked() ) {\n // Re-enable the button\n button.removeAttribute('disabled');\n } else {\n // Disable the button\n button.attribute('disabled','');\n }\n }\n "
+ "\n \n var button;\n var checkbox;\nfunction setup() {\n checkbox = createCheckbox('enable', true);\n checkbox.changed(enableButton);\n button = createButton('button');\n button.position(10, 10);\n }\nfunction enableButton() {\n if (this.checked()) {\n // Re-enable the button\n button.removeAttribute('disabled');\n } else {\n // Disable the button\n button.attribute('disabled', '');\n }\n }\n "
],
"class": "p5.Element",
"module": "p5.dom",
@@ -18212,41 +19425,51 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1558,
+ "line": 1793,
"description": "Either returns the value of the element if no arguments\ngiven, or sets the value of the element.
\n",
"itemtype": "method",
"name": "value",
- "params": [
- {
- "name": "value",
- "description": "",
- "type": "String|Number",
- "optional": true
- }
- ],
"return": {
- "description": "value of element if no value is specified or p5.Element",
- "type": "String|Object|p5.Element"
+ "description": "value of the element",
+ "type": "String|Number"
},
"example": [
- "\n\n// gets the value\nvar inp;\nfunction setup() {\n inp = createInput('');\n}\n\nfunction mousePressed() {\n print(inp.value());\n}\n\n\n// sets the value\nvar inp;\nfunction setup() {\n inp = createInput('myValue');\n}\n\nfunction mousePressed() {\n inp.value(\"myValue\");\n}\n"
+ "\n\n// gets the value\nvar inp;\nfunction setup() {\n inp = createInput('');\n}\n\nfunction mousePressed() {\n print(inp.value());\n}\n\n\n// sets the value\nvar inp;\nfunction setup() {\n inp = createInput('myValue');\n}\n\nfunction mousePressed() {\n inp.value('myValue');\n}\n"
],
"class": "p5.Element",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 1793,
+ "params": [],
+ "return": {
+ "description": "value of the element",
+ "type": "String|Number"
+ }
+ },
+ {
+ "line": 1823,
+ "params": [
+ {
+ "name": "value",
+ "description": "",
+ "type": "String|Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1601,
+ "line": 1839,
"description": "Shows the current element. Essentially, setting display:block for the style.
\n",
"itemtype": "method",
"name": "show",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n \n var div = createDiv('div');\n div.style(\"display\", \"none\");\n div.show(); // turns display to block\n "
+ "\n \n var div = createDiv('div');\n div.style('display', 'none');\n div.show(); // turns display to block\n "
],
"class": "p5.Element",
"module": "p5.dom",
@@ -18254,14 +19477,11 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1619,
+ "line": 1857,
"description": "Hides the current element. Essentially, setting display:none for the style.
\n",
"itemtype": "method",
"name": "hide",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
"\n\nvar div = createDiv('this is a div');\ndiv.hide();\n"
],
@@ -18271,38 +19491,51 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1635,
+ "line": 1873,
"description": "Sets the width and height of the element. AUTO can be used to\n only adjust one dimension. If no arguments given returns the width and height\n of the element in an object.
\n",
"itemtype": "method",
"name": "size",
- "params": [
- {
- "name": "w",
- "description": "width of the element
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "h",
- "description": "height of the element
\n",
- "type": "Number",
- "optional": true
- }
- ],
"return": {
- "description": "",
- "type": "Object|p5.Element"
+ "description": "the width and height of the element in an object",
+ "type": "Object"
},
"example": [
"\n \n var div = createDiv('this is a div');\n div.size(100, 100);\n "
],
"class": "p5.Element",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 1873,
+ "params": [],
+ "return": {
+ "description": "the width and height of the element in an object",
+ "type": "Object"
+ }
+ },
+ {
+ "line": 1887,
+ "params": [
+ {
+ "name": "w",
+ "description": "width of the element, either AUTO, or a number
\n",
+ "type": "Number|Constant"
+ },
+ {
+ "name": "h",
+ "description": "height of the element, either AUTO, or a number
\n",
+ "type": "Number|Constant",
+ "optional": true
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1701,
+ "line": 1951,
"description": "Removes the element and deregisters all listeners.
\n",
"itemtype": "method",
"name": "remove",
@@ -18315,7 +19548,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1750,
+ "line": 1999,
"description": "Path to the media element source.
\n",
"itemtype": "property",
"name": "src",
@@ -18324,7 +19557,7 @@ module.exports={
"type": "String"
},
"example": [
- "\n\nvar ele;\n\nfunction setup() {\n background(250);\n\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n //We'll set up our example so that\n //when you click on the text,\n //an alert box displays the MediaElement's\n //src field.\n textAlign(CENTER);\n text(\"Click Me!\", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n //Show our p5.MediaElement's src field\n alert(ele.src);\n }\n}\n\n"
+ "\n\nvar ele;\n\nfunction setup() {\n background(250);\n\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n //We'll set up our example so that\n //when you click on the text,\n //an alert box displays the MediaElement's\n //src field.\n textAlign(CENTER);\n text('Click Me!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n //Show our p5.MediaElement's src field\n alert(ele.src);\n }\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18332,16 +19565,13 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1820,
+ "line": 2065,
"description": "Play an HTML5 media element.
\n",
"itemtype": "method",
"name": "play",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n\nvar ele;\n\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n background(250);\n textAlign(CENTER);\n text(\"Click to Play!\", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n\n //Here we call the play() function on\n //the p5.MediaElement we created above.\n //This will start the audio sample.\n ele.play();\n\n background(200);\n text(\"You clicked Play!\", width/2, height/2);\n }\n}\n"
+ "\n\nvar ele;\n\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n background(250);\n textAlign(CENTER);\n text('Click to Play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n //Here we call the play() function on\n //the p5.MediaElement we created above.\n //This will start the audio sample.\n ele.play();\n\n background(200);\n text('You clicked Play!', width / 2, height / 2);\n }\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18349,16 +19579,13 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1875,
+ "line": 2126,
"description": "Stops an HTML5 media element (sets current time to zero).
\n",
"itemtype": "method",
"name": "stop",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n\n\n//This example both starts \n//and stops a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n background(200);\n textAlign(CENTER);\n text(\"Click to play!\", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if(sampleIsPlaying) {\n //if the sample is currently playing\n //calling the stop() function on\n //our p5.MediaElement will stop\n //it and reset its current\n //time to 0 (i.e. it will start\n //at the beginning the next time\n //you play it)\n ele.stop();\n\n sampleIsPlaying = false;\n text(\"Click to play!\", width/2, height/2);\n } else {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop(); \n\n sampleIsPlaying = true;\n text(\"Click to stop!\", width/2, height/2);\n }\n }\n}\n\n"
+ "\n\n//This example both starts\n//and stops a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (sampleIsPlaying) {\n //if the sample is currently playing\n //calling the stop() function on\n //our p5.MediaElement will stop\n //it and reset its current\n //time to 0 (i.e. it will start\n //at the beginning the next time\n //you play it)\n ele.stop();\n\n sampleIsPlaying = false;\n text('Click to play!', width / 2, height / 2);\n } else {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop();\n\n sampleIsPlaying = true;\n text('Click to stop!', width / 2, height / 2);\n }\n }\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18366,16 +19593,13 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 1942,
+ "line": 2190,
"description": "Pauses an HTML5 media element.
\n",
"itemtype": "method",
"name": "pause",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n\n//This example both starts\n//and pauses a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/lucky_dragons_-_power_melody.mp3');\n background(200);\n textAlign(CENTER);\n text(\"Click to play!\", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if(sampleIsPlaying) {\n //Calling pause() on our\n //p5.MediaElement will stop it\n //playing, but when we call the\n //loop() or play() functions\n //the sample will start from\n //where we paused it.\n ele.pause();\n\n sampleIsPlaying = false;\n text(\"Click to resume!\", width/2, height/2);\n } else {\n //loop our sound element until we\n //call ele.pause() on it.\n ele.loop(); \n\n sampleIsPlaying = true;\n text(\"Click to pause!\", width/2, height/2);\n }\n }\n}\n\n"
+ "\n\n//This example both starts\n//and pauses a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/lucky_dragons.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (sampleIsPlaying) {\n //Calling pause() on our\n //p5.MediaElement will stop it\n //playing, but when we call the\n //loop() or play() functions\n //the sample will start from\n //where we paused it.\n ele.pause();\n\n sampleIsPlaying = false;\n text('Click to resume!', width / 2, height / 2);\n } else {\n //loop our sound element until we\n //call ele.pause() on it.\n ele.loop();\n\n sampleIsPlaying = true;\n text('Click to pause!', width / 2, height / 2);\n }\n }\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18383,16 +19607,13 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2006,
+ "line": 2252,
"description": "Set 'loop' to true for an HTML5 media element, and starts playing.
\n",
"itemtype": "method",
"name": "loop",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"example": [
- "\n\n//Clicking the canvas will loop\n//the audio sample until the user\n//clicks again to stop it\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsLooping = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/lucky_dragons_-_power_melody.mp3');\n background(200);\n textAlign(CENTER);\n text(\"Click to loop!\", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if(sampleIsLooping == false) {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop();\n\n sampleIsLooping = true;\n text(\"Click to stop!\", width/2, height/2);\n } else {\n ele.stop();\n\n sampleIsLooping = false;\n text(\"Click to loop!\", width/2, height/2);\n }\n }\n}\n\n"
+ "\n\n//Clicking the canvas will loop\n//the audio sample until the user\n//clicks again to stop it\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsLooping = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/lucky_dragons.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to loop!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (!sampleIsLooping) {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop();\n\n sampleIsLooping = true;\n text('Click to stop!', width / 2, height / 2);\n } else {\n ele.stop();\n\n sampleIsLooping = false;\n text('Click to loop!', width / 2, height / 2);\n }\n }\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18400,21 +19621,21 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2064,
+ "line": 2308,
"description": "Set 'loop' to false for an HTML5 media element. Element will stop\nwhen it reaches the end.
\n",
"itemtype": "method",
"name": "noLoop",
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
+ "example": [
+ "\n\n//This example both starts\n//and stops loop of sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (sampleIsPlaying) {\n ele.noLoop();\n text('No more Loops!', width / 2, height / 2);\n } else {\n ele.loop();\n sampleIsPlaying = true;\n text('Click to stop looping!', width / 2, height / 2);\n }\n }\n}\n\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2077,
+ "line": 2360,
"description": "Set HTML5 media element to autoplay or not.
\n",
"itemtype": "method",
"name": "autoplay",
@@ -18425,83 +19646,128 @@ module.exports={
"type": "Boolean"
}
],
- "return": {
- "description": "",
- "type": "Object|p5.Element"
- },
+ "chainable": 1,
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2089,
+ "line": 2372,
"description": "Sets volume for this HTML5 media element. If no argument is given,\nreturns the current volume.
\n",
- "params": [
- {
- "name": "val",
- "description": "volume between 0.0 and 1.0
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "return": {
- "description": "current volume or p5.MediaElement",
- "type": "Number|p5.MediaElement"
- },
"itemtype": "method",
"name": "volume",
+ "return": {
+ "description": "current volume",
+ "type": "Number"
+ },
+ "example": [
+ "\n\nvar ele;\nfunction setup() {\n // p5.MediaElement objects are usually created\n // by calling the createAudio(), createVideo(),\n // and createCapture() functions.\n // In this example we create\n // a new p5.MediaElement via createAudio().\n ele = createAudio('assets/lucky_dragons.mp3');\n background(250);\n textAlign(CENTER);\n text('Click to Play!', width / 2, height / 2);\n}\nfunction mouseClicked() {\n // Here we call the volume() function\n // on the sound element to set its volume\n // Volume must be between 0.0 and 1.0\n ele.volume(0.2);\n ele.play();\n background(200);\n text('You clicked Play!', width / 2, height / 2);\n}\n\n\nvar audio;\nvar counter = 0;\n\nfunction loaded() {\n audio.play();\n}\n\nfunction setup() {\n audio = createAudio('assets/lucky_dragons.mp3', loaded);\n textAlign(CENTER);\n}\n\nfunction draw() {\n if (counter === 0) {\n background(0, 255, 0);\n text('volume(0.9)', width / 2, height / 2);\n } else if (counter === 1) {\n background(255, 255, 0);\n text('volume(0.5)', width / 2, height / 2);\n } else if (counter === 2) {\n background(255, 0, 0);\n text('volume(0.1)', width / 2, height / 2);\n }\n}\n\nfunction mousePressed() {\n counter++;\n if (counter === 0) {\n audio.volume(0.9);\n } else if (counter === 1) {\n audio.volume(0.5);\n } else if (counter === 2) {\n audio.volume(0.1);\n } else {\n counter = 0;\n audio.volume(0.9);\n }\n}\n\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 2372,
+ "params": [],
+ "return": {
+ "description": "current volume",
+ "type": "Number"
+ }
+ },
+ {
+ "line": 2445,
+ "params": [
+ {
+ "name": "val",
+ "description": "volume between 0.0 and 1.0
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2105,
+ "line": 2458,
"description": "If no arguments are given, returns the current playback speed of the\nelement. The speed parameter sets the speed where 2.0 will play the\nelement twice as fast, 0.5 will play at half the speed, and -1 will play\nthe element in normal speed in reverse.(Note that not all browsers support\nbackward playback and even if they do, playback might not be smooth.)
\n",
"itemtype": "method",
"name": "speed",
- "params": [
- {
- "name": "speed",
- "description": "speed multiplier for element playback
\n",
- "type": "Number",
- "optional": true
- }
- ],
"return": {
- "description": "current playback speed or p5.MediaElement",
- "type": "Number|Object|p5.MediaElement"
+ "description": "current playback speed of the element",
+ "type": "Number"
},
+ "example": [
+ "\n\n//Clicking the canvas will loop\n//the audio sample until the user\n//clicks again to stop it\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\nvar button;\n\nfunction setup() {\n createCanvas(710, 400);\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n ele.loop();\n background(200);\n\n button = createButton('2x speed');\n button.position(100, 68);\n button.mousePressed(twice_speed);\n\n button = createButton('half speed');\n button.position(200, 68);\n button.mousePressed(half_speed);\n\n button = createButton('reverse play');\n button.position(300, 68);\n button.mousePressed(reverse_speed);\n\n button = createButton('STOP');\n button.position(400, 68);\n button.mousePressed(stop_song);\n\n button = createButton('PLAY!');\n button.position(500, 68);\n button.mousePressed(play_speed);\n}\n\nfunction twice_speed() {\n ele.speed(2);\n}\n\nfunction half_speed() {\n ele.speed(0.5);\n}\n\nfunction reverse_speed() {\n ele.speed(-1);\n}\n\nfunction stop_song() {\n ele.stop();\n}\n\nfunction play_speed() {\n ele.play();\n}\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 2458,
+ "params": [],
+ "return": {
+ "description": "current playback speed of the element",
+ "type": "Number"
+ }
+ },
+ {
+ "line": 2529,
+ "params": [
+ {
+ "name": "speed",
+ "description": "speed multiplier for element playback
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2124,
+ "line": 2546,
"description": "If no arguments are given, returns the current time of the element.\nIf an argument is given the current time of the element is set to it.
\n",
"itemtype": "method",
"name": "time",
- "params": [
- {
- "name": "time",
- "description": "time to jump to (in seconds)
\n",
- "type": "Number",
- "optional": true
- }
- ],
"return": {
- "description": "current time (in seconds)\n or p5.MediaElement",
- "type": "Number|Object|p5.MediaElement"
+ "description": "current time (in seconds)",
+ "type": "Number"
},
+ "example": [
+ "\n\nvar ele;\nvar beginning = true;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/lucky_dragons.mp3');\n background(250);\n textAlign(CENTER);\n text('start at beginning', width / 2, height / 2);\n}\n\n// this function fires with click anywhere\nfunction mousePressed() {\n if (beginning === true) {\n // here we start the sound at the beginning\n // time(0) is not necessary here\n // as this produces the same result as\n // play()\n ele.play().time(0);\n background(200);\n text('jump 2 sec in', width / 2, height / 2);\n beginning = false;\n } else {\n // here we jump 2 seconds into the sound\n ele.play().time(2);\n background(250);\n text('start at beginning', width / 2, height / 2);\n beginning = true;\n }\n}\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
- "submodule": "p5.dom"
+ "submodule": "p5.dom",
+ "overloads": [
+ {
+ "line": 2546,
+ "params": [],
+ "return": {
+ "description": "current time (in seconds)",
+ "type": "Number"
+ }
+ },
+ {
+ "line": 2591,
+ "params": [
+ {
+ "name": "time",
+ "description": "time to jump to (in seconds)
\n",
+ "type": "Number"
+ }
+ ],
+ "chainable": 1
+ }
+ ]
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2141,
+ "line": 2605,
"description": "Returns the duration of the HTML5 media element.
\n",
"itemtype": "method",
"name": "duration",
@@ -18509,48 +19775,16 @@ module.exports={
"description": "duration",
"type": "Number"
},
- "class": "p5.MediaElement",
- "module": "p5.dom",
- "submodule": "p5.dom"
- },
- {
- "file": "lib/addons/p5.dom.js",
- "line": 2201,
- "description": "helper method for web GL mode to figure out if the element\nhas been modified and might need to be re-uploaded to texture\nmemory between frames.
\n",
- "itemtype": "method",
- "name": "isModified",
- "access": "private",
- "tagname": "",
- "return": {
- "description": "a boolean indicating whether or not the\nimage has been updated or modified since last texture upload.",
- "type": "Boolean"
- },
- "class": "p5.MediaElement",
- "module": "p5.dom",
- "submodule": "p5.dom"
- },
- {
- "file": "lib/addons/p5.dom.js",
- "line": 2213,
- "description": "helper method for web GL mode to indicate that an element has been\nchanged or unchanged since last upload. gl texture upload will\nset this value to false after uploading the texture; or might set\nit to true if metadata has become available but there is no actual\ntexture data available yet..
\n",
- "itemtype": "method",
- "name": "setModified",
- "params": [
- {
- "name": "val",
- "description": "sets whether or not the element has been\nmodified.
\n",
- "type": "Boolean"
- }
+ "example": [
+ "\n\nvar ele;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/doorbell.mp3');\n background(250);\n textAlign(CENTER);\n text('Click to know the duration!', 10, 25, 70, 80);\n}\nfunction mouseClicked() {\n ele.play();\n background(200);\n //ele.duration dislpays the duration\n text(ele.duration() + ' seconds', width / 2, height / 2);\n}\n"
],
- "access": "private",
- "tagname": "",
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2227,
+ "line": 2746,
"description": "Schedule an event to be called when the audio or video\nelement reaches the end. If the element is looping,\nthis will not be called. The element is passed in\nas the argument to the onended callback.
\n",
"itemtype": "method",
"name": "onended",
@@ -18561,12 +19795,9 @@ module.exports={
"type": "Function"
}
],
- "return": {
- "description": "",
- "type": "Object|p5.MediaElement"
- },
+ "chainable": 1,
"example": [
- "\n\nfunction setup() {\n audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls(true);\n audioEl.onended(sayDone);\n}\n\nfunction sayDone(elt) {\n alert('done playing ' + elt.src );\n}\n"
+ "\n\nfunction setup() {\n var audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n audioEl.onended(sayDone);\n}\n\nfunction sayDone(elt) {\n alert('done playing ' + elt.src);\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18574,14 +19805,14 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2259,
+ "line": 2777,
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2261,
+ "line": 2779,
"description": "Send the audio output of this element to a specified audioNode or\np5.sound object. If no element is provided, connects to p5's master\noutput. That connection is established when this method is first called.\nAll connections are removed by the .disconnect() method.
\nThis method is meant to be used with the p5.sound.js addon library.
\n",
"itemtype": "method",
"name": "connect",
@@ -18598,7 +19829,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2313,
+ "line": 2828,
"description": "Disconnect all Web Audio routing, including to master output.\nThis is useful if you want to re-route the output through\naudio effects, for example.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -18608,58 +19839,64 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2329,
+ "line": 2843,
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2331,
+ "line": 2845,
"description": "Show the default MediaElement controls, as determined by the web browser.
\n",
"itemtype": "method",
"name": "showControls",
+ "example": [
+ "\n\nvar ele;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n //In this example we create\n //a new p5.MediaElement via createAudio()\n ele = createAudio('assets/lucky_dragons.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to Show Controls!', 10, 25, 70, 80);\n}\nfunction mousePressed() {\n ele.showControls();\n background(200);\n text('Controls Shown', width / 2, height / 2);\n}\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2342,
+ "line": 2876,
"description": "Hide the default mediaElement controls.
\n",
"itemtype": "method",
"name": "hideControls",
+ "example": [
+ "\n\nvar ele;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n //In this example we create\n //a new p5.MediaElement via createAudio()\n ele = createAudio('assets/lucky_dragons.mp3');\n ele.showControls();\n background(200);\n textAlign(CENTER);\n text('Click to hide Controls!', 10, 25, 70, 80);\n}\nfunction mousePressed() {\n ele.hideControls();\n background(200);\n text('Controls hidden', width / 2, height / 2);\n}\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2351,
+ "line": 2905,
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2353,
+ "line": 2916,
"description": "Schedule events to trigger every time a MediaElement\n(audio/video) reaches a playback cue point.
\nAccepts a callback function, a time (in seconds) at which to trigger\nthe callback, and an optional parameter for the callback.
\nTime will be passed as the first parameter to the callback function,\nand param will be the second parameter.
\n",
"itemtype": "method",
"name": "addCue",
"params": [
{
"name": "time",
- "description": "Time in seconds, relative to this media\n element's playback. For example, to trigger\n an event every time playback reaches two\n seconds, pass in the number 2. This will be\n passed as the first parameter to\n the callback function.
\n",
+ "description": "Time in seconds, relative to this media\n element's playback. For example, to trigger\n an event every time playback reaches two\n seconds, pass in the number 2. This will be\n passed as the first parameter to\n the callback function.
\n",
"type": "Number"
},
{
"name": "callback",
- "description": "Name of a function that will be\n called at the given time. The callback will\n receive time and (optionally) param as its\n two parameters.
\n",
+ "description": "Name of a function that will be\n called at the given time. The callback will\n receive time and (optionally) param as its\n two parameters.
\n",
"type": "Function"
},
{
"name": "value",
- "description": "An object to be passed as the\n second parameter to the\n callback function.
\n",
+ "description": "An object to be passed as the\n second parameter to the\n callback function.
\n",
"type": "Object",
"optional": true
}
@@ -18669,7 +19906,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n background(255,255,255);\n\n audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n\n // schedule three calls to changeBackground\n audioEl.addCue(0.5, changeBackground, color(255,0,0) );\n audioEl.addCue(1.0, changeBackground, color(0,255,0) );\n audioEl.addCue(2.5, changeBackground, color(0,0,255) );\n audioEl.addCue(3.0, changeBackground, color(0,255,255) );\n audioEl.addCue(4.2, changeBackground, color(255,255,0) );\n audioEl.addCue(5.0, changeBackground, color(255,255,0) );\n}\n\nfunction changeBackground(val) {\n background(val);\n}\n"
+ "\n\n//\n//\nfunction setup() {\n noCanvas();\n\n var audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n\n // schedule three calls to changeBackground\n audioEl.addCue(0.5, changeBackground, color(255, 0, 0));\n audioEl.addCue(1.0, changeBackground, color(0, 255, 0));\n audioEl.addCue(2.5, changeBackground, color(0, 0, 255));\n audioEl.addCue(3.0, changeBackground, color(0, 255, 255));\n audioEl.addCue(4.2, changeBackground, color(255, 255, 0));\n audioEl.addCue(5.0, changeBackground, color(255, 255, 0));\n}\n\nfunction changeBackground(val) {\n background(val);\n}\n"
],
"class": "p5.MediaElement",
"module": "p5.dom",
@@ -18677,7 +19914,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2415,
+ "line": 2980,
"description": "Remove a callback based on its ID. The ID is returned by the\naddCue method.
\n",
"itemtype": "method",
"name": "removeCue",
@@ -18688,23 +19925,36 @@ module.exports={
"type": "Number"
}
],
+ "example": [
+ "\n\nvar audioEl, id1, id2;\nfunction setup() {\n background(255, 255, 255);\n audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n // schedule five calls to changeBackground\n id1 = audioEl.addCue(0.5, changeBackground, color(255, 0, 0));\n audioEl.addCue(1.0, changeBackground, color(0, 255, 0));\n audioEl.addCue(2.5, changeBackground, color(0, 0, 255));\n audioEl.addCue(3.0, changeBackground, color(0, 255, 255));\n id2 = audioEl.addCue(4.2, changeBackground, color(255, 255, 0));\n text('Click to remove first and last Cue!', 10, 25, 70, 80);\n}\nfunction mousePressed() {\n audioEl.removeCue(id1);\n audioEl.removeCue(id2);\n}\nfunction changeBackground(val) {\n background(val);\n}\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2435,
+ "line": 3022,
"description": "Remove all of the callbacks that had originally been scheduled\nvia the addCue method.
\n",
"itemtype": "method",
"name": "clearCues",
+ "params": [
+ {
+ "name": "id",
+ "description": "ID of the cue, as returned by addCue
\n",
+ "type": "Number"
+ }
+ ],
+ "example": [
+ "\n\nvar audioEl;\nfunction setup() {\n background(255, 255, 255);\n audioEl = createAudio('assets/beat.mp3');\n //Show the default MediaElement controls, as determined by the web browser\n audioEl.showControls();\n // schedule calls to changeBackground\n background(200);\n text('Click to change Cue!', 10, 25, 70, 80);\n audioEl.addCue(0.5, changeBackground, color(255, 0, 0));\n audioEl.addCue(1.0, changeBackground, color(0, 255, 0));\n audioEl.addCue(2.5, changeBackground, color(0, 0, 255));\n audioEl.addCue(3.0, changeBackground, color(0, 255, 255));\n audioEl.addCue(4.2, changeBackground, color(255, 255, 0));\n}\nfunction mousePressed() {\n // here we clear the scheduled callbacks\n audioEl.clearCues();\n // then we add some more callbacks\n audioEl.addCue(1, changeBackground, color(2, 2, 2));\n audioEl.addCue(3, changeBackground, color(255, 255, 0));\n}\nfunction changeBackground(val) {\n background(val);\n}\n"
+ ],
"class": "p5.MediaElement",
"module": "p5.dom",
"submodule": "p5.dom"
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2491,
+ "line": 3092,
"description": "Underlying File object. All normal File methods can be called on this.
\n",
"itemtype": "property",
"name": "file",
@@ -18714,7 +19964,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2503,
+ "line": 3104,
"description": "File type (image, text, etc.)
\n",
"itemtype": "property",
"name": "type",
@@ -18724,7 +19974,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2509,
+ "line": 3110,
"description": "File subtype (usually the file extension jpg, png, xml, etc.)
\n",
"itemtype": "property",
"name": "subtype",
@@ -18734,7 +19984,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2515,
+ "line": 3116,
"description": "File name
\n",
"itemtype": "property",
"name": "name",
@@ -18744,7 +19994,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2521,
+ "line": 3122,
"description": "File size
\n",
"itemtype": "property",
"name": "size",
@@ -18754,7 +20004,7 @@ module.exports={
},
{
"file": "lib/addons/p5.dom.js",
- "line": 2528,
+ "line": 3129,
"description": "URL string containing image data.
\n",
"itemtype": "property",
"name": "data",
@@ -18772,29 +20022,32 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 212,
- "description": "Returns the Audio Context for this sketch. Useful for users\nwho would like to dig deeper into the Web Audio API\n.
",
- "itemtype": "method",
- "name": "getAudioContext",
- "return": {
- "description": "AudioContext for this sketch",
- "type": "Object"
- },
+ "line": 214,
+ "description": "Determine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats
\n",
"class": "p5.sound",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 226,
- "description": "Determine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats
\n",
+ "line": 262,
+ "description": "Returns the Audio Context for this sketch. Useful for users\nwho would like to dig deeper into the Web Audio API\n.
\n\nSome browsers require users to startAudioContext\nwith a user gesture, such as touchStarted in the example below.
",
+ "itemtype": "method",
+ "name": "getAudioContext",
+ "return": {
+ "description": "AudioContext for this sketch",
+ "type": "Object"
+ },
+ "example": [
+ "\n\n function draw() {\n background(255);\n textAlign(CENTER);\n\n if (getAudioContext().state !== 'running') {\n text('click to start audio', width/2, height/2);\n } else {\n text('audio is enabled', width/2, height/2);\n }\n }\n\n function touchStarted() {\n if (getAudioContext().state !== 'running') {\n getAudioContext().resume();\n }\n var synth = new p5.MonoSynth();\n synth.play('A4', 0.5, 0, 0.2);\n }\n\n"
+ ],
"class": "p5.sound",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 296,
+ "line": 328,
"description": "Master contains AudioContext and the master sound output.
\n",
"class": "p5.sound",
"module": "p5.sound",
@@ -18802,7 +20055,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 331,
+ "line": 361,
"description": "Returns a number representing the master amplitude (volume) for sound\nin this sketch.
\n",
"itemtype": "method",
"name": "getMasterVolume",
@@ -18816,8 +20069,8 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 342,
- "description": "Scale the output of all sound in this sketch
\nScaled between 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Env class.\n\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.\n\nHow This Works: When you load the p5.sound module, it\ncreates a single instance of p5sound. All sound objects in this\nmodule output to p5sound before reaching your computer's output.\nSo if you change the amplitude of p5sound, it impacts all of the\nsound in this module.
\n\nIf no value is provided, returns a Web Audio API Gain Node
",
+ "line": 372,
+ "description": "Scale the output of all sound in this sketch
\nScaled between 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Envelope class.\n\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.\n\nHow This Works: When you load the p5.sound module, it\ncreates a single instance of p5sound. All sound objects in this\nmodule output to p5sound before reaching your computer's output.\nSo if you change the amplitude of p5sound, it impacts all of the\nsound in this module.
\n\nIf no value is provided, returns a Web Audio API Gain Node
",
"itemtype": "method",
"name": "masterVolume",
"params": [
@@ -18845,7 +20098,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 384,
+ "line": 414,
"description": "p5.soundOut is the p5.sound master output. It sends output to\nthe destination of this window's web audio context. It contains\nWeb Audio API nodes including a dyanmicsCompressor (.limiter),\nand Gain Nodes for .input and .output.
\n",
"itemtype": "property",
"name": "soundOut",
@@ -18856,17 +20109,14 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 393,
- "description": "a silent connection to the DesinationNode\nwhich will ensure that anything connected to it\nwill not be garbage collected
\n",
- "access": "private",
- "tagname": "",
- "class": "p5.sound",
+ "line": 439,
+ "class": "p5",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 412,
+ "line": 442,
"description": "Returns a number representing the sample rate, in samples per second,\nof all sound objects in this audio context. It is determined by the\nsampling rate of your operating system's sound card, and it is not\ncurrently possile to change.\nIt is often 44100, or twice the range of human hearing.
\n",
"itemtype": "method",
"name": "sampleRate",
@@ -18880,8 +20130,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 425,
+ "line": 455,
"description": "Returns the closest MIDI note value for\na given frequency.
\n",
+ "itemtype": "method",
+ "name": "freqToMidi",
"params": [
{
"name": "frequency",
@@ -18899,7 +20151,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 438,
+ "line": 469,
"description": "Returns the frequency value of a MIDI note value.\nGeneral MIDI treats notes as integers where middle C\nis 60, C# is 61, D is 62 etc. Useful for generating\nmusical frequencies with oscillators.
\n",
"itemtype": "method",
"name": "midiToFreq",
@@ -18923,7 +20175,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 471,
+ "line": 531,
"description": "List the SoundFile formats that you will include. LoadSound\nwill search your directory for these extensions, and will pick\na format that is compatable with the client's web browser.\nHere is a free online file\nconverter.
\n",
"itemtype": "method",
"name": "soundFormats",
@@ -18945,15 +20197,15 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 584,
- "description": "Used by Osc and Env to chain signal math
\n",
+ "line": 644,
+ "description": "Used by Osc and Envelope to chain signal math
\n",
"class": "p5",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 869,
+ "line": 923,
"description": "loadSound() returns a new p5.SoundFile from a specified\npath. If called during preload(), the p5.SoundFile will be ready\nto play in time for setup() and draw(). If called outside of\npreload, the p5.SoundFile will not be ready immediately, so\nloadSound accepts a callback as the second parameter. Using a\n\nlocal server is recommended when loading external files.
\n",
"itemtype": "method",
"name": "loadSound",
@@ -18995,31 +20247,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 917,
- "description": "This is a helper function that the p5.SoundFile calls to load\nitself. Accepts a callback (the name of another function)\nas an optional parameter.
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "successCallback",
- "description": "Name of a function to call once file loads
\n",
- "type": "Function",
- "optional": true
- },
- {
- "name": "errorCallback",
- "description": "Name of a function to call if there is an error
\n",
- "type": "Function",
- "optional": true
- }
- ],
- "class": "p5.SoundFile",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 1009,
+ "line": 1065,
"description": "Returns true if the sound file finished loading successfully.
\n",
"itemtype": "method",
"name": "isLoaded",
@@ -19033,7 +20261,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1022,
+ "line": 1078,
"description": "Play the p5.SoundFile
\n",
"itemtype": "method",
"name": "play",
@@ -19075,19 +20303,19 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1119,
- "description": "p5.SoundFile has two play modes: restart and\nsustain. Play Mode determines what happens to a\np5.SoundFile if it is triggered while in the middle of playback.\nIn sustain mode, playback will continue simultaneous to the\nnew playback. In restart mode, play() will stop playback\nand start over. Sustain is the default mode.
\n",
+ "line": 1183,
+ "description": "p5.SoundFile has two play modes: restart and\nsustain. Play Mode determines what happens to a\np5.SoundFile if it is triggered while in the middle of playback.\nIn sustain mode, playback will continue simultaneous to the\nnew playback. In restart mode, play() will stop playback\nand start over. With untilDone, a sound will play only if it's\nnot already playing. Sustain is the default mode.
\n",
"itemtype": "method",
"name": "playMode",
"params": [
{
"name": "str",
- "description": "'restart' or 'sustain'
\n",
+ "description": "'restart' or 'sustain' or 'untilDone'
\n",
"type": "String"
}
],
"example": [
- "\n\nfunction setup(){\n mySound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\nfunction mouseClicked() {\n mySound.playMode('sustain');\n mySound.play();\n}\nfunction keyPressed() {\n mySound.playMode('restart');\n mySound.play();\n}\n\n "
+ "\n\nvar mySound;\nfunction preload(){\n mySound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\nfunction mouseClicked() {\n mySound.playMode('sustain');\n mySound.play();\n}\nfunction keyPressed() {\n mySound.playMode('restart');\n mySound.play();\n}\n\n "
],
"class": "p5.SoundFile",
"module": "p5.sound",
@@ -19095,7 +20323,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1161,
+ "line": 1227,
"description": "Pauses a file that is currently playing. If the file is not\nplaying, then nothing will happen.
\nAfter pausing, .play() will resume from the paused\nposition.\nIf p5.SoundFile had been set to loop before it was paused,\nit will continue to loop after it is unpaused with .play().
\n",
"itemtype": "method",
"name": "pause",
@@ -19116,7 +20344,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1217,
+ "line": 1283,
"description": "Loop the p5.SoundFile. Accepts optional parameters to set the\nplayback rate, playback volume, loopStart, loopEnd.
\n",
"itemtype": "method",
"name": "loop",
@@ -19158,8 +20386,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1233,
+ "line": 1299,
"description": "Set a p5.SoundFile's looping flag to true or false. If the sound\nis currently playing, this change will take effect when it\nreaches the end of the current playback.
\n",
+ "itemtype": "method",
+ "name": "setLoop",
"params": [
{
"name": "Boolean",
@@ -19173,8 +20403,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1253,
+ "line": 1320,
"description": "Returns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not.
\n",
+ "itemtype": "method",
+ "name": "isLooping",
"return": {
"description": "",
"type": "Boolean"
@@ -19185,7 +20417,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1267,
+ "line": 1335,
"description": "Returns true if a p5.SoundFile is playing, false if not (i.e.\npaused or stopped).
\n",
"itemtype": "method",
"name": "isPlaying",
@@ -19199,7 +20431,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1277,
+ "line": 1345,
"description": "Returns true if a p5.SoundFile is paused, false if not (i.e.\nplaying or stopped).
\n",
"itemtype": "method",
"name": "isPaused",
@@ -19213,7 +20445,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1287,
+ "line": 1355,
"description": "Stop soundfile playback.
\n",
"itemtype": "method",
"name": "stop",
@@ -19231,18 +20463,8 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1311,
- "description": "Stop playback on all of this soundfile's sources.
\n",
- "access": "private",
- "tagname": "",
- "class": "p5.SoundFile",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 1333,
- "description": "Multiply the output volume (amplitude) of a sound file\nbetween 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Env class.
\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.
\n",
+ "line": 1401,
+ "description": "Multiply the output volume (amplitude) of a sound file\nbetween 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Envelope class.
\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.
\n",
"itemtype": "method",
"name": "setVolume",
"params": [
@@ -19270,7 +20492,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1374,
+ "line": 1442,
"description": "Set the stereo panning of a p5.sound object to\na floating point number between -1.0 (left) and 1.0 (right).\nDefault is 0.0 (center).
\n",
"itemtype": "method",
"name": "pan",
@@ -19289,7 +20511,7 @@ module.exports={
}
],
"example": [
- "\n\n\n var ball = {};\n var soundFile;\n\n function setup() {\n soundFormats('ogg', 'mp3');\n soundFile = loadSound('assets/beatbox.mp3');\n }\n\n function draw() {\n background(0);\n ball.x = constrain(mouseX, 0, width);\n ellipse(ball.x, height/2, 20, 20)\n }\n\n function mousePressed(){\n // map the ball's x location to a panning degree\n // between -1.0 (left) and 1.0 (right)\n var panning = map(ball.x, 0., width,-1.0, 1.0);\n soundFile.pan(panning);\n soundFile.play();\n }\n "
+ "\n\n\n var ball = {};\n var soundFile;\n\n function preload() {\n soundFormats('ogg', 'mp3');\n soundFile = loadSound('assets/beatbox.mp3');\n }\n\n function draw() {\n background(0);\n ball.x = constrain(mouseX, 0, width);\n ellipse(ball.x, height/2, 20, 20)\n }\n\n function mousePressed(){\n // map the ball's x location to a panning degree\n // between -1.0 (left) and 1.0 (right)\n var panning = map(ball.x, 0., width,-1.0, 1.0);\n soundFile.pan(panning);\n soundFile.play();\n }\n "
],
"class": "p5.SoundFile",
"module": "p5.sound",
@@ -19297,8 +20519,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1413,
+ "line": 1481,
"description": "Returns the current stereo pan position (-1.0 to 1.0)
\n",
+ "itemtype": "method",
+ "name": "getPan",
"return": {
"description": "Returns the stereo pan setting of the Oscillator\n as a number between -1.0 (left) and 1.0 (right).\n 0.0 is center and default.",
"type": "Number"
@@ -19309,7 +20533,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1423,
+ "line": 1492,
"description": "Set the playback rate of a sound file. Will change the speed and the pitch.\nValues less than zero will reverse the audio buffer.
\n",
"itemtype": "method",
"name": "rate",
@@ -19330,7 +20554,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1495,
+ "line": 1565,
"description": "Returns the duration of a sound file in seconds.
\n",
"itemtype": "method",
"name": "duration",
@@ -19344,8 +20568,8 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1509,
- "description": "Return the current position of the p5.SoundFile playhead, in seconds.\nNote that if you change the playbackRate while the p5.SoundFile is\nplaying, the results may not be accurate.
\n",
+ "line": 1579,
+ "description": "Return the current position of the p5.SoundFile playhead, in seconds.\nTime is relative to the normal buffer direction, so if reverseBuffer\nhas been called, currentTime will count backwards.
\n",
"itemtype": "method",
"name": "currentTime",
"return": {
@@ -19358,7 +20582,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1525,
+ "line": 1590,
"description": "Move the playhead of the song to a position, in seconds. Start timing\nand playback duration. If none are given, will reset the file to play\nentire duration from start to finish.
\n",
"itemtype": "method",
"name": "jump",
@@ -19380,7 +20604,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1548,
+ "line": 1613,
"description": "Return the number of channels in a sound file.\nFor example, Mono = 1, Stereo = 2.
\n",
"itemtype": "method",
"name": "channels",
@@ -19394,7 +20618,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1558,
+ "line": 1623,
"description": "Return the sample rate of the sound file.
\n",
"itemtype": "method",
"name": "sampleRate",
@@ -19408,7 +20632,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1567,
+ "line": 1632,
"description": "Return the number of samples in a sound file.\nEqual to sampleRate * duration.
\n",
"itemtype": "method",
"name": "frames",
@@ -19422,7 +20646,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1577,
+ "line": 1642,
"description": "Returns an array of amplitude peaks in a p5.SoundFile that can be\nused to draw a static waveform. Scans through the p5.SoundFile's\naudio buffer to find the greatest amplitudes. Accepts one\nparameter, 'length', which determines size of the array.\nLarger arrays result in more precise waveform visualizations.
\nInspired by Wavesurfer.js.
\n",
"itemtype": "method",
"name": "getPeaks",
@@ -19444,7 +20668,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1629,
+ "line": 1694,
"description": "Reverses the p5.SoundFile's buffer source.\nPlayback must be handled separately (see example).
\n",
"itemtype": "method",
"name": "reverseBuffer",
@@ -19457,7 +20681,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1664,
+ "line": 1734,
"description": "Schedule an event to be called when the soundfile\nreaches the end of a buffer. If the soundfile is\nplaying through once, this will be called when it\nends. If it is looping, it will be called when\nstop is called.
\n",
"itemtype": "method",
"name": "onended",
@@ -19474,7 +20698,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1717,
+ "line": 1787,
"description": "Connects the output of a p5sound object to input of another\np5.sound object. For example, you may connect a p5.SoundFile to an\nFFT or an Effect. If no parameter is given, it will connect to\nthe master output. Most p5sound objects connect to the master\noutput when they are created.
\n",
"itemtype": "method",
"name": "connect",
@@ -19492,7 +20716,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1738,
+ "line": 1808,
"description": "Disconnects the output of this p5sound object.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -19502,14 +20726,14 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1746,
+ "line": 1818,
"class": "p5.SoundFile",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1751,
+ "line": 1823,
"description": "Reset the source for this SoundFile to a\nnew path (URL).
\n",
"itemtype": "method",
"name": "setPath",
@@ -19531,8 +20755,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1764,
+ "line": 1836,
"description": "Replace the current Audio Buffer with a new Buffer.
\n",
+ "itemtype": "method",
+ "name": "setBuffer",
"params": [
{
"name": "buf",
@@ -19546,7 +20772,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 1835,
+ "line": 1908,
"description": "processPeaks returns an array of timestamps where it thinks there is a beat.
\nThis is an asynchronous function that processes the soundfile in an offline audio context,\nand sends the results to your callback function.
\nThe process involves running the soundfile through a lowpass filter, and finding all of the\npeaks above the initial threshold. If the total number of peaks are below the minimum number of peaks,\nit decreases the threshold and re-runs the analysis until either minPeaks or minThreshold are reached.
\n",
"itemtype": "method",
"name": "processPeaks",
@@ -19585,14 +20811,14 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2026,
+ "line": 2099,
"class": "p5.SoundFile",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2035,
+ "line": 2108,
"description": "Schedule events to trigger every time a MediaElement\n(audio/video) reaches a playback cue point.
\nAccepts a callback function, a time (in seconds) at which to trigger\nthe callback, and an optional parameter for the callback.
\nTime will be passed as the first parameter to the callback function,\nand param will be the second parameter.
\n",
"itemtype": "method",
"name": "addCue",
@@ -19619,7 +20845,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n mySound = loadSound('assets/beat.mp3');\n\n // schedule calls to changeText\n mySound.addCue(0.50, changeText, \"hello\" );\n mySound.addCue(1.00, changeText, \"p5\" );\n mySound.addCue(1.50, changeText, \"what\" );\n mySound.addCue(2.00, changeText, \"do\" );\n mySound.addCue(2.50, changeText, \"you\" );\n mySound.addCue(3.00, changeText, \"want\" );\n mySound.addCue(4.00, changeText, \"to\" );\n mySound.addCue(5.00, changeText, \"make\" );\n mySound.addCue(6.00, changeText, \"?\" );\n}\n\nfunction changeText(val) {\n background(0);\n text(val, width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (mySound.isPlaying() ) {\n mySound.stop();\n } else {\n mySound.play();\n }\n }\n}\n"
+ "\n\nvar mySound;\nfunction preload() {\n mySound = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n // schedule calls to changeText\n mySound.addCue(0.50, changeText, \"hello\" );\n mySound.addCue(1.00, changeText, \"p5\" );\n mySound.addCue(1.50, changeText, \"what\" );\n mySound.addCue(2.00, changeText, \"do\" );\n mySound.addCue(2.50, changeText, \"you\" );\n mySound.addCue(3.00, changeText, \"want\" );\n mySound.addCue(4.00, changeText, \"to\" );\n mySound.addCue(5.00, changeText, \"make\" );\n mySound.addCue(6.00, changeText, \"?\" );\n}\n\nfunction changeText(val) {\n background(0);\n text(val, width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (mySound.isPlaying() ) {\n mySound.stop();\n } else {\n mySound.play();\n }\n }\n}\n"
],
"class": "p5.SoundFile",
"module": "p5.sound",
@@ -19627,7 +20853,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2110,
+ "line": 2186,
"description": "Remove a callback based on its ID. The ID is returned by the\naddCue method.
\n",
"itemtype": "method",
"name": "removeCue",
@@ -19644,7 +20870,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2128,
+ "line": 2204,
"description": "Remove all of the callbacks that had originally been scheduled\nvia the addCue method.
\n",
"itemtype": "method",
"name": "clearCues",
@@ -19654,7 +20880,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2236,
+ "line": 2312,
"description": "Connects to the p5sound instance (master output) by default.\nOptionally, you can pass in a specific source (i.e. a soundfile).
\n",
"itemtype": "method",
"name": "setInput",
@@ -19681,7 +20907,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2341,
+ "line": 2419,
"description": "Returns a single Amplitude reading at the moment it is called.\nFor continuous readings, run in the draw loop.
\n",
"itemtype": "method",
"name": "getLevel",
@@ -19706,7 +20932,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2382,
+ "line": 2460,
"description": "Determines whether the results of Amplitude.process() will be\nNormalized. To normalize, Amplitude finds the difference the\nloudest reading it has processed and the maximum amplitude of\n1.0. Amplitude adds this difference to all values to produce\nresults that will reliably map between 0.0 and 1.0. However,\nif a louder moment occurs, the amount that Normalize adds to\nall the values will change. Accepts an optional boolean parameter\n(true or false). Normalizing is off by default.
\n",
"itemtype": "method",
"name": "toggleNormalize",
@@ -19724,7 +20950,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2402,
+ "line": 2480,
"description": "Smooth Amplitude analysis by averaging with the last analysis\nframe. Off by default.
\n",
"itemtype": "method",
"name": "smooth",
@@ -19741,7 +20967,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2571,
+ "line": 2654,
"description": "Set the input source for the FFT analysis. If no source is\nprovided, FFT will analyze all sound in the sketch.
\n",
"itemtype": "method",
"name": "setInput",
@@ -19759,7 +20985,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2590,
+ "line": 2673,
"description": "Returns an array of amplitude values (between -1.0 and +1.0) that represent\na snapshot of amplitude readings in a single buffer. Length will be\nequal to bins (defaults to 1024). Can be used to draw the waveform\nof a sound.
\n",
"itemtype": "method",
"name": "waveform",
@@ -19787,7 +21013,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2633,
+ "line": 2716,
"description": "Returns an array of amplitude values (between 0 and 255)\nacross the frequency spectrum. Length is equal to FFT bins\n(1024 by default). The array indices correspond to frequencies\n(i.e. pitches), from the lowest to the highest that humans can\nhear. Each value represents amplitude at that slice of the\nfrequency spectrum. Must be called prior to using\ngetEnergy().
\n",
"itemtype": "method",
"name": "analyze",
@@ -19818,8 +21044,8 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2725,
- "description": "Returns the amount of energy (volume) at a specific\n\nfrequency, or the average amount of energy between two\nfrequencies. Accepts Number(s) corresponding\nto frequency (in Hz), or a String corresponding to predefined\nfrequency ranges ("bass", "lowMid", "mid", "highMid", "treble").\nReturns a range between 0 (no energy/volume at that frequency) and\n255 (maximum energy).\nNOTE: analyze() must be called prior to getEnergy(). Analyze()\ntells the FFT to analyze frequency data, and getEnergy() uses\nthe results determine the value at a specific frequency or\nrange of frequencies.
\n",
+ "line": 2808,
+ "description": "Returns the amount of energy (volume) at a specific\n\nfrequency, or the average amount of energy between two\nfrequencies. Accepts Number(s) corresponding\nto frequency (in Hz), or a String corresponding to predefined\nfrequency ranges ("bass", "lowMid", "mid", "highMid", "treble").\nReturns a range between 0 (no energy/volume at that frequency) and\n255 (maximum energy).\nNOTE: analyze() must be called prior to getEnergy(). Analyze()\ntells the FFT to analyze frequency data, and getEnergy() uses\nthe results determine the value at a specific frequency or\nrange of frequencies.
\n",
"itemtype": "method",
"name": "getEnergy",
"params": [
@@ -19845,7 +21071,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2805,
+ "line": 2890,
"description": "Returns the\n\nspectral centroid of the input signal.\nNOTE: analyze() must be called prior to getCentroid(). Analyze()\ntells the FFT to analyze frequency data, and getCentroid() uses\nthe results determine the spectral centroid.
\n",
"itemtype": "method",
"name": "getCentroid",
@@ -19854,7 +21080,7 @@ module.exports={
"type": "Number"
},
"example": [
- "\n\n\n\nfunction setup(){\ncnv = createCanvas(800,400);\nsound = new p5.AudioIn();\nsound.start();\nfft = new p5.FFT();\nsound.connect(fft);\n}\n\n\nfunction draw(){\n\nvar centroidplot = 0.0;\nvar spectralCentroid = 0;\n\n\nbackground(0);\nstroke(0,255,0);\nvar spectrum = fft.analyze();\nfill(0,255,0); // spectrum is green\n\n//draw the spectrum\n\nfor (var i = 0; i< spectrum.length; i++){\n var x = map(log(i), 0, log(spectrum.length), 0, width);\n var h = map(spectrum[i], 0, 255, 0, height);\n var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length));\n rect(x, height, rectangle_width, -h )\n}\n\nvar nyquist = 22050;\n\n// get the centroid\nspectralCentroid = fft.getCentroid();\n\n// the mean_freq_index calculation is for the display.\nvar mean_freq_index = spectralCentroid/(nyquist/spectrum.length);\n\ncentroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width);\n\n\nstroke(255,0,0); // the line showing where the centroid is will be red\n\nrect(centroidplot, 0, width / spectrum.length, height)\nnoStroke();\nfill(255,255,255); // text is white\ntextSize(40);\ntext(\"centroid: \"+round(spectralCentroid)+\" Hz\", 10, 40);\n}\n "
+ "\n\n\n\nfunction setup(){\ncnv = createCanvas(100,100);\nsound = new p5.AudioIn();\nsound.start();\nfft = new p5.FFT();\nsound.connect(fft);\n}\n\n\nfunction draw(){\n\nvar centroidplot = 0.0;\nvar spectralCentroid = 0;\n\n\nbackground(0);\nstroke(0,255,0);\nvar spectrum = fft.analyze();\nfill(0,255,0); // spectrum is green\n\n//draw the spectrum\nfor (var i = 0; i< spectrum.length; i++){\n var x = map(log(i), 0, log(spectrum.length), 0, width);\n var h = map(spectrum[i], 0, 255, 0, height);\n var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length));\n rect(x, height, rectangle_width, -h )\n}\n\nvar nyquist = 22050;\n\n// get the centroid\nspectralCentroid = fft.getCentroid();\n\n// the mean_freq_index calculation is for the display.\nvar mean_freq_index = spectralCentroid/(nyquist/spectrum.length);\n\ncentroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width);\n\n\nstroke(255,0,0); // the line showing where the centroid is will be red\n\nrect(centroidplot, 0, width / spectrum.length, height)\nnoStroke();\nfill(255,255,255); // text is white\ntext(\"centroid: \", 10, 20);\ntext(round(spectralCentroid)+\" Hz\", 10, 40);\n}\n "
],
"class": "p5.FFT",
"module": "p5.sound",
@@ -19862,7 +21088,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2886,
+ "line": 2970,
"description": "Smooth FFT analysis by averaging with the last analysis frame.
\n",
"itemtype": "method",
"name": "smooth",
@@ -19879,7 +21105,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2906,
+ "line": 2992,
"description": "Returns an array of average amplitude values for a given number\nof frequency bands split equally. N defaults to 16.\nNOTE: analyze() must be called prior to linAverages(). Analyze()\ntells the FFT to analyze frequency data, and linAverages() uses\nthe results to group them into a smaller set of averages.
\n",
"itemtype": "method",
"name": "linAverages",
@@ -19900,7 +21126,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2936,
+ "line": 3022,
"description": "Returns an array of average amplitude values of the spectrum, for a given\nset of \nOctave Bands\nNOTE: analyze() must be called prior to logAverages(). Analyze()\ntells the FFT to analyze frequency data, and logAverages() uses\nthe results to group them into a smaller set of averages.
\n",
"itemtype": "method",
"name": "logAverages",
@@ -19921,7 +21147,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 2966,
+ "line": 3052,
"description": "Calculates and Returns the 1/N\nOctave Bands\nN defaults to 3 and minimum central frequency to 15.625Hz.\n(1/3 Octave Bands ~= 31 Frequency Bands)\nSetting fCtr0 to a central value of a higher octave will ignore the lower bands\nand produce less frequency groups.
\n",
"itemtype": "method",
"name": "getOctaveBands",
@@ -19947,434 +21173,478 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 3024,
+ "line": 3110,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 3427,
+ "line": 3487,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 3448,
+ "line": 3508,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 3507,
+ "line": 3567,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 3960,
+ "line": 3885,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4097,
+ "line": 4057,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4130,
+ "line": 4215,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4176,
+ "line": 4256,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4197,
+ "line": 4326,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4217,
+ "line": 4514,
"class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4319,
- "description": "Fade to value, for smooth transitions
\n",
- "itemtype": "method",
- "name": "fade",
- "params": [
- {
- "name": "value",
- "description": "Value to set this signal
\n",
- "type": "Number"
- },
- {
- "name": "secondsFromNow",
- "description": "Length of fade, in seconds from now
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "class": "p5.Signal",
+ "line": 4571,
+ "class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4330,
- "description": "Connect a p5.sound object or Web Audio node to this\np5.Signal so that its amplitude values can be scaled.
\n",
- "params": [
- {
- "name": "input",
- "description": "",
- "type": "Object"
- }
- ],
- "class": "p5.Signal",
+ "line": 4739,
+ "class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4343,
- "description": "Add a constant value to this audio signal,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalAdd.
\n",
- "itemtype": "method",
- "name": "add",
- "params": [
- {
- "name": "number",
- "description": "",
- "type": "Number"
- }
- ],
- "return": {
- "description": "object",
- "type": "p5.SignalAdd"
- },
- "class": "p5.Signal",
+ "line": 4787,
+ "class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4362,
- "description": "Multiply this signal by a constant value,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalMult.
\n",
- "itemtype": "method",
- "name": "mult",
- "params": [
- {
- "name": "number",
- "description": "to multiply
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "object",
- "type": "Tone.Multiply"
- },
- "class": "p5.Signal",
+ "line": 4818,
+ "class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4381,
- "description": "Scale this signal value to a given range,\nand return the result as an audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalScale.
\n",
- "itemtype": "method",
- "name": "scale",
- "params": [
- {
- "name": "number",
- "description": "to multiply
\n",
- "type": "Number"
- },
- {
- "name": "inMin",
- "description": "input range minumum
\n",
- "type": "Number"
- },
- {
- "name": "inMax",
- "description": "input range maximum
\n",
- "type": "Number"
- },
- {
- "name": "outMin",
- "description": "input range minumum
\n",
- "type": "Number"
- },
- {
- "name": "outMax",
- "description": "input range maximum
\n",
- "type": "Number"
- }
- ],
- "return": {
- "description": "object",
- "type": "p5.SignalScale"
- },
- "class": "p5.Signal",
+ "line": 4839,
+ "class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4515,
- "description": "Start an oscillator. Accepts an optional parameter to\ndetermine how long (in seconds from now) until the\noscillator starts.
\n",
- "itemtype": "method",
- "name": "start",
- "params": [
- {
- "name": "time",
- "description": "startTime in seconds from now.
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "frequency",
- "description": "frequency in Hz.
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "class": "p5.Oscillator",
+ "line": 4859,
+ "class": "p5.FFT",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4555,
- "description": "Stop an oscillator. Accepts an optional parameter\nto determine how long (in seconds from now) until the\noscillator stops.
\n",
+ "line": 4961,
+ "description": "Fade to value, for smooth transitions
\n",
"itemtype": "method",
- "name": "stop",
+ "name": "fade",
"params": [
{
- "name": "secondsFromNow",
- "description": "Time, in seconds from now.
\n",
+ "name": "value",
+ "description": "Value to set this signal
\n",
"type": "Number"
- }
- ],
- "class": "p5.Oscillator",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 4571,
- "description": "Set the amplitude between 0 and 1.0. Or, pass in an object\nsuch as an oscillator to modulate amplitude with an audio signal.
\n",
- "itemtype": "method",
- "name": "amp",
- "params": [
- {
- "name": "vol",
- "description": "between 0 and 1.0\n or a modulating signal/oscillator
\n",
- "type": "Number|Object"
- },
- {
- "name": "rampTime",
- "description": "create a fade that lasts rampTime
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "timeFromNow",
- "description": "schedule this event to happen\n seconds from now
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "return": {
- "description": "gain If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's\n gain/amplitude/volume)",
- "type": "AudioParam"
- },
- "class": "p5.Oscillator",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 4606,
- "description": "Set frequency of an oscillator to a value. Or, pass in an object\nsuch as an oscillator to modulate the frequency with an audio signal.
\n",
- "itemtype": "method",
- "name": "freq",
- "params": [
- {
- "name": "Frequency",
- "description": "Frequency in Hz\n or modulating signal/oscillator
\n",
- "type": "Number|Object"
},
{
- "name": "rampTime",
- "description": "Ramp time (in seconds)
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "timeFromNow",
- "description": "Schedule this event to happen\n at x seconds from now
\n",
+ "name": "secondsFromNow",
+ "description": "Length of fade, in seconds from now
\n",
"type": "Number",
"optional": true
}
],
- "return": {
- "description": "Frequency If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's frequency",
- "type": "AudioParam"
- },
- "example": [
- "\n\nvar osc = new p5.Oscillator(300);\nosc.start();\nosc.freq(40, 10);\n"
- ],
- "class": "p5.Oscillator",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 4665,
- "description": "Set type to 'sine', 'triangle', 'sawtooth' or 'square'.
\n",
- "itemtype": "method",
- "name": "setType",
- "params": [
- {
- "name": "type",
- "description": "'sine', 'triangle', 'sawtooth' or 'square'.
\n",
- "type": "String"
- }
- ],
- "class": "p5.Oscillator",
+ "class": "p5.Signal",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4677,
- "description": "Connect to a p5.sound / Web Audio object.
\n",
+ "line": 4972,
+ "description": "Connect a p5.sound object or Web Audio node to this\np5.Signal so that its amplitude values can be scaled.
\n",
"itemtype": "method",
- "name": "connect",
+ "name": "setInput",
"params": [
{
- "name": "unit",
- "description": "A p5.sound or Web Audio object
\n",
+ "name": "input",
+ "description": "",
"type": "Object"
}
],
- "class": "p5.Oscillator",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 4694,
- "description": "Disconnect all outputs
\n",
- "itemtype": "method",
- "name": "disconnect",
- "class": "p5.Oscillator",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 4705,
- "description": "Pan between Left (-1) and Right (1)
\n",
- "itemtype": "method",
- "name": "pan",
- "params": [
- {
- "name": "panning",
- "description": "Number between -1 and 1
\n",
- "type": "Number"
- },
- {
- "name": "timeFromNow",
- "description": "schedule this event to happen\n seconds from now
\n",
- "type": "Number"
- }
- ],
- "class": "p5.Oscillator",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 4737,
- "description": "Set the phase of an oscillator between 0.0 and 1.0.\nIn this implementation, phase is a delay time\nbased on the oscillator's current frequency.
\n",
- "itemtype": "method",
- "name": "phase",
- "params": [
- {
- "name": "phase",
- "description": "float between 0.0 and 1.0
\n",
- "type": "Number"
- }
- ],
- "class": "p5.Oscillator",
+ "class": "p5.Signal",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4791,
- "description": "Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method again\nwill override the initial add() with a new value.
\n",
+ "line": 4986,
+ "description": "Add a constant value to this audio signal,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalAdd.
\n",
"itemtype": "method",
"name": "add",
"params": [
{
"name": "number",
- "description": "Constant number to add
\n",
+ "description": "",
"type": "Number"
}
],
"return": {
- "description": "Oscillator Returns this oscillator\n with scaled output",
- "type": "p5.Oscillator"
+ "description": "object",
+ "type": "p5.Signal"
},
- "class": "p5.Oscillator",
+ "class": "p5.Signal",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4808,
- "description": "Multiply the p5.Oscillator's output amplitude\nby a fixed value (i.e. turn it up!). Calling this method\nagain will override the initial mult() with a new value.
\n",
+ "line": 5005,
+ "description": "Multiply this signal by a constant value,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalMult.
\n",
"itemtype": "method",
"name": "mult",
"params": [
{
"name": "number",
- "description": "Constant number to multiply
\n",
+ "description": "to multiply
\n",
"type": "Number"
}
],
"return": {
- "description": "Oscillator Returns this oscillator\n with multiplied output",
- "type": "p5.Oscillator"
+ "description": "object",
+ "type": "p5.Signal"
},
- "class": "p5.Oscillator",
+ "class": "p5.Signal",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4824,
- "description": "Scale this oscillator's amplitude values to a given\nrange, and return the oscillator. Calling this method\nagain will override the initial scale() with new values.
\n",
+ "line": 5024,
+ "description": "Scale this signal value to a given range,\nand return the result as an audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalScale.
\n",
+ "itemtype": "method",
+ "name": "scale",
+ "params": [
+ {
+ "name": "number",
+ "description": "to multiply
\n",
+ "type": "Number"
+ },
+ {
+ "name": "inMin",
+ "description": "input range minumum
\n",
+ "type": "Number"
+ },
+ {
+ "name": "inMax",
+ "description": "input range maximum
\n",
+ "type": "Number"
+ },
+ {
+ "name": "outMin",
+ "description": "input range minumum
\n",
+ "type": "Number"
+ },
+ {
+ "name": "outMax",
+ "description": "input range maximum
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "object",
+ "type": "p5.Signal"
+ },
+ "class": "p5.Signal",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5158,
+ "description": "Start an oscillator. Accepts an optional parameter to\ndetermine how long (in seconds from now) until the\noscillator starts.
\n",
+ "itemtype": "method",
+ "name": "start",
+ "params": [
+ {
+ "name": "time",
+ "description": "startTime in seconds from now.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "frequency",
+ "description": "frequency in Hz.
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5198,
+ "description": "Stop an oscillator. Accepts an optional parameter\nto determine how long (in seconds from now) until the\noscillator stops.
\n",
+ "itemtype": "method",
+ "name": "stop",
+ "params": [
+ {
+ "name": "secondsFromNow",
+ "description": "Time, in seconds from now.
\n",
+ "type": "Number"
+ }
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5214,
+ "description": "Set the amplitude between 0 and 1.0. Or, pass in an object\nsuch as an oscillator to modulate amplitude with an audio signal.
\n",
+ "itemtype": "method",
+ "name": "amp",
+ "params": [
+ {
+ "name": "vol",
+ "description": "between 0 and 1.0\n or a modulating signal/oscillator
\n",
+ "type": "Number|Object"
+ },
+ {
+ "name": "rampTime",
+ "description": "create a fade that lasts rampTime
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "timeFromNow",
+ "description": "schedule this event to happen\n seconds from now
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "gain If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's\n gain/amplitude/volume)",
+ "type": "AudioParam"
+ },
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5249,
+ "description": "Set frequency of an oscillator to a value. Or, pass in an object\nsuch as an oscillator to modulate the frequency with an audio signal.
\n",
+ "itemtype": "method",
+ "name": "freq",
+ "params": [
+ {
+ "name": "Frequency",
+ "description": "Frequency in Hz\n or modulating signal/oscillator
\n",
+ "type": "Number|Object"
+ },
+ {
+ "name": "rampTime",
+ "description": "Ramp time (in seconds)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "timeFromNow",
+ "description": "Schedule this event to happen\n at x seconds from now
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "Frequency If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's frequency",
+ "type": "AudioParam"
+ },
+ "example": [
+ "\n\nvar osc = new p5.Oscillator(300);\nosc.start();\nosc.freq(40, 10);\n"
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5308,
+ "description": "Set type to 'sine', 'triangle', 'sawtooth' or 'square'.
\n",
+ "itemtype": "method",
+ "name": "setType",
+ "params": [
+ {
+ "name": "type",
+ "description": "'sine', 'triangle', 'sawtooth' or 'square'.
\n",
+ "type": "String"
+ }
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5320,
+ "description": "Connect to a p5.sound / Web Audio object.
\n",
+ "itemtype": "method",
+ "name": "connect",
+ "params": [
+ {
+ "name": "unit",
+ "description": "A p5.sound or Web Audio object
\n",
+ "type": "Object"
+ }
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5337,
+ "description": "Disconnect all outputs
\n",
+ "itemtype": "method",
+ "name": "disconnect",
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5354,
+ "description": "Pan between Left (-1) and Right (1)
\n",
+ "itemtype": "method",
+ "name": "pan",
+ "params": [
+ {
+ "name": "panning",
+ "description": "Number between -1 and 1
\n",
+ "type": "Number"
+ },
+ {
+ "name": "timeFromNow",
+ "description": "schedule this event to happen\n seconds from now
\n",
+ "type": "Number"
+ }
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5386,
+ "description": "Set the phase of an oscillator between 0.0 and 1.0.\nIn this implementation, phase is a delay time\nbased on the oscillator's current frequency.
\n",
+ "itemtype": "method",
+ "name": "phase",
+ "params": [
+ {
+ "name": "phase",
+ "description": "float between 0.0 and 1.0
\n",
+ "type": "Number"
+ }
+ ],
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5440,
+ "description": "Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method again\nwill override the initial add() with a new value.
\n",
+ "itemtype": "method",
+ "name": "add",
+ "params": [
+ {
+ "name": "number",
+ "description": "Constant number to add
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "Oscillator Returns this oscillator\n with scaled output",
+ "type": "p5.Oscillator"
+ },
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5457,
+ "description": "Multiply the p5.Oscillator's output amplitude\nby a fixed value (i.e. turn it up!). Calling this method\nagain will override the initial mult() with a new value.
\n",
+ "itemtype": "method",
+ "name": "mult",
+ "params": [
+ {
+ "name": "number",
+ "description": "Constant number to multiply
\n",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "Oscillator Returns this oscillator\n with multiplied output",
+ "type": "p5.Oscillator"
+ },
+ "class": "p5.Oscillator",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 5473,
+ "description": "Scale this oscillator's amplitude values to a given\nrange, and return the oscillator. Calling this method\nagain will override the initial scale() with new values.
\n",
"itemtype": "method",
"name": "scale",
"params": [
@@ -20409,81 +21679,81 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 4923,
+ "line": 5572,
"class": "p5.SqrOsc",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5109,
+ "line": 5775,
"class": "p5.SqrOsc",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5333,
+ "line": 6064,
"description": "Time until envelope reaches attackLevel
\n",
"itemtype": "property",
"name": "attackTime",
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5338,
+ "line": 6069,
"description": "Level once attack is complete.
\n",
"itemtype": "property",
"name": "attackLevel",
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5343,
+ "line": 6074,
"description": "Time until envelope reaches decayLevel.
\n",
"itemtype": "property",
"name": "decayTime",
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5348,
+ "line": 6079,
"description": "Level after decay. The envelope will sustain here until it is released.
\n",
"itemtype": "property",
"name": "decayLevel",
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5353,
+ "line": 6084,
"description": "Duration of the release portion of the envelope.
\n",
"itemtype": "property",
"name": "releaseTime",
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5358,
+ "line": 6089,
"description": "Level at the end of the release.
\n",
"itemtype": "property",
"name": "releaseLevel",
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5394,
+ "line": 6125,
"description": "Reset the envelope with a series of time/value pairs.
\n",
"itemtype": "method",
"name": "set",
@@ -20520,15 +21790,15 @@ module.exports={
}
],
"example": [
- "\n\nvar t1 = 0.1; // attack time in seconds\nvar l1 = 0.7; // attack level 0.0 to 1.0\nvar t2 = 0.3; // decay time in seconds\nvar l2 = 0.1; // decay level 0.0 to 1.0\nvar t3 = 0.2; // sustain time in seconds\nvar l3 = dL; // sustain level 0.0 to 1.0\n// release level defaults to zero\n\nvar env;\nvar triOsc;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env(t1, l1, t2, l2, t3, l3);\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env); // give the env control of the triOsc's amp\n triOsc.start();\n}\n\n// mouseClick triggers envelope if over canvas\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(triOsc);\n }\n}\n\n"
+ "\n\nvar t1 = 0.1; // attack time in seconds\nvar l1 = 0.7; // attack level 0.0 to 1.0\nvar t2 = 0.3; // decay time in seconds\nvar l2 = 0.1; // decay level 0.0 to 1.0\nvar t3 = 0.2; // sustain time in seconds\nvar l3 = 0.5; // sustain level 0.0 to 1.0\n// release level defaults to zero\n\nvar env;\nvar triOsc;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope(t1, l1, t2, l2, t3, l3);\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env); // give the env control of the triOsc's amp\n triOsc.start();\n}\n\n// mouseClick triggers envelope if over canvas\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(triOsc);\n }\n}\n\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5453,
+ "line": 6184,
"description": "Set values like a traditional\n\nADSR envelope\n.
\n",
"itemtype": "method",
"name": "setADSR",
@@ -20558,15 +21828,15 @@ module.exports={
}
],
"example": [
- "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"
+ "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5518,
+ "line": 6249,
"description": "Set max (attackLevel) and min (releaseLevel) of envelope.
\n",
"itemtype": "method",
"name": "setRange",
@@ -20583,16 +21853,16 @@ module.exports={
}
],
"example": [
- "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"
+ "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5597,
- "description": "Assign a parameter to be controlled by this envelope.\nIf a p5.Sound object is given, then the p5.Env will control its\noutput gain. If multiple inputs are provided, the env will\ncontrol all of them.
\n",
+ "line": 6328,
+ "description": "Assign a parameter to be controlled by this envelope.\nIf a p5.Sound object is given, then the p5.Envelope will control its\noutput gain. If multiple inputs are provided, the env will\ncontrol all of them.
\n",
"itemtype": "method",
"name": "setInput",
"params": [
@@ -20604,13 +21874,13 @@ module.exports={
"multiple": true
}
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5612,
+ "line": 6343,
"description": "Set whether the envelope ramp is linear (default) or exponential.\nExponential ramps can be useful because we perceive amplitude\nand frequency logarithmically.
\n",
"itemtype": "method",
"name": "setExp",
@@ -20621,14 +21891,14 @@ module.exports={
"type": "Boolean"
}
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5630,
- "description": "Play tells the envelope to start acting on a given input.\nIf the input is a p5.sound object (i.e. AudioIn, Oscillator,\nSoundFile), then Env will control its output volume.\nEnvelopes can also be used to control any \nWeb Audio Audio Param.
\n",
+ "line": 6361,
+ "description": "Play tells the envelope to start acting on a given input.\nIf the input is a p5.sound object (i.e. AudioIn, Oscillator,\nSoundFile), then Envelope will control its output volume.\nEnvelopes can also be used to control any \nWeb Audio Audio Param.
\n",
"itemtype": "method",
"name": "play",
"params": [
@@ -20651,15 +21921,15 @@ module.exports={
}
],
"example": [
- "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n // trigger env on triOsc, 0 seconds from now\n // After decay, sustain for 0.2 seconds before release\n env.play(triOsc, 0, 0.2);\n}\n"
+ "\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n // trigger env on triOsc, 0 seconds from now\n // After decay, sustain for 0.2 seconds before release\n env.play(triOsc, 0, 0.2);\n}\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5691,
+ "line": 6422,
"description": "Trigger the Attack, and Decay portion of the Envelope.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go. Input can be\nany p5.sound object, or a \nWeb Audio Param.
\n",
"itemtype": "method",
"name": "triggerAttack",
@@ -20676,15 +21946,15 @@ module.exports={
}
],
"example": [
- "\n\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack(){\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n"
+ "\n\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack(){\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5800,
+ "line": 6529,
"description": "Trigger the Release of the Envelope. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.
\n",
"itemtype": "method",
"name": "triggerRelease",
@@ -20701,16 +21971,16 @@ module.exports={
}
],
"example": [
- "\n\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack(){\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n"
+ "\n\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack(){\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 5899,
- "description": "Exponentially ramp to a value using the first two\nvalues from setADSR(attackTime, decayTime)\nas \ntime constants for simple exponential ramps.\nIf the value is higher than current value, it uses attackTime,\nwhile a decrease uses decayTime.
\n",
+ "line": 6626,
+ "description": "Exponentially ramp to a value using the first two\nvalues from setADSR(attackTime, decayTime)\nas \ntime constants for simple exponential ramps.\nIf the value is higher than current value, it uses attackTime,\nwhile a decrease uses decayTime.
\n",
"itemtype": "method",
"name": "ramp",
"params": [
@@ -20737,15 +22007,15 @@ module.exports={
}
],
"example": [
- "\n\nvar env, osc, amp, cnv;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar attackLevel = 1;\nvar decayLevel = 0;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n fill(0,255,0);\n noStroke();\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime);\n\n osc = new p5.Oscillator();\n osc.amp(env);\n osc.start();\n\n amp = new p5.Amplitude();\n\n cnv.mousePressed(triggerRamp);\n}\n\nfunction triggerRamp() {\n env.ramp(osc, 0, attackLevel, decayLevel);\n}\n\nfunction draw() {\n background(20,20,20);\n text('click me', 10, 20);\n var h = map(amp.getLevel(), 0, 0.4, 0, height);;\n\n rect(0, height, width, -h);\n}\n"
+ "\n\nvar env, osc, amp, cnv;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar attackLevel = 1;\nvar decayLevel = 0;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n fill(0,255,0);\n noStroke();\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime);\n\n osc = new p5.Oscillator();\n osc.amp(env);\n osc.start();\n\n amp = new p5.Amplitude();\n\n cnv.mousePressed(triggerRamp);\n}\n\nfunction triggerRamp() {\n env.ramp(osc, 0, attackLevel, decayLevel);\n}\n\nfunction draw() {\n background(20,20,20);\n text('click me', 10, 20);\n var h = map(amp.getLevel(), 0, 0.4, 0, height);;\n\n rect(0, height, width, -h);\n}\n"
],
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6004,
+ "line": 6733,
"description": "Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method\nagain will override the initial add() with new values.
\n",
"itemtype": "method",
"name": "add",
@@ -20758,16 +22028,16 @@ module.exports={
],
"return": {
"description": "Envelope Returns this envelope\n with scaled output",
- "type": "p5.Env"
+ "type": "p5.Envelope"
},
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6020,
- "description": "Multiply the p5.Env's output amplitude\nby a fixed value. Calling this method\nagain will override the initial mult() with new values.
\n",
+ "line": 6749,
+ "description": "Multiply the p5.Envelope's output amplitude\nby a fixed value. Calling this method\nagain will override the initial mult() with new values.
\n",
"itemtype": "method",
"name": "mult",
"params": [
@@ -20779,15 +22049,15 @@ module.exports={
],
"return": {
"description": "Envelope Returns this envelope\n with scaled output",
- "type": "p5.Env"
+ "type": "p5.Envelope"
},
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6036,
+ "line": 6765,
"description": "Scale this envelope's amplitude values to a given\nrange, and return the envelope. Calling this method\nagain will override the initial scale() with new values.
\n",
"itemtype": "method",
"name": "scale",
@@ -20815,15 +22085,15 @@ module.exports={
],
"return": {
"description": "Envelope Returns this envelope\n with scaled output",
- "type": "p5.Env"
+ "type": "p5.Envelope"
},
- "class": "p5.Env",
+ "class": "p5.Envelope",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6140,
+ "line": 6873,
"description": "Set the width of a Pulse object (an oscillator that implements\nPulse Width Modulation).
\n",
"itemtype": "method",
"name": "width",
@@ -20841,7 +22111,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6325,
+ "line": 7060,
"description": "Set type of noise to 'white', 'pink' or 'brown'.\nWhite is the default.
\n",
"itemtype": "method",
"name": "setType",
@@ -20859,103 +22129,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6355,
- "description": "Start the noise
\n",
- "itemtype": "method",
- "name": "start",
- "class": "p5.Noise",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6372,
- "description": "Stop the noise.
\n",
- "itemtype": "method",
- "name": "stop",
- "class": "p5.Noise",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6384,
- "description": "Pan the noise.
\n",
- "itemtype": "method",
- "name": "pan",
- "params": [
- {
- "name": "panning",
- "description": "Number between -1 (left)\n and 1 (right)
\n",
- "type": "Number"
- },
- {
- "name": "timeFromNow",
- "description": "schedule this event to happen\n seconds from now
\n",
- "type": "Number"
- }
- ],
- "class": "p5.Noise",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6393,
- "description": "Set the amplitude of the noise between 0 and 1.0. Or,\nmodulate amplitude with an audio signal such as an oscillator.
\n",
- "params": [
- {
- "name": "volume",
- "description": "amplitude between 0 and 1.0\n or modulating signal/oscillator
\n",
- "type": "Number|Object"
- },
- {
- "name": "rampTime",
- "description": "create a fade that lasts rampTime
\n",
- "type": "Number",
- "optional": true
- },
- {
- "name": "timeFromNow",
- "description": "schedule this event to happen\n seconds from now
\n",
- "type": "Number",
- "optional": true
- }
- ],
- "class": "p5.Noise",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6403,
- "description": "Send output to a p5.sound or web audio object
\n",
- "itemtype": "method",
- "name": "connect",
- "params": [
- {
- "name": "unit",
- "description": "",
- "type": "Object"
- }
- ],
- "class": "p5.Noise",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6409,
- "description": "Disconnect all output.
\n",
- "itemtype": "method",
- "name": "disconnect",
- "class": "p5.Noise",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6481,
+ "line": 7178,
"description": "Client must allow browser to access their microphone / audioin source.\nDefault: false. Will become true when the client enables acces.
\n",
"itemtype": "property",
"name": "enabled",
@@ -20966,7 +22140,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6506,
+ "line": 7194,
"description": "Start processing audio input. This enables the use of other\nAudioIn methods like getLevel(). Note that by default, AudioIn\nis not connected to p5.sound's output. So you won't hear\nanything unless you use the connect() method.
\nCertain browsers limit access to the user's microphone. For example,\nChrome only allows access from localhost and over https. For this reason,\nyou may want to include an errorCallback—a function that is called in case\nthe browser won't provide mic access.
\n",
"itemtype": "method",
"name": "start",
@@ -20990,7 +22164,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6571,
+ "line": 7247,
"description": "Turn the AudioIn off. If the AudioIn is stopped, it cannot getLevel().\nIf re-starting, the user may be prompted for permission access.
\n",
"itemtype": "method",
"name": "stop",
@@ -21000,7 +22174,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6583,
+ "line": 7263,
"description": "Connect to an audio unit. If no parameter is provided, will\nconnect to the master output (i.e. your speakers).
\n",
"itemtype": "method",
"name": "connect",
@@ -21018,7 +22192,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6604,
+ "line": 7284,
"description": "Disconnect the AudioIn from all audio units. For example, if\nconnect() had been called, disconnect() will stop sending\nsignal to your speakers.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -21028,7 +22202,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6616,
+ "line": 7298,
"description": "Read the Amplitude (volume level) of an AudioIn. The AudioIn\nclass contains its own instance of the Amplitude class to help\nmake it easy to get a microphone's volume level. Accepts an\noptional smoothing value (0.0 < 1.0). NOTE: AudioIn must\n.start() before using .getLevel().
\n",
"itemtype": "method",
"name": "getLevel",
@@ -21050,17 +22224,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6634,
- "description": "Add input sources to the list of available sources.
\n",
- "access": "private",
- "tagname": "",
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6649,
+ "line": 7316,
"description": "Set amplitude (volume) of a mic input between 0 and 1.0.
\n",
"itemtype": "method",
"name": "amp",
@@ -21083,19 +22247,30 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6677,
- "description": "Chrome only. Returns a list of available input sources\nand allows the user to set the media source. Firefox allows\nthe user to choose from input sources in the permissions dialogue\ninstead of enumerating available sources and selecting one.\nNote: in order to have descriptive media names your page must be\nserved over a secure (HTTPS) connection and the page should\nrequest user media before enumerating devices. Otherwise device\nID will be a long device ID number and does not specify device\ntype. For example see\nhttps://simpl.info/getusermedia/sources/index.html vs.\nhttp://simpl.info/getusermedia/sources/index.html
\n",
+ "line": 7335,
+ "description": "Returns a list of available input sources. This is a wrapper\nfor <a title="MediaDevices.enumerateDevices() - Web APIs | MDN" target="_blank" href=\n "https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices"
\n\nand it returns a Promise.
\n
\n",
"itemtype": "method",
"name": "getSources",
"params": [
{
- "name": "callback",
- "description": "a callback to handle the sources\n when they have been enumerated
\n",
- "type": "Function"
+ "name": "successCallback",
+ "description": "This callback function handles the sources when they\n have been enumerated. The callback function\n receives the deviceList array as its only argument
\n",
+ "type": "Function",
+ "optional": true
+ },
+ {
+ "name": "errorCallback",
+ "description": "This optional callback receives the error\n message as its argument.
\n",
+ "type": "Function",
+ "optional": true
}
],
+ "return": {
+ "description": "Returns a Promise that can be used in place of the callbacks, similar\n to the enumerateDevices() method",
+ "type": "Promise"
+ },
"example": [
- "\n \n var audiograb;\n\n function setup(){\n //new audioIn\n audioGrab = new p5.AudioIn();\n\n audioGrab.getSources(function(sourceList) {\n //print out the array of available sources\n console.log(sourceList);\n //set the source to the first item in the inputSources array\n audioGrab.setSource(0);\n });\n }\n "
+ "\n \n var audiograb;\n\n function setup(){\n //new audioIn\n audioGrab = new p5.AudioIn();\n\n audioGrab.getSources(function(deviceList) {\n //print out the array of available sources\n console.log(deviceList);\n //set the source to the first item in the deviceList array\n audioGrab.setSource(0);\n });\n }\n "
],
"class": "p5.AudioIn",
"module": "p5.sound",
@@ -21103,8 +22278,8 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6726,
- "description": "Set the input source. Accepts a number representing a\nposition in the array returned by listSources().\nThis is only available in browsers that support\nMediaStreamTrack.getSources(). Instead, some browsers\ngive users the option to set their own media source.
\n",
+ "line": 7386,
+ "description": "Set the input source. Accepts a number representing a\nposition in the array returned by getSources().\nThis is only available in browsers that support\n<a title="MediaDevices.enumerateDevices() - Web APIs | MDN" target="_blank" href=\n"https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices"
\n\nnavigator.mediaDevices.enumerateDevices().
\n
\n",
"itemtype": "method",
"name": "setSource",
"params": [
@@ -21120,164 +22295,84 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6763,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6779,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6803,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6829,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 6858,
+ "line": 7426,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6888,
+ "line": 7442,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6936,
+ "line": 7466,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6959,
+ "line": 7492,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 6984,
+ "line": 7514,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7005,
+ "line": 7536,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7012,
+ "line": 7582,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7034,
+ "line": 7613,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7063,
+ "line": 7631,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7090,
+ "line": 7968,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7118,
+ "line": 7990,
"class": "p5.AudioIn",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7146,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7192,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7223,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7241,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7629,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7651,
- "class": "p5.AudioIn",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7721,
- "description": "The p5.Effect class is built\n using Tone.js CrossFade
\n",
- "access": "private",
- "tagname": "",
- "class": "p5.Effect",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 7727,
+ "line": 8066,
"description": "In classes that extend\np5.Effect, connect effect nodes\nto the wet parameter
\n",
"class": "p5.Effect",
"module": "p5.sound",
@@ -21285,7 +22380,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7740,
+ "line": 8079,
"description": "Set the output volume of the filter.
\n",
"itemtype": "method",
"name": "amp",
@@ -21315,7 +22410,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7757,
+ "line": 8096,
"description": "Link effects together in a chain
Example usage: filter.chain(reverb, delay, panner);\nMay be used with an open-ended number of arguments
\n",
"itemtype": "method",
"name": "chain",
@@ -21333,7 +22428,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7774,
+ "line": 8113,
"description": "Adjust the dry/wet value.
\n",
"itemtype": "method",
"name": "drywet",
@@ -21351,7 +22446,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7786,
+ "line": 8125,
"description": "Send output to a p5.js-sound, Web Audio Node, or use signal to\ncontrol an AudioParam
\n",
"itemtype": "method",
"name": "connect",
@@ -21368,7 +22463,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7797,
+ "line": 8136,
"description": "Disconnect all output.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -21378,7 +22473,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7904,
+ "line": 8254,
"description": "The p5.Filter is built with a\n\nWeb Audio BiquadFilter Node.
\n",
"itemtype": "property",
"name": "biquadFilter",
@@ -21389,7 +22484,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7919,
+ "line": 8272,
"description": "Filter an audio signal according to a set\nof filter parameters.
\n",
"itemtype": "method",
"name": "process",
@@ -21418,7 +22513,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7933,
+ "line": 8286,
"description": "Set the frequency and the resonance of the filter.
\n",
"itemtype": "method",
"name": "set",
@@ -21448,7 +22543,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7950,
+ "line": 8303,
"description": "Set the filter frequency, in Hz, from 10 to 22050 (the range of\nhuman hearing, although in reality most people hear in a narrower\nrange).
\n",
"itemtype": "method",
"name": "freq",
@@ -21475,7 +22570,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7975,
+ "line": 8328,
"description": "Controls either width of a bandpass frequency,\nor the resonance of a low/highpass cutoff frequency.
\n",
"itemtype": "method",
"name": "res",
@@ -21502,7 +22597,42 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 7997,
+ "line": 8350,
+ "description": "Controls the gain attribute of a Biquad Filter.\nThis is distinctly different from .amp() which is inherited from p5.Effect\n.amp() controls the volume via the output gain node\np5.Filter.gain() controls the gain parameter of a Biquad Filter node.
\n",
+ "itemtype": "method",
+ "name": "gain",
+ "params": [
+ {
+ "name": "gain",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "Returns the current or updated gain value",
+ "type": "Number"
+ },
+ "class": "p5.Filter",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8371,
+ "description": "Toggle function. Switches between the specified type and allpass
\n",
+ "itemtype": "method",
+ "name": "toggle",
+ "return": {
+ "description": "[Toggle value]",
+ "type": "Boolean"
+ },
+ "class": "p5.Filter",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8386,
"description": "Set the type of a p5.Filter. Possible types include:\n"lowpass" (default), "highpass", "bandpass",\n"lowshelf", "highshelf", "peaking", "notch",\n"allpass".
\n",
"itemtype": "method",
"name": "setType",
@@ -21519,7 +22649,285 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8124,
+ "line": 8593,
+ "description": "The p5.EQ is built with abstracted p5.Filter objects.\nTo modify any bands, use methods of the \np5.Filter API, especially gain and freq.\nBands are stored in an array, with indices 0 - 3, or 0 - 7
\n",
+ "itemtype": "property",
+ "name": "bands",
+ "type": "Array",
+ "class": "p5.EQ",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8628,
+ "description": "Process an input by connecting it to the EQ
\n",
+ "itemtype": "method",
+ "name": "process",
+ "params": [
+ {
+ "name": "src",
+ "description": "Audio source
\n",
+ "type": "Object"
+ }
+ ],
+ "class": "p5.EQ",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8716,
+ "description": "\nWeb Audio Spatial Panner Node
\nProperties include
\n\n- <a title="w3 spec for Panning Model"\nhref="https://www.w3.org/TR/webaudio/#idl-def-PanningModelType"
\npanningModel: "equal power" or "HRTF"
\n
\n \n- <a title="w3 spec for Distance Model"\nhref="https://www.w3.org/TR/webaudio/#idl-def-DistanceModelType"
\ndistanceModel: "linear", "inverse", or "exponential"
\n
\n \n
\n",
+ "itemtype": "property",
+ "name": "panner",
+ "type": "AudioNode",
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8739,
+ "description": "Connect an audio sorce
\n",
+ "itemtype": "method",
+ "name": "process",
+ "params": [
+ {
+ "name": "src",
+ "description": "Input source
\n",
+ "type": "Object"
+ }
+ ],
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8748,
+ "description": "Set the X,Y,Z position of the Panner
\n",
+ "itemtype": "method",
+ "name": "set",
+ "params": [
+ {
+ "name": "xVal",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "yVal",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "zVal",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "time",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "Updated x, y, z values as an array",
+ "type": "Array"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8767,
+ "description": "Getter and setter methods for position coordinates
\n",
+ "itemtype": "method",
+ "name": "positionX",
+ "return": {
+ "description": "updated coordinate value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8772,
+ "description": "Getter and setter methods for position coordinates
\n",
+ "itemtype": "method",
+ "name": "positionY",
+ "return": {
+ "description": "updated coordinate value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8777,
+ "description": "Getter and setter methods for position coordinates
\n",
+ "itemtype": "method",
+ "name": "positionZ",
+ "return": {
+ "description": "updated coordinate value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8815,
+ "description": "Set the X,Y,Z position of the Panner
\n",
+ "itemtype": "method",
+ "name": "orient",
+ "params": [
+ {
+ "name": "xVal",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "yVal",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "zVal",
+ "description": "",
+ "type": "Number"
+ },
+ {
+ "name": "time",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "Updated x, y, z values as an array",
+ "type": "Array"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8834,
+ "description": "Getter and setter methods for orient coordinates
\n",
+ "itemtype": "method",
+ "name": "orientX",
+ "return": {
+ "description": "updated coordinate value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8839,
+ "description": "Getter and setter methods for orient coordinates
\n",
+ "itemtype": "method",
+ "name": "orientY",
+ "return": {
+ "description": "updated coordinate value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8844,
+ "description": "Getter and setter methods for orient coordinates
\n",
+ "itemtype": "method",
+ "name": "orientZ",
+ "return": {
+ "description": "updated coordinate value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8882,
+ "description": "Set the rolloff factor and max distance
\n",
+ "itemtype": "method",
+ "name": "setFalloff",
+ "params": [
+ {
+ "name": "maxDistance",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "rolloffFactor",
+ "description": "",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8892,
+ "description": "Maxium distance between the source and the listener
\n",
+ "itemtype": "method",
+ "name": "maxDist",
+ "params": [
+ {
+ "name": "maxDistance",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "updated value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 8904,
+ "description": "How quickly the volume is reduced as the source moves away from the listener
\n",
+ "itemtype": "method",
+ "name": "rollof",
+ "params": [
+ {
+ "name": "rolloffFactor",
+ "description": "",
+ "type": "Number"
+ }
+ ],
+ "return": {
+ "description": "updated value",
+ "type": "Number"
+ },
+ "class": "p5.Panner3D",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 9209,
"description": "The p5.Delay is built with two\n\nWeb Audio Delay Nodes, one for each stereo channel.
\n",
"itemtype": "property",
"name": "leftDelay",
@@ -21530,7 +22938,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8132,
+ "line": 9217,
"description": "The p5.Delay is built with two\n\nWeb Audio Delay Nodes, one for each stereo channel.
\n",
"itemtype": "property",
"name": "rightDelay",
@@ -21541,7 +22949,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8164,
+ "line": 9249,
"description": "Add delay to an audio signal according to a set\nof delay parameters.
\n",
"itemtype": "method",
"name": "process",
@@ -21576,7 +22984,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8199,
+ "line": 9284,
"description": "Set the delay (echo) time, in seconds. Usually this value will be\na floating point number between 0.0 and 1.0.
\n",
"itemtype": "method",
"name": "delayTime",
@@ -21593,7 +23001,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8218,
+ "line": 9303,
"description": "Feedback occurs when Delay sends its signal back through its input\nin a loop. The feedback amount determines how much signal to send each\ntime through the loop. A feedback greater than 1.0 is not desirable because\nit will increase the overall output each time through the loop,\ncreating an infinite feedback loop. The default value is 0.5
\n",
"itemtype": "method",
"name": "feedback",
@@ -21614,7 +23022,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8246,
+ "line": 9331,
"description": "Set a lowpass filter frequency for the delay. A lowpass filter\nwill cut off any frequencies higher than the filter frequency.
\n",
"itemtype": "method",
"name": "filter",
@@ -21636,7 +23044,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8263,
+ "line": 9348,
"description": "Choose a preset type of delay. 'pingPong' bounces the signal\nfrom the left to the right channel to produce a stereo effect.\nAny other parameter will revert to the default delay setting.
\n",
"itemtype": "method",
"name": "setType",
@@ -21653,7 +23061,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8296,
+ "line": 9381,
"description": "Set the output level of the delay effect.
\n",
"itemtype": "method",
"name": "amp",
@@ -21682,7 +23090,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8305,
+ "line": 9390,
"description": "Send output to a p5.sound or web audio object
\n",
"itemtype": "method",
"name": "connect",
@@ -21699,7 +23107,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8311,
+ "line": 9396,
"description": "Disconnect all output.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -21709,7 +23117,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8390,
+ "line": 9475,
"description": "Connect a source to the reverb, and assign reverb parameters.
\n",
"itemtype": "method",
"name": "process",
@@ -21744,7 +23152,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8419,
+ "line": 9504,
"description": "Set the reverb settings. Similar to .process(), but without\nassigning a new input.
\n",
"itemtype": "method",
"name": "set",
@@ -21774,7 +23182,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8447,
+ "line": 9532,
"description": "Set the output level of the reverb effect.
\n",
"itemtype": "method",
"name": "amp",
@@ -21803,7 +23211,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8456,
+ "line": 9541,
"description": "Send output to a p5.sound or web audio object
\n",
"itemtype": "method",
"name": "connect",
@@ -21820,7 +23228,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8462,
+ "line": 9547,
"description": "Disconnect all output.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -21830,17 +23238,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8467,
- "description": "Inspired by Simple Reverb by Jordan Santell\nhttps://github.com/web-audio-components/simple-reverb/blob/master/index.js
\nUtility function for building an impulse response\nbased on the module parameters.
\n",
- "access": "private",
- "tagname": "",
- "class": "p5.Reverb",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 8556,
+ "line": 9641,
"description": "Internally, the p5.Convolver uses the a\n\nWeb Audio Convolver Node.
\n",
"itemtype": "property",
"name": "convolverNod",
@@ -21851,7 +23249,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8581,
+ "line": 9666,
"description": "Create a p5.Convolver. Accepts a path to a soundfile\nthat will be used to generate an impulse response.
\n",
"itemtype": "method",
"name": "createConvolver",
@@ -21887,34 +23285,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8631,
- "description": "Private method to load a buffer as an Impulse Response,\nassign it to the convolverNode, and add to the Array of .impulses.
\n",
- "params": [
- {
- "name": "path",
- "description": "",
- "type": "String"
- },
- {
- "name": "callback",
- "description": "",
- "type": "Function"
- },
- {
- "name": "errorCallback",
- "description": "",
- "type": "Function"
- }
- ],
- "access": "private",
- "tagname": "",
- "class": "p5.Convolver",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 8697,
+ "line": 9790,
"description": "Connect a source to the reverb, and assign reverb parameters.
\n",
"itemtype": "method",
"name": "process",
@@ -21934,7 +23305,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8729,
+ "line": 9822,
"description": "If you load multiple impulse files using the .addImpulse method,\nthey will be stored as Objects in this Array. Toggle between them\nwith the toggleImpulse(id) method.
\n",
"itemtype": "property",
"name": "impulses",
@@ -21945,7 +23316,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8737,
+ "line": 9830,
"description": "Load and assign a new Impulse Response to the p5.Convolver.\nThe impulse is added to the .impulses array. Previous\nimpulses can be accessed with the .toggleImpulse(id)\nmethod.
\n",
"itemtype": "method",
"name": "addImpulse",
@@ -21972,7 +23343,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8755,
+ "line": 9848,
"description": "Similar to .addImpulse, except that the .impulses\nArray is reset to save memory. A new .impulses\narray is created with this impulse as the only item.
\n",
"itemtype": "method",
"name": "resetImpulse",
@@ -21999,7 +23370,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8773,
+ "line": 9866,
"description": "If you have used .addImpulse() to add multiple impulses\nto a p5.Convolver, then you can use this method to toggle between\nthe items in the .impulses Array. Accepts a parameter\nto identify which impulse you wish to use, identified either by its\noriginal filename (String) or by its position in the .impulses\n Array (Number).
\nYou can access the objects in the .impulses Array directly. Each\nObject has two attributes: an .audioBuffer (type:\nWeb Audio \nAudioBuffer) and a .name, a String that corresponds\nwith the original filename.
\n",
"itemtype": "method",
"name": "toggleImpulse",
@@ -22016,22 +23387,24 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8817,
+ "line": 9912,
"class": "p5.Convolver",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 8842,
+ "line": 9937,
"class": "p5.Convolver",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9059,
+ "line": 10132,
"description": "Set the global tempo, in beats per minute, for all\np5.Parts. This method will impact all active p5.Parts.
\n",
+ "itemtype": "method",
+ "name": "setBPM",
"params": [
{
"name": "BPM",
@@ -22050,7 +23423,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9148,
+ "line": 10222,
"description": "Array of values to pass into the callback\nat each step of the phrase. Depending on the callback\nfunction's requirements, these values may be numbers,\nstrings, or an object with multiple parameters.\nZero (0) indicates a rest.
\n",
"itemtype": "property",
"name": "sequence",
@@ -22061,7 +23434,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9236,
+ "line": 10310,
"description": "Set the tempo of this part, in Beats Per Minute.
\n",
"itemtype": "method",
"name": "setBPM",
@@ -22084,7 +23457,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9246,
+ "line": 10320,
"description": "Returns the Beats Per Minute of this currently part.
\n",
"itemtype": "method",
"name": "getBPM",
@@ -22098,7 +23471,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9255,
+ "line": 10329,
"description": "Start playback of this part. It will play\nthrough all of its phrases at a speed\ndetermined by setBPM.
\n",
"itemtype": "method",
"name": "start",
@@ -22116,7 +23489,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9271,
+ "line": 10345,
"description": "Loop playback of this part. It will begin\nlooping through all of its phrases at a speed\ndetermined by setBPM.
\n",
"itemtype": "method",
"name": "loop",
@@ -22134,7 +23507,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9288,
+ "line": 10362,
"description": "Tell the part to stop looping.
\n",
"itemtype": "method",
"name": "noLoop",
@@ -22144,7 +23517,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9300,
+ "line": 10374,
"description": "Stop the part and cue it to step 0.
\n",
"itemtype": "method",
"name": "stop",
@@ -22162,7 +23535,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9310,
+ "line": 10384,
"description": "Pause the part. Playback will resume\nfrom the current step.
\n",
"itemtype": "method",
"name": "pause",
@@ -22179,7 +23552,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9322,
+ "line": 10396,
"description": "Add a p5.Phrase to this Part.
\n",
"itemtype": "method",
"name": "addPhrase",
@@ -22196,7 +23569,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9343,
+ "line": 10417,
"description": "Remove a phrase from this part, based on the name it was\ngiven when it was created.
\n",
"itemtype": "method",
"name": "removePhrase",
@@ -22213,7 +23586,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9357,
+ "line": 10431,
"description": "Get a phrase from this part, based on the name it was\ngiven when it was created. Now you can modify its array.
\n",
"itemtype": "method",
"name": "getPhrase",
@@ -22230,7 +23603,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9371,
+ "line": 10445,
"description": "Get a phrase from this part, based on the name it was\ngiven when it was created. Now you can modify its array.
\n",
"itemtype": "method",
"name": "replaceSequence",
@@ -22252,7 +23625,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9399,
+ "line": 10473,
"description": "Fire a callback function at every step.
\n",
"itemtype": "method",
"name": "onStep",
@@ -22269,7 +23642,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9452,
+ "line": 10526,
"description": "Start playback of the score.
\n",
"itemtype": "method",
"name": "start",
@@ -22279,7 +23652,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9461,
+ "line": 10535,
"description": "Stop playback of the score.
\n",
"itemtype": "method",
"name": "stop",
@@ -22289,7 +23662,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9471,
+ "line": 10545,
"description": "Pause playback of the score.
\n",
"itemtype": "method",
"name": "pause",
@@ -22299,7 +23672,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9479,
+ "line": 10553,
"description": "Loop playback of the score.
\n",
"itemtype": "method",
"name": "loop",
@@ -22309,7 +23682,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9488,
+ "line": 10562,
"description": "Stop looping playback of the score. If it\nis currently playing, this will go into effect\nafter the current round of playback completes.
\n",
"itemtype": "method",
"name": "noLoop",
@@ -22319,8 +23692,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9513,
+ "line": 10587,
"description": "Set the tempo for all parts in the score
\n",
+ "itemtype": "method",
+ "name": "setBPM",
"params": [
{
"name": "BPM",
@@ -22339,18 +23714,178 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9567,
+ "line": 10655,
+ "description": "musicalTimeMode uses Tone.Time convention\ntrue if string, false if number
\n",
+ "itemtype": "property",
+ "name": "musicalTimeMode",
+ "type": "Boolean",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10662,
+ "description": "musicalTimeMode variables\nmodify these only when the interval is specified in musicalTime format as a string
\n",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10669,
+ "description": "Set a limit to the number of loops to play. defaults to Infinity
\n",
+ "itemtype": "property",
+ "name": "maxIterations",
+ "type": "Number",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10678,
+ "description": "Do not initiate the callback if timeFromNow is < 0\nThis ususually occurs for a few milliseconds when the page\nis not fully loaded
\nThe callback should only be called until maxIterations is reached
\n",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10692,
+ "description": "Start the loop
\n",
+ "itemtype": "method",
+ "name": "start",
+ "params": [
+ {
+ "name": "timeFromNow",
+ "description": "schedule a starting time
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10705,
+ "description": "Stop the loop
\n",
+ "itemtype": "method",
+ "name": "stop",
+ "params": [
+ {
+ "name": "timeFromNow",
+ "description": "schedule a stopping time
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10718,
+ "description": "Pause the loop
\n",
+ "itemtype": "method",
+ "name": "pause",
+ "params": [
+ {
+ "name": "timeFromNow",
+ "description": "schedule a pausing time
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10731,
+ "description": "Synchronize loops. Use this method to start two more more loops in synchronization\nor to start a loop in synchronization with a loop that is already playing\nThis method will schedule the implicit loop in sync with the explicit master loop\ni.e. loopToStart.syncedStart(loopToSyncWith)
\n",
+ "itemtype": "method",
+ "name": "syncedStart",
+ "params": [
+ {
+ "name": "otherLoop",
+ "description": "a p5.SoundLoop to sync with
\n",
+ "type": "Object"
+ },
+ {
+ "name": "timeFromNow",
+ "description": "Start the loops in sync after timeFromNow seconds
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10812,
+ "description": "Getters and Setters, setting any paramter will result in a change in the clock's\nfrequency, that will be reflected after the next callback\nbeats per minute (defaults to 60)
\n",
+ "itemtype": "property",
+ "name": "bpm",
+ "type": "Number",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10830,
+ "description": "number of quarter notes in a measure (defaults to 4)
\n",
+ "itemtype": "property",
+ "name": "timeSignature",
+ "type": "Number",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10846,
+ "description": "length of the loops interval
\n",
+ "itemtype": "property",
+ "name": "interval",
+ "type": "Number|String",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10860,
+ "description": "how many times the callback has been called so far
\n",
+ "itemtype": "property",
+ "name": "iterations",
+ "type": "Number",
+ "readonly": "",
+ "class": "p5.SoundLoop",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 10901,
"description": "The p5.Compressor is built with a Web Audio Dynamics Compressor Node\n
\n",
"itemtype": "property",
"name": "compressor",
- "type": "WebAudioNode",
+ "type": "AudioNode",
"class": "p5.Compressor",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9578,
+ "line": 10912,
"description": "Performs the same function as .connect, but also accepts\noptional parameters to set compressor's audioParams
\n",
"itemtype": "method",
"name": "process",
@@ -22397,7 +23932,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9601,
+ "line": 10935,
"description": "Set the paramters of a compressor.
\n",
"itemtype": "method",
"name": "set",
@@ -22434,7 +23969,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9633,
+ "line": 10967,
"description": "Get current attack or set value w/ time ramp
\n",
"itemtype": "method",
"name": "attack",
@@ -22458,7 +23993,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9653,
+ "line": 10987,
"description": "Get current knee or set value w/ time ramp
\n",
"itemtype": "method",
"name": "knee",
@@ -22482,7 +24017,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9673,
+ "line": 11007,
"description": "Get current ratio or set value w/ time ramp
\n",
"itemtype": "method",
"name": "ratio",
@@ -22506,7 +24041,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9692,
+ "line": 11026,
"description": "Get current threshold or set value w/ time ramp
\n",
"itemtype": "method",
"name": "threshold",
@@ -22529,7 +24064,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9711,
+ "line": 11045,
"description": "Get current release or set value w/ time ramp
\n",
"itemtype": "method",
"name": "release",
@@ -22552,8 +24087,10 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9731,
+ "line": 11065,
"description": "Return the current reduction value
\n",
+ "itemtype": "method",
+ "name": "reduction",
"return": {
"description": "Value of the amount of gain reduction that is applied to the signal",
"type": "Number"
@@ -22564,18 +24101,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9828,
- "description": "callback invoked when the recording is over
\n",
- "access": "private",
- "tagname": "",
- "type": "Function(Float32Array)",
- "class": "p5.SoundRecorder",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 9841,
+ "line": 11180,
"description": "Connect a specific device to the p5.SoundRecorder.\nIf no parameter is given, p5.SoundRecorer will record\nall audible p5.sound from your sketch.
\n",
"itemtype": "method",
"name": "setInput",
@@ -22593,7 +24119,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9862,
+ "line": 11201,
"description": "Start recording. To access the recording, provide\na p5.SoundFile as the first parameter. The p5.SoundRecorder\nwill send its recording to that p5.SoundFile for playback once\nrecording is complete. Optional parameters include duration\n(in seconds) of the recording, and a callback function that\nwill be called once the complete recording has been\ntransfered to the p5.SoundFile.
\n",
"itemtype": "method",
"name": "record",
@@ -22622,7 +24148,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9895,
+ "line": 11234,
"description": "Stop the recording. Once the recording is stopped,\nthe results will be sent to the p5.SoundFile that\nwas given on .record(), and if a callback function\nwas provided on record, that function will be called.
\n",
"itemtype": "method",
"name": "stop",
@@ -22632,24 +24158,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 9914,
- "description": "internal method called on audio process
\n",
- "access": "private",
- "tagname": "",
- "params": [
- {
- "name": "event",
- "description": "",
- "type": "AudioProcessorEvent"
- }
- ],
- "class": "p5.SoundRecorder",
- "module": "p5.sound",
- "submodule": "p5.sound"
- },
- {
- "file": "lib/addons/p5.sound.js",
- "line": 9968,
+ "line": 11307,
"description": "Save a p5.SoundFile as a .wav audio file.
\n",
"itemtype": "method",
"name": "saveSound",
@@ -22671,7 +24180,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10144,
+ "line": 11484,
"description": "isDetected is set to true when a peak is detected.
\n",
"itemtype": "attribute",
"name": "isDetected",
@@ -22683,7 +24192,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10157,
+ "line": 11497,
"description": "The update method is run in the draw loop.
\nAccepts an FFT object. You must call .analyze()\non the FFT object prior to updating the peakDetect\nbecause it relies on a completed FFT analysis.
\n",
"itemtype": "method",
"name": "update",
@@ -22700,7 +24209,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10188,
+ "line": 11528,
"description": "onPeak accepts two arguments: a function to call when\na peak is detected. The value of the peak,\nbetween 0.0 and 1.0, is passed to the callback.
\n",
"itemtype": "method",
"name": "onPeak",
@@ -22718,7 +24227,7 @@ module.exports={
}
],
"example": [
- "\n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 0;\n\nfunction setup() {\n cnv = createCanvas(100,100);\n textAlign(CENTER);\n\n soundFile = loadSound('assets/beat.mp3');\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n\n setupSound();\n\n // when a beat is detected, call triggerBeat()\n peakDetect.onPeak(triggerBeat);\n}\n\nfunction draw() {\n background(0);\n fill(255);\n text('click to play', width/2, height/2);\n\n fft.analyze();\n peakDetect.update(fft);\n\n ellipseWidth *= 0.95;\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// this function is called by peakDetect.onPeak\nfunction triggerBeat() {\n ellipseWidth = 50;\n}\n\n// mouseclick starts/stops sound\nfunction setupSound() {\n cnv.mouseClicked( function() {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n });\n}\n"
+ "\n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 0;\n\nfunction preload() {\n soundFile = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n cnv = createCanvas(100,100);\n textAlign(CENTER);\n\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n\n setupSound();\n\n // when a beat is detected, call triggerBeat()\n peakDetect.onPeak(triggerBeat);\n}\n\nfunction draw() {\n background(0);\n fill(255);\n text('click to play', width/2, height/2);\n\n fft.analyze();\n peakDetect.update(fft);\n\n ellipseWidth *= 0.95;\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// this function is called by peakDetect.onPeak\nfunction triggerBeat() {\n ellipseWidth = 50;\n}\n\n// mouseclick starts/stops sound\nfunction setupSound() {\n cnv.mouseClicked( function() {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n });\n}\n"
],
"class": "p5.PeakDetect",
"module": "p5.sound",
@@ -22726,7 +24235,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10334,
+ "line": 11677,
"description": "Connect a source to the gain node.
\n",
"itemtype": "method",
"name": "setInput",
@@ -22743,7 +24252,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10344,
+ "line": 11687,
"description": "Send output to a p5.sound or web audio object
\n",
"itemtype": "method",
"name": "connect",
@@ -22760,7 +24269,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10354,
+ "line": 11697,
"description": "Disconnect all output.
\n",
"itemtype": "method",
"name": "disconnect",
@@ -22770,7 +24279,7 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10362,
+ "line": 11707,
"description": "Set the output level of the gain node.
\n",
"itemtype": "method",
"name": "amp",
@@ -22799,544 +24308,1105 @@ module.exports={
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10443,
- "description": "The p5.Distortion is built with a\n\nWeb Audio WaveShaper Node.
\n",
- "itemtype": "property",
- "name": "WaveShaperNode",
- "type": "AudioNode",
- "class": "p5.Distortion",
+ "line": 11765,
+ "description": "Connect to p5 objects or Web Audio Nodes
\n",
+ "itemtype": "method",
+ "name": "connect",
+ "params": [
+ {
+ "name": "unit",
+ "description": "",
+ "type": "Object"
+ }
+ ],
+ "class": "p5.AudioVoice",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10458,
- "description": "Process a sound source, optionally specify amount and oversample values.
\n",
+ "line": 11774,
+ "description": "Disconnect from soundOut
\n",
"itemtype": "method",
- "name": "process",
+ "name": "disconnect",
+ "class": "p5.AudioVoice",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 11860,
+ "description": "Play tells the MonoSynth to start playing a note. This method schedules\nthe calling of .triggerAttack and .triggerRelease.
\n",
+ "itemtype": "method",
+ "name": "play",
"params": [
{
- "name": "amount",
- "description": "Unbounded distortion amount.\n Normal values range from 0-1.
\n",
+ "name": "note",
+ "description": "the note you want to play, specified as a\n frequency in Hertz (Number) or as a midi\n value in Note/Octave format ("C4", "Eb3"...etc")\n See \n Tone. Defaults to 440 hz.
\n",
+ "type": "String | Number"
+ },
+ {
+ "name": "velocity",
+ "description": "velocity of the note to play (ranging from 0 to 1)
\n",
"type": "Number",
- "optional": true,
- "optdefault": "0.25"
+ "optional": true
},
{
- "name": "oversample",
- "description": "'none', '2x', or '4x'.
\n",
- "type": "String",
- "optional": true,
- "optdefault": "'none'"
+ "name": "secondsFromNow",
+ "description": "time from now (in seconds) at which to play
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "sustainTime",
+ "description": "time to sustain before releasing the envelope
\n",
+ "type": "Number",
+ "optional": true
}
],
- "class": "p5.Distortion",
+ "example": [
+ "\n\nvar monoSynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n monoSynth = new p5.MonoSynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // time from now (in seconds)\n var time = 0;\n // note duration (in seconds)\n var dur = 1/6;\n // note velocity (volume, from 0 to 1)\n var v = random();\n\n monoSynth.play(\"Fb3\", v, 0, dur);\n monoSynth.play(\"Gb3\", v, time += dur, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n\n"
+ ],
+ "class": "p5.MonoSynth",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10470,
- "description": "Set the amount and oversample of the waveshaper distortion.
\n",
- "itemtype": "method",
- "name": "set",
+ "line": 11908,
+ "description": "Trigger the Attack, and Decay portion of the Envelope.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go.
\n",
"params": [
{
- "name": "amount",
- "description": "Unbounded distortion amount.\n Normal values range from 0-1.
\n",
+ "name": "note",
+ "description": "the note you want to play, specified as a\n frequency in Hertz (Number) or as a midi\n value in Note/Octave format ("C4", "Eb3"...etc")\n See \n Tone. Defaults to 440 hz
\n",
+ "type": "String | Number"
+ },
+ {
+ "name": "velocity",
+ "description": "velocity of the note to play (ranging from 0 to 1)
\n",
"type": "Number",
- "optional": true,
- "optdefault": "0.25"
+ "optional": true
},
{
- "name": "oversample",
- "description": "'none', '2x', or '4x'.
\n",
- "type": "String",
- "optional": true,
- "optdefault": "'none'"
+ "name": "secondsFromNow",
+ "description": "time from now (in seconds) at which to play
\n",
+ "type": "Number",
+ "optional": true
}
],
- "class": "p5.Distortion",
+ "itemtype": "method",
+ "name": "triggerAttack",
+ "example": [
+ "\n\nvar monoSynth = new p5.MonoSynth();\n\nfunction mousePressed() {\n monoSynth.triggerAttack(\"E3\");\n}\n\nfunction mouseReleased() {\n monoSynth.triggerRelease();\n}\n"
+ ],
+ "class": "p5.MonoSynth",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10488,
- "description": "Return the distortion amount, typically between 0-1.
\n",
+ "line": 11942,
+ "description": "Trigger the release of the Envelope. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.
\n",
+ "params": [
+ {
+ "name": "secondsFromNow",
+ "description": "time to trigger the release
\n",
+ "type": "Number"
+ }
+ ],
"itemtype": "method",
- "name": "getAmount",
- "return": {
- "description": "Unbounded distortion amount.\n Normal values range from 0-1.",
- "type": "Number"
- },
- "class": "p5.Distortion",
+ "name": "triggerRelease",
+ "example": [
+ "\n\nvar monoSynth = new p5.MonoSynth();\n\nfunction mousePressed() {\n monoSynth.triggerAttack(\"E3\");\n}\n\nfunction mouseReleased() {\n monoSynth.triggerRelease();\n}\n"
+ ],
+ "class": "p5.MonoSynth",
"module": "p5.sound",
"submodule": "p5.sound"
},
{
"file": "lib/addons/p5.sound.js",
- "line": 10498,
- "description": "Return the oversampling.
\n",
+ "line": 11967,
+ "description": "Set values like a traditional\n\nADSR envelope\n.
\n",
"itemtype": "method",
- "name": "getOversample",
- "return": {
- "description": "Oversample can either be 'none', '2x', or '4x'.",
- "type": "String"
- },
- "class": "p5.Distortion",
+ "name": "setADSR",
+ "params": [
+ {
+ "name": "attackTime",
+ "description": "Time (in seconds before envelope\n reaches Attack Level
\n",
+ "type": "Number"
+ },
+ {
+ "name": "decayTime",
+ "description": "Time (in seconds) before envelope\n reaches Decay/Sustain Level
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "susRatio",
+ "description": "Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "releaseTime",
+ "description": "Time in seconds from now (defaults to 0)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.MonoSynth",
"module": "p5.sound",
"submodule": "p5.sound"
- }
- ],
- "warnings": [
- {
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:16"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:60"
+ "file": "lib/addons/p5.sound.js",
+ "line": 11991,
+ "description": "Getters and Setters
\n",
+ "itemtype": "property",
+ "name": "attack",
+ "type": "Number",
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:89"
+ "file": "lib/addons/p5.sound.js",
+ "line": 11995,
+ "itemtype": "property",
+ "name": "decay",
+ "type": "Number",
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:118"
+ "file": "lib/addons/p5.sound.js",
+ "line": 11998,
+ "itemtype": "property",
+ "name": "sustain",
+ "type": "Number",
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:326"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12001,
+ "itemtype": "property",
+ "name": "release",
+ "type": "Number",
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:356"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12038,
+ "description": "MonoSynth amp
\n",
+ "itemtype": "method",
+ "name": "amp",
+ "params": [
+ {
+ "name": "vol",
+ "description": "desired volume
\n",
+ "type": "Number"
+ },
+ {
+ "name": "rampTime",
+ "description": "Time to reach new volume
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "return": {
+ "description": "new volume value",
+ "type": "Number"
+ },
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:392"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12052,
+ "description": "Connect to a p5.sound / Web Audio object.
\n",
+ "itemtype": "method",
+ "name": "connect",
+ "params": [
+ {
+ "name": "unit",
+ "description": "A p5.sound or Web Audio object
\n",
+ "type": "Object"
+ }
+ ],
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:489"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12062,
+ "description": "Disconnect all outputs
\n",
+ "itemtype": "method",
+ "name": "disconnect",
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:518"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12072,
+ "description": "Get rid of the MonoSynth and free up its resources / memory.
\n",
+ "itemtype": "method",
+ "name": "dispose",
+ "class": "p5.MonoSynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/creating_reading.js:557"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12145,
+ "description": "An object that holds information about which notes have been played and\nwhich notes are currently being played. New notes are added as keys\non the fly. While a note has been attacked, but not released, the value of the\nkey is the audiovoice which is generating that note. When notes are released,\nthe value of the key becomes undefined.
\n",
+ "itemtype": "property",
+ "name": "notes",
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/p5.Color.js:447"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12157,
+ "description": "A PolySynth must have at least 1 voice, defaults to 8
\n",
+ "itemtype": "property",
+ "name": "polyvalue",
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:15"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12162,
+ "description": "Monosynth that generates the sound for each note that is triggered. The\np5.PolySynth defaults to using the p5.MonoSynth as its voice.
\n",
+ "itemtype": "property",
+ "name": "AudioVoice",
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:178"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12193,
+ "description": "Play a note by triggering noteAttack and noteRelease with sustain time
\n",
+ "itemtype": "method",
+ "name": "play",
+ "params": [
+ {
+ "name": "note",
+ "description": "midi note to play (ranging from 0 to 127 - 60 being a middle C)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "velocity",
+ "description": "velocity of the note to play (ranging from 0 to 1)
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "secondsFromNow",
+ "description": "time from now (in seconds) at which to play
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "sustainTime",
+ "description": "time to sustain before releasing the envelope
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "example": [
+ "\n\nvar polySynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n polySynth = new p5.PolySynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // note duration (in seconds)\n var dur = 0.1;\n\n // time from now (in seconds)\n var time = 0;\n\n // velocity (volume, from 0 to 1)\n var vel = 0.1;\n\n polySynth.play(\"G2\", vel, 0, dur);\n polySynth.play(\"C3\", vel, 0, dur);\n polySynth.play(\"G3\", vel, 0, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n"
+ ],
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:235"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12239,
+ "description": "noteADSR sets the envelope for a specific note that has just been triggered.\nUsing this method modifies the envelope of whichever audiovoice is being used\nto play the desired note. The envelope should be reset before noteRelease is called\nin order to prevent the modified envelope from being used on other notes.
\n",
+ "itemtype": "method",
+ "name": "noteADSR",
+ "params": [
+ {
+ "name": "note",
+ "description": "Midi note on which ADSR should be set.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "attackTime",
+ "description": "Time (in seconds before envelope\n reaches Attack Level
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "decayTime",
+ "description": "Time (in seconds) before envelope\n reaches Decay/Sustain Level
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "susRatio",
+ "description": "Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "releaseTime",
+ "description": "Time in seconds from now (defaults to 0)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:373"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12267,
+ "description": "Set the PolySynths global envelope. This method modifies the envelopes of each\nmonosynth so that all notes are played with this envelope.
\n",
+ "itemtype": "method",
+ "name": "setADSR",
+ "params": [
+ {
+ "name": "attackTime",
+ "description": "Time (in seconds before envelope\n reaches Attack Level
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "decayTime",
+ "description": "Time (in seconds) before envelope\n reaches Decay/Sustain Level
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "susRatio",
+ "description": "Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "releaseTime",
+ "description": "Time in seconds from now (defaults to 0)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:489"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12291,
+ "description": "Trigger the Attack, and Decay portion of a MonoSynth.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go.
\n",
+ "itemtype": "method",
+ "name": "noteAttack",
+ "params": [
+ {
+ "name": "note",
+ "description": "midi note on which attack should be triggered.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "velocity",
+ "description": "velocity of the note to play (ranging from 0 to 1)/
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "secondsFromNow",
+ "description": "time from now (in seconds)
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "example": [
+ "\n\nvar polySynth = new p5.PolySynth();\nvar pitches = [\"G\", \"D\", \"G\", \"C\"];\nvar octaves = [2, 3, 4];\n\nfunction mousePressed() {\n // play a chord: multiple notes at the same time\n for (var i = 0; i < 4; i++) {\n var note = random(pitches) + random(octaves);\n polySynth.noteAttack(note, 0.1);\n }\n}\n\nfunction mouseReleased() {\n // release all voices\n polySynth.noteRelease();\n}\n"
+ ],
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:514"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12381,
+ "description": "Trigger the Release of an AudioVoice note. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.
\n",
+ "itemtype": "method",
+ "name": "noteRelease",
+ "params": [
+ {
+ "name": "note",
+ "description": "midi note on which attack should be triggered.\n If no value is provided, all notes will be released.
\n",
+ "type": "Number",
+ "optional": true
+ },
+ {
+ "name": "secondsFromNow",
+ "description": "time to trigger the release
\n",
+ "type": "Number",
+ "optional": true
+ }
+ ],
+ "example": [
+ "\n\nvar pitches = [\"G\", \"D\", \"G\", \"C\"];\nvar octaves = [2, 3, 4];\nvar polySynth = new p5.PolySynth();\n\nfunction mousePressed() {\n // play a chord: multiple notes at the same time\n for (var i = 0; i < 4; i++) {\n var note = random(pitches) + random(octaves);\n polySynth.noteAttack(note, 0.1);\n }\n}\n\nfunction mouseReleased() {\n // release all voices\n polySynth.noteRelease();\n}\n\n"
+ ],
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/color/setting.js:581"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12446,
+ "description": "Connect to a p5.sound / Web Audio object.
\n",
+ "itemtype": "method",
+ "name": "connect",
+ "params": [
+ {
+ "name": "unit",
+ "description": "A p5.sound or Web Audio object
\n",
+ "type": "Object"
+ }
+ ],
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:16"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12456,
+ "description": "Disconnect all outputs
\n",
+ "itemtype": "method",
+ "name": "disconnect",
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
},
{
- "message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:132"
+ "file": "lib/addons/p5.sound.js",
+ "line": 12466,
+ "description": "Get rid of the MonoSynth and free up its resources / memory.
\n",
+ "itemtype": "method",
+ "name": "dispose",
+ "class": "p5.PolySynth",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 12534,
+ "description": "The p5.Distortion is built with a\n\nWeb Audio WaveShaper Node.
\n",
+ "itemtype": "property",
+ "name": "WaveShaperNode",
+ "type": "AudioNode",
+ "class": "p5.Distortion",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 12549,
+ "description": "Process a sound source, optionally specify amount and oversample values.
\n",
+ "itemtype": "method",
+ "name": "process",
+ "params": [
+ {
+ "name": "amount",
+ "description": "Unbounded distortion amount.\n Normal values range from 0-1.
\n",
+ "type": "Number",
+ "optional": true,
+ "optdefault": "0.25"
+ },
+ {
+ "name": "oversample",
+ "description": "'none', '2x', or '4x'.
\n",
+ "type": "String",
+ "optional": true,
+ "optdefault": "'none'"
+ }
+ ],
+ "class": "p5.Distortion",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 12561,
+ "description": "Set the amount and oversample of the waveshaper distortion.
\n",
+ "itemtype": "method",
+ "name": "set",
+ "params": [
+ {
+ "name": "amount",
+ "description": "Unbounded distortion amount.\n Normal values range from 0-1.
\n",
+ "type": "Number",
+ "optional": true,
+ "optdefault": "0.25"
+ },
+ {
+ "name": "oversample",
+ "description": "'none', '2x', or '4x'.
\n",
+ "type": "String",
+ "optional": true,
+ "optdefault": "'none'"
+ }
+ ],
+ "class": "p5.Distortion",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 12579,
+ "description": "Return the distortion amount, typically between 0-1.
\n",
+ "itemtype": "method",
+ "name": "getAmount",
+ "return": {
+ "description": "Unbounded distortion amount.\n Normal values range from 0-1.",
+ "type": "Number"
+ },
+ "class": "p5.Distortion",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ },
+ {
+ "file": "lib/addons/p5.sound.js",
+ "line": 12589,
+ "description": "Return the oversampling.
\n",
+ "itemtype": "method",
+ "name": "getOversample",
+ "return": {
+ "description": "Oversample can either be 'none', '2x', or '4x'.",
+ "type": "String"
+ },
+ "class": "p5.Distortion",
+ "module": "p5.sound",
+ "submodule": "p5.sound"
+ }
+ ],
+ "warnings": [
+ {
+ "message": "unknown tag: alt",
+ "line": " src/color/creating_reading.js:16"
},
{
"message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:187"
+ "line": " src/color/creating_reading.js:61"
},
{
"message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:262"
+ "line": " src/color/creating_reading.js:91"
},
{
"message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:313"
+ "line": " src/color/creating_reading.js:121"
},
{
"message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:393"
+ "line": " src/color/creating_reading.js:319"
},
{
"message": "unknown tag: alt",
- "line": " src/core/2d_primitives.js:477"
+ "line": " src/color/creating_reading.js:350"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:14"
+ "line": " src/color/creating_reading.js:387"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:80"
+ "line": " src/color/creating_reading.js:484"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:108"
+ "line": " src/color/creating_reading.js:514"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:174"
+ "line": " src/color/creating_reading.js:554"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:203"
+ "line": " src/color/p5.Color.js:52"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:237"
+ "line": " src/color/p5.Color.js:248"
},
{
"message": "unknown tag: alt",
- "line": " src/core/attributes.js:301"
+ "line": " src/color/p5.Color.js:275"
},
{
"message": "unknown tag: alt",
- "line": " src/core/constants.js:33"
+ "line": " src/color/p5.Color.js:302"
},
{
"message": "unknown tag: alt",
- "line": " src/core/constants.js:52"
+ "line": " src/color/p5.Color.js:329"
},
{
"message": "unknown tag: alt",
- "line": " src/core/constants.js:71"
+ "line": " src/color/p5.Color.js:763"
},
{
"message": "unknown tag: alt",
- "line": " src/core/constants.js:90"
+ "line": " src/color/setting.js:15"
},
{
"message": "unknown tag: alt",
- "line": " src/core/constants.js:109"
+ "line": " src/color/setting.js:185"
},
{
"message": "unknown tag: alt",
- "line": " src/core/core.js:49"
+ "line": " src/color/setting.js:223"
},
{
"message": "unknown tag: alt",
- "line": " src/core/core.js:85"
+ "line": " src/color/setting.js:344"
},
{
"message": "unknown tag: alt",
- "line": " src/core/core.js:116"
+ "line": " src/color/setting.js:501"
},
{
"message": "unknown tag: alt",
- "line": " src/core/core.js:393"
+ "line": " src/color/setting.js:542"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:16"
+ "line": " src/color/setting.js:582"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:99"
+ "line": " src/core/shape/2d_primitives.js:16"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:124"
+ "line": " src/core/shape/2d_primitives.js:149"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:175"
+ "line": " src/core/shape/2d_primitives.js:208"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:256"
+ "line": " src/core/shape/2d_primitives.js:264"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:308"
+ "line": " src/core/shape/2d_primitives.js:299"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:353"
+ "line": " src/core/shape/2d_primitives.js:353"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:378"
+ "line": " src/core/shape/2d_primitives.js:436"
},
{
"message": "unknown tag: alt",
- "line": " src/core/curves.js:476"
+ "line": " src/core/shape/attributes.js:14"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:22"
+ "line": " src/core/shape/attributes.js:83"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:51"
+ "line": " src/core/shape/attributes.js:113"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:79"
+ "line": " src/core/shape/attributes.js:182"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:110"
+ "line": " src/core/shape/attributes.js:213"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:188"
+ "line": " src/core/shape/attributes.js:250"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:262"
+ "line": " src/core/shape/attributes.js:317"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:288"
+ "line": " src/core/shape/curves.js:13"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:305"
+ "line": " src/core/shape/curves.js:96"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:322"
+ "line": " src/core/shape/curves.js:139"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:338"
+ "line": " src/core/shape/curves.js:194"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:354"
+ "line": " src/core/shape/curves.js:273"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:428"
+ "line": " src/core/shape/curves.js:364"
},
{
- "message": "replacing incorrect tag: returns with return",
- "line": " src/core/environment.js:475"
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/curves.js:406"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/curves.js:502"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:22"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:70"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:270"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:317"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:390"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:435"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:500"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:560"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:646"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:709"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:475"
+ "line": " src/core/shape/vertex.js:800"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:800"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:800"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/shape/vertex.js:800"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/constants.js:58"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/constants.js:77"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/constants.js:96"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/constants.js:115"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/constants.js:134"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:22"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:49"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:76"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:108"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:167"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:268"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:293"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:312"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:331"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:347"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:363"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:441"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:492"
},
{
"message": "replacing incorrect tag: returns with return",
- "line": " src/core/environment.js:520"
+ "line": " src/core/environment.js:527"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/core/environment.js:547"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/core/environment.js:547"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:520"
+ "line": " src/core/environment.js:604"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:577"
+ "line": " src/core/environment.js:635"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:608"
+ "line": " src/core/environment.js:658"
},
{
"message": "unknown tag: alt",
- "line": " src/core/environment.js:629"
+ "line": " src/core/main.js:49"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:53"
+ "line": " src/core/main.js:90"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:112"
+ "line": " src/core/main.js:121"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:163"
+ "line": " src/core/main.js:408"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:213"
+ "line": " src/core/p5.Element.js:51"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:263"
+ "line": " src/core/p5.Element.js:116"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:329"
+ "line": " src/core/p5.Element.js:153"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:383"
+ "line": " src/core/p5.Element.js:188"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:437"
+ "line": " src/core/p5.Element.js:249"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:496"
+ "line": " src/core/p5.Element.js:298"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:541"
+ "line": " src/core/p5.Element.js:364"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:608"
+ "line": " src/core/p5.Element.js:418"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:643"
+ "line": " src/core/p5.Element.js:474"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:686"
+ "line": " src/core/p5.Element.js:532"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:735"
+ "line": " src/core/p5.Element.js:575"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:776"
+ "line": " src/core/p5.Element.js:642"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:828"
+ "line": " src/core/p5.Element.js:677"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:866"
+ "line": " src/core/p5.Element.js:719"
},
{
"message": "unknown tag: alt",
- "line": " src/core/p5.Element.js:904"
+ "line": " src/core/p5.Element.js:767"
},
{
"message": "unknown tag: alt",
- "line": " src/core/rendering.js:14"
+ "line": " src/core/p5.Element.js:807"
},
{
"message": "unknown tag: alt",
- "line": " src/core/rendering.js:112"
+ "line": " src/core/p5.Element.js:856"
},
{
"message": "unknown tag: alt",
- "line": " src/core/rendering.js:162"
+ "line": " src/core/p5.Element.js:894"
},
{
"message": "unknown tag: alt",
- "line": " src/core/rendering.js:185"
+ "line": " src/core/p5.Element.js:932"
},
{
"message": "unknown tag: alt",
- "line": " src/core/rendering.js:223"
+ "line": " src/core/p5.Graphics.js:65"
},
{
"message": "unknown tag: alt",
- "line": " src/core/structure.js:15"
+ "line": " src/core/rendering.js:17"
},
{
"message": "unknown tag: alt",
- "line": " src/core/structure.js:77"
+ "line": " src/core/rendering.js:119"
},
{
"message": "unknown tag: alt",
- "line": " src/core/structure.js:119"
+ "line": " src/core/rendering.js:174"
},
{
"message": "unknown tag: alt",
- "line": " src/core/structure.js:194"
+ "line": " src/core/rendering.js:197"
},
{
"message": "unknown tag: alt",
- "line": " src/core/structure.js:266"
+ "line": " src/core/rendering.js:236"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:15"
+ "line": " src/core/structure.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:137"
+ "line": " src/core/structure.js:74"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:163"
+ "line": " src/core/structure.js:116"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:263"
+ "line": " src/core/structure.js:181"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:345"
+ "line": " src/core/structure.js:247"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:386"
+ "line": " src/core/transform.js:13"
},
{
"message": "unknown tag: alt",
- "line": " src/core/transform.js:427"
+ "line": " src/core/transform.js:135"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:22"
+ "line": " src/core/transform.js:161"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:70"
+ "line": " src/core/transform.js:201"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:267"
+ "line": " src/core/transform.js:231"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:332"
+ "line": " src/core/transform.js:261"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:374"
+ "line": " src/core/transform.js:291"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:434"
+ "line": " src/core/transform.js:366"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:502"
+ "line": " src/core/transform.js:405"
},
{
"message": "unknown tag: alt",
- "line": " src/core/vertex.js:579"
+ "line": " src/core/transform.js:444"
},
{
"message": "unknown tag: alt",
@@ -23356,23 +25426,31 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/events/acceleration.js:237"
+ "line": " src/events/acceleration.js:239"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/events/acceleration.js:283"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/events/acceleration.js:350"
},
{
"message": "unknown tag: alt",
- "line": " src/events/acceleration.js:280"
+ "line": " src/events/acceleration.js:393"
},
{
"message": "unknown tag: alt",
- "line": " src/events/acceleration.js:372"
+ "line": " src/events/acceleration.js:437"
},
{
"message": "unknown tag: alt",
- "line": " src/events/acceleration.js:403"
+ "line": " src/events/acceleration.js:468"
},
{
"message": "unknown tag: alt",
- "line": " src/events/acceleration.js:462"
+ "line": " src/events/acceleration.js:527"
},
{
"message": "unknown tag: alt",
@@ -23380,43 +25458,43 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/events/keyboard.js:46"
+ "line": " src/events/keyboard.js:45"
},
{
"message": "unknown tag: alt",
- "line": " src/events/keyboard.js:75"
+ "line": " src/events/keyboard.js:74"
},
{
"message": "unknown tag: alt",
- "line": " src/events/keyboard.js:108"
+ "line": " src/events/keyboard.js:107"
},
{
"message": "unknown tag: alt",
- "line": " src/events/keyboard.js:198"
+ "line": " src/events/keyboard.js:194"
},
{
"message": "unknown tag: alt",
- "line": " src/events/keyboard.js:254"
+ "line": " src/events/keyboard.js:246"
},
{
"message": "unknown tag: alt",
- "line": " src/events/keyboard.js:317"
+ "line": " src/events/keyboard.js:310"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:23"
+ "line": " src/events/mouse.js:22"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:49"
+ "line": " src/events/mouse.js:48"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:75"
+ "line": " src/events/mouse.js:74"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:107"
+ "line": " src/events/mouse.js:106"
},
{
"message": "unknown tag: alt",
@@ -23424,75 +25502,79 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:175"
+ "line": " src/events/mouse.js:174"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:213"
+ "line": " src/events/mouse.js:211"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:255"
+ "line": " src/events/mouse.js:252"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:298"
+ "line": " src/events/mouse.js:294"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:334"
+ "line": " src/events/mouse.js:333"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:416"
+ "line": " src/events/mouse.js:424"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:460"
+ "line": " src/events/mouse.js:468"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:531"
+ "line": " src/events/mouse.js:538"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:597"
+ "line": " src/events/mouse.js:604"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:664"
+ "line": " src/events/mouse.js:671"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:723"
+ "line": " src/events/mouse.js:730"
},
{
"message": "unknown tag: alt",
- "line": " src/events/mouse.js:781"
+ "line": " src/events/mouse.js:804"
},
{
"message": "unknown tag: alt",
- "line": " src/events/touch.js:53"
+ "line": " src/events/touch.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/events/touch.js:116"
+ "line": " src/events/touch.js:74"
},
{
"message": "unknown tag: alt",
- "line": " src/events/touch.js:178"
+ "line": " src/events/touch.js:138"
},
{
"message": "unknown tag: alt",
- "line": " src/image/image.js:24"
+ "line": " src/events/touch.js:200"
},
{
"message": "unknown tag: alt",
- "line": " src/image/image.js:115"
+ "line": " src/image/image.js:22"
},
{
"message": "unknown tag: alt",
- "line": " src/image/image.js:233"
+ "line": " src/image/image.js:102"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/image/image.js:195"
},
{
"message": "unknown tag: alt",
@@ -23500,7 +25582,7 @@ module.exports={
},
{
"message": "replacing incorrect tag: returns with return",
- "line": " src/image/loading_displaying.js:107"
+ "line": " src/image/loading_displaying.js:108"
},
{
"message": "unknown tag: alt",
@@ -23508,67 +25590,67 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/image/loading_displaying.js:325"
+ "line": " src/image/loading_displaying.js:296"
},
{
"message": "unknown tag: alt",
- "line": " src/image/loading_displaying.js:384"
+ "line": " src/image/loading_displaying.js:396"
},
{
"message": "unknown tag: alt",
- "line": " src/image/loading_displaying.js:449"
+ "line": " src/image/loading_displaying.js:462"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:45"
+ "line": " src/image/p5.Image.js:90"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:72"
+ "line": " src/image/p5.Image.js:117"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:106"
+ "line": " src/image/p5.Image.js:152"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:186"
+ "line": " src/image/p5.Image.js:231"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:236"
+ "line": " src/image/p5.Image.js:267"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:270"
+ "line": " src/image/p5.Image.js:315"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:315"
+ "line": " src/image/p5.Image.js:360"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:353"
+ "line": " src/image/p5.Image.js:398"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:435"
+ "line": " src/image/p5.Image.js:483"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:480"
+ "line": " src/image/p5.Image.js:564"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:543"
+ "line": " src/image/p5.Image.js:627"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:577"
+ "line": " src/image/p5.Image.js:663"
},
{
"message": "unknown tag: alt",
- "line": " src/image/p5.Image.js:684"
+ "line": " src/image/p5.Image.js:785"
},
{
"message": "unknown tag: alt",
@@ -23580,27 +25662,27 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/image/pixels.js:165"
+ "line": " src/image/pixels.js:177"
},
{
"message": "unknown tag: alt",
- "line": " src/image/pixels.js:212"
+ "line": " src/image/pixels.js:236"
},
{
"message": "unknown tag: alt",
- "line": " src/image/pixels.js:390"
+ "line": " src/image/pixels.js:415"
},
{
"message": "unknown tag: alt",
- "line": " src/image/pixels.js:461"
+ "line": " src/image/pixels.js:494"
},
{
"message": "unknown tag: alt",
- "line": " src/image/pixels.js:498"
+ "line": " src/image/pixels.js:531"
},
{
"message": "unknown tag: alt",
- "line": " src/image/pixels.js:572"
+ "line": " src/image/pixels.js:605"
},
{
"message": "unknown tag: alt",
@@ -23608,43 +25690,51 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/io/files.js:145"
+ "line": " src/io/files.js:180"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/io/files.js:293"
},
{
"message": "unknown tag: alt",
- "line": " src/io/files.js:237"
+ "line": " src/io/files.js:626"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/io/files.js:737"
},
{
"message": "unknown tag: alt",
- "line": " src/io/files.js:558"
+ "line": " src/io/files.js:737"
},
{
"message": "unknown tag: alt",
- "line": " src/io/files.js:1194"
+ "line": " src/io/files.js:1530"
},
{
"message": "unknown tag: alt",
- "line": " src/io/files.js:1248"
+ "line": " src/io/files.js:1582"
},
{
"message": "unknown tag: alt",
- "line": " src/io/files.js:1306"
+ "line": " src/io/files.js:1644"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:58"
+ "line": " src/io/p5.Table.js:56"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:121"
+ "line": " src/io/p5.Table.js:120"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:170"
+ "line": " src/io/p5.Table.js:168"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:215"
+ "line": " src/io/p5.Table.js:214"
},
{
"message": "unknown tag: alt",
@@ -23652,431 +25742,595 @@ module.exports={
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:329"
+ "line": " src/io/p5.Table.js:328"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:498"
+ "line": " src/io/p5.Table.js:523"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:551"
+ "line": " src/io/p5.Table.js:576"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:593"
+ "line": " src/io/p5.Table.js:618"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:757"
+ "line": " src/io/p5.Table.js:879"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:826"
+ "line": " src/io/p5.Table.js:944"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:875"
+ "line": " src/io/p5.Table.js:994"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:937"
+ "line": " src/io/p5.Table.js:1040"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:984"
+ "line": " src/io/p5.Table.js:1085"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:1029"
+ "line": " src/io/p5.Table.js:1132"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.Table.js:1077"
+ "line": " src/io/p5.Table.js:1177"
},
{
"message": "unknown tag: alt",
- "line": " src/io/p5.XML.js:11"
+ "line": " src/io/p5.Table.js:1230"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:12"
+ "line": " src/io/p5.Table.js:1296"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:36"
+ "line": " src/io/p5.TableRow.js:42"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:76"
+ "line": " src/io/p5.TableRow.js:106"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:130"
+ "line": " src/io/p5.TableRow.js:150"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:184"
+ "line": " src/io/p5.TableRow.js:195"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:234"
+ "line": " src/io/p5.TableRow.js:243"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:273"
+ "line": " src/io/p5.TableRow.js:299"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:317"
+ "line": " src/io/p5.XML.js:11"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:371"
+ "line": " src/math/calculation.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:409"
+ "line": " src/math/calculation.js:36"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:464"
+ "line": " src/math/calculation.js:76"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:507"
+ "line": " src/math/calculation.js:121"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:550"
+ "line": " src/math/calculation.js:190"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:602"
+ "line": " src/math/calculation.js:240"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:636"
+ "line": " src/math/calculation.js:279"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:675"
+ "line": " src/math/calculation.js:324"
},
{
"message": "unknown tag: alt",
- "line": " src/math/calculation.js:720"
+ "line": " src/math/calculation.js:379"
},
{
"message": "unknown tag: alt",
- "line": " src/math/noise.js:41"
+ "line": " src/math/calculation.js:418"
},
{
"message": "unknown tag: alt",
- "line": " src/math/noise.js:171"
+ "line": " src/math/calculation.js:474"
},
{
"message": "unknown tag: alt",
- "line": " src/math/noise.js:233"
+ "line": " src/math/calculation.js:524"
},
{
"message": "unknown tag: alt",
- "line": " src/math/p5.Vector.js:13"
+ "line": " src/math/calculation.js:574"
},
{
"message": "unknown tag: alt",
- "line": " src/math/random.js:47"
+ "line": " src/math/calculation.js:627"
},
{
"message": "unknown tag: alt",
- "line": " src/math/random.js:78"
+ "line": " src/math/calculation.js:661"
},
{
"message": "unknown tag: alt",
- "line": " src/math/random.js:168"
+ "line": " src/math/calculation.js:700"
},
{
"message": "unknown tag: alt",
- "line": " src/math/trigonometry.js:134"
+ "line": " src/math/calculation.js:747"
},
{
"message": "unknown tag: alt",
- "line": " src/math/trigonometry.js:174"
+ "line": " src/math/math.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/math/trigonometry.js:206"
+ "line": " src/math/noise.js:40"
},
{
"message": "unknown tag: alt",
- "line": " src/math/trigonometry.js:238"
+ "line": " src/math/noise.js:187"
},
{
"message": "unknown tag: alt",
- "line": " src/math/trigonometry.js:320"
+ "line": " src/math/noise.js:253"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/attributes.js:13"
+ "line": " src/math/p5.Vector.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/attributes.js:63"
+ "line": " src/math/random.js:48"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/attributes.js:100"
+ "line": " src/math/random.js:79"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/attributes.js:133"
+ "line": " src/math/random.js:166"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/attributes.js:158"
+ "line": " src/math/trigonometry.js:124"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/loading_displaying.js:16"
+ "line": " src/math/trigonometry.js:160"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/loading_displaying.js:135"
+ "line": " src/math/trigonometry.js:188"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/loading_displaying.js:197"
+ "line": " src/math/trigonometry.js:216"
},
{
"message": "unknown tag: alt",
- "line": " src/typography/p5.Font.js:47"
+ "line": " src/math/trigonometry.js:296"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/math/trigonometry.js:332"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/math/trigonometry.js:347"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/math/trigonometry.js:362"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/conversion.js:12"
+ "line": " src/typography/attributes.js:13"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:15"
+ "line": " src/typography/attributes.js:84"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:44"
+ "line": " src/typography/attributes.js:122"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:146"
+ "line": " src/typography/attributes.js:154"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:257"
+ "line": " src/typography/attributes.js:189"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:339"
+ "line": " src/typography/loading_displaying.js:16"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:404"
+ "line": " src/typography/loading_displaying.js:143"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:454"
+ "line": " src/typography/loading_displaying.js:230"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/string_functions.js:550"
+ "line": " src/typography/p5.Font.js:43"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:12"
+ "line": " src/utilities/conversion.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:34"
+ "line": " src/utilities/string_functions.js:15"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:56"
+ "line": " src/utilities/string_functions.js:44"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:78"
+ "line": " src/utilities/string_functions.js:132"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:101"
+ "line": " src/utilities/string_functions.js:237"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:123"
+ "line": " src/utilities/string_functions.js:313"
},
{
"message": "unknown tag: alt",
- "line": " src/utilities/time_date.js:145"
+ "line": " src/utilities/string_functions.js:375"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/camera.js:12"
+ "line": " src/utilities/string_functions.js:437"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/camera.js:160"
+ "line": " src/utilities/string_functions.js:526"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/camera.js:232"
+ "line": " src/utilities/time_date.js:12"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/light.js:40"
+ "line": " src/utilities/time_date.js:34"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/light.js:89"
+ "line": " src/utilities/time_date.js:56"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/light.js:168"
+ "line": " src/utilities/time_date.js:78"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/loading.js:35"
+ "line": " src/utilities/time_date.js:101"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/loading.js:197"
+ "line": " src/utilities/time_date.js:123"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/material.js:81"
+ "line": " src/utilities/time_date.js:145"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/material.js:113"
+ "line": " src/webgl/3d_primitives.js:15"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/material.js:210"
+ "line": " src/webgl/interaction.js:13"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/material.js:253"
+ "line": " src/webgl/interaction.js:146"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/p5.RendererGL.js:352"
+ "line": " src/webgl/interaction.js:146"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/p5.RendererGL.js:400"
+ "line": " src/webgl/interaction.js:146"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/p5.RendererGL.js:431"
+ "line": " src/webgl/interaction.js:146"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/p5.RendererGL.js:460"
+ "line": " src/webgl/interaction.js:146"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/p5.RendererGL.js:505"
+ "line": " src/webgl/interaction.js:380"
},
{
"message": "unknown tag: alt",
- "line": " src/webgl/primitives.js:13"
+ "line": " src/webgl/light.js:12"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/light.js:101"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/light.js:212"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/loading.js:14"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/loading.js:14"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/loading.js:244"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/material.js:14"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/webgl/material.js:83"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/material.js:83"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/material.js:176"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/material.js:211"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/material.js:301"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/material.js:350"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:15"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:61"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:126"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:209"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:487"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:546"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:604"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:752"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:824"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.Camera.js:1089"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.RendererGL.js:215"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.RendererGL.js:427"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.RendererGL.js:474"
+ },
+ {
+ "message": "unknown tag: alt",
+ "line": " src/webgl/p5.RendererGL.js:515"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:117"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/webgl/text.js:160"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:193"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:205"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:235"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:249"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:387"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " src/webgl/text.js:387"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:457"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:472"
+ },
+ {
+ "message": "replacing incorrect tag: function with method",
+ "line": " src/webgl/text.js:547"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " lib/addons/p5.dom.js:1368"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " lib/addons/p5.dom.js:1470"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " lib/addons/p5.dom.js:1509"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " lib/addons/p5.dom.js:1603"
},
{
"message": "replacing incorrect tag: params with param",
- "line": " lib/addons/p5.sound.js:1577"
+ "line": " lib/addons/p5.sound.js:1642"
+ },
+ {
+ "message": "replacing incorrect tag: returns with return",
+ "line": " lib/addons/p5.sound.js:1642"
},
{
"message": "replacing incorrect tag: returns with return",
- "line": " lib/addons/p5.sound.js:1577"
+ "line": " lib/addons/p5.sound.js:7335"
},
{
"message": "replacing incorrect tag: returns with return",
- "line": " lib/addons/p5.sound.js:8218"
+ "line": " lib/addons/p5.sound.js:9303"
},
{
- "message": "Missing item type\nConversions adapted from .\n\nIn these functions, hue is always in the range [0,1); all other components\nare in the range [0,1]. 'Brightness' and 'value' are used interchangeably.",
+ "message": "Missing item type\nConversions adapted from .\n\nIn these functions, hue is always in the range [0, 1], just like all other\ncomponents are in the range [0, 1]. 'Brightness' and 'value' are used\ninterchangeably.",
"line": " src/color/color_conversion.js:10"
},
{
"message": "Missing item type\nConvert an HSBA array to HSLA.",
- "line": " src/color/color_conversion.js:20"
+ "line": " src/color/color_conversion.js:21"
},
{
"message": "Missing item type\nConvert an HSBA array to RGBA.",
- "line": " src/color/color_conversion.js:46"
+ "line": " src/color/color_conversion.js:47"
},
{
"message": "Missing item type\nConvert an HSLA array to HSBA.",
- "line": " src/color/color_conversion.js:95"
+ "line": " src/color/color_conversion.js:102"
},
{
"message": "Missing item type\nConvert an HSLA array to RGBA.\n\nWe need to change basis from HSLA to something that can be more easily be\nprojected onto RGBA. We will choose hue and brightness as our first two\ncomponents, and pick a convenient third one ('zest') so that we don't need\nto calculate formal HSBA saturation.",
- "line": " src/color/color_conversion.js:118"
+ "line": " src/color/color_conversion.js:125"
},
{
"message": "Missing item type\nConvert an RGBA array to HSBA.",
- "line": " src/color/color_conversion.js:176"
+ "line": " src/color/color_conversion.js:189"
},
{
"message": "Missing item type\nConvert an RGBA array to HSLA.",
- "line": " src/color/color_conversion.js:211"
+ "line": " src/color/color_conversion.js:228"
},
{
"message": "Missing item type\nHue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.",
- "line": " src/color/p5.Color.js:118"
+ "line": " src/color/p5.Color.js:410"
},
{
"message": "Missing item type\nSaturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.",
- "line": " src/color/p5.Color.js:149"
+ "line": " src/color/p5.Color.js:441"
},
{
"message": "Missing item type\nCSS named colors.",
- "line": " src/color/p5.Color.js:168"
+ "line": " src/color/p5.Color.js:460"
},
{
"message": "Missing item type\nThese regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.\n\nNote that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.",
- "line": " src/color/p5.Color.js:321"
+ "line": " src/color/p5.Color.js:613"
},
{
"message": "Missing item type\nFull color string patterns. The capture groups are necessary.",
- "line": " src/color/p5.Color.js:334"
+ "line": " src/color/p5.Color.js:626"
},
{
"message": "Missing item type\nFor a number of different inputs, returns a color formatted as [r, g, b, a]\narrays, with each component normalized between 0 and 1.",
- "line": " src/color/p5.Color.js:447"
+ "line": " src/color/p5.Color.js:763"
},
{
"message": "Missing item type\nFor HSB and HSL, interpret the gray level as a brightness/lightness\nvalue (they are equivalent when chroma is zero). For RGB, normalize the\ngray level according to the blue maximum.",
- "line": " src/color/p5.Color.js:638"
- },
- {
- "message": "Missing item type",
- "line": " src/core/canvas.js:1"
- },
- {
- "message": "Missing item type\nThis is the p5 instance constructor.\n\nA p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.\n\nA p5 sketch can run in \"global\" or \"instance\" mode:\n\"global\" - all properties and methods are attached to the window\n\"instance\" - all properties and methods are bound to this p5 object",
- "line": " src/core/core.js:15"
- },
- {
- "message": "Missing item type\nSets the resolution at which Beziers display.\n\nThe default value is 20.",
- "line": " src/core/curves.js:99"
- },
- {
- "message": "Missing item type\nSets the resolution at which curves display.\n\nThe default value is 20.",
- "line": " src/core/curves.js:353"
+ "line": " src/color/p5.Color.js:989"
},
{
"message": "Missing item type\nReturns the current framerate.",
- "line": " src/core/environment.js:238"
+ "line": " src/core/environment.js:242"
},
{
- "message": "Missing item type\nSpecifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second.\n\nCalling frameRate() with no arguments returns the current framerate.",
- "line": " src/core/environment.js:247"
+ "message": "Missing item type\nSpecifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second.\n\nCalling frameRate() with no arguments returns the current framerate.",
+ "line": " src/core/environment.js:252"
},
{
"message": "Missing item type",
@@ -24084,35 +26338,43 @@ module.exports={
},
{
"message": "Missing item type\nPrints out a fancy, colorful message to the console log",
- "line": " src/core/error_helpers.js:34"
+ "line": " src/core/error_helpers.js:65"
},
{
"message": "Missing item type\nValidates parameters\nparam {String} func the name of the function\nparam {Array} args user input arguments\n\nexample:\n var a;\n ellipse(10,10,a,5);\nconsole ouput:\n \"It looks like ellipse received an empty variable in spot #2.\"\n\nexample:\n ellipse(10,\"foo\",5,5);\nconsole output:\n \"ellipse was expecting a number for parameter #1,\n received \"foo\" instead.\"",
- "line": " src/core/error_helpers.js:106"
+ "line": " src/core/error_helpers.js:563"
},
{
"message": "Missing item type\nPrints out all the colors in the color pallete with white text.\nFor color blindness testing.",
- "line": " src/core/error_helpers.js:273"
+ "line": " src/core/error_helpers.js:624"
+ },
+ {
+ "message": "Missing item type",
+ "line": " src/core/helpers.js:1"
},
{
"message": "Missing item type\n_globalInit\n\nTODO: ???\nif sketch is on window\nassume \"global\" mode\nand instantiate p5 automatically\notherwise do nothing",
"line": " src/core/init.js:5"
},
+ {
+ "message": "Missing item type",
+ "line": " src/core/legacy.js:1"
+ },
{
"message": "Missing item type\nHelper fxn for sharing pixel methods",
- "line": " src/core/p5.Element.js:1031"
+ "line": " src/core/p5.Element.js:1088"
},
{
"message": "Missing item type\nResize our canvas element.",
- "line": " src/core/p5.Renderer.js:72"
+ "line": " src/core/p5.Renderer.js:96"
},
{
"message": "Missing item type\nHelper fxn to check font type (system or otf)",
- "line": " src/core/p5.Renderer.js:146"
+ "line": " src/core/p5.Renderer.js:300"
},
{
"message": "Missing item type\nHelper fxn to measure ascent and descent.\nAdapted from http://stackoverflow.com/a/25355178",
- "line": " src/core/p5.Renderer.js:202"
+ "line": " src/core/p5.Renderer.js:353"
},
{
"message": "Missing item type\np5.Renderer2D\nThe 2D graphics canvas renderer class.\nextends p5.Renderer",
@@ -24120,31 +26382,35 @@ module.exports={
},
{
"message": "Missing item type\nGenerate a cubic Bezier representing an arc on the unit circle of total\nangle `size` radians, beginning `start` radians above the x-axis. Up to\nfour of these curves are combined to make a full arc.\n\nSee www.joecridge.me/bezier.pdf for an explanation of the method.",
- "line": " src/core/p5.Renderer2D.js:356"
+ "line": " src/core/p5.Renderer2D.js:414"
},
{
"message": "Missing item type\nshim for Uint8ClampedArray.slice\n(allows arrayCopy to work with pixels[])\nwith thanks to http://halfpapstudios.com/blog/tag/html5-canvas/\nEnumerable set to false to protect for...in from\nUint8ClampedArray.prototype pollution.",
- "line": " src/core/shim.js:65"
+ "line": " src/core/shim.js:23"
+ },
+ {
+ "message": "Missing item type\nthis is implementation of Object.assign() which is unavailable in\nIE11 and (non-Chrome) Android browsers.\nThe assign() method is used to copy the values of all enumerable\nown properties from one or more source objects to a target object.\nIt will return the target object.\nModified from https://github.com/ljharb/object.assign",
+ "line": " src/core/shim.js:45"
},
{
- "message": "Missing item type\nprivate helper function to handle the user passing objects in\nduring construction or calls to create()",
- "line": " src/data/p5.TypedDict.js:179"
+ "message": "Missing item type\nprivate helper function to handle the user passing in objects\nduring construction or calls to create()",
+ "line": " src/data/p5.TypedDict.js:203"
},
{
"message": "Missing item type\nprivate helper function to ensure that the user passed in valid\nvalues for the Dictionary type",
- "line": " src/data/p5.TypedDict.js:321"
+ "line": " src/data/p5.TypedDict.js:382"
},
{
"message": "Missing item type\nprivate helper function to ensure that the user passed in valid\nvalues for the Dictionary type",
- "line": " src/data/p5.TypedDict.js:368"
+ "line": " src/data/p5.TypedDict.js:425"
},
{
"message": "Missing item type\nprivate helper function for finding lowest or highest value\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'",
- "line": " src/data/p5.TypedDict.js:485"
+ "line": " src/data/p5.TypedDict.js:542"
},
{
"message": "Missing item type\nprivate helper function for finding lowest or highest key\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'",
- "line": " src/data/p5.TypedDict.js:548"
+ "line": " src/data/p5.TypedDict.js:609"
},
{
"message": "Missing item type\n_updatePAccelerations updates the pAcceleration values",
@@ -24156,11 +26422,11 @@ module.exports={
},
{
"message": "Missing item type\nThe onblur function is called when the user is no longer focused\non the p5 element. Because the keyup events will not fire if the user is\nnot focused on the element we must assume all keys currently down have\nbeen released.",
- "line": " src/events/keyboard.js:307"
+ "line": " src/events/keyboard.js:300"
},
{
"message": "Missing item type\nThe checkDownKeys function returns a boolean true if any keys pressed\nand a false if no keys are currently pressed.\n\nHelps avoid instances where a multiple keys are pressed simultaneously and\nreleasing a single key will then switch the\nkeyIsPressed property to true.",
- "line": " src/events/keyboard.js:364"
+ "line": " src/events/keyboard.js:387"
},
{
"message": "Missing item type\nThis module defines the filters for use with image buffers.\n\nThis module is basically a collection of functions stored in an object\nas opposed to modules. The functions are destructive, modifying\nthe passed in canvas rather than creating a copy.\n\nGenerally speaking users of this module will use the Filters.apply method\non a canvas to create an effect.\n\nA number of functions are borrowed/adapted from\nhttp://www.html5rocks.com/en/tutorials/canvas/imagefilters/\nor the java processing implementation.",
@@ -24168,271 +26434,183 @@ module.exports={
},
{
"message": "Missing item type\nReturns the pixel buffer for a canvas",
- "line": " src/image/filters.js:28"
+ "line": " src/image/filters.js:26"
},
{
"message": "Missing item type\nReturns a 32 bit number containing ARGB data at ith pixel in the\n1D array containing pixels data.",
- "line": " src/image/filters.js:51"
+ "line": " src/image/filters.js:46"
},
{
"message": "Missing item type\nModifies pixels RGBA values to values contained in the data object.",
- "line": " src/image/filters.js:70"
+ "line": " src/image/filters.js:67"
},
{
"message": "Missing item type\nReturns the ImageData object for a canvas\nhttps://developer.mozilla.org/en-US/docs/Web/API/ImageData",
- "line": " src/image/filters.js:90"
+ "line": " src/image/filters.js:87"
},
{
"message": "Missing item type\nReturns a blank ImageData object.",
- "line": " src/image/filters.js:113"
+ "line": " src/image/filters.js:107"
},
{
"message": "Missing item type\nApplys a filter function to a canvas.\n\nThe difference between this and the actual filter functions defined below\nis that the filter functions generally modify the pixel buffer but do\nnot actually put that data back to the canvas (where it would actually\nupdate what is visible). By contrast this method does make the changes\nactually visible in the canvas.\n\nThe apply method is the method that callers of this module would generally\nuse. It has been separated from the actual filters to support an advanced\nuse case of creating a filter chain that executes without actually updating\nthe canvas in between everystep.",
- "line": " src/image/filters.js:129"
+ "line": " src/image/filters.js:122"
},
{
"message": "Missing item type\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/",
- "line": " src/image/filters.js:167"
+ "line": " src/image/filters.js:159"
},
{
"message": "Missing item type\nConverts any colors in the image to grayscale equivalents.\nNo parameter is used.\n\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/",
- "line": " src/image/filters.js:202"
+ "line": " src/image/filters.js:193"
},
{
"message": "Missing item type\nSets the alpha channel to entirely opaque. No parameter is used.",
- "line": " src/image/filters.js:224"
+ "line": " src/image/filters.js:216"
},
{
"message": "Missing item type\nSets each pixel to its inverse value. No parameter is used.",
- "line": " src/image/filters.js:239"
+ "line": " src/image/filters.js:232"
},
{
"message": "Missing item type\nLimits each channel of the image to the number of colors specified as\nthe parameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n\nAdapted from java based processing implementation",
- "line": " src/image/filters.js:255"
+ "line": " src/image/filters.js:247"
},
{
"message": "Missing item type\nreduces the bright areas in an image",
- "line": " src/image/filters.js:286"
+ "line": " src/image/filters.js:279"
},
{
"message": "Missing item type\nincreases the bright areas in an image",
"line": " src/image/filters.js:367"
},
{
- "message": "Missing item type\nThis module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.",
+ "message": "Missing item type\nThis module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.",
"line": " src/image/image.js:8"
},
{
"message": "Missing item type\nValidates clipping params. Per drawImage spec sWidth and sHight cannot be\nnegative or greater than image intrinsic width and height",
- "line": " src/image/loading_displaying.js:107"
+ "line": " src/image/loading_displaying.js:108"
},
{
"message": "Missing item type\nApply the current tint color to the input image, return the resulting\ncanvas.",
- "line": " src/image/loading_displaying.js:413"
+ "line": " src/image/loading_displaying.js:425"
},
{
- "message": "Missing item type\nThis module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.",
+ "message": "Missing item type\nThis module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.",
"line": " src/image/p5.Image.js:9"
},
{
"message": "Missing item type\nHelper fxn for sharing pixel methods",
- "line": " src/image/p5.Image.js:177"
- },
- {
- "message": "Missing item type\nGenerate a blob of file data as a url to prepare for download.\nAccepts an array of data, a filename, and an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.",
- "line": " src/io/files.js:1433"
+ "line": " src/image/p5.Image.js:222"
},
{
- "message": "Missing item type\nForces download. Accepts a url to filedata/blob, a filename,\nand an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.",
- "line": " src/io/files.js:1456"
+ "message": "Missing item type\nGenerate a blob of file data as a url to prepare for download.\nAccepts an array of data, a filename, and an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.",
+ "line": " src/io/files.js:1770"
},
{
"message": "Missing item type\nReturns a file extension, or another string\nif the provided parameter has no extension.",
- "line": " src/io/files.js:1496"
+ "line": " src/io/files.js:1839"
},
{
"message": "Missing item type\nReturns true if the browser is Safari, false if not.\nSafari makes trouble for downloading files.",
- "line": " src/io/files.js:1528"
+ "line": " src/io/files.js:1872"
},
{
"message": "Missing item type\nHelper function, a callback for download that deletes\nan invisible anchor element from the DOM once the file\nhas been automatically downloaded.",
- "line": " src/io/files.js:1540"
- },
- {
- "message": "Missing item type\nTable Options\nGeneric class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.
\nCSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.
\nFile names should end with .csv if they're comma separated.
\nA rough \"spec\" for CSV can be found\nhere.
\nTo load files, use the loadTable method.
\nTo save tables to your computer, use the save method\n or the saveTable method.
\n\nPossible options include:\n\n- csv - parse the table as comma-separated values\n
- tsv - parse the table as tab-separated values\n
- header - this table has a header (title) row\n
",
- "line": " src/io/p5.Table.js:12"
+ "line": " src/io/files.js:1884"
},
{
- "message": "Missing item type\nReturns the total number of columns in a Table.",
- "line": " src/io/p5.Table.js:644"
+ "message": "Missing item type\nTable Options\nGeneric class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.
\nCSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.
\nFile names should end with .csv if they're comma separated.
\nA rough \"spec\" for CSV can be found\nhere.
\nTo load files, use the loadTable method.
\nTo save tables to your computer, use the save method\n or the saveTable method.
\n\nPossible options include:\n\n- csv - parse the table as comma-separated values\n
- tsv - parse the table as tab-separated values\n
- header - this table has a header (title) row\n
",
+ "line": " src/io/p5.Table.js:11"
},
{
"message": "Missing item type\nThis method is called while the parsing of XML (when loadXML() is\ncalled). The difference between this method and the setContent()\nmethod defined later is that this one is used to set the content\nwhen the node in question has more nodes under it and so on and\nnot directly text content. While in the other one is used when\nthe node in question directly has text inside it.",
- "line": " src/io/p5.XML.js:767"
+ "line": " src/io/p5.XML.js:801"
},
{
- "message": "Missing item type\nThis method is called while the parsing of XML (when loadXML() is\ncalled). The XML node is passed and its attributes are stored in the\np5.XML's attribute Object.",
- "line": " src/io/p5.XML.js:784"
+ "message": "Missing item type\nThis method is called while the parsing of XML (when loadXML() is\ncalled). The XML node is passed and its attributes are stored in the\np5.XML's attribute Object.",
+ "line": " src/io/p5.XML.js:818"
},
{
"message": "Missing item type\nMultiplies a vector by a scalar and returns a new vector.",
- "line": " src/math/p5.Vector.js:963"
+ "line": " src/math/p5.Vector.js:1611"
},
{
"message": "Missing item type\nDivides a vector by a scalar and returns a new vector.",
- "line": " src/math/p5.Vector.js:990"
+ "line": " src/math/p5.Vector.js:1638"
},
{
"message": "Missing item type\nCalculates the dot product of two vectors.",
- "line": " src/math/p5.Vector.js:1018"
+ "line": " src/math/p5.Vector.js:1665"
},
{
"message": "Missing item type\nCalculates the cross product of two vectors.",
- "line": " src/math/p5.Vector.js:1032"
+ "line": " src/math/p5.Vector.js:1679"
},
{
"message": "Missing item type\nCalculates the Euclidean distance between two points (considering a\npoint as a vector object).",
- "line": " src/math/p5.Vector.js:1046"
+ "line": " src/math/p5.Vector.js:1693"
},
{
"message": "Missing item type\nLinear interpolate a vector to another vector and return the result as a\nnew vector.",
- "line": " src/math/p5.Vector.js:1061"
+ "line": " src/math/p5.Vector.js:1708"
},
{
"message": "Missing item type\nHelper function to measure ascent and descent.",
- "line": " src/typography/attributes.js:248"
+ "line": " src/typography/attributes.js:282"
},
{
"message": "Missing item type\nReturns the set of opentype glyphs for the supplied string.\n\nNote that there is not a strict one-to-one mapping between characters\nand glyphs, so the list of returned glyphs can be larger or smaller\n than the length of the given string.",
- "line": " src/typography/p5.Font.js:206"
+ "line": " src/typography/p5.Font.js:256"
},
{
"message": "Missing item type\nReturns an opentype path for the supplied string and position.",
- "line": " src/typography/p5.Font.js:221"
+ "line": " src/typography/p5.Font.js:271"
},
{
- "message": "Missing item type\nParse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:\n\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5\n\nf 4 3 2 1",
- "line": " src/webgl/loading.js:98"
+ "message": "Missing item type",
+ "line": " src/webgl/3d_primitives.js:259"
},
{
- "message": "Missing item type",
- "line": " src/webgl/material.js:297"
+ "message": "Missing item type\nDraws a point, a coordinate in space at the dimension of one pixel,\ngiven x, y and z coordinates. The color of the point is determined\nby the current stroke, while the point size is determined by current\nstroke weight.",
+ "line": " src/webgl/3d_primitives.js:745"
},
{
- "message": "Missing item type\ncomputes smooth normals per vertex as an average of each\nface.",
- "line": " src/webgl/p5.Geometry.js:86"
+ "message": "Missing item type\nDraw a line given two points",
+ "line": " src/webgl/3d_primitives.js:1162"
},
{
- "message": "Missing item type\nAverages the vertex normals. Used in curved\nsurfaces",
- "line": " src/webgl/p5.Geometry.js:111"
+ "message": "Missing item type\nParse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:\n\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5\n\nf 4 3 2 1",
+ "line": " src/webgl/loading.js:135"
},
{
- "message": "Missing item type\nAverages pole normals. Used in spherical primitives",
- "line": " src/webgl/p5.Geometry.js:130"
+ "message": "Missing item type",
+ "line": " src/webgl/material.js:399"
},
{
"message": "Missing item type\nCreate a 2D array for establishing stroke connections",
- "line": " src/webgl/p5.Geometry.js:161"
+ "line": " src/webgl/p5.Geometry.js:190"
},
{
"message": "Missing item type\nCreate 4 vertices for each stroke line, two at the beginning position\nand two at the end position. These vertices are displaced relative to\nthat line's normal on the GPU",
- "line": " src/webgl/p5.Geometry.js:182"
- },
- {
- "message": "Missing item type\nModifies all vertices to be centered within the range -100 to 100.",
- "line": " src/webgl/p5.Geometry.js:209"
+ "line": " src/webgl/p5.Geometry.js:211"
},
{
"message": "Missing item type",
"line": " src/webgl/p5.Matrix.js:1"
},
- {
- "message": "Missing item type\nA class to describe a 4x4 matrix\nfor model and view matrix manipulation in the p5js webgl renderer.\nclass p5.Matrix",
- "line": " src/webgl/p5.Matrix.js:19"
- },
- {
- "message": "Missing item type\nSets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Matrix, or the values from a float array.",
- "line": " src/webgl/p5.Matrix.js:75"
- },
- {
- "message": "Missing item type\nGets a copy of the vector, returns a p5.Matrix object.",
- "line": " src/webgl/p5.Matrix.js:113"
- },
- {
- "message": "Missing item type\nreturn a copy of a matrix",
- "line": " src/webgl/p5.Matrix.js:122"
- },
- {
- "message": "Missing item type\nreturn an identity matrix",
- "line": " src/webgl/p5.Matrix.js:147"
- },
- {
- "message": "Missing item type\ntranspose according to a given matrix",
- "line": " src/webgl/p5.Matrix.js:155"
- },
- {
- "message": "Missing item type\ninvert matrix according to a give matrix",
- "line": " src/webgl/p5.Matrix.js:215"
- },
- {
- "message": "Missing item type\nInverts a 3x3 matrix",
- "line": " src/webgl/p5.Matrix.js:300"
- },
- {
- "message": "Missing item type\ntransposes a 3x3 p5.Matrix by a mat3",
- "line": " src/webgl/p5.Matrix.js:336"
- },
- {
- "message": "Missing item type\nconverts a 4x4 matrix to its 3x3 inverse tranform\ncommonly used in MVMatrix to NMatrix conversions.",
- "line": " src/webgl/p5.Matrix.js:352"
- },
- {
- "message": "Missing item type\ninspired by Toji's mat4 determinant",
- "line": " src/webgl/p5.Matrix.js:380"
- },
- {
- "message": "Missing item type\nmultiply two mat4s",
- "line": " src/webgl/p5.Matrix.js:403"
- },
- {
- "message": "Missing item type\nscales a p5.Matrix by scalars or a vector",
- "line": " src/webgl/p5.Matrix.js:460"
- },
- {
- "message": "Missing item type\nrotate our Matrix around an axis by the given angle.",
- "line": " src/webgl/p5.Matrix.js:505"
- },
- {
- "message": "Missing item type",
- "line": " src/webgl/p5.Matrix.js:584"
- },
- {
- "message": "Missing item type\nsets the perspective matrix",
- "line": " src/webgl/p5.Matrix.js:614"
- },
- {
- "message": "Missing item type\nsets the ortho matrix",
- "line": " src/webgl/p5.Matrix.js:648"
- },
{
"message": "Missing item type\nPRIVATE",
- "line": " src/webgl/p5.Matrix.js:683"
+ "line": " src/webgl/p5.Matrix.js:673"
},
{
- "message": "Missing item type\nWelcome to RendererGL Immediate Mode.\nImmediate mode is used for drawing custom shapes\nfrom a set of vertices. Immediate Mode is activated\nwhen you call beginShape() & de-activated when you call endShape().\nImmediate mode is a style of programming borrowed\nfrom OpenGL's (now-deprecated) immediate mode.\nIt differs from p5.js' default, Retained Mode, which caches\ngeometries and buffers on the CPU to reduce the number of webgl\ndraw calls. Retained mode is more efficient & performative,\nhowever, Immediate Mode is useful for sketching quick\ngeometric ideas.",
+ "message": "Missing item type\nWelcome to RendererGL Immediate Mode.\nImmediate mode is used for drawing custom shapes\nfrom a set of vertices. Immediate Mode is activated\nwhen you call beginShape() & de-activated when you call endShape().\nImmediate mode is a style of programming borrowed\nfrom OpenGL's (now-deprecated) immediate mode.\nIt differs from p5.js' default, Retained Mode, which caches\ngeometries and buffers on the CPU to reduce the number of webgl\ndraw calls. Retained mode is more efficient & performative,\nhowever, Immediate Mode is useful for sketching quick\ngeometric ideas.",
"line": " src/webgl/p5.RendererGL.Immediate.js:1"
},
- {
- "message": "Missing item type\nBegin shape drawing. This is a helpful way of generating\ncustom shapes quickly. However in WEBGL mode, application\nperformance will likely drop as a result of too many calls to\nbeginShape() / endShape(). As a high performance alternative,\nplease use p5.js geometry primitives.",
- "line": " src/webgl/p5.RendererGL.Immediate.js:19"
- },
- {
- "message": "Missing item type\nadds a vertex to be drawn in a custom Shape.",
- "line": " src/webgl/p5.RendererGL.Immediate.js:60"
- },
{
"message": "Missing item type\nEnd shape drawing and render vertices to screen.",
- "line": " src/webgl/p5.RendererGL.Immediate.js:103"
+ "line": " src/webgl/p5.RendererGL.Immediate.js:118"
},
{
"message": "Missing item type\ninitializes buffer defaults. runs each time a new geometry is\nregistered",
@@ -24440,103 +26618,87 @@ module.exports={
},
{
"message": "Missing item type\ncreateBuffers description",
- "line": " src/webgl/p5.RendererGL.Retained.js:33"
+ "line": " src/webgl/p5.RendererGL.Retained.js:47"
},
{
"message": "Missing item type\nDraws buffers given a geometry key ID",
- "line": " src/webgl/p5.RendererGL.Retained.js:84"
+ "line": " src/webgl/p5.RendererGL.Retained.js:191"
},
{
"message": "Missing item type\nmodel view, projection, & normal\nmatrices",
- "line": " src/webgl/p5.RendererGL.js:69"
+ "line": " src/webgl/p5.RendererGL.js:83"
},
{
"message": "Missing item type\n[background description]",
- "line": " src/webgl/p5.RendererGL.js:331"
+ "line": " src/webgl/p5.RendererGL.js:405"
},
{
"message": "Missing item type\n[resize description]",
- "line": " src/webgl/p5.RendererGL.js:642"
+ "line": " src/webgl/p5.RendererGL.js:644"
},
{
"message": "Missing item type\nclears color and depth buffers\nwith r,g,b,a",
- "line": " src/webgl/p5.RendererGL.js:659"
+ "line": " src/webgl/p5.RendererGL.js:670"
},
{
"message": "Missing item type\n[translate description]",
- "line": " src/webgl/p5.RendererGL.js:675"
+ "line": " src/webgl/p5.RendererGL.js:688"
},
{
"message": "Missing item type\nScales the Model View Matrix by a vector",
- "line": " src/webgl/p5.RendererGL.js:693"
- },
- {
- "message": "Missing item type\npushes a copy of the model view matrix onto the\nMV Matrix stack.",
- "line": " src/webgl/p5.RendererGL.js:725"
- },
- {
- "message": "Missing item type\n[pop description]",
- "line": " src/webgl/p5.RendererGL.js:734"
+ "line": " src/webgl/p5.RendererGL.js:707"
},
{
"message": "Missing item type\nturn a two dimensional array into one dimensional array",
- "line": " src/webgl/p5.RendererGL.js:904"
+ "line": " src/webgl/p5.RendererGL.js:1028"
},
{
"message": "Missing item type\nturn a p5.Vector Array into a one dimensional number array",
- "line": " src/webgl/p5.RendererGL.js:918"
+ "line": " src/webgl/p5.RendererGL.js:1065"
},
{
- "message": "Missing item type",
- "line": " src/webgl/primitives.js:265"
- },
- {
- "message": "Missing item type\nDraw a line given two points",
- "line": " src/webgl/primitives.js:860"
+ "message": "Missing item type\nensures that p5 is using a 3d renderer. throws an error if not.",
+ "line": " src/webgl/p5.RendererGL.js:1081"
},
{
"message": "Missing item type\nHelper function for select and selectAll",
- "line": " lib/addons/p5.dom.js:156"
+ "line": " lib/addons/p5.dom.js:168"
},
{
"message": "Missing item type\nHelper function for getElement and getElements.",
- "line": " lib/addons/p5.dom.js:172"
+ "line": " lib/addons/p5.dom.js:184"
},
{
"message": "Missing item type\nHelpers for create methods.",
- "line": " lib/addons/p5.dom.js:225"
+ "line": " lib/addons/p5.dom.js:245"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:369"
+ "line": " lib/addons/p5.dom.js:384"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:874"
+ "line": " lib/addons/p5.dom.js:981"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:937"
+ "line": " lib/addons/p5.dom.js:1062"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:965"
- },
- {
- "message": "Missing item type\nCenters a p5 Element either vertically, horizontally,\nor both, relative to its parent or according to\nthe body if the Element has no parent. If no argument is passed\nthe Element is aligned both vertically and horizontally.",
- "line": " lib/addons/p5.dom.js:1223"
+ "line": " lib/addons/p5.dom.js:1102"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:2259"
+ "line": " lib/addons/p5.dom.js:2777"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:2329"
+ "line": " lib/addons/p5.dom.js:2843"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.dom.js:2351"
+ "line": " lib/addons/p5.dom.js:2905"
},
{
"message": "Missing item type\np5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound\n\nFrom the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors\n\nMIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE\n\nSome of the many audio libraries & resources that inspire p5.sound:\n - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js\n - buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/\n - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0\n - wavesurfer.js https://github.com/katspaugh/wavesurfer.js\n - Web Audio Components by Jordan Santell https://github.com/web-audio-components\n - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound\n\n Web Audio API: http://w3.org/TR/webaudio/",
@@ -24544,245 +26706,456 @@ module.exports={
},
{
"message": "Missing item type\nDetermine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats",
- "line": " lib/addons/p5.sound.js:226"
+ "line": " lib/addons/p5.sound.js:214"
},
{
"message": "Missing item type\nMaster contains AudioContext and the master sound output.",
- "line": " lib/addons/p5.sound.js:296"
+ "line": " lib/addons/p5.sound.js:328"
},
{
"message": "Missing item type\na silent connection to the DesinationNode\nwhich will ensure that anything connected to it\nwill not be garbage collected",
- "line": " lib/addons/p5.sound.js:393"
+ "line": " lib/addons/p5.sound.js:423"
},
{
- "message": "Missing item type\nReturns the closest MIDI note value for\na given frequency.",
- "line": " lib/addons/p5.sound.js:425"
+ "message": "Missing item type",
+ "line": " lib/addons/p5.sound.js:439"
},
{
- "message": "Missing item type\nUsed by Osc and Env to chain signal math",
- "line": " lib/addons/p5.sound.js:584"
+ "message": "Missing item type\nUsed by Osc and Envelope to chain signal math",
+ "line": " lib/addons/p5.sound.js:644"
},
{
"message": "Missing item type\nThis is a helper function that the p5.SoundFile calls to load\nitself. Accepts a callback (the name of another function)\nas an optional parameter.",
- "line": " lib/addons/p5.sound.js:917"
- },
- {
- "message": "Missing item type\nSet a p5.SoundFile's looping flag to true or false. If the sound\nis currently playing, this change will take effect when it\nreaches the end of the current playback.",
- "line": " lib/addons/p5.sound.js:1233"
- },
- {
- "message": "Missing item type\nReturns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not.",
- "line": " lib/addons/p5.sound.js:1253"
+ "line": " lib/addons/p5.sound.js:973"
},
{
"message": "Missing item type\nStop playback on all of this soundfile's sources.",
- "line": " lib/addons/p5.sound.js:1311"
- },
- {
- "message": "Missing item type\nReturns the current stereo pan position (-1.0 to 1.0)",
- "line": " lib/addons/p5.sound.js:1413"
+ "line": " lib/addons/p5.sound.js:1379"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:1746"
- },
- {
- "message": "Missing item type\nReplace the current Audio Buffer with a new Buffer.",
- "line": " lib/addons/p5.sound.js:1764"
+ "line": " lib/addons/p5.sound.js:1818"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:2026"
+ "line": " lib/addons/p5.sound.js:2099"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:3024"
+ "line": " lib/addons/p5.sound.js:3110"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:3427"
+ "line": " lib/addons/p5.sound.js:3487"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:3448"
+ "line": " lib/addons/p5.sound.js:3508"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:3507"
+ "line": " lib/addons/p5.sound.js:3567"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:3960"
+ "line": " lib/addons/p5.sound.js:3885"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:4097"
+ "line": " lib/addons/p5.sound.js:4057"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:4130"
+ "line": " lib/addons/p5.sound.js:4215"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:4176"
+ "line": " lib/addons/p5.sound.js:4256"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:4197"
+ "line": " lib/addons/p5.sound.js:4326"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:4217"
- },
- {
- "message": "Missing item type\nConnect a p5.sound object or Web Audio node to this\np5.Signal so that its amplitude values can be scaled.",
- "line": " lib/addons/p5.sound.js:4330"
+ "line": " lib/addons/p5.sound.js:4514"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:4923"
+ "line": " lib/addons/p5.sound.js:4571"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:5109"
- },
- {
- "message": "Missing item type\nSet the amplitude of the noise between 0 and 1.0. Or,\nmodulate amplitude with an audio signal such as an oscillator.",
- "line": " lib/addons/p5.sound.js:6393"
- },
- {
- "message": "Missing item type\nAdd input sources to the list of available sources.",
- "line": " lib/addons/p5.sound.js:6634"
+ "line": " lib/addons/p5.sound.js:4739"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6763"
+ "line": " lib/addons/p5.sound.js:4787"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6779"
+ "line": " lib/addons/p5.sound.js:4818"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6803"
+ "line": " lib/addons/p5.sound.js:4839"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6829"
+ "line": " lib/addons/p5.sound.js:4859"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6858"
+ "line": " lib/addons/p5.sound.js:5572"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6888"
+ "line": " lib/addons/p5.sound.js:5775"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6936"
+ "line": " lib/addons/p5.sound.js:7426"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6959"
+ "line": " lib/addons/p5.sound.js:7442"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:6984"
+ "line": " lib/addons/p5.sound.js:7466"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7005"
+ "line": " lib/addons/p5.sound.js:7492"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7012"
+ "line": " lib/addons/p5.sound.js:7514"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7034"
+ "line": " lib/addons/p5.sound.js:7536"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7063"
+ "line": " lib/addons/p5.sound.js:7582"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7090"
+ "line": " lib/addons/p5.sound.js:7613"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7118"
+ "line": " lib/addons/p5.sound.js:7631"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7146"
+ "line": " lib/addons/p5.sound.js:7968"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7192"
+ "line": " lib/addons/p5.sound.js:7990"
},
{
- "message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7223"
- },
- {
- "message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7241"
- },
- {
- "message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7629"
- },
- {
- "message": "Missing item type",
- "line": " lib/addons/p5.sound.js:7651"
+ "message": "Missing item type\nThe p5.Effect class is built\n \tusing Tone.js CrossFade",
+ "line": " lib/addons/p5.sound.js:8060"
},
{
- "message": "Missing item type\nThe p5.Effect class is built\n using Tone.js CrossFade",
- "line": " lib/addons/p5.sound.js:7721"
+ "message": "Missing item type\nIn classes that extend\np5.Effect, connect effect nodes\nto the wet parameter",
+ "line": " lib/addons/p5.sound.js:8066"
},
{
- "message": "Missing item type\nIn classes that extend\np5.Effect, connect effect nodes\nto the wet parameter",
- "line": " lib/addons/p5.sound.js:7727"
+ "message": "Missing item type\nEQFilter extends p5.Filter with constraints\nnecessary for the p5.EQ",
+ "line": " lib/addons/p5.sound.js:8456"
},
{
"message": "Missing item type\nInspired by Simple Reverb by Jordan Santell\nhttps://github.com/web-audio-components/simple-reverb/blob/master/index.js\n\nUtility function for building an impulse response\nbased on the module parameters.",
- "line": " lib/addons/p5.sound.js:8467"
+ "line": " lib/addons/p5.sound.js:9552"
},
{
"message": "Missing item type\nPrivate method to load a buffer as an Impulse Response,\nassign it to the convolverNode, and add to the Array of .impulses.",
- "line": " lib/addons/p5.sound.js:8631"
+ "line": " lib/addons/p5.sound.js:9724"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:8817"
+ "line": " lib/addons/p5.sound.js:9912"
},
{
"message": "Missing item type",
- "line": " lib/addons/p5.sound.js:8842"
+ "line": " lib/addons/p5.sound.js:9937"
},
{
- "message": "Missing item type\nSet the global tempo, in beats per minute, for all\np5.Parts. This method will impact all active p5.Parts.",
- "line": " lib/addons/p5.sound.js:9059"
+ "message": "Missing item type\nmusicalTimeMode variables\nmodify these only when the interval is specified in musicalTime format as a string",
+ "line": " lib/addons/p5.sound.js:10662"
},
{
- "message": "Missing item type\nSet the tempo for all parts in the score",
- "line": " lib/addons/p5.sound.js:9513"
- },
- {
- "message": "Missing item type\nReturn the current reduction value",
- "line": " lib/addons/p5.sound.js:9731"
+ "message": "Missing item type\nDo not initiate the callback if timeFromNow is < 0\nThis ususually occurs for a few milliseconds when the page\nis not fully loaded\n\nThe callback should only be called until maxIterations is reached",
+ "line": " lib/addons/p5.sound.js:10678"
},
{
"message": "Missing item type\ncallback invoked when the recording is over",
- "line": " lib/addons/p5.sound.js:9828"
+ "line": " lib/addons/p5.sound.js:11167"
},
{
"message": "Missing item type\ninternal method called on audio process",
- "line": " lib/addons/p5.sound.js:9914"
+ "line": " lib/addons/p5.sound.js:11253"
+ },
+ {
+ "message": "Missing item type\nPrivate method to ensure accurate values of this._voicesInUse\nAny time a new value is scheduled, it is necessary to increment all subsequent\nscheduledValues after attack, and decrement all subsequent\nscheduledValues after release",
+ "line": " lib/addons/p5.sound.js:12361"
+ },
+ {
+ "message": "Missing item type\np5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound\n\nFrom the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors\n\nMIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE\n\nSome of the many audio libraries & resources that inspire p5.sound:\n - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js\n - buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/\n - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0\n - wavesurfer.js https://github.com/katspaugh/wavesurfer.js\n - Web Audio Components by Jordan Santell https://github.com/web-audio-components\n - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound\n\n Web Audio API: http://w3.org/TR/webaudio/",
+ "line": " lib/addons/p5.sound.min.js:3"
}
- ]
+ ],
+ "consts": {
+ "RGB": [
+ "p5.colorMode"
+ ],
+ "HSB": [
+ "p5.colorMode"
+ ],
+ "HSL": [
+ "p5.colorMode"
+ ],
+ "CHORD": [
+ "p5.arc"
+ ],
+ "PIE": [
+ "p5.arc"
+ ],
+ "OPEN": [
+ "p5.arc"
+ ],
+ "CENTER": [
+ "p5.ellipseMode",
+ "p5.rectMode",
+ "p5.imageMode",
+ "p5.textAlign"
+ ],
+ "RADIUS": [
+ "p5.ellipseMode",
+ "p5.rectMode"
+ ],
+ "CORNER": [
+ "p5.ellipseMode",
+ "p5.rectMode",
+ "p5.imageMode"
+ ],
+ "CORNERS": [
+ "p5.ellipseMode",
+ "p5.rectMode",
+ "p5.imageMode"
+ ],
+ "SQUARE": [
+ "p5.strokeCap"
+ ],
+ "PROJECT": [
+ "p5.strokeCap"
+ ],
+ "ROUND": [
+ "p5.strokeCap",
+ "p5.strokeJoin"
+ ],
+ "MITER": [
+ "p5.strokeJoin"
+ ],
+ "BEVEL": [
+ "p5.strokeJoin"
+ ],
+ "POINTS": [
+ "p5.beginShape"
+ ],
+ "LINES": [
+ "p5.beginShape"
+ ],
+ "TRIANGLES": [
+ "p5.beginShape"
+ ],
+ "TRIANGLE_FAN": [
+ "p5.beginShape"
+ ],
+ "TRIANGLE_STRIP": [
+ "p5.beginShape"
+ ],
+ "QUADS": [
+ "p5.beginShape"
+ ],
+ "QUAD_STRIP": [
+ "p5.beginShape"
+ ],
+ "CLOSE": [
+ "p5.endShape"
+ ],
+ "ARROW": [
+ "p5.cursor"
+ ],
+ "CROSS": [
+ "p5.cursor"
+ ],
+ "HAND": [
+ "p5.cursor"
+ ],
+ "MOVE": [
+ "p5.cursor"
+ ],
+ "TEXT": [
+ "p5.cursor"
+ ],
+ "WAIT": [
+ "p5.cursor"
+ ],
+ "P2D": [
+ "p5.createCanvas",
+ "p5.createGraphics"
+ ],
+ "WEBGL": [
+ "p5.createCanvas",
+ "p5.createGraphics"
+ ],
+ "BLEND": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "DARKEST": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "LIGHTEST": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "DIFFERENCE": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "MULTIPLY": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "EXCLUSION": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "SCREEN": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "REPLACE": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "OVERLAY": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "HARD_LIGHT": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "SOFT_LIGHT": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "DODGE": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "BURN": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "ADD": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend"
+ ],
+ "NORMAL": [
+ "p5.blendMode",
+ "p5.Image.blend",
+ "p5.blend",
+ "p5.textStyle"
+ ],
+ "THRESHOLD": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "GRAY": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "OPAQUE": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "INVERT": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "POSTERIZE": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "BLUR": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "ERODE": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "DILATE": [
+ "p5.Image.filter",
+ "p5.filter"
+ ],
+ "RADIANS": [
+ "p5.angleMode"
+ ],
+ "DEGREES": [
+ "p5.angleMode"
+ ],
+ "LEFT": [
+ "p5.textAlign"
+ ],
+ "RIGHT": [
+ "p5.textAlign"
+ ],
+ "TOP": [
+ "p5.textAlign"
+ ],
+ "BOTTOM": [
+ "p5.textAlign"
+ ],
+ "BASELINE": [
+ "p5.textAlign"
+ ],
+ "ITALIC": [
+ "p5.textStyle"
+ ],
+ "BOLD": [
+ "p5.textStyle"
+ ],
+ "VIDEO": [
+ "p5.createCapture"
+ ],
+ "AUDIO": [
+ "p5.createCapture"
+ ]
+ }
}
},{}],2:[function(_dereq_,module,exports){
var lookup = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
@@ -26464,24 +28837,25 @@ function blitBuffer (src, dst, offset, length) {
}
}).call(this,typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {})
-},{"base64-js":2,"ieee754":7,"isarray":8}],5:[function(_dereq_,module,exports){
+},{"base64-js":2,"ieee754":8,"isarray":9}],5:[function(_dereq_,module,exports){
(function (process,global){
/*!
* @overview es6-promise - a tiny implementation of Promises/A+.
* @copyright Copyright (c) 2014 Yehuda Katz, Tom Dale, Stefan Penner and contributors (Conversion to ES6 API by Jake Archibald)
* @license Licensed under MIT license
* See https://raw.githubusercontent.com/stefanpenner/es6-promise/master/LICENSE
- * @version 4.0.5
+ * @version 4.1.1
*/
(function (global, factory) {
- typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
- typeof define === 'function' && define.amd ? define(factory) :
- (global.ES6Promise = factory());
+ typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+ typeof define === 'function' && define.amd ? define(factory) :
+ (global.ES6Promise = factory());
}(this, (function () { 'use strict';
function objectOrFunction(x) {
- return typeof x === 'function' || typeof x === 'object' && x !== null;
+ var type = typeof x;
+ return x !== null && (type === 'object' || type === 'function');
}
function isFunction(x) {
@@ -26489,12 +28863,12 @@ function isFunction(x) {
}
var _isArray = undefined;
-if (!Array.isArray) {
+if (Array.isArray) {
+ _isArray = Array.isArray;
+} else {
_isArray = function (x) {
return Object.prototype.toString.call(x) === '[object Array]';
};
-} else {
- _isArray = Array.isArray;
}
var isArray = _isArray;
@@ -26682,7 +29056,7 @@ function then(onFulfillment, onRejection) {
@return {Promise} a promise that will become fulfilled with the given
`value`
*/
-function resolve(object) {
+function resolve$1(object) {
/*jshint validthis:true */
var Constructor = this;
@@ -26691,7 +29065,7 @@ function resolve(object) {
}
var promise = new Constructor(noop);
- _resolve(promise, object);
+ resolve(promise, object);
return promise;
}
@@ -26722,24 +29096,24 @@ function getThen(promise) {
}
}
-function tryThen(then, value, fulfillmentHandler, rejectionHandler) {
+function tryThen(then$$1, value, fulfillmentHandler, rejectionHandler) {
try {
- then.call(value, fulfillmentHandler, rejectionHandler);
+ then$$1.call(value, fulfillmentHandler, rejectionHandler);
} catch (e) {
return e;
}
}
-function handleForeignThenable(promise, thenable, then) {
+function handleForeignThenable(promise, thenable, then$$1) {
asap(function (promise) {
var sealed = false;
- var error = tryThen(then, thenable, function (value) {
+ var error = tryThen(then$$1, thenable, function (value) {
if (sealed) {
return;
}
sealed = true;
if (thenable !== value) {
- _resolve(promise, value);
+ resolve(promise, value);
} else {
fulfill(promise, value);
}
@@ -26749,12 +29123,12 @@ function handleForeignThenable(promise, thenable, then) {
}
sealed = true;
- _reject(promise, reason);
+ reject(promise, reason);
}, 'Settle: ' + (promise._label || ' unknown promise'));
if (!sealed && error) {
sealed = true;
- _reject(promise, error);
+ reject(promise, error);
}
}, promise);
}
@@ -26763,35 +29137,36 @@ function handleOwnThenable(promise, thenable) {
if (thenable._state === FULFILLED) {
fulfill(promise, thenable._result);
} else if (thenable._state === REJECTED) {
- _reject(promise, thenable._result);
+ reject(promise, thenable._result);
} else {
subscribe(thenable, undefined, function (value) {
- return _resolve(promise, value);
+ return resolve(promise, value);
}, function (reason) {
- return _reject(promise, reason);
+ return reject(promise, reason);
});
}
}
-function handleMaybeThenable(promise, maybeThenable, then$$) {
- if (maybeThenable.constructor === promise.constructor && then$$ === then && maybeThenable.constructor.resolve === resolve) {
+function handleMaybeThenable(promise, maybeThenable, then$$1) {
+ if (maybeThenable.constructor === promise.constructor && then$$1 === then && maybeThenable.constructor.resolve === resolve$1) {
handleOwnThenable(promise, maybeThenable);
} else {
- if (then$$ === GET_THEN_ERROR) {
- _reject(promise, GET_THEN_ERROR.error);
- } else if (then$$ === undefined) {
+ if (then$$1 === GET_THEN_ERROR) {
+ reject(promise, GET_THEN_ERROR.error);
+ GET_THEN_ERROR.error = null;
+ } else if (then$$1 === undefined) {
fulfill(promise, maybeThenable);
- } else if (isFunction(then$$)) {
- handleForeignThenable(promise, maybeThenable, then$$);
+ } else if (isFunction(then$$1)) {
+ handleForeignThenable(promise, maybeThenable, then$$1);
} else {
fulfill(promise, maybeThenable);
}
}
}
-function _resolve(promise, value) {
+function resolve(promise, value) {
if (promise === value) {
- _reject(promise, selfFulfillment());
+ reject(promise, selfFulfillment());
} else if (objectOrFunction(value)) {
handleMaybeThenable(promise, value, getThen(value));
} else {
@@ -26820,7 +29195,7 @@ function fulfill(promise, value) {
}
}
-function _reject(promise, reason) {
+function reject(promise, reason) {
if (promise._state !== PENDING) {
return;
}
@@ -26899,13 +29274,13 @@ function invokeCallback(settled, promise, callback, detail) {
if (value === TRY_CATCH_ERROR) {
failed = true;
error = value.error;
- value = null;
+ value.error = null;
} else {
succeeded = true;
}
if (promise === value) {
- _reject(promise, cannotReturnOwn());
+ reject(promise, cannotReturnOwn());
return;
}
} else {
@@ -26916,25 +29291,25 @@ function invokeCallback(settled, promise, callback, detail) {
if (promise._state !== PENDING) {
// noop
} else if (hasCallback && succeeded) {
- _resolve(promise, value);
+ resolve(promise, value);
} else if (failed) {
- _reject(promise, error);
+ reject(promise, error);
} else if (settled === FULFILLED) {
fulfill(promise, value);
} else if (settled === REJECTED) {
- _reject(promise, value);
+ reject(promise, value);
}
}
function initializePromise(promise, resolver) {
try {
resolver(function resolvePromise(value) {
- _resolve(promise, value);
+ resolve(promise, value);
}, function rejectPromise(reason) {
- _reject(promise, reason);
+ reject(promise, reason);
});
} catch (e) {
- _reject(promise, e);
+ reject(promise, e);
}
}
@@ -26950,7 +29325,7 @@ function makePromise(promise) {
promise._subscribers = [];
}
-function Enumerator(Constructor, input) {
+function Enumerator$1(Constructor, input) {
this._instanceConstructor = Constructor;
this.promise = new Constructor(noop);
@@ -26959,7 +29334,6 @@ function Enumerator(Constructor, input) {
}
if (isArray(input)) {
- this._input = input;
this.length = input.length;
this._remaining = input.length;
@@ -26969,34 +29343,31 @@ function Enumerator(Constructor, input) {
fulfill(this.promise, this._result);
} else {
this.length = this.length || 0;
- this._enumerate();
+ this._enumerate(input);
if (this._remaining === 0) {
fulfill(this.promise, this._result);
}
}
} else {
- _reject(this.promise, validationError());
+ reject(this.promise, validationError());
}
}
function validationError() {
return new Error('Array Methods must be provided an Array');
-};
-
-Enumerator.prototype._enumerate = function () {
- var length = this.length;
- var _input = this._input;
+}
- for (var i = 0; this._state === PENDING && i < length; i++) {
- this._eachEntry(_input[i], i);
+Enumerator$1.prototype._enumerate = function (input) {
+ for (var i = 0; this._state === PENDING && i < input.length; i++) {
+ this._eachEntry(input[i], i);
}
};
-Enumerator.prototype._eachEntry = function (entry, i) {
+Enumerator$1.prototype._eachEntry = function (entry, i) {
var c = this._instanceConstructor;
- var resolve$$ = c.resolve;
+ var resolve$$1 = c.resolve;
- if (resolve$$ === resolve) {
+ if (resolve$$1 === resolve$1) {
var _then = getThen(entry);
if (_then === then && entry._state !== PENDING) {
@@ -27004,28 +29375,28 @@ Enumerator.prototype._eachEntry = function (entry, i) {
} else if (typeof _then !== 'function') {
this._remaining--;
this._result[i] = entry;
- } else if (c === Promise) {
+ } else if (c === Promise$2) {
var promise = new c(noop);
handleMaybeThenable(promise, entry, _then);
this._willSettleAt(promise, i);
} else {
- this._willSettleAt(new c(function (resolve$$) {
- return resolve$$(entry);
+ this._willSettleAt(new c(function (resolve$$1) {
+ return resolve$$1(entry);
}), i);
}
} else {
- this._willSettleAt(resolve$$(entry), i);
+ this._willSettleAt(resolve$$1(entry), i);
}
};
-Enumerator.prototype._settledAt = function (state, i, value) {
+Enumerator$1.prototype._settledAt = function (state, i, value) {
var promise = this.promise;
if (promise._state === PENDING) {
this._remaining--;
if (state === REJECTED) {
- _reject(promise, value);
+ reject(promise, value);
} else {
this._result[i] = value;
}
@@ -27036,7 +29407,7 @@ Enumerator.prototype._settledAt = function (state, i, value) {
}
};
-Enumerator.prototype._willSettleAt = function (promise, i) {
+Enumerator$1.prototype._willSettleAt = function (promise, i) {
var enumerator = this;
subscribe(promise, undefined, function (value) {
@@ -27093,8 +29464,8 @@ Enumerator.prototype._willSettleAt = function (promise, i) {
fulfilled, or rejected if any of them become rejected.
@static
*/
-function all(entries) {
- return new Enumerator(this, entries).promise;
+function all$1(entries) {
+ return new Enumerator$1(this, entries).promise;
}
/**
@@ -27162,7 +29533,7 @@ function all(entries) {
@return {Promise} a promise which settles in the same way as the first passed
promise to settle.
*/
-function race(entries) {
+function race$1(entries) {
/*jshint validthis:true */
var Constructor = this;
@@ -27214,11 +29585,11 @@ function race(entries) {
Useful for tooling.
@return {Promise} a promise rejected with the given `reason`.
*/
-function reject(reason) {
+function reject$1(reason) {
/*jshint validthis:true */
var Constructor = this;
var promise = new Constructor(noop);
- _reject(promise, reason);
+ reject(promise, reason);
return promise;
}
@@ -27333,27 +29704,27 @@ function needsNew() {
Useful for tooling.
@constructor
*/
-function Promise(resolver) {
+function Promise$2(resolver) {
this[PROMISE_ID] = nextId();
this._result = this._state = undefined;
this._subscribers = [];
if (noop !== resolver) {
typeof resolver !== 'function' && needsResolver();
- this instanceof Promise ? initializePromise(this, resolver) : needsNew();
+ this instanceof Promise$2 ? initializePromise(this, resolver) : needsNew();
}
}
-Promise.all = all;
-Promise.race = race;
-Promise.resolve = resolve;
-Promise.reject = reject;
-Promise._setScheduler = setScheduler;
-Promise._setAsap = setAsap;
-Promise._asap = asap;
+Promise$2.all = all$1;
+Promise$2.race = race$1;
+Promise$2.resolve = resolve$1;
+Promise$2.reject = reject$1;
+Promise$2._setScheduler = setScheduler;
+Promise$2._setAsap = setAsap;
+Promise$2._asap = asap;
-Promise.prototype = {
- constructor: Promise,
+Promise$2.prototype = {
+ constructor: Promise$2,
/**
The primary way of interacting with a promise is through its `then` method,
@@ -27582,7 +29953,8 @@ Promise.prototype = {
}
};
-function polyfill() {
+/*global self*/
+function polyfill$1() {
var local = undefined;
if (typeof global !== 'undefined') {
@@ -27612,19 +29984,21 @@ function polyfill() {
}
}
- local.Promise = Promise;
+ local.Promise = Promise$2;
}
// Strange compat..
-Promise.polyfill = polyfill;
-Promise.Promise = Promise;
+Promise$2.polyfill = polyfill$1;
+Promise$2.Promise = Promise$2;
-return Promise;
+return Promise$2;
})));
+
+
}).call(this,_dereq_('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {})
-},{"_process":43}],6:[function(_dereq_,module,exports){
+},{"_process":12}],6:[function(_dereq_,module,exports){
(function (global, factory) {
if (typeof define === 'function' && define.amd) {
define(['exports', 'module'], factory);
@@ -27650,8 +30024,6 @@ return Promise;
return 'jsonp_' + Date.now() + '_' + Math.ceil(Math.random() * 100000);
}
- // Known issue: Will throw 'Uncaught ReferenceError: callback_*** is not defined'
- // error if request timeout
function clearFunction(functionName) {
// IE8 throws an exception when you try to delete a property on window
// http://stackoverflow.com/a/1824228/751089
@@ -27664,7 +30036,9 @@ return Promise;
function removeScript(scriptId) {
var script = document.getElementById(scriptId);
- document.getElementsByTagName('head')[0].removeChild(script);
+ if (script) {
+ document.getElementsByTagName('head')[0].removeChild(script);
+ }
}
function fetchJsonp(_url) {
@@ -27702,6 +30076,9 @@ return Promise;
var jsonpScript = document.createElement('script');
jsonpScript.setAttribute('src', '' + url + jsonpCallback + '=' + callbackFunction);
+ if (options.charset) {
+ jsonpScript.setAttribute('charset', options.charset);
+ }
jsonpScript.id = scriptId;
document.getElementsByTagName('head')[0].appendChild(jsonpScript);
@@ -27710,7 +30087,19 @@ return Promise;
clearFunction(callbackFunction);
removeScript(scriptId);
+ window[callbackFunction] = function () {
+ clearFunction(callbackFunction);
+ };
}, timeout);
+
+ // Caught if got 404/500
+ jsonpScript.onerror = function () {
+ reject(new Error('JSONP request to ' + _url + ' failed'));
+
+ clearFunction(callbackFunction);
+ removeScript(scriptId);
+ if (timeoutId) clearTimeout(timeoutId);
+ };
});
}
@@ -27734,6 +30123,196 @@ return Promise;
module.exports = fetchJsonp;
});
},{}],7:[function(_dereq_,module,exports){
+/* FileSaver.js
+ * A saveAs() FileSaver implementation.
+ * 1.3.2
+ * 2016-06-16 18:25:19
+ *
+ * By Eli Grey, http://eligrey.com
+ * License: MIT
+ * See https://github.com/eligrey/FileSaver.js/blob/master/LICENSE.md
+ */
+
+/*global self */
+/*jslint bitwise: true, indent: 4, laxbreak: true, laxcomma: true, smarttabs: true, plusplus: true */
+
+/*! @source http://purl.eligrey.com/github/FileSaver.js/blob/master/FileSaver.js */
+
+var saveAs = saveAs || (function(view) {
+ "use strict";
+ // IE <10 is explicitly unsupported
+ if (typeof view === "undefined" || typeof navigator !== "undefined" && /MSIE [1-9]\./.test(navigator.userAgent)) {
+ return;
+ }
+ var
+ doc = view.document
+ // only get URL when necessary in case Blob.js hasn't overridden it yet
+ , get_URL = function() {
+ return view.URL || view.webkitURL || view;
+ }
+ , save_link = doc.createElementNS("http://www.w3.org/1999/xhtml", "a")
+ , can_use_save_link = "download" in save_link
+ , click = function(node) {
+ var event = new MouseEvent("click");
+ node.dispatchEvent(event);
+ }
+ , is_safari = /constructor/i.test(view.HTMLElement) || view.safari
+ , is_chrome_ios =/CriOS\/[\d]+/.test(navigator.userAgent)
+ , throw_outside = function(ex) {
+ (view.setImmediate || view.setTimeout)(function() {
+ throw ex;
+ }, 0);
+ }
+ , force_saveable_type = "application/octet-stream"
+ // the Blob API is fundamentally broken as there is no "downloadfinished" event to subscribe to
+ , arbitrary_revoke_timeout = 1000 * 40 // in ms
+ , revoke = function(file) {
+ var revoker = function() {
+ if (typeof file === "string") { // file is an object URL
+ get_URL().revokeObjectURL(file);
+ } else { // file is a File
+ file.remove();
+ }
+ };
+ setTimeout(revoker, arbitrary_revoke_timeout);
+ }
+ , dispatch = function(filesaver, event_types, event) {
+ event_types = [].concat(event_types);
+ var i = event_types.length;
+ while (i--) {
+ var listener = filesaver["on" + event_types[i]];
+ if (typeof listener === "function") {
+ try {
+ listener.call(filesaver, event || filesaver);
+ } catch (ex) {
+ throw_outside(ex);
+ }
+ }
+ }
+ }
+ , auto_bom = function(blob) {
+ // prepend BOM for UTF-8 XML and text/* types (including HTML)
+ // note: your browser will automatically convert UTF-16 U+FEFF to EF BB BF
+ if (/^\s*(?:text\/\S*|application\/xml|\S*\/\S*\+xml)\s*;.*charset\s*=\s*utf-8/i.test(blob.type)) {
+ return new Blob([String.fromCharCode(0xFEFF), blob], {type: blob.type});
+ }
+ return blob;
+ }
+ , FileSaver = function(blob, name, no_auto_bom) {
+ if (!no_auto_bom) {
+ blob = auto_bom(blob);
+ }
+ // First try a.download, then web filesystem, then object URLs
+ var
+ filesaver = this
+ , type = blob.type
+ , force = type === force_saveable_type
+ , object_url
+ , dispatch_all = function() {
+ dispatch(filesaver, "writestart progress write writeend".split(" "));
+ }
+ // on any filesys errors revert to saving with object URLs
+ , fs_error = function() {
+ if ((is_chrome_ios || (force && is_safari)) && view.FileReader) {
+ // Safari doesn't allow downloading of blob urls
+ var reader = new FileReader();
+ reader.onloadend = function() {
+ var url = is_chrome_ios ? reader.result : reader.result.replace(/^data:[^;]*;/, 'data:attachment/file;');
+ var popup = view.open(url, '_blank');
+ if(!popup) view.location.href = url;
+ url=undefined; // release reference before dispatching
+ filesaver.readyState = filesaver.DONE;
+ dispatch_all();
+ };
+ reader.readAsDataURL(blob);
+ filesaver.readyState = filesaver.INIT;
+ return;
+ }
+ // don't create more object URLs than needed
+ if (!object_url) {
+ object_url = get_URL().createObjectURL(blob);
+ }
+ if (force) {
+ view.location.href = object_url;
+ } else {
+ var opened = view.open(object_url, "_blank");
+ if (!opened) {
+ // Apple does not allow window.open, see https://developer.apple.com/library/safari/documentation/Tools/Conceptual/SafariExtensionGuide/WorkingwithWindowsandTabs/WorkingwithWindowsandTabs.html
+ view.location.href = object_url;
+ }
+ }
+ filesaver.readyState = filesaver.DONE;
+ dispatch_all();
+ revoke(object_url);
+ }
+ ;
+ filesaver.readyState = filesaver.INIT;
+
+ if (can_use_save_link) {
+ object_url = get_URL().createObjectURL(blob);
+ setTimeout(function() {
+ save_link.href = object_url;
+ save_link.download = name;
+ click(save_link);
+ dispatch_all();
+ revoke(object_url);
+ filesaver.readyState = filesaver.DONE;
+ });
+ return;
+ }
+
+ fs_error();
+ }
+ , FS_proto = FileSaver.prototype
+ , saveAs = function(blob, name, no_auto_bom) {
+ return new FileSaver(blob, name || blob.name || "download", no_auto_bom);
+ }
+ ;
+ // IE 10+ (native saveAs)
+ if (typeof navigator !== "undefined" && navigator.msSaveOrOpenBlob) {
+ return function(blob, name, no_auto_bom) {
+ name = name || blob.name || "download";
+
+ if (!no_auto_bom) {
+ blob = auto_bom(blob);
+ }
+ return navigator.msSaveOrOpenBlob(blob, name);
+ };
+ }
+
+ FS_proto.abort = function(){};
+ FS_proto.readyState = FS_proto.INIT = 0;
+ FS_proto.WRITING = 1;
+ FS_proto.DONE = 2;
+
+ FS_proto.error =
+ FS_proto.onwritestart =
+ FS_proto.onprogress =
+ FS_proto.onwrite =
+ FS_proto.onabort =
+ FS_proto.onerror =
+ FS_proto.onwriteend =
+ null;
+
+ return saveAs;
+}(
+ typeof self !== "undefined" && self
+ || typeof window !== "undefined" && window
+ || this.content
+));
+// `self` is undefined in Firefox for Android content script context
+// while `this` is nsIContentFrameMessageManager
+// with an attribute `content` that corresponds to the window
+
+if (typeof module !== "undefined" && module.exports) {
+ module.exports.saveAs = saveAs;
+} else if ((typeof define !== "undefined" && define !== null) && (define.amd !== null)) {
+ define("FileSaver.js", function() {
+ return saveAs;
+ });
+}
+
+},{}],8:[function(_dereq_,module,exports){
exports.read = function (buffer, offset, isLE, mLen, nBytes) {
var e, m
var eLen = nBytes * 8 - mLen - 1
@@ -27819,17943 +30398,16501 @@ exports.write = function (buffer, value, offset, isLE, mLen, nBytes) {
buffer[offset + i - d] |= s * 128
}
-},{}],8:[function(_dereq_,module,exports){
+},{}],9:[function(_dereq_,module,exports){
var toString = {}.toString;
module.exports = Array.isArray || function (arr) {
return toString.call(arr) == '[object Array]';
};
-},{}],9:[function(_dereq_,module,exports){
-// The Bounding Box object
+},{}],10:[function(_dereq_,module,exports){
+/*
-'use strict';
+ Copyright 2000, Silicon Graphics, Inc. All Rights Reserved.
+ Copyright 2015, Google Inc. All Rights Reserved.
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to
+ deal in the Software without restriction, including without limitation the
+ rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+ sell copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice including the dates of first publication and
+ either this permission notice or a reference to http://oss.sgi.com/projects/FreeB/
+ shall be included in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ SILICON GRAPHICS, INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+ IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+ Original Code. The Original Code is: OpenGL Sample Implementation,
+ Version 1.2.1, released January 26, 2000, developed by Silicon Graphics,
+ Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc.
+ Copyright in any portions created by third parties is as indicated
+ elsewhere herein. All Rights Reserved.
+*/
+'use strict';var n;function t(a,b){return a.b===b.b&&a.a===b.a}function u(a,b){return a.ba?0:a;c=0>c?0:c;return a<=c?0===c?(b+d)/2:b+a/(a+c)*(d-b):d+c/(a+c)*(b-d)};function ea(a){var b=B(a.b);C(b,a.c);C(b.b,a.c);D(b,a.a);return b}function E(a,b){var c=!1,d=!1;a!==b&&(b.a!==a.a&&(d=!0,F(b.a,a.a)),b.d!==a.d&&(c=!0,G(b.d,a.d)),H(b,a),d||(C(b,a.a),a.a.c=a),c||(D(b,a.d),a.d.a=a))}function I(a){var b=a.b,c=!1;a.d!==a.b.d&&(c=!0,G(a.d,a.b.d));a.c===a?F(a.a,null):(a.b.d.a=J(a),a.a.c=a.c,H(a,J(a)),c||D(a,a.d));b.c===b?(F(b.a,null),G(b.d,null)):(a.d.a=J(b),b.a.c=b.c,H(b,J(b)));fa(a)}
+function K(a){var b=B(a),c=b.b;H(b,a.e);b.a=a.b.a;C(c,b.a);b.d=c.d=a.d;b=b.b;H(a.b,J(a.b));H(a.b,b);a.b.a=b.a;b.b.a.c=b.b;b.b.d=a.b.d;b.f=a.f;b.b.f=a.b.f;return b}function L(a,b){var c=!1,d=B(a),e=d.b;b.d!==a.d&&(c=!0,G(b.d,a.d));H(d,a.e);H(e,b);d.a=a.b.a;e.a=b.a;d.d=e.d=a.d;a.d.a=e;c||D(d,a.d);return d}function B(a){var b=new M,c=new M,d=a.b.h;c.h=d;d.b.h=b;b.h=a;a.b.h=c;b.b=c;b.c=b;b.e=c;c.b=b;c.c=c;return c.e=b}function H(a,b){var c=a.c,d=b.c;c.b.e=b;d.b.e=a;a.c=d;b.c=c}
+function C(a,b){var c=b.f,d=new N(b,c);c.e=d;b.f=d;c=d.c=a;do c.a=d,c=c.c;while(c!==a)}function D(a,b){var c=b.d,d=new ga(b,c);c.b=d;b.d=d;d.a=a;d.c=b.c;c=a;do c.d=d,c=c.e;while(c!==a)}function fa(a){var b=a.h;a=a.b.h;b.b.h=a;a.b.h=b}function F(a,b){var c=a.c,d=c;do d.a=b,d=d.c;while(d!==c);c=a.f;d=a.e;d.f=c;c.e=d}function G(a,b){var c=a.a,d=c;do d.d=b,d=d.e;while(d!==c);c=a.d;d=a.b;d.d=c;c.b=d};function ha(a){var b=0;Math.abs(a[1])>Math.abs(a[0])&&(b=1);Math.abs(a[2])>Math.abs(a[b])&&(b=2);return b};var O=4*1E150;function P(a,b){a.f+=b.f;a.b.f+=b.b.f}function ia(a,b,c){a=a.a;b=b.a;c=c.a;if(b.b.a===a)return c.b.a===a?u(b.a,c.a)?0>=x(c.b.a,b.a,c.a):0<=x(b.b.a,c.a,b.a):0>=x(c.b.a,a,c.a);if(c.b.a===a)return 0<=x(b.b.a,a,b.a);b=v(b.b.a,a,b.a);a=v(c.b.a,a,c.a);return b>=a}function Q(a){a.a.i=null;var b=a.e;b.a.c=b.c;b.c.a=b.a;a.e=null}function ja(a,b){I(a.a);a.c=!1;a.a=b;b.i=a}function ka(a){var b=a.a.a;do a=R(a);while(a.a.a===b);a.c&&(b=L(S(a).a.b,a.a.e),ja(a,b),a=R(a));return a}
+function la(a,b,c){var d=new ma;d.a=c;d.e=na(a.f,b.e,d);return c.i=d}function oa(a,b){switch(a.s){case 100130:return 0!==(b&1);case 100131:return 0!==b;case 100132:return 0b;case 100134:return 2<=b||-2>=b}return!1}function pa(a){var b=a.a,c=b.d;c.c=a.d;c.a=b;Q(a)}function T(a,b,c){a=b;for(b=b.a;a!==c;){a.c=!1;var d=S(a),e=d.a;if(e.a!==b.a){if(!d.c){pa(a);break}e=L(b.c.b,e.b);ja(d,e)}b.c!==e&&(E(J(e),e),E(b,e));pa(a);b=d.a;a=d}return b}
+function U(a,b,c,d,e,f){var g=!0;do la(a,b,c.b),c=c.c;while(c!==d);for(null===e&&(e=S(b).a.b.c);;){d=S(b);c=d.a.b;if(c.a!==e.a)break;c.c!==e&&(E(J(c),c),E(J(e),c));d.f=b.f-c.f;d.d=oa(a,d.f);b.b=!0;!g&&qa(a,b)&&(P(c,e),Q(b),I(e));g=!1;b=d;e=c}b.b=!0;f&&ra(a,b)}function sa(a,b,c,d,e){var f=[b.g[0],b.g[1],b.g[2]];b.d=null;b.d=a.o?a.o(f,c,d,a.c)||null:null;null===b.d&&(e?a.n||(V(a,100156),a.n=!0):b.d=c[0])}
+function ta(a,b,c){var d=[null,null,null,null];d[0]=b.a.d;d[1]=c.a.d;sa(a,b.a,d,[.5,.5,0,0],!1);E(b,c)}function ua(a,b,c,d,e){var f=Math.abs(b.b-a.b)+Math.abs(b.a-a.a),g=Math.abs(c.b-a.b)+Math.abs(c.a-a.a),h=e+1;d[e]=.5*g/(f+g);d[h]=.5*f/(f+g);a.g[0]+=d[e]*b.g[0]+d[h]*c.g[0];a.g[1]+=d[e]*b.g[1]+d[h]*c.g[1];a.g[2]+=d[e]*b.g[2]+d[h]*c.g[2]}
+function qa(a,b){var c=S(b),d=b.a,e=c.a;if(u(d.a,e.a)){if(0=l?W(c,l):u(h[g[l>>1]],h[g[l]])?W(c,l):va(c,l));h[f]=null;k[f]=c.b;c.b=f}else for(c.c[-(f+1)]=null;0x(d.b.a,e.a,d.a))return!1;R(b).b=b.b=!0;K(d.b);E(J(e),d)}return!0}
+function wa(a,b){var c=S(b),d=b.a,e=c.a,f=d.a,g=e.a,h=d.b.a,k=e.b.a,l=new N;x(h,a.a,f);x(k,a.a,g);if(f===g||Math.min(f.a,h.a)>Math.max(g.a,k.a))return!1;if(u(f,g)){if(0x(h,g,f))return!1;var r=h,p=f,q=k,y=g,m,w;u(r,p)||(m=r,r=p,p=m);u(q,y)||(m=q,q=y,y=m);u(r,q)||(m=r,r=q,q=m,m=p,p=y,y=m);u(q,p)?u(p,y)?(m=v(r,q,p),w=v(q,p,y),0>m+w&&(m=-m,w=-w),l.b=A(m,q.b,w,p.b)):(m=x(r,q,p),w=-x(r,y,p),0>m+w&&(m=-m,w=-w),l.b=A(m,q.b,w,y.b)):l.b=(q.b+p.b)/2;z(r,p)||(m=r,r=p,p=m);z(q,y)||
+(m=q,q=y,y=m);z(r,q)||(m=r,r=q,q=m,m=p,p=y,y=m);z(q,p)?z(p,y)?(m=aa(r,q,p),w=aa(q,p,y),0>m+w&&(m=-m,w=-w),l.a=A(m,q.a,w,p.a)):(m=ba(r,q,p),w=-ba(r,y,p),0>m+w&&(m=-m,w=-w),l.a=A(m,q.a,w,y.a)):l.a=(q.a+p.a)/2;u(l,a.a)&&(l.b=a.a.b,l.a=a.a.a);r=u(f,g)?f:g;u(r,l)&&(l.b=r.b,l.a=r.a);if(t(l,f)||t(l,g))return qa(a,b),!1;if(!t(h,a.a)&&0<=x(h,a.a,l)||!t(k,a.a)&&0>=x(k,a.a,l)){if(k===a.a)return K(d.b),E(e.b,d),b=ka(b),d=S(b).a,T(a,S(b),c),U(a,b,J(d),d,d,!0),!0;if(h===a.a){K(e.b);E(d.e,J(e));f=c=b;g=f.a.b.a;
+do f=R(f);while(f.a.b.a===g);b=f;f=S(b).a.b.c;c.a=J(e);e=T(a,c,null);U(a,b,e.c,d.b.c,f,!0);return!0}0<=x(h,a.a,l)&&(R(b).b=b.b=!0,K(d.b),d.a.b=a.a.b,d.a.a=a.a.a);0>=x(k,a.a,l)&&(b.b=c.b=!0,K(e.b),e.a.b=a.a.b,e.a.a=a.a.a);return!1}K(d.b);K(e.b);E(J(e),d);d.a.b=l.b;d.a.a=l.a;d.a.h=xa(a.e,d.a);d=d.a;e=[0,0,0,0];l=[f.d,h.d,g.d,k.d];d.g[0]=d.g[1]=d.g[2]=0;ua(d,f,h,e,0);ua(d,g,k,e,2);sa(a,d,l,e,!0);R(b).b=b.b=c.b=!0;return!1}
+function ra(a,b){for(var c=S(b);;){for(;c.b;)b=c,c=S(c);if(!b.b&&(c=b,b=R(b),null===b||!b.b))break;b.b=!1;var d=b.a,e=c.a,f;if(f=d.b.a!==e.b.a)a:{f=b;var g=S(f),h=f.a,k=g.a,l=void 0;if(u(h.b.a,k.b.a)){if(0>x(h.b.a,k.b.a,h.a)){f=!1;break a}R(f).b=f.b=!0;l=K(h);E(k.b,l);l.d.c=f.d}else{if(0e;++e){var f=a[e];-1E150>f&&(f=-1E150,c=!0);1E150h;++h){var k=a.g[h];kb[h]&&(b[h]=k,c[h]=a)}a=0;b[1]-f[1]>b[0]-f[0]&&(a=1);b[2]-f[2]>b[a]-f[a]&&(a=2);if(f[a]>=b[a])e[0]=0,e[1]=0,e[2]=1;else{b=0;f=g[a];c=c[a];g=[0,0,0];f=[f.g[0]-c.g[0],f.g[1]-c.g[1],f.g[2]-c.g[2]];h=[0,0,0];for(a=d.e;a!==d;a=
+a.e)h[0]=a.g[0]-c.g[0],h[1]=a.g[1]-c.g[1],h[2]=a.g[2]-c.g[2],g[0]=f[1]*h[2]-f[2]*h[1],g[1]=f[2]*h[0]-f[0]*h[2],g[2]=f[0]*h[1]-f[1]*h[0],k=g[0]*g[0]+g[1]*g[1]+g[2]*g[2],k>b&&(b=k,e[0]=g[0],e[1]=g[1],e[2]=g[2]);0>=b&&(e[0]=e[1]=e[2]=0,e[ha(f)]=1)}d=!0}g=ha(e);a=this.b.c;b=(g+1)%3;c=(g+2)%3;g=0=b.f)){do e+=(b.a.b-b.b.a.b)*(b.a.a+b.b.a.a),b=b.e;while(b!==a.a)}if(0>e)for(e=this.b.c,d=e.e;d!==
+e;d=d.e)d.a=-d.a}this.n=!1;e=this.b.b;for(a=e.h;a!==e;a=d)if(d=a.h,b=a.e,t(a.a,a.b.a)&&a.e.e!==a&&(ta(this,b,a),I(a),a=b,b=a.e),b.e===a){if(b!==a){if(b===d||b===d.b)d=d.h;I(b)}if(a===d||a===d.b)d=d.h;I(a)}this.e=e=new Da;d=this.b.c;for(a=d.e;a!==d;a=a.e)a.h=xa(e,a);Ea(e);this.f=new Aa(this);za(this,-O);for(za(this,O);null!==(e=Fa(this.e));){for(;;){a:if(a=this.e,0===a.a)d=Ga(a.b);else if(d=a.c[a.d[a.a-1]],0!==a.b.a&&(a=Ga(a.b),u(a,d))){d=a;break a}if(null===d||!t(d,e))break;d=Fa(this.e);ta(this,e.c,
+d.c)}ya(this,e)}this.a=this.f.a.a.b.a.a;for(e=0;null!==(d=this.f.a.a.b);)d.h||++e,Q(d);this.f=null;e=this.e;e.b=null;e.d=null;this.e=e.c=null;e=this.b;for(a=e.a.b;a!==e.a;a=d)d=a.b,a=a.a,a.e.e===a&&(P(a.c,a),I(a));if(!this.n){e=this.b;if(this.m)for(a=e.b.h;a!==e.b;a=d)d=a.h,a.b.d.c!==a.d.c?a.f=a.d.c?1:-1:I(a);else for(a=e.a.b;a!==e.a;a=d)if(d=a.b,a.c){for(a=a.a;u(a.b.a,a.a);a=a.c.b);for(;u(a.a,a.b.a);a=a.e);b=a.c.b;for(c=void 0;a.e!==b;)if(u(a.b.a,b.a)){for(;b.e!==a&&(ca(b.e)||0>=x(b.a,b.b.a,b.e.b.a));)c=
+L(b.e,b),b=c.b;b=b.c.b}else{for(;b.e!==a&&(da(a.c.b)||0<=x(a.b.a,a.a,a.c.b.a));)c=L(a,a.c.b),a=c.b;a=a.e}for(;b.e.e!==a;)c=L(b.e,b),b=c.b}if(this.h||this.i||this.k||this.l)if(this.m)for(e=this.b,d=e.a.b;d!==e.a;d=d.b){if(d.c){this.h&&this.h(2,this.c);a=d.a;do this.k&&this.k(a.a.d,this.c),a=a.e;while(a!==d.a);this.i&&this.i(this.c)}}else{e=this.b;d=!!this.l;a=!1;b=-1;for(c=e.a.d;c!==e.a;c=c.d)if(c.c){a||(this.h&&this.h(4,this.c),a=!0);g=c.a;do d&&(f=g.b.d.c?0:1,b!==f&&(b=f,this.l&&this.l(!!b,this.c))),
+this.k&&this.k(g.a.d,this.c),g=g.e;while(g!==c.a)}a&&this.i&&this.i(this.c)}if(this.r){e=this.b;for(a=e.a.b;a!==e.a;a=d)if(d=a.b,!a.c){b=a.a;c=b.e;g=void 0;do g=c,c=g.e,g.d=null,null===g.b.d&&(g.c===g?F(g.a,null):(g.a.c=g.c,H(g,J(g))),f=g.b,f.c===f?F(f.a,null):(f.a.c=f.c,H(f,J(f))),fa(g));while(g!==b);b=a.d;a=a.b;a.d=b;b.b=a}this.r(this.b);this.c=this.b=null;return}}this.b=this.c=null};
+function Z(a,b){if(a.d!==b)for(;a.d!==b;)if(a.dc.f&&(c.f*=2,c.c=Ja(c.c,c.f+1));var e;0===c.b?e=d:(e=c.b,c.b=c.c[c.b]);c.e[e]=b;c.c[e]=d;c.d[d]=e;c.h&&va(c,d);return e}c=a.a++;a.c[c]=b;return-(c+1)}
+function Fa(a){if(0===a.a)return Ka(a.b);var b=a.c[a.d[a.a-1]];if(0!==a.b.a&&u(Ga(a.b),b))return Ka(a.b);do--a.a;while(0a.a||u(d[g],d[k])){c[f]=g;e[g]=f;break}c[f]=k;e[k]=f;f=h}}function va(a,b){for(var c=a.d,d=a.e,e=a.c,f=b,g=c[f];;){var h=f>>1,k=c[h];if(0===h||u(d[k],d[g])){c[f]=g;e[g]=f;break}c[f]=k;e[k]=f;f=h}};function ma(){this.e=this.a=null;this.f=0;this.c=this.b=this.h=this.d=!1}function S(a){return a.e.c.b}function R(a){return a.e.a.b};this.libtess={GluTesselator:X,windingRule:{GLU_TESS_WINDING_ODD:100130,GLU_TESS_WINDING_NONZERO:100131,GLU_TESS_WINDING_POSITIVE:100132,GLU_TESS_WINDING_NEGATIVE:100133,GLU_TESS_WINDING_ABS_GEQ_TWO:100134},primitiveType:{GL_LINE_LOOP:2,GL_TRIANGLES:4,GL_TRIANGLE_STRIP:5,GL_TRIANGLE_FAN:6},errorType:{GLU_TESS_MISSING_BEGIN_POLYGON:100151,GLU_TESS_MISSING_END_POLYGON:100153,GLU_TESS_MISSING_BEGIN_CONTOUR:100152,GLU_TESS_MISSING_END_CONTOUR:100154,GLU_TESS_COORD_TOO_LARGE:100155,GLU_TESS_NEED_COMBINE_CALLBACK:100156},
+gluEnum:{GLU_TESS_MESH:100112,GLU_TESS_TOLERANCE:100142,GLU_TESS_WINDING_RULE:100140,GLU_TESS_BOUNDARY_ONLY:100141,GLU_INVALID_ENUM:100900,GLU_INVALID_VALUE:100901,GLU_TESS_BEGIN:100100,GLU_TESS_VERTEX:100101,GLU_TESS_END:100102,GLU_TESS_ERROR:100103,GLU_TESS_EDGE_FLAG:100104,GLU_TESS_COMBINE:100105,GLU_TESS_BEGIN_DATA:100106,GLU_TESS_VERTEX_DATA:100107,GLU_TESS_END_DATA:100108,GLU_TESS_ERROR_DATA:100109,GLU_TESS_EDGE_FLAG_DATA:100110,GLU_TESS_COMBINE_DATA:100111}};X.prototype.gluDeleteTess=X.prototype.x;
+X.prototype.gluTessProperty=X.prototype.B;X.prototype.gluGetTessProperty=X.prototype.y;X.prototype.gluTessNormal=X.prototype.A;X.prototype.gluTessCallback=X.prototype.z;X.prototype.gluTessVertex=X.prototype.C;X.prototype.gluTessBeginPolygon=X.prototype.u;X.prototype.gluTessBeginContour=X.prototype.t;X.prototype.gluTessEndContour=X.prototype.v;X.prototype.gluTessEndPolygon=X.prototype.w; if (typeof module !== 'undefined') { module.exports = this.libtess; }
-function derive(v0, v1, v2, v3, t) {
- return Math.pow(1 - t, 3) * v0 +
- 3 * Math.pow(1 - t, 2) * t * v1 +
- 3 * (1 - t) * Math.pow(t, 2) * v2 +
- Math.pow(t, 3) * v3;
-}
+},{}],11:[function(_dereq_,module,exports){
+(function (Buffer){
/**
- * A bounding box is an enclosing box that describes the smallest measure within which all the points lie.
- * It is used to calculate the bounding box of a glyph or text path.
- *
- * On initialization, x1/y1/x2/y2 will be NaN. Check if the bounding box is empty using `isEmpty()`.
- *
- * @exports opentype.BoundingBox
- * @class
- * @constructor
+ * https://opentype.js.org v0.9.0 | (c) Frederik De Bleser and other contributors | MIT License | Uses tiny-inflate by Devon Govett and string.prototype.codepointat polyfill by Mathias Bynens
*/
-function BoundingBox() {
- this.x1 = Number.NaN;
- this.y1 = Number.NaN;
- this.x2 = Number.NaN;
- this.y2 = Number.NaN;
-}
-/**
- * Returns true if the bounding box is empty, that is, no points have been added to the box yet.
- */
-BoundingBox.prototype.isEmpty = function() {
- return isNaN(this.x1) || isNaN(this.y1) || isNaN(this.x2) || isNaN(this.y2);
-};
+(function (global, factory) {
+ typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+ typeof define === 'function' && define.amd ? define(['exports'], factory) :
+ (factory((global.opentype = {})));
+}(this, (function (exports) { 'use strict';
+
+ /*! https://mths.be/codepointat v0.2.0 by @mathias */
+ if (!String.prototype.codePointAt) {
+ (function() {
+ var defineProperty = (function() {
+ // IE 8 only supports `Object.defineProperty` on DOM elements
+ try {
+ var object = {};
+ var $defineProperty = Object.defineProperty;
+ var result = $defineProperty(object, object, object) && $defineProperty;
+ } catch(error) {}
+ return result;
+ }());
+ var codePointAt = function(position) {
+ if (this == null) {
+ throw TypeError();
+ }
+ var string = String(this);
+ var size = string.length;
+ // `ToInteger`
+ var index = position ? Number(position) : 0;
+ if (index != index) { // better `isNaN`
+ index = 0;
+ }
+ // Account for out-of-bounds indices:
+ if (index < 0 || index >= size) {
+ return undefined;
+ }
+ // Get the first code unit
+ var first = string.charCodeAt(index);
+ var second;
+ if ( // check if it’s the start of a surrogate pair
+ first >= 0xD800 && first <= 0xDBFF && // high surrogate
+ size > index + 1 // there is a next code unit
+ ) {
+ second = string.charCodeAt(index + 1);
+ if (second >= 0xDC00 && second <= 0xDFFF) { // low surrogate
+ // https://mathiasbynens.be/notes/javascript-encoding#surrogate-formulae
+ return (first - 0xD800) * 0x400 + second - 0xDC00 + 0x10000;
+ }
+ }
+ return first;
+ };
+ if (defineProperty) {
+ defineProperty(String.prototype, 'codePointAt', {
+ 'value': codePointAt,
+ 'configurable': true,
+ 'writable': true
+ });
+ } else {
+ String.prototype.codePointAt = codePointAt;
+ }
+ }());
+ }
-/**
- * Add the point to the bounding box.
- * The x1/y1/x2/y2 coordinates of the bounding box will now encompass the given point.
- * @param {number} x - The X coordinate of the point.
- * @param {number} y - The Y coordinate of the point.
- */
-BoundingBox.prototype.addPoint = function(x, y) {
- if (typeof x === 'number') {
- if (isNaN(this.x1) || isNaN(this.x2)) {
- this.x1 = x;
- this.x2 = x;
- }
- if (x < this.x1) {
- this.x1 = x;
- }
- if (x > this.x2) {
- this.x2 = x;
- }
- }
- if (typeof y === 'number') {
- if (isNaN(this.y1) || isNaN(this.y2)) {
- this.y1 = y;
- this.y2 = y;
- }
- if (y < this.y1) {
- this.y1 = y;
- }
- if (y > this.y2) {
- this.y2 = y;
- }
- }
-};
+ var TINF_OK = 0;
+ var TINF_DATA_ERROR = -3;
-/**
- * Add a X coordinate to the bounding box.
- * This extends the bounding box to include the X coordinate.
- * This function is used internally inside of addBezier.
- * @param {number} x - The X coordinate of the point.
- */
-BoundingBox.prototype.addX = function(x) {
- this.addPoint(x, null);
-};
+ function Tree() {
+ this.table = new Uint16Array(16); /* table of code length counts */
+ this.trans = new Uint16Array(288); /* code -> symbol translation table */
+ }
-/**
- * Add a Y coordinate to the bounding box.
- * This extends the bounding box to include the Y coordinate.
- * This function is used internally inside of addBezier.
- * @param {number} y - The Y coordinate of the point.
- */
-BoundingBox.prototype.addY = function(y) {
- this.addPoint(null, y);
-};
+ function Data(source, dest) {
+ this.source = source;
+ this.sourceIndex = 0;
+ this.tag = 0;
+ this.bitcount = 0;
+
+ this.dest = dest;
+ this.destLen = 0;
+
+ this.ltree = new Tree(); /* dynamic length/symbol tree */
+ this.dtree = new Tree(); /* dynamic distance tree */
+ }
-/**
- * Add a Bézier curve to the bounding box.
- * This extends the bounding box to include the entire Bézier.
- * @param {number} x0 - The starting X coordinate.
- * @param {number} y0 - The starting Y coordinate.
- * @param {number} x1 - The X coordinate of the first control point.
- * @param {number} y1 - The Y coordinate of the first control point.
- * @param {number} x2 - The X coordinate of the second control point.
- * @param {number} y2 - The Y coordinate of the second control point.
- * @param {number} x - The ending X coordinate.
- * @param {number} y - The ending Y coordinate.
- */
-BoundingBox.prototype.addBezier = function(x0, y0, x1, y1, x2, y2, x, y) {
- // This code is based on http://nishiohirokazu.blogspot.com/2009/06/how-to-calculate-bezier-curves-bounding.html
- // and https://github.com/icons8/svg-path-bounding-box
+ /* --------------------------------------------------- *
+ * -- uninitialized global data (static structures) -- *
+ * --------------------------------------------------- */
+
+ var sltree = new Tree();
+ var sdtree = new Tree();
+
+ /* extra bits and base tables for length codes */
+ var length_bits = new Uint8Array(30);
+ var length_base = new Uint16Array(30);
+
+ /* extra bits and base tables for distance codes */
+ var dist_bits = new Uint8Array(30);
+ var dist_base = new Uint16Array(30);
+
+ /* special ordering of code length codes */
+ var clcidx = new Uint8Array([
+ 16, 17, 18, 0, 8, 7, 9, 6,
+ 10, 5, 11, 4, 12, 3, 13, 2,
+ 14, 1, 15
+ ]);
+
+ /* used by tinf_decode_trees, avoids allocations every call */
+ var code_tree = new Tree();
+ var lengths = new Uint8Array(288 + 32);
+
+ /* ----------------------- *
+ * -- utility functions -- *
+ * ----------------------- */
+
+ /* build extra bits and base tables */
+ function tinf_build_bits_base(bits, base, delta, first) {
+ var i, sum;
+
+ /* build bits table */
+ for (i = 0; i < delta; ++i) { bits[i] = 0; }
+ for (i = 0; i < 30 - delta; ++i) { bits[i + delta] = i / delta | 0; }
+
+ /* build base table */
+ for (sum = first, i = 0; i < 30; ++i) {
+ base[i] = sum;
+ sum += 1 << bits[i];
+ }
+ }
- var p0 = [x0, y0];
- var p1 = [x1, y1];
- var p2 = [x2, y2];
- var p3 = [x, y];
+ /* build the fixed huffman trees */
+ function tinf_build_fixed_trees(lt, dt) {
+ var i;
- this.addPoint(x0, y0);
- this.addPoint(x, y);
+ /* build fixed length tree */
+ for (i = 0; i < 7; ++i) { lt.table[i] = 0; }
- for (var i = 0; i <= 1; i++) {
- var b = 6 * p0[i] - 12 * p1[i] + 6 * p2[i];
- var a = -3 * p0[i] + 9 * p1[i] - 9 * p2[i] + 3 * p3[i];
- var c = 3 * p1[i] - 3 * p0[i];
+ lt.table[7] = 24;
+ lt.table[8] = 152;
+ lt.table[9] = 112;
- if (a === 0) {
- if (b === 0) continue;
- var t = -c / b;
- if (0 < t && t < 1) {
- if (i === 0) this.addX(derive(p0[i], p1[i], p2[i], p3[i], t));
- if (i === 1) this.addY(derive(p0[i], p1[i], p2[i], p3[i], t));
- }
- continue;
- }
+ for (i = 0; i < 24; ++i) { lt.trans[i] = 256 + i; }
+ for (i = 0; i < 144; ++i) { lt.trans[24 + i] = i; }
+ for (i = 0; i < 8; ++i) { lt.trans[24 + 144 + i] = 280 + i; }
+ for (i = 0; i < 112; ++i) { lt.trans[24 + 144 + 8 + i] = 144 + i; }
- var b2ac = Math.pow(b, 2) - 4 * c * a;
- if (b2ac < 0) continue;
- var t1 = (-b + Math.sqrt(b2ac)) / (2 * a);
- if (0 < t1 && t1 < 1) {
- if (i === 0) this.addX(derive(p0[i], p1[i], p2[i], p3[i], t1));
- if (i === 1) this.addY(derive(p0[i], p1[i], p2[i], p3[i], t1));
- }
- var t2 = (-b - Math.sqrt(b2ac)) / (2 * a);
- if (0 < t2 && t2 < 1) {
- if (i === 0) this.addX(derive(p0[i], p1[i], p2[i], p3[i], t2));
- if (i === 1) this.addY(derive(p0[i], p1[i], p2[i], p3[i], t2));
- }
- }
-};
+ /* build fixed distance tree */
+ for (i = 0; i < 5; ++i) { dt.table[i] = 0; }
-/**
- * Add a quadratic curve to the bounding box.
- * This extends the bounding box to include the entire quadratic curve.
- * @param {number} x0 - The starting X coordinate.
- * @param {number} y0 - The starting Y coordinate.
- * @param {number} x1 - The X coordinate of the control point.
- * @param {number} y1 - The Y coordinate of the control point.
- * @param {number} x - The ending X coordinate.
- * @param {number} y - The ending Y coordinate.
- */
-BoundingBox.prototype.addQuad = function(x0, y0, x1, y1, x, y) {
- var cp1x = x0 + 2 / 3 * (x1 - x0);
- var cp1y = y0 + 2 / 3 * (y1 - y0);
- var cp2x = cp1x + 1 / 3 * (x - x0);
- var cp2y = cp1y + 1 / 3 * (y - y0);
- this.addBezier(x0, y0, cp1x, cp1y, cp2x, cp2y, x, y);
-};
+ dt.table[5] = 32;
-exports.BoundingBox = BoundingBox;
+ for (i = 0; i < 32; ++i) { dt.trans[i] = i; }
+ }
-},{}],10:[function(_dereq_,module,exports){
-// Run-time checking of preconditions.
+ /* given an array of code lengths, build a tree */
+ var offs = new Uint16Array(16);
-'use strict';
+ function tinf_build_tree(t, lengths, off, num) {
+ var i, sum;
-exports.fail = function(message) {
- throw new Error(message);
-};
+ /* clear code length count table */
+ for (i = 0; i < 16; ++i) { t.table[i] = 0; }
-// Precondition function that checks if the given predicate is true.
-// If not, it will throw an error.
-exports.argument = function(predicate, message) {
- if (!predicate) {
- exports.fail(message);
- }
-};
+ /* scan symbol lengths, and sum code length counts */
+ for (i = 0; i < num; ++i) { t.table[lengths[off + i]]++; }
-// Precondition function that checks if the given assertion is true.
-// If not, it will throw an error.
-exports.assert = exports.argument;
+ t.table[0] = 0;
-},{}],11:[function(_dereq_,module,exports){
-// Drawing utility functions.
+ /* compute offset table for distribution sort */
+ for (sum = 0, i = 0; i < 16; ++i) {
+ offs[i] = sum;
+ sum += t.table[i];
+ }
-'use strict';
+ /* create code->symbol translation table (symbols sorted by code) */
+ for (i = 0; i < num; ++i) {
+ if (lengths[off + i]) { t.trans[offs[lengths[off + i]]++] = i; }
+ }
+ }
-// Draw a line on the given context from point `x1,y1` to point `x2,y2`.
-function line(ctx, x1, y1, x2, y2) {
- ctx.beginPath();
- ctx.moveTo(x1, y1);
- ctx.lineTo(x2, y2);
- ctx.stroke();
-}
+ /* ---------------------- *
+ * -- decode functions -- *
+ * ---------------------- */
-exports.line = line;
+ /* get one bit from source stream */
+ function tinf_getbit(d) {
+ /* check if tag is empty */
+ if (!d.bitcount--) {
+ /* load next tag */
+ d.tag = d.source[d.sourceIndex++];
+ d.bitcount = 7;
+ }
-},{}],12:[function(_dereq_,module,exports){
-// Glyph encoding
+ /* shift bit out of tag */
+ var bit = d.tag & 1;
+ d.tag >>>= 1;
-'use strict';
+ return bit;
+ }
-var cffStandardStrings = [
- '.notdef', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', 'ampersand', 'quoteright',
- 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', 'zero', 'one', 'two',
- 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', 'equal', 'greater',
- 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S',
- 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', 'asciicircum', 'underscore',
- 'quoteleft', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't',
- 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', 'exclamdown', 'cent', 'sterling',
- 'fraction', 'yen', 'florin', 'section', 'currency', 'quotesingle', 'quotedblleft', 'guillemotleft',
- 'guilsinglleft', 'guilsinglright', 'fi', 'fl', 'endash', 'dagger', 'daggerdbl', 'periodcentered', 'paragraph',
- 'bullet', 'quotesinglbase', 'quotedblbase', 'quotedblright', 'guillemotright', 'ellipsis', 'perthousand',
- 'questiondown', 'grave', 'acute', 'circumflex', 'tilde', 'macron', 'breve', 'dotaccent', 'dieresis', 'ring',
- 'cedilla', 'hungarumlaut', 'ogonek', 'caron', 'emdash', 'AE', 'ordfeminine', 'Lslash', 'Oslash', 'OE',
- 'ordmasculine', 'ae', 'dotlessi', 'lslash', 'oslash', 'oe', 'germandbls', 'onesuperior', 'logicalnot', 'mu',
- 'trademark', 'Eth', 'onehalf', 'plusminus', 'Thorn', 'onequarter', 'divide', 'brokenbar', 'degree', 'thorn',
- 'threequarters', 'twosuperior', 'registered', 'minus', 'eth', 'multiply', 'threesuperior', 'copyright',
- 'Aacute', 'Acircumflex', 'Adieresis', 'Agrave', 'Aring', 'Atilde', 'Ccedilla', 'Eacute', 'Ecircumflex',
- 'Edieresis', 'Egrave', 'Iacute', 'Icircumflex', 'Idieresis', 'Igrave', 'Ntilde', 'Oacute', 'Ocircumflex',
- 'Odieresis', 'Ograve', 'Otilde', 'Scaron', 'Uacute', 'Ucircumflex', 'Udieresis', 'Ugrave', 'Yacute',
- 'Ydieresis', 'Zcaron', 'aacute', 'acircumflex', 'adieresis', 'agrave', 'aring', 'atilde', 'ccedilla', 'eacute',
- 'ecircumflex', 'edieresis', 'egrave', 'iacute', 'icircumflex', 'idieresis', 'igrave', 'ntilde', 'oacute',
- 'ocircumflex', 'odieresis', 'ograve', 'otilde', 'scaron', 'uacute', 'ucircumflex', 'udieresis', 'ugrave',
- 'yacute', 'ydieresis', 'zcaron', 'exclamsmall', 'Hungarumlautsmall', 'dollaroldstyle', 'dollarsuperior',
- 'ampersandsmall', 'Acutesmall', 'parenleftsuperior', 'parenrightsuperior', '266 ff', 'onedotenleader',
- 'zerooldstyle', 'oneoldstyle', 'twooldstyle', 'threeoldstyle', 'fouroldstyle', 'fiveoldstyle', 'sixoldstyle',
- 'sevenoldstyle', 'eightoldstyle', 'nineoldstyle', 'commasuperior', 'threequartersemdash', 'periodsuperior',
- 'questionsmall', 'asuperior', 'bsuperior', 'centsuperior', 'dsuperior', 'esuperior', 'isuperior', 'lsuperior',
- 'msuperior', 'nsuperior', 'osuperior', 'rsuperior', 'ssuperior', 'tsuperior', 'ff', 'ffi', 'ffl',
- 'parenleftinferior', 'parenrightinferior', 'Circumflexsmall', 'hyphensuperior', 'Gravesmall', 'Asmall',
- 'Bsmall', 'Csmall', 'Dsmall', 'Esmall', 'Fsmall', 'Gsmall', 'Hsmall', 'Ismall', 'Jsmall', 'Ksmall', 'Lsmall',
- 'Msmall', 'Nsmall', 'Osmall', 'Psmall', 'Qsmall', 'Rsmall', 'Ssmall', 'Tsmall', 'Usmall', 'Vsmall', 'Wsmall',
- 'Xsmall', 'Ysmall', 'Zsmall', 'colonmonetary', 'onefitted', 'rupiah', 'Tildesmall', 'exclamdownsmall',
- 'centoldstyle', 'Lslashsmall', 'Scaronsmall', 'Zcaronsmall', 'Dieresissmall', 'Brevesmall', 'Caronsmall',
- 'Dotaccentsmall', 'Macronsmall', 'figuredash', 'hypheninferior', 'Ogoneksmall', 'Ringsmall', 'Cedillasmall',
- 'questiondownsmall', 'oneeighth', 'threeeighths', 'fiveeighths', 'seveneighths', 'onethird', 'twothirds',
- 'zerosuperior', 'foursuperior', 'fivesuperior', 'sixsuperior', 'sevensuperior', 'eightsuperior', 'ninesuperior',
- 'zeroinferior', 'oneinferior', 'twoinferior', 'threeinferior', 'fourinferior', 'fiveinferior', 'sixinferior',
- 'seveninferior', 'eightinferior', 'nineinferior', 'centinferior', 'dollarinferior', 'periodinferior',
- 'commainferior', 'Agravesmall', 'Aacutesmall', 'Acircumflexsmall', 'Atildesmall', 'Adieresissmall',
- 'Aringsmall', 'AEsmall', 'Ccedillasmall', 'Egravesmall', 'Eacutesmall', 'Ecircumflexsmall', 'Edieresissmall',
- 'Igravesmall', 'Iacutesmall', 'Icircumflexsmall', 'Idieresissmall', 'Ethsmall', 'Ntildesmall', 'Ogravesmall',
- 'Oacutesmall', 'Ocircumflexsmall', 'Otildesmall', 'Odieresissmall', 'OEsmall', 'Oslashsmall', 'Ugravesmall',
- 'Uacutesmall', 'Ucircumflexsmall', 'Udieresissmall', 'Yacutesmall', 'Thornsmall', 'Ydieresissmall', '001.000',
- '001.001', '001.002', '001.003', 'Black', 'Bold', 'Book', 'Light', 'Medium', 'Regular', 'Roman', 'Semibold'];
-
-var cffStandardEncoding = [
- '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
- '', '', '', '', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', 'ampersand', 'quoteright',
- 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', 'zero', 'one', 'two',
- 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', 'equal', 'greater',
- 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S',
- 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', 'asciicircum', 'underscore',
- 'quoteleft', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't',
- 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', '', '', '', '', '', '', '', '',
- '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
- 'exclamdown', 'cent', 'sterling', 'fraction', 'yen', 'florin', 'section', 'currency', 'quotesingle',
- 'quotedblleft', 'guillemotleft', 'guilsinglleft', 'guilsinglright', 'fi', 'fl', '', 'endash', 'dagger',
- 'daggerdbl', 'periodcentered', '', 'paragraph', 'bullet', 'quotesinglbase', 'quotedblbase', 'quotedblright',
- 'guillemotright', 'ellipsis', 'perthousand', '', 'questiondown', '', 'grave', 'acute', 'circumflex', 'tilde',
- 'macron', 'breve', 'dotaccent', 'dieresis', '', 'ring', 'cedilla', '', 'hungarumlaut', 'ogonek', 'caron',
- 'emdash', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', 'AE', '', 'ordfeminine', '', '', '',
- '', 'Lslash', 'Oslash', 'OE', 'ordmasculine', '', '', '', '', '', 'ae', '', '', '', 'dotlessi', '', '',
- 'lslash', 'oslash', 'oe', 'germandbls'];
-
-var cffExpertEncoding = [
- '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
- '', '', '', '', 'space', 'exclamsmall', 'Hungarumlautsmall', '', 'dollaroldstyle', 'dollarsuperior',
- 'ampersandsmall', 'Acutesmall', 'parenleftsuperior', 'parenrightsuperior', 'twodotenleader', 'onedotenleader',
- 'comma', 'hyphen', 'period', 'fraction', 'zerooldstyle', 'oneoldstyle', 'twooldstyle', 'threeoldstyle',
- 'fouroldstyle', 'fiveoldstyle', 'sixoldstyle', 'sevenoldstyle', 'eightoldstyle', 'nineoldstyle', 'colon',
- 'semicolon', 'commasuperior', 'threequartersemdash', 'periodsuperior', 'questionsmall', '', 'asuperior',
- 'bsuperior', 'centsuperior', 'dsuperior', 'esuperior', '', '', 'isuperior', '', '', 'lsuperior', 'msuperior',
- 'nsuperior', 'osuperior', '', '', 'rsuperior', 'ssuperior', 'tsuperior', '', 'ff', 'fi', 'fl', 'ffi', 'ffl',
- 'parenleftinferior', '', 'parenrightinferior', 'Circumflexsmall', 'hyphensuperior', 'Gravesmall', 'Asmall',
- 'Bsmall', 'Csmall', 'Dsmall', 'Esmall', 'Fsmall', 'Gsmall', 'Hsmall', 'Ismall', 'Jsmall', 'Ksmall', 'Lsmall',
- 'Msmall', 'Nsmall', 'Osmall', 'Psmall', 'Qsmall', 'Rsmall', 'Ssmall', 'Tsmall', 'Usmall', 'Vsmall', 'Wsmall',
- 'Xsmall', 'Ysmall', 'Zsmall', 'colonmonetary', 'onefitted', 'rupiah', 'Tildesmall', '', '', '', '', '', '', '',
- '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
- 'exclamdownsmall', 'centoldstyle', 'Lslashsmall', '', '', 'Scaronsmall', 'Zcaronsmall', 'Dieresissmall',
- 'Brevesmall', 'Caronsmall', '', 'Dotaccentsmall', '', '', 'Macronsmall', '', '', 'figuredash', 'hypheninferior',
- '', '', 'Ogoneksmall', 'Ringsmall', 'Cedillasmall', '', '', '', 'onequarter', 'onehalf', 'threequarters',
- 'questiondownsmall', 'oneeighth', 'threeeighths', 'fiveeighths', 'seveneighths', 'onethird', 'twothirds', '',
- '', 'zerosuperior', 'onesuperior', 'twosuperior', 'threesuperior', 'foursuperior', 'fivesuperior',
- 'sixsuperior', 'sevensuperior', 'eightsuperior', 'ninesuperior', 'zeroinferior', 'oneinferior', 'twoinferior',
- 'threeinferior', 'fourinferior', 'fiveinferior', 'sixinferior', 'seveninferior', 'eightinferior',
- 'nineinferior', 'centinferior', 'dollarinferior', 'periodinferior', 'commainferior', 'Agravesmall',
- 'Aacutesmall', 'Acircumflexsmall', 'Atildesmall', 'Adieresissmall', 'Aringsmall', 'AEsmall', 'Ccedillasmall',
- 'Egravesmall', 'Eacutesmall', 'Ecircumflexsmall', 'Edieresissmall', 'Igravesmall', 'Iacutesmall',
- 'Icircumflexsmall', 'Idieresissmall', 'Ethsmall', 'Ntildesmall', 'Ogravesmall', 'Oacutesmall',
- 'Ocircumflexsmall', 'Otildesmall', 'Odieresissmall', 'OEsmall', 'Oslashsmall', 'Ugravesmall', 'Uacutesmall',
- 'Ucircumflexsmall', 'Udieresissmall', 'Yacutesmall', 'Thornsmall', 'Ydieresissmall'];
-
-var standardNames = [
- '.notdef', '.null', 'nonmarkingreturn', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent',
- 'ampersand', 'quotesingle', 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash',
- 'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less',
- 'equal', 'greater', 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O',
- 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright',
- 'asciicircum', 'underscore', 'grave', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o',
- 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde',
- 'Adieresis', 'Aring', 'Ccedilla', 'Eacute', 'Ntilde', 'Odieresis', 'Udieresis', 'aacute', 'agrave',
- 'acircumflex', 'adieresis', 'atilde', 'aring', 'ccedilla', 'eacute', 'egrave', 'ecircumflex', 'edieresis',
- 'iacute', 'igrave', 'icircumflex', 'idieresis', 'ntilde', 'oacute', 'ograve', 'ocircumflex', 'odieresis',
- 'otilde', 'uacute', 'ugrave', 'ucircumflex', 'udieresis', 'dagger', 'degree', 'cent', 'sterling', 'section',
- 'bullet', 'paragraph', 'germandbls', 'registered', 'copyright', 'trademark', 'acute', 'dieresis', 'notequal',
- 'AE', 'Oslash', 'infinity', 'plusminus', 'lessequal', 'greaterequal', 'yen', 'mu', 'partialdiff', 'summation',
- 'product', 'pi', 'integral', 'ordfeminine', 'ordmasculine', 'Omega', 'ae', 'oslash', 'questiondown',
- 'exclamdown', 'logicalnot', 'radical', 'florin', 'approxequal', 'Delta', 'guillemotleft', 'guillemotright',
- 'ellipsis', 'nonbreakingspace', 'Agrave', 'Atilde', 'Otilde', 'OE', 'oe', 'endash', 'emdash', 'quotedblleft',
- 'quotedblright', 'quoteleft', 'quoteright', 'divide', 'lozenge', 'ydieresis', 'Ydieresis', 'fraction',
- 'currency', 'guilsinglleft', 'guilsinglright', 'fi', 'fl', 'daggerdbl', 'periodcentered', 'quotesinglbase',
- 'quotedblbase', 'perthousand', 'Acircumflex', 'Ecircumflex', 'Aacute', 'Edieresis', 'Egrave', 'Iacute',
- 'Icircumflex', 'Idieresis', 'Igrave', 'Oacute', 'Ocircumflex', 'apple', 'Ograve', 'Uacute', 'Ucircumflex',
- 'Ugrave', 'dotlessi', 'circumflex', 'tilde', 'macron', 'breve', 'dotaccent', 'ring', 'cedilla', 'hungarumlaut',
- 'ogonek', 'caron', 'Lslash', 'lslash', 'Scaron', 'scaron', 'Zcaron', 'zcaron', 'brokenbar', 'Eth', 'eth',
- 'Yacute', 'yacute', 'Thorn', 'thorn', 'minus', 'multiply', 'onesuperior', 'twosuperior', 'threesuperior',
- 'onehalf', 'onequarter', 'threequarters', 'franc', 'Gbreve', 'gbreve', 'Idotaccent', 'Scedilla', 'scedilla',
- 'Cacute', 'cacute', 'Ccaron', 'ccaron', 'dcroat'];
-
-/**
- * This is the encoding used for fonts created from scratch.
- * It loops through all glyphs and finds the appropriate unicode value.
- * Since it's linear time, other encodings will be faster.
- * @exports opentype.DefaultEncoding
- * @class
- * @constructor
- * @param {opentype.Font}
- */
-function DefaultEncoding(font) {
- this.font = font;
-}
+ /* read a num bit value from a stream and add base */
+ function tinf_read_bits(d, num, base) {
+ if (!num)
+ { return base; }
-DefaultEncoding.prototype.charToGlyphIndex = function(c) {
- var code = c.charCodeAt(0);
- var glyphs = this.font.glyphs;
- if (glyphs) {
- for (var i = 0; i < glyphs.length; i += 1) {
- var glyph = glyphs.get(i);
- for (var j = 0; j < glyph.unicodes.length; j += 1) {
- if (glyph.unicodes[j] === code) {
- return i;
- }
- }
- }
- } else {
- return null;
- }
-};
+ while (d.bitcount < 24) {
+ d.tag |= d.source[d.sourceIndex++] << d.bitcount;
+ d.bitcount += 8;
+ }
-/**
- * @exports opentype.CmapEncoding
- * @class
- * @constructor
- * @param {Object} cmap - a object with the cmap encoded data
- */
-function CmapEncoding(cmap) {
- this.cmap = cmap;
-}
+ var val = d.tag & (0xffff >>> (16 - num));
+ d.tag >>>= num;
+ d.bitcount -= num;
+ return val + base;
+ }
-/**
- * @param {string} c - the character
- * @return {number} The glyph index.
- */
-CmapEncoding.prototype.charToGlyphIndex = function(c) {
- return this.cmap.glyphIndexMap[c.charCodeAt(0)] || 0;
-};
+ /* given a data stream and a tree, decode a symbol */
+ function tinf_decode_symbol(d, t) {
+ while (d.bitcount < 24) {
+ d.tag |= d.source[d.sourceIndex++] << d.bitcount;
+ d.bitcount += 8;
+ }
+
+ var sum = 0, cur = 0, len = 0;
+ var tag = d.tag;
+
+ /* get more bits while code value is above sum */
+ do {
+ cur = 2 * cur + (tag & 1);
+ tag >>>= 1;
+ ++len;
+
+ sum += t.table[len];
+ cur -= t.table[len];
+ } while (cur >= 0);
+
+ d.tag = tag;
+ d.bitcount -= len;
+
+ return t.trans[sum + cur];
+ }
-/**
- * @exports opentype.CffEncoding
- * @class
- * @constructor
- * @param {string} encoding - The encoding
- * @param {Array} charset - The charcater set.
- */
-function CffEncoding(encoding, charset) {
- this.encoding = encoding;
- this.charset = charset;
-}
+ /* given a data stream, decode dynamic trees from it */
+ function tinf_decode_trees(d, lt, dt) {
+ var hlit, hdist, hclen;
+ var i, num, length;
+
+ /* get 5 bits HLIT (257-286) */
+ hlit = tinf_read_bits(d, 5, 257);
+
+ /* get 5 bits HDIST (1-32) */
+ hdist = tinf_read_bits(d, 5, 1);
+
+ /* get 4 bits HCLEN (4-19) */
+ hclen = tinf_read_bits(d, 4, 4);
+
+ for (i = 0; i < 19; ++i) { lengths[i] = 0; }
+
+ /* read code lengths for code length alphabet */
+ for (i = 0; i < hclen; ++i) {
+ /* get 3 bits code length (0-7) */
+ var clen = tinf_read_bits(d, 3, 0);
+ lengths[clcidx[i]] = clen;
+ }
+
+ /* build code length tree */
+ tinf_build_tree(code_tree, lengths, 0, 19);
+
+ /* decode code lengths for the dynamic trees */
+ for (num = 0; num < hlit + hdist;) {
+ var sym = tinf_decode_symbol(d, code_tree);
+
+ switch (sym) {
+ case 16:
+ /* copy previous code length 3-6 times (read 2 bits) */
+ var prev = lengths[num - 1];
+ for (length = tinf_read_bits(d, 2, 3); length; --length) {
+ lengths[num++] = prev;
+ }
+ break;
+ case 17:
+ /* repeat code length 0 for 3-10 times (read 3 bits) */
+ for (length = tinf_read_bits(d, 3, 3); length; --length) {
+ lengths[num++] = 0;
+ }
+ break;
+ case 18:
+ /* repeat code length 0 for 11-138 times (read 7 bits) */
+ for (length = tinf_read_bits(d, 7, 11); length; --length) {
+ lengths[num++] = 0;
+ }
+ break;
+ default:
+ /* values 0-15 represent the actual code lengths */
+ lengths[num++] = sym;
+ break;
+ }
+ }
+
+ /* build dynamic trees */
+ tinf_build_tree(lt, lengths, 0, hlit);
+ tinf_build_tree(dt, lengths, hlit, hdist);
+ }
-/**
- * @param {string} s - The character
- * @return {number} The index.
- */
-CffEncoding.prototype.charToGlyphIndex = function(s) {
- var code = s.charCodeAt(0);
- var charName = this.encoding[code];
- return this.charset.indexOf(charName);
-};
+ /* ----------------------------- *
+ * -- block inflate functions -- *
+ * ----------------------------- */
-/**
- * @exports opentype.GlyphNames
- * @class
- * @constructor
- * @param {Object} post
- */
-function GlyphNames(post) {
- var i;
- switch (post.version) {
- case 1:
- this.names = exports.standardNames.slice();
- break;
- case 2:
- this.names = new Array(post.numberOfGlyphs);
- for (i = 0; i < post.numberOfGlyphs; i++) {
- if (post.glyphNameIndex[i] < exports.standardNames.length) {
- this.names[i] = exports.standardNames[post.glyphNameIndex[i]];
- } else {
- this.names[i] = post.names[post.glyphNameIndex[i] - exports.standardNames.length];
- }
- }
+ /* given a stream and two trees, inflate a block of data */
+ function tinf_inflate_block_data(d, lt, dt) {
+ while (1) {
+ var sym = tinf_decode_symbol(d, lt);
- break;
- case 2.5:
- this.names = new Array(post.numberOfGlyphs);
- for (i = 0; i < post.numberOfGlyphs; i++) {
- this.names[i] = exports.standardNames[i + post.glyphNameIndex[i]];
- }
+ /* check for end of block */
+ if (sym === 256) {
+ return TINF_OK;
+ }
- break;
- case 3:
- this.names = [];
- break;
- }
-}
+ if (sym < 256) {
+ d.dest[d.destLen++] = sym;
+ } else {
+ var length, dist, offs;
+ var i;
-/**
- * Gets the index of a glyph by name.
- * @param {string} name - The glyph name
- * @return {number} The index
- */
-GlyphNames.prototype.nameToGlyphIndex = function(name) {
- return this.names.indexOf(name);
-};
+ sym -= 257;
-/**
- * @param {number} gid
- * @return {string}
- */
-GlyphNames.prototype.glyphIndexToName = function(gid) {
- return this.names[gid];
-};
+ /* possibly get more bits from length code */
+ length = tinf_read_bits(d, length_bits[sym], length_base[sym]);
-/**
- * @alias opentype.addGlyphNames
- * @param {opentype.Font}
- */
-function addGlyphNames(font) {
- var glyph;
- var glyphIndexMap = font.tables.cmap.glyphIndexMap;
- var charCodes = Object.keys(glyphIndexMap);
+ dist = tinf_decode_symbol(d, dt);
- for (var i = 0; i < charCodes.length; i += 1) {
- var c = charCodes[i];
- var glyphIndex = glyphIndexMap[c];
- glyph = font.glyphs.get(glyphIndex);
- glyph.addUnicode(parseInt(c));
- }
+ /* possibly get more bits from distance code */
+ offs = d.destLen - tinf_read_bits(d, dist_bits[dist], dist_base[dist]);
- for (i = 0; i < font.glyphs.length; i += 1) {
- glyph = font.glyphs.get(i);
- if (font.cffEncoding) {
- if (font.isCIDFont) {
- glyph.name = 'gid' + i;
- } else {
- glyph.name = font.cffEncoding.charset[i];
- }
- } else if (font.glyphNames.names) {
- glyph.name = font.glyphNames.glyphIndexToName(i);
- }
- }
-}
+ /* copy match */
+ for (i = offs; i < offs + length; ++i) {
+ d.dest[d.destLen++] = d.dest[i];
+ }
+ }
+ }
+ }
-exports.cffStandardStrings = cffStandardStrings;
-exports.cffStandardEncoding = cffStandardEncoding;
-exports.cffExpertEncoding = cffExpertEncoding;
-exports.standardNames = standardNames;
-exports.DefaultEncoding = DefaultEncoding;
-exports.CmapEncoding = CmapEncoding;
-exports.CffEncoding = CffEncoding;
-exports.GlyphNames = GlyphNames;
-exports.addGlyphNames = addGlyphNames;
+ /* inflate an uncompressed block of data */
+ function tinf_inflate_uncompressed_block(d) {
+ var length, invlength;
+ var i;
+
+ /* unread from bitbuffer */
+ while (d.bitcount > 8) {
+ d.sourceIndex--;
+ d.bitcount -= 8;
+ }
-},{}],13:[function(_dereq_,module,exports){
-// The Font object
+ /* get length */
+ length = d.source[d.sourceIndex + 1];
+ length = 256 * length + d.source[d.sourceIndex];
-'use strict';
+ /* get one's complement of length */
+ invlength = d.source[d.sourceIndex + 3];
+ invlength = 256 * invlength + d.source[d.sourceIndex + 2];
-var path = _dereq_('./path');
-var sfnt = _dereq_('./tables/sfnt');
-var encoding = _dereq_('./encoding');
-var glyphset = _dereq_('./glyphset');
-var Substitution = _dereq_('./substitution');
-var util = _dereq_('./util');
-var HintingTrueType = _dereq_('./hintingtt');
-
-/**
- * @typedef FontOptions
- * @type Object
- * @property {Boolean} empty - whether to create a new empty font
- * @property {string} familyName
- * @property {string} styleName
- * @property {string=} fullName
- * @property {string=} postScriptName
- * @property {string=} designer
- * @property {string=} designerURL
- * @property {string=} manufacturer
- * @property {string=} manufacturerURL
- * @property {string=} license
- * @property {string=} licenseURL
- * @property {string=} version
- * @property {string=} description
- * @property {string=} copyright
- * @property {string=} trademark
- * @property {Number} unitsPerEm
- * @property {Number} ascender
- * @property {Number} descender
- * @property {Number} createdTimestamp
- * @property {string=} weightClass
- * @property {string=} widthClass
- * @property {string=} fsSelection
- */
-
-/**
- * A Font represents a loaded OpenType font file.
- * It contains a set of glyphs and methods to draw text on a drawing context,
- * or to get a path representing the text.
- * @exports opentype.Font
- * @class
- * @param {FontOptions}
- * @constructor
- */
-function Font(options) {
- options = options || {};
-
- if (!options.empty) {
- // Check that we've provided the minimum set of names.
- util.checkArgument(options.familyName, 'When creating a new Font object, familyName is required.');
- util.checkArgument(options.styleName, 'When creating a new Font object, styleName is required.');
- util.checkArgument(options.unitsPerEm, 'When creating a new Font object, unitsPerEm is required.');
- util.checkArgument(options.ascender, 'When creating a new Font object, ascender is required.');
- util.checkArgument(options.descender, 'When creating a new Font object, descender is required.');
- util.checkArgument(options.descender < 0, 'Descender should be negative (e.g. -512).');
-
- // OS X will complain if the names are empty, so we put a single space everywhere by default.
- this.names = {
- fontFamily: {en: options.familyName || ' '},
- fontSubfamily: {en: options.styleName || ' '},
- fullName: {en: options.fullName || options.familyName + ' ' + options.styleName},
- postScriptName: {en: options.postScriptName || options.familyName + options.styleName},
- designer: {en: options.designer || ' '},
- designerURL: {en: options.designerURL || ' '},
- manufacturer: {en: options.manufacturer || ' '},
- manufacturerURL: {en: options.manufacturerURL || ' '},
- license: {en: options.license || ' '},
- licenseURL: {en: options.licenseURL || ' '},
- version: {en: options.version || 'Version 0.1'},
- description: {en: options.description || ' '},
- copyright: {en: options.copyright || ' '},
- trademark: {en: options.trademark || ' '}
- };
- this.unitsPerEm = options.unitsPerEm || 1000;
- this.ascender = options.ascender;
- this.descender = options.descender;
- this.createdTimestamp = options.createdTimestamp;
- this.tables = { os2: {
- usWeightClass: options.weightClass || this.usWeightClasses.MEDIUM,
- usWidthClass: options.widthClass || this.usWidthClasses.MEDIUM,
- fsSelection: options.fsSelection || this.fsSelectionValues.REGULAR
- } };
- }
+ /* check length */
+ if (length !== (~invlength & 0x0000ffff))
+ { return TINF_DATA_ERROR; }
- this.supported = true; // Deprecated: parseBuffer will throw an error if font is not supported.
- this.glyphs = new glyphset.GlyphSet(this, options.glyphs || []);
- this.encoding = new encoding.DefaultEncoding(this);
- this.substitution = new Substitution(this);
- this.tables = this.tables || {};
-
- Object.defineProperty(this, 'hinting', {
- get: function() {
- if (this._hinting) return this._hinting;
- if (this.outlinesFormat === 'truetype') {
- return (this._hinting = new HintingTrueType(this));
- }
- }
- });
-}
+ d.sourceIndex += 4;
-/**
- * Check if the font has a glyph for the given character.
- * @param {string}
- * @return {Boolean}
- */
-Font.prototype.hasChar = function(c) {
- return this.encoding.charToGlyphIndex(c) !== null;
-};
+ /* copy block */
+ for (i = length; i; --i)
+ { d.dest[d.destLen++] = d.source[d.sourceIndex++]; }
-/**
- * Convert the given character to a single glyph index.
- * Note that this function assumes that there is a one-to-one mapping between
- * the given character and a glyph; for complex scripts this might not be the case.
- * @param {string}
- * @return {Number}
- */
-Font.prototype.charToGlyphIndex = function(s) {
- return this.encoding.charToGlyphIndex(s);
-};
+ /* make sure we start next block on a byte boundary */
+ d.bitcount = 0;
-/**
- * Convert the given character to a single Glyph object.
- * Note that this function assumes that there is a one-to-one mapping between
- * the given character and a glyph; for complex scripts this might not be the case.
- * @param {string}
- * @return {opentype.Glyph}
- */
-Font.prototype.charToGlyph = function(c) {
- var glyphIndex = this.charToGlyphIndex(c);
- var glyph = this.glyphs.get(glyphIndex);
- if (!glyph) {
- // .notdef
- glyph = this.glyphs.get(0);
- }
+ return TINF_OK;
+ }
- return glyph;
-};
+ /* inflate stream from source to dest */
+ function tinf_uncompress(source, dest) {
+ var d = new Data(source, dest);
+ var bfinal, btype, res;
+
+ do {
+ /* read final block flag */
+ bfinal = tinf_getbit(d);
+
+ /* read block type (2 bits) */
+ btype = tinf_read_bits(d, 2, 0);
+
+ /* decompress block */
+ switch (btype) {
+ case 0:
+ /* decompress uncompressed block */
+ res = tinf_inflate_uncompressed_block(d);
+ break;
+ case 1:
+ /* decompress block with fixed huffman trees */
+ res = tinf_inflate_block_data(d, sltree, sdtree);
+ break;
+ case 2:
+ /* decompress block with dynamic huffman trees */
+ tinf_decode_trees(d, d.ltree, d.dtree);
+ res = tinf_inflate_block_data(d, d.ltree, d.dtree);
+ break;
+ default:
+ res = TINF_DATA_ERROR;
+ }
+
+ if (res !== TINF_OK)
+ { throw new Error('Data error'); }
+
+ } while (!bfinal);
+
+ if (d.destLen < d.dest.length) {
+ if (typeof d.dest.slice === 'function')
+ { return d.dest.slice(0, d.destLen); }
+ else
+ { return d.dest.subarray(0, d.destLen); }
+ }
+
+ return d.dest;
+ }
-/**
- * Convert the given text to a list of Glyph objects.
- * Note that there is no strict one-to-one mapping between characters and
- * glyphs, so the list of returned glyphs can be larger or smaller than the
- * length of the given string.
- * @param {string}
- * @param {GlyphRenderOptions} [options]
- * @return {opentype.Glyph[]}
- */
-Font.prototype.stringToGlyphs = function(s, options) {
- options = options || this.defaultRenderOptions;
- var i;
- // Get glyph indexes
- var indexes = [];
- for (i = 0; i < s.length; i += 1) {
- var c = s[i];
- indexes.push(this.charToGlyphIndex(c));
- }
- var length = indexes.length;
-
- // Apply substitutions on glyph indexes
- if (options.features) {
- var script = options.script || this.substitution.getDefaultScriptName();
- var manyToOne = [];
- if (options.features.liga) manyToOne = manyToOne.concat(this.substitution.getFeature('liga', script, options.language));
- if (options.features.rlig) manyToOne = manyToOne.concat(this.substitution.getFeature('rlig', script, options.language));
- for (i = 0; i < length; i += 1) {
- for (var j = 0; j < manyToOne.length; j++) {
- var ligature = manyToOne[j];
- var components = ligature.sub;
- var compCount = components.length;
- var k = 0;
- while (k < compCount && components[k] === indexes[i + k]) k++;
- if (k === compCount) {
- indexes.splice(i, compCount, ligature.by);
- length = length - compCount + 1;
- }
- }
- }
- }
+ /* -------------------- *
+ * -- initialization -- *
+ * -------------------- */
- // convert glyph indexes to glyph objects
- var glyphs = new Array(length);
- var notdef = this.glyphs.get(0);
- for (i = 0; i < length; i += 1) {
- glyphs[i] = this.glyphs.get(indexes[i]) || notdef;
- }
- return glyphs;
-};
+ /* build fixed huffman trees */
+ tinf_build_fixed_trees(sltree, sdtree);
-/**
- * @param {string}
- * @return {Number}
- */
-Font.prototype.nameToGlyphIndex = function(name) {
- return this.glyphNames.nameToGlyphIndex(name);
-};
+ /* build extra bits and base tables */
+ tinf_build_bits_base(length_bits, length_base, 4, 3);
+ tinf_build_bits_base(dist_bits, dist_base, 2, 1);
-/**
- * @param {string}
- * @return {opentype.Glyph}
- */
-Font.prototype.nameToGlyph = function(name) {
- var glyphIndex = this.nameToGlyphIndex(name);
- var glyph = this.glyphs.get(glyphIndex);
- if (!glyph) {
- // .notdef
- glyph = this.glyphs.get(0);
- }
+ /* fix a special case */
+ length_bits[28] = 0;
+ length_base[28] = 258;
- return glyph;
-};
+ var tinyInflate = tinf_uncompress;
-/**
- * @param {Number}
- * @return {String}
- */
-Font.prototype.glyphIndexToName = function(gid) {
- if (!this.glyphNames.glyphIndexToName) {
- return '';
- }
+ // The Bounding Box object
- return this.glyphNames.glyphIndexToName(gid);
-};
+ function derive(v0, v1, v2, v3, t) {
+ return Math.pow(1 - t, 3) * v0 +
+ 3 * Math.pow(1 - t, 2) * t * v1 +
+ 3 * (1 - t) * Math.pow(t, 2) * v2 +
+ Math.pow(t, 3) * v3;
+ }
+ /**
+ * A bounding box is an enclosing box that describes the smallest measure within which all the points lie.
+ * It is used to calculate the bounding box of a glyph or text path.
+ *
+ * On initialization, x1/y1/x2/y2 will be NaN. Check if the bounding box is empty using `isEmpty()`.
+ *
+ * @exports opentype.BoundingBox
+ * @class
+ * @constructor
+ */
+ function BoundingBox() {
+ this.x1 = Number.NaN;
+ this.y1 = Number.NaN;
+ this.x2 = Number.NaN;
+ this.y2 = Number.NaN;
+ }
-/**
- * Retrieve the value of the kerning pair between the left glyph (or its index)
- * and the right glyph (or its index). If no kerning pair is found, return 0.
- * The kerning value gets added to the advance width when calculating the spacing
- * between glyphs.
- * @param {opentype.Glyph} leftGlyph
- * @param {opentype.Glyph} rightGlyph
- * @return {Number}
- */
-Font.prototype.getKerningValue = function(leftGlyph, rightGlyph) {
- leftGlyph = leftGlyph.index || leftGlyph;
- rightGlyph = rightGlyph.index || rightGlyph;
- var gposKerning = this.getGposKerningValue;
- return gposKerning ? gposKerning(leftGlyph, rightGlyph) :
- (this.kerningPairs[leftGlyph + ',' + rightGlyph] || 0);
-};
-
-/**
- * @typedef GlyphRenderOptions
- * @type Object
- * @property {string} [script] - script used to determine which features to apply. By default, 'DFLT' or 'latn' is used.
- * See https://www.microsoft.com/typography/otspec/scripttags.htm
- * @property {string} [language='dflt'] - language system used to determine which features to apply.
- * See https://www.microsoft.com/typography/developers/opentype/languagetags.aspx
- * @property {boolean} [kerning=true] - whether to include kerning values
- * @property {object} [features] - OpenType Layout feature tags. Used to enable or disable the features of the given script/language system.
- * See https://www.microsoft.com/typography/otspec/featuretags.htm
- */
-Font.prototype.defaultRenderOptions = {
- kerning: true,
- features: {
- liga: true,
- rlig: true
- }
-};
+ /**
+ * Returns true if the bounding box is empty, that is, no points have been added to the box yet.
+ */
+ BoundingBox.prototype.isEmpty = function() {
+ return isNaN(this.x1) || isNaN(this.y1) || isNaN(this.x2) || isNaN(this.y2);
+ };
+
+ /**
+ * Add the point to the bounding box.
+ * The x1/y1/x2/y2 coordinates of the bounding box will now encompass the given point.
+ * @param {number} x - The X coordinate of the point.
+ * @param {number} y - The Y coordinate of the point.
+ */
+ BoundingBox.prototype.addPoint = function(x, y) {
+ if (typeof x === 'number') {
+ if (isNaN(this.x1) || isNaN(this.x2)) {
+ this.x1 = x;
+ this.x2 = x;
+ }
+ if (x < this.x1) {
+ this.x1 = x;
+ }
+ if (x > this.x2) {
+ this.x2 = x;
+ }
+ }
+ if (typeof y === 'number') {
+ if (isNaN(this.y1) || isNaN(this.y2)) {
+ this.y1 = y;
+ this.y2 = y;
+ }
+ if (y < this.y1) {
+ this.y1 = y;
+ }
+ if (y > this.y2) {
+ this.y2 = y;
+ }
+ }
+ };
+
+ /**
+ * Add a X coordinate to the bounding box.
+ * This extends the bounding box to include the X coordinate.
+ * This function is used internally inside of addBezier.
+ * @param {number} x - The X coordinate of the point.
+ */
+ BoundingBox.prototype.addX = function(x) {
+ this.addPoint(x, null);
+ };
+
+ /**
+ * Add a Y coordinate to the bounding box.
+ * This extends the bounding box to include the Y coordinate.
+ * This function is used internally inside of addBezier.
+ * @param {number} y - The Y coordinate of the point.
+ */
+ BoundingBox.prototype.addY = function(y) {
+ this.addPoint(null, y);
+ };
+
+ /**
+ * Add a Bézier curve to the bounding box.
+ * This extends the bounding box to include the entire Bézier.
+ * @param {number} x0 - The starting X coordinate.
+ * @param {number} y0 - The starting Y coordinate.
+ * @param {number} x1 - The X coordinate of the first control point.
+ * @param {number} y1 - The Y coordinate of the first control point.
+ * @param {number} x2 - The X coordinate of the second control point.
+ * @param {number} y2 - The Y coordinate of the second control point.
+ * @param {number} x - The ending X coordinate.
+ * @param {number} y - The ending Y coordinate.
+ */
+ BoundingBox.prototype.addBezier = function(x0, y0, x1, y1, x2, y2, x, y) {
+ var this$1 = this;
+
+ // This code is based on http://nishiohirokazu.blogspot.com/2009/06/how-to-calculate-bezier-curves-bounding.html
+ // and https://github.com/icons8/svg-path-bounding-box
+
+ var p0 = [x0, y0];
+ var p1 = [x1, y1];
+ var p2 = [x2, y2];
+ var p3 = [x, y];
+
+ this.addPoint(x0, y0);
+ this.addPoint(x, y);
+
+ for (var i = 0; i <= 1; i++) {
+ var b = 6 * p0[i] - 12 * p1[i] + 6 * p2[i];
+ var a = -3 * p0[i] + 9 * p1[i] - 9 * p2[i] + 3 * p3[i];
+ var c = 3 * p1[i] - 3 * p0[i];
+
+ if (a === 0) {
+ if (b === 0) { continue; }
+ var t = -c / b;
+ if (0 < t && t < 1) {
+ if (i === 0) { this$1.addX(derive(p0[i], p1[i], p2[i], p3[i], t)); }
+ if (i === 1) { this$1.addY(derive(p0[i], p1[i], p2[i], p3[i], t)); }
+ }
+ continue;
+ }
+
+ var b2ac = Math.pow(b, 2) - 4 * c * a;
+ if (b2ac < 0) { continue; }
+ var t1 = (-b + Math.sqrt(b2ac)) / (2 * a);
+ if (0 < t1 && t1 < 1) {
+ if (i === 0) { this$1.addX(derive(p0[i], p1[i], p2[i], p3[i], t1)); }
+ if (i === 1) { this$1.addY(derive(p0[i], p1[i], p2[i], p3[i], t1)); }
+ }
+ var t2 = (-b - Math.sqrt(b2ac)) / (2 * a);
+ if (0 < t2 && t2 < 1) {
+ if (i === 0) { this$1.addX(derive(p0[i], p1[i], p2[i], p3[i], t2)); }
+ if (i === 1) { this$1.addY(derive(p0[i], p1[i], p2[i], p3[i], t2)); }
+ }
+ }
+ };
+
+ /**
+ * Add a quadratic curve to the bounding box.
+ * This extends the bounding box to include the entire quadratic curve.
+ * @param {number} x0 - The starting X coordinate.
+ * @param {number} y0 - The starting Y coordinate.
+ * @param {number} x1 - The X coordinate of the control point.
+ * @param {number} y1 - The Y coordinate of the control point.
+ * @param {number} x - The ending X coordinate.
+ * @param {number} y - The ending Y coordinate.
+ */
+ BoundingBox.prototype.addQuad = function(x0, y0, x1, y1, x, y) {
+ var cp1x = x0 + 2 / 3 * (x1 - x0);
+ var cp1y = y0 + 2 / 3 * (y1 - y0);
+ var cp2x = cp1x + 1 / 3 * (x - x0);
+ var cp2y = cp1y + 1 / 3 * (y - y0);
+ this.addBezier(x0, y0, cp1x, cp1y, cp2x, cp2y, x, y);
+ };
+
+ // Geometric objects
+
+ /**
+ * A bézier path containing a set of path commands similar to a SVG path.
+ * Paths can be drawn on a context using `draw`.
+ * @exports opentype.Path
+ * @class
+ * @constructor
+ */
+ function Path() {
+ this.commands = [];
+ this.fill = 'black';
+ this.stroke = null;
+ this.strokeWidth = 1;
+ }
-/**
- * Helper function that invokes the given callback for each glyph in the given text.
- * The callback gets `(glyph, x, y, fontSize, options)`.* @param {string} text
- * @param {string} text - The text to apply.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- * @param {Function} callback
- */
-Font.prototype.forEachGlyph = function(text, x, y, fontSize, options, callback) {
- x = x !== undefined ? x : 0;
- y = y !== undefined ? y : 0;
- fontSize = fontSize !== undefined ? fontSize : 72;
- options = options || this.defaultRenderOptions;
- var fontScale = 1 / this.unitsPerEm * fontSize;
- var glyphs = this.stringToGlyphs(text, options);
- for (var i = 0; i < glyphs.length; i += 1) {
- var glyph = glyphs[i];
- callback.call(this, glyph, x, y, fontSize, options);
- if (glyph.advanceWidth) {
- x += glyph.advanceWidth * fontScale;
- }
+ /**
+ * @param {number} x
+ * @param {number} y
+ */
+ Path.prototype.moveTo = function(x, y) {
+ this.commands.push({
+ type: 'M',
+ x: x,
+ y: y
+ });
+ };
+
+ /**
+ * @param {number} x
+ * @param {number} y
+ */
+ Path.prototype.lineTo = function(x, y) {
+ this.commands.push({
+ type: 'L',
+ x: x,
+ y: y
+ });
+ };
+
+ /**
+ * Draws cubic curve
+ * @function
+ * curveTo
+ * @memberof opentype.Path.prototype
+ * @param {number} x1 - x of control 1
+ * @param {number} y1 - y of control 1
+ * @param {number} x2 - x of control 2
+ * @param {number} y2 - y of control 2
+ * @param {number} x - x of path point
+ * @param {number} y - y of path point
+ */
+
+ /**
+ * Draws cubic curve
+ * @function
+ * bezierCurveTo
+ * @memberof opentype.Path.prototype
+ * @param {number} x1 - x of control 1
+ * @param {number} y1 - y of control 1
+ * @param {number} x2 - x of control 2
+ * @param {number} y2 - y of control 2
+ * @param {number} x - x of path point
+ * @param {number} y - y of path point
+ * @see curveTo
+ */
+ Path.prototype.curveTo = Path.prototype.bezierCurveTo = function(x1, y1, x2, y2, x, y) {
+ this.commands.push({
+ type: 'C',
+ x1: x1,
+ y1: y1,
+ x2: x2,
+ y2: y2,
+ x: x,
+ y: y
+ });
+ };
+
+ /**
+ * Draws quadratic curve
+ * @function
+ * quadraticCurveTo
+ * @memberof opentype.Path.prototype
+ * @param {number} x1 - x of control
+ * @param {number} y1 - y of control
+ * @param {number} x - x of path point
+ * @param {number} y - y of path point
+ */
+
+ /**
+ * Draws quadratic curve
+ * @function
+ * quadTo
+ * @memberof opentype.Path.prototype
+ * @param {number} x1 - x of control
+ * @param {number} y1 - y of control
+ * @param {number} x - x of path point
+ * @param {number} y - y of path point
+ */
+ Path.prototype.quadTo = Path.prototype.quadraticCurveTo = function(x1, y1, x, y) {
+ this.commands.push({
+ type: 'Q',
+ x1: x1,
+ y1: y1,
+ x: x,
+ y: y
+ });
+ };
+
+ /**
+ * Closes the path
+ * @function closePath
+ * @memberof opentype.Path.prototype
+ */
+
+ /**
+ * Close the path
+ * @function close
+ * @memberof opentype.Path.prototype
+ */
+ Path.prototype.close = Path.prototype.closePath = function() {
+ this.commands.push({
+ type: 'Z'
+ });
+ };
+
+ /**
+ * Add the given path or list of commands to the commands of this path.
+ * @param {Array} pathOrCommands - another opentype.Path, an opentype.BoundingBox, or an array of commands.
+ */
+ Path.prototype.extend = function(pathOrCommands) {
+ if (pathOrCommands.commands) {
+ pathOrCommands = pathOrCommands.commands;
+ } else if (pathOrCommands instanceof BoundingBox) {
+ var box = pathOrCommands;
+ this.moveTo(box.x1, box.y1);
+ this.lineTo(box.x2, box.y1);
+ this.lineTo(box.x2, box.y2);
+ this.lineTo(box.x1, box.y2);
+ this.close();
+ return;
+ }
+
+ Array.prototype.push.apply(this.commands, pathOrCommands);
+ };
+
+ /**
+ * Calculate the bounding box of the path.
+ * @returns {opentype.BoundingBox}
+ */
+ Path.prototype.getBoundingBox = function() {
+ var this$1 = this;
+
+ var box = new BoundingBox();
+
+ var startX = 0;
+ var startY = 0;
+ var prevX = 0;
+ var prevY = 0;
+ for (var i = 0; i < this.commands.length; i++) {
+ var cmd = this$1.commands[i];
+ switch (cmd.type) {
+ case 'M':
+ box.addPoint(cmd.x, cmd.y);
+ startX = prevX = cmd.x;
+ startY = prevY = cmd.y;
+ break;
+ case 'L':
+ box.addPoint(cmd.x, cmd.y);
+ prevX = cmd.x;
+ prevY = cmd.y;
+ break;
+ case 'Q':
+ box.addQuad(prevX, prevY, cmd.x1, cmd.y1, cmd.x, cmd.y);
+ prevX = cmd.x;
+ prevY = cmd.y;
+ break;
+ case 'C':
+ box.addBezier(prevX, prevY, cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
+ prevX = cmd.x;
+ prevY = cmd.y;
+ break;
+ case 'Z':
+ prevX = startX;
+ prevY = startY;
+ break;
+ default:
+ throw new Error('Unexpected path command ' + cmd.type);
+ }
+ }
+ if (box.isEmpty()) {
+ box.addPoint(0, 0);
+ }
+ return box;
+ };
+
+ /**
+ * Draw the path to a 2D context.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context.
+ */
+ Path.prototype.draw = function(ctx) {
+ var this$1 = this;
+
+ ctx.beginPath();
+ for (var i = 0; i < this.commands.length; i += 1) {
+ var cmd = this$1.commands[i];
+ if (cmd.type === 'M') {
+ ctx.moveTo(cmd.x, cmd.y);
+ } else if (cmd.type === 'L') {
+ ctx.lineTo(cmd.x, cmd.y);
+ } else if (cmd.type === 'C') {
+ ctx.bezierCurveTo(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
+ } else if (cmd.type === 'Q') {
+ ctx.quadraticCurveTo(cmd.x1, cmd.y1, cmd.x, cmd.y);
+ } else if (cmd.type === 'Z') {
+ ctx.closePath();
+ }
+ }
+
+ if (this.fill) {
+ ctx.fillStyle = this.fill;
+ ctx.fill();
+ }
+
+ if (this.stroke) {
+ ctx.strokeStyle = this.stroke;
+ ctx.lineWidth = this.strokeWidth;
+ ctx.stroke();
+ }
+ };
+
+ /**
+ * Convert the Path to a string of path data instructions
+ * See http://www.w3.org/TR/SVG/paths.html#PathData
+ * @param {number} [decimalPlaces=2] - The amount of decimal places for floating-point values
+ * @return {string}
+ */
+ Path.prototype.toPathData = function(decimalPlaces) {
+ var this$1 = this;
+
+ decimalPlaces = decimalPlaces !== undefined ? decimalPlaces : 2;
+
+ function floatToString(v) {
+ if (Math.round(v) === v) {
+ return '' + Math.round(v);
+ } else {
+ return v.toFixed(decimalPlaces);
+ }
+ }
+
+ function packValues() {
+ var arguments$1 = arguments;
+
+ var s = '';
+ for (var i = 0; i < arguments.length; i += 1) {
+ var v = arguments$1[i];
+ if (v >= 0 && i > 0) {
+ s += ' ';
+ }
+
+ s += floatToString(v);
+ }
+
+ return s;
+ }
+
+ var d = '';
+ for (var i = 0; i < this.commands.length; i += 1) {
+ var cmd = this$1.commands[i];
+ if (cmd.type === 'M') {
+ d += 'M' + packValues(cmd.x, cmd.y);
+ } else if (cmd.type === 'L') {
+ d += 'L' + packValues(cmd.x, cmd.y);
+ } else if (cmd.type === 'C') {
+ d += 'C' + packValues(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
+ } else if (cmd.type === 'Q') {
+ d += 'Q' + packValues(cmd.x1, cmd.y1, cmd.x, cmd.y);
+ } else if (cmd.type === 'Z') {
+ d += 'Z';
+ }
+ }
+
+ return d;
+ };
+
+ /**
+ * Convert the path to an SVG element, as a string.
+ * @param {number} [decimalPlaces=2] - The amount of decimal places for floating-point values
+ * @return {string}
+ */
+ Path.prototype.toSVG = function(decimalPlaces) {
+ var svg = '= 0 && v <= 255, 'Byte value should be between 0 and 255.');
+ return [v];
+ };
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.BYTE = constant(1);
+
+ /**
+ * Convert a 8-bit signed integer to a list of 1 byte.
+ * @param {string}
+ * @returns {Array}
+ */
+ encode.CHAR = function(v) {
+ return [v.charCodeAt(0)];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.CHAR = constant(1);
+
+ /**
+ * Convert an ASCII string to a list of bytes.
+ * @param {string}
+ * @returns {Array}
+ */
+ encode.CHARARRAY = function(v) {
+ var b = [];
+ for (var i = 0; i < v.length; i += 1) {
+ b[i] = v.charCodeAt(i);
+ }
+
+ return b;
+ };
+
+ /**
+ * @param {Array}
+ * @returns {number}
+ */
+ sizeOf.CHARARRAY = function(v) {
+ return v.length;
+ };
+
+ /**
+ * Convert a 16-bit unsigned integer to a list of 2 bytes.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.USHORT = function(v) {
+ return [(v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.USHORT = constant(2);
+
+ /**
+ * Convert a 16-bit signed integer to a list of 2 bytes.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.SHORT = function(v) {
+ // Two's complement
+ if (v >= LIMIT16) {
+ v = -(2 * LIMIT16 - v);
+ }
+
+ return [(v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.SHORT = constant(2);
+
+ /**
+ * Convert a 24-bit unsigned integer to a list of 3 bytes.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.UINT24 = function(v) {
+ return [(v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.UINT24 = constant(3);
+
+ /**
+ * Convert a 32-bit unsigned integer to a list of 4 bytes.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.ULONG = function(v) {
+ return [(v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.ULONG = constant(4);
+
+ /**
+ * Convert a 32-bit unsigned integer to a list of 4 bytes.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.LONG = function(v) {
+ // Two's complement
+ if (v >= LIMIT32) {
+ v = -(2 * LIMIT32 - v);
+ }
+
+ return [(v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.LONG = constant(4);
+
+ encode.FIXED = encode.ULONG;
+ sizeOf.FIXED = sizeOf.ULONG;
+
+ encode.FWORD = encode.SHORT;
+ sizeOf.FWORD = sizeOf.SHORT;
+
+ encode.UFWORD = encode.USHORT;
+ sizeOf.UFWORD = sizeOf.USHORT;
+
+ /**
+ * Convert a 32-bit Apple Mac timestamp integer to a list of 8 bytes, 64-bit timestamp.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.LONGDATETIME = function(v) {
+ return [0, 0, 0, 0, (v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.LONGDATETIME = constant(8);
+
+ /**
+ * Convert a 4-char tag to a list of 4 bytes.
+ * @param {string}
+ * @returns {Array}
+ */
+ encode.TAG = function(v) {
+ check.argument(v.length === 4, 'Tag should be exactly 4 ASCII characters.');
+ return [v.charCodeAt(0),
+ v.charCodeAt(1),
+ v.charCodeAt(2),
+ v.charCodeAt(3)];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.TAG = constant(4);
+
+ // CFF data types ///////////////////////////////////////////////////////////
+
+ encode.Card8 = encode.BYTE;
+ sizeOf.Card8 = sizeOf.BYTE;
+
+ encode.Card16 = encode.USHORT;
+ sizeOf.Card16 = sizeOf.USHORT;
+
+ encode.OffSize = encode.BYTE;
+ sizeOf.OffSize = sizeOf.BYTE;
+
+ encode.SID = encode.USHORT;
+ sizeOf.SID = sizeOf.USHORT;
+
+ // Convert a numeric operand or charstring number to a variable-size list of bytes.
+ /**
+ * Convert a numeric operand or charstring number to a variable-size list of bytes.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.NUMBER = function(v) {
+ if (v >= -107 && v <= 107) {
+ return [v + 139];
+ } else if (v >= 108 && v <= 1131) {
+ v = v - 108;
+ return [(v >> 8) + 247, v & 0xFF];
+ } else if (v >= -1131 && v <= -108) {
+ v = -v - 108;
+ return [(v >> 8) + 251, v & 0xFF];
+ } else if (v >= -32768 && v <= 32767) {
+ return encode.NUMBER16(v);
+ } else {
+ return encode.NUMBER32(v);
+ }
+ };
+
+ /**
+ * @param {number}
+ * @returns {number}
+ */
+ sizeOf.NUMBER = function(v) {
+ return encode.NUMBER(v).length;
+ };
+
+ /**
+ * Convert a signed number between -32768 and +32767 to a three-byte value.
+ * This ensures we always use three bytes, but is not the most compact format.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.NUMBER16 = function(v) {
+ return [28, (v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.NUMBER16 = constant(3);
+
+ /**
+ * Convert a signed number between -(2^31) and +(2^31-1) to a five-byte value.
+ * This is useful if you want to be sure you always use four bytes,
+ * at the expense of wasting a few bytes for smaller numbers.
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.NUMBER32 = function(v) {
+ return [29, (v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
+ };
+
+ /**
+ * @constant
+ * @type {number}
+ */
+ sizeOf.NUMBER32 = constant(5);
+
+ /**
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.REAL = function(v) {
+ var value = v.toString();
+
+ // Some numbers use an epsilon to encode the value. (e.g. JavaScript will store 0.0000001 as 1e-7)
+ // This code converts it back to a number without the epsilon.
+ var m = /\.(\d*?)(?:9{5,20}|0{5,20})\d{0,2}(?:e(.+)|$)/.exec(value);
+ if (m) {
+ var epsilon = parseFloat('1e' + ((m[2] ? +m[2] : 0) + m[1].length));
+ value = (Math.round(v * epsilon) / epsilon).toString();
+ }
+
+ var nibbles = '';
+ for (var i = 0, ii = value.length; i < ii; i += 1) {
+ var c = value[i];
+ if (c === 'e') {
+ nibbles += value[++i] === '-' ? 'c' : 'b';
+ } else if (c === '.') {
+ nibbles += 'a';
+ } else if (c === '-') {
+ nibbles += 'e';
+ } else {
+ nibbles += c;
+ }
+ }
+
+ nibbles += (nibbles.length & 1) ? 'f' : 'ff';
+ var out = [30];
+ for (var i$1 = 0, ii$1 = nibbles.length; i$1 < ii$1; i$1 += 2) {
+ out.push(parseInt(nibbles.substr(i$1, 2), 16));
+ }
+
+ return out;
+ };
+
+ /**
+ * @param {number}
+ * @returns {number}
+ */
+ sizeOf.REAL = function(v) {
+ return encode.REAL(v).length;
+ };
+
+ encode.NAME = encode.CHARARRAY;
+ sizeOf.NAME = sizeOf.CHARARRAY;
+
+ encode.STRING = encode.CHARARRAY;
+ sizeOf.STRING = sizeOf.CHARARRAY;
+
+ /**
+ * @param {DataView} data
+ * @param {number} offset
+ * @param {number} numBytes
+ * @returns {string}
+ */
+ decode.UTF8 = function(data, offset, numBytes) {
+ var codePoints = [];
+ var numChars = numBytes;
+ for (var j = 0; j < numChars; j++, offset += 1) {
+ codePoints[j] = data.getUint8(offset);
+ }
+
+ return String.fromCharCode.apply(null, codePoints);
+ };
+
+ /**
+ * @param {DataView} data
+ * @param {number} offset
+ * @param {number} numBytes
+ * @returns {string}
+ */
+ decode.UTF16 = function(data, offset, numBytes) {
+ var codePoints = [];
+ var numChars = numBytes / 2;
+ for (var j = 0; j < numChars; j++, offset += 2) {
+ codePoints[j] = data.getUint16(offset);
+ }
+
+ return String.fromCharCode.apply(null, codePoints);
+ };
+
+ /**
+ * Convert a JavaScript string to UTF16-BE.
+ * @param {string}
+ * @returns {Array}
+ */
+ encode.UTF16 = function(v) {
+ var b = [];
+ for (var i = 0; i < v.length; i += 1) {
+ var codepoint = v.charCodeAt(i);
+ b[b.length] = (codepoint >> 8) & 0xFF;
+ b[b.length] = codepoint & 0xFF;
+ }
+
+ return b;
+ };
+
+ /**
+ * @param {string}
+ * @returns {number}
+ */
+ sizeOf.UTF16 = function(v) {
+ return v.length * 2;
+ };
+
+ // Data for converting old eight-bit Macintosh encodings to Unicode.
+ // This representation is optimized for decoding; encoding is slower
+ // and needs more memory. The assumption is that all opentype.js users
+ // want to open fonts, but saving a font will be comparatively rare
+ // so it can be more expensive. Keyed by IANA character set name.
+ //
+ // Python script for generating these strings:
+ //
+ // s = u''.join([chr(c).decode('mac_greek') for c in range(128, 256)])
+ // print(s.encode('utf-8'))
+ /**
+ * @private
+ */
+ var eightBitMacEncodings = {
+ 'x-mac-croatian': // Python: 'mac_croatian'
+ 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®Š™´¨≠ŽØ∞±≤≥∆µ∂∑∏š∫ªºΩžø' +
+ '¿¡¬√ƒ≈Ć«Č… ÀÃÕŒœĐ—“”‘’÷◊©⁄€‹›Æ»–·‚„‰ÂćÁčÈÍÎÏÌÓÔđÒÚÛÙıˆ˜¯πË˚¸Êæˇ',
+ 'x-mac-cyrillic': // Python: 'mac_cyrillic'
+ 'АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ†°Ґ£§•¶І®©™Ђђ≠Ѓѓ∞±≤≥іµґЈЄєЇїЉљЊњ' +
+ 'јЅ¬√ƒ≈∆«»… ЋћЌќѕ–—“”‘’÷„ЎўЏџ№Ёёяабвгдежзийклмнопрстуфхцчшщъыьэю',
+ 'x-mac-gaelic': // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/GAELIC.TXT
+ 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØḂ±≤≥ḃĊċḊḋḞḟĠġṀæø' +
+ 'ṁṖṗɼƒſṠ«»… ÀÃÕŒœ–—“”‘’ṡẛÿŸṪ€‹›Ŷŷṫ·Ỳỳ⁊ÂÊÁËÈÍÎÏÌÓÔ♣ÒÚÛÙıÝýŴŵẄẅẀẁẂẃ',
+ 'x-mac-greek': // Python: 'mac_greek'
+ 'Ĺ²É³ÖÜ΅àâä΄¨çéèê룙î‰ôö¦€ùûü†ΓΔΘΛΞΠß®©ΣΪ§≠°·Α±≤≥¥ΒΕΖΗΙΚΜΦΫΨΩ' +
+ 'άΝ¬ΟΡ≈Τ«»… ΥΧΆΈœ–―“”‘’÷ΉΊΌΎέήίόΏύαβψδεφγηιξκλμνοπώρστθωςχυζϊϋΐΰ\u00AD',
+ 'x-mac-icelandic': // Python: 'mac_iceland'
+ 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûüÝ°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' +
+ '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€ÐðÞþý·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ',
+ 'x-mac-inuit': // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/INUIT.TXT
+ 'ᐃᐄᐅᐆᐊᐋᐱᐲᐳᐴᐸᐹᑉᑎᑏᑐᑑᑕᑖᑦᑭᑮᑯᑰᑲᑳᒃᒋᒌᒍᒎᒐᒑ°ᒡᒥᒦ•¶ᒧ®©™ᒨᒪᒫᒻᓂᓃᓄᓅᓇᓈᓐᓯᓰᓱᓲᓴᓵᔅᓕᓖᓗ' +
+ 'ᓘᓚᓛᓪᔨᔩᔪᔫᔭ… ᔮᔾᕕᕖᕗ–—“”‘’ᕘᕙᕚᕝᕆᕇᕈᕉᕋᕌᕐᕿᖀᖁᖂᖃᖄᖅᖏᖐᖑᖒᖓᖔᖕᙱᙲᙳᙴᙵᙶᖖᖠᖡᖢᖣᖤᖥᖦᕼŁł',
+ 'x-mac-ce': // Python: 'mac_latin2'
+ 'ÄĀāÉĄÖÜáąČäčĆć鏟ĎíďĒēĖóėôöõúĚěü†°Ę£§•¶ß®©™ę¨≠ģĮįĪ≤≥īĶ∂∑łĻļĽľĹĺŅ' +
+ 'ņѬ√ńŇ∆«»… ňŐÕőŌ–—“”‘’÷◊ōŔŕŘ‹›řŖŗŠ‚„šŚśÁŤťÍŽžŪÓÔūŮÚůŰűŲųÝýķŻŁżĢˇ',
+ macintosh: // Python: 'mac_roman'
+ 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' +
+ '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›fifl‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ',
+ 'x-mac-romanian': // Python: 'mac_romanian'
+ 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ĂȘ∞±≤≥¥µ∂∑∏π∫ªºΩăș' +
+ '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›Țț‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ',
+ 'x-mac-turkish': // Python: 'mac_turkish'
+ 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' +
+ '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ'
+ };
+
+ /**
+ * Decodes an old-style Macintosh string. Returns either a Unicode JavaScript
+ * string, or 'undefined' if the encoding is unsupported. For example, we do
+ * not support Chinese, Japanese or Korean because these would need large
+ * mapping tables.
+ * @param {DataView} dataView
+ * @param {number} offset
+ * @param {number} dataLength
+ * @param {string} encoding
+ * @returns {string}
+ */
+ decode.MACSTRING = function(dataView, offset, dataLength, encoding) {
+ var table = eightBitMacEncodings[encoding];
+ if (table === undefined) {
+ return undefined;
+ }
+
+ var result = '';
+ for (var i = 0; i < dataLength; i++) {
+ var c = dataView.getUint8(offset + i);
+ // In all eight-bit Mac encodings, the characters 0x00..0x7F are
+ // mapped to U+0000..U+007F; we only need to look up the others.
+ if (c <= 0x7F) {
+ result += String.fromCharCode(c);
+ } else {
+ result += table[c & 0x7F];
+ }
+ }
+
+ return result;
+ };
+
+ // Helper function for encode.MACSTRING. Returns a dictionary for mapping
+ // Unicode character codes to their 8-bit MacOS equivalent. This table
+ // is not exactly a super cheap data structure, but we do not care because
+ // encoding Macintosh strings is only rarely needed in typical applications.
+ var macEncodingTableCache = typeof WeakMap === 'function' && new WeakMap();
+ var macEncodingCacheKeys;
+ var getMacEncodingTable = function (encoding) {
+ // Since we use encoding as a cache key for WeakMap, it has to be
+ // a String object and not a literal. And at least on NodeJS 2.10.1,
+ // WeakMap requires that the same String instance is passed for cache hits.
+ if (!macEncodingCacheKeys) {
+ macEncodingCacheKeys = {};
+ for (var e in eightBitMacEncodings) {
+ /*jshint -W053 */ // Suppress "Do not use String as a constructor."
+ macEncodingCacheKeys[e] = new String(e);
+ }
+ }
+
+ var cacheKey = macEncodingCacheKeys[encoding];
+ if (cacheKey === undefined) {
+ return undefined;
+ }
+
+ // We can't do "if (cache.has(key)) {return cache.get(key)}" here:
+ // since garbage collection may run at any time, it could also kick in
+ // between the calls to cache.has() and cache.get(). In that case,
+ // we would return 'undefined' even though we do support the encoding.
+ if (macEncodingTableCache) {
+ var cachedTable = macEncodingTableCache.get(cacheKey);
+ if (cachedTable !== undefined) {
+ return cachedTable;
+ }
+ }
+
+ var decodingTable = eightBitMacEncodings[encoding];
+ if (decodingTable === undefined) {
+ return undefined;
+ }
+
+ var encodingTable = {};
+ for (var i = 0; i < decodingTable.length; i++) {
+ encodingTable[decodingTable.charCodeAt(i)] = i + 0x80;
+ }
+
+ if (macEncodingTableCache) {
+ macEncodingTableCache.set(cacheKey, encodingTable);
+ }
+
+ return encodingTable;
+ };
+
+ /**
+ * Encodes an old-style Macintosh string. Returns a byte array upon success.
+ * If the requested encoding is unsupported, or if the input string contains
+ * a character that cannot be expressed in the encoding, the function returns
+ * 'undefined'.
+ * @param {string} str
+ * @param {string} encoding
+ * @returns {Array}
+ */
+ encode.MACSTRING = function(str, encoding) {
+ var table = getMacEncodingTable(encoding);
+ if (table === undefined) {
+ return undefined;
+ }
+
+ var result = [];
+ for (var i = 0; i < str.length; i++) {
+ var c = str.charCodeAt(i);
+
+ // In all eight-bit Mac encodings, the characters 0x00..0x7F are
+ // mapped to U+0000..U+007F; we only need to look up the others.
+ if (c >= 0x80) {
+ c = table[c];
+ if (c === undefined) {
+ // str contains a Unicode character that cannot be encoded
+ // in the requested encoding.
+ return undefined;
+ }
+ }
+ result[i] = c;
+ // result.push(c);
+ }
+
+ return result;
+ };
+
+ /**
+ * @param {string} str
+ * @param {string} encoding
+ * @returns {number}
+ */
+ sizeOf.MACSTRING = function(str, encoding) {
+ var b = encode.MACSTRING(str, encoding);
+ if (b !== undefined) {
+ return b.length;
+ } else {
+ return 0;
+ }
+ };
+
+ // Helper for encode.VARDELTAS
+ function isByteEncodable(value) {
+ return value >= -128 && value <= 127;
+ }
-/**
- * Create a Path object that represents the given text.
- * @param {string} text - The text to create.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- * @return {opentype.Path}
- */
-Font.prototype.getPath = function(text, x, y, fontSize, options) {
- var fullPath = new path.Path();
- this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
- var glyphPath = glyph.getPath(gX, gY, gFontSize, options, this);
- fullPath.extend(glyphPath);
- });
- return fullPath;
-};
+ // Helper for encode.VARDELTAS
+ function encodeVarDeltaRunAsZeroes(deltas, pos, result) {
+ var runLength = 0;
+ var numDeltas = deltas.length;
+ while (pos < numDeltas && runLength < 64 && deltas[pos] === 0) {
+ ++pos;
+ ++runLength;
+ }
+ result.push(0x80 | (runLength - 1));
+ return pos;
+ }
-/**
- * Create an array of Path objects that represent the glyps of a given text.
- * @param {string} text - The text to create.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- * @return {opentype.Path[]}
- */
-Font.prototype.getPaths = function(text, x, y, fontSize, options) {
- var glyphPaths = [];
- this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
- var glyphPath = glyph.getPath(gX, gY, gFontSize);
- glyphPaths.push(glyphPath);
- });
+ // Helper for encode.VARDELTAS
+ function encodeVarDeltaRunAsBytes(deltas, offset, result) {
+ var runLength = 0;
+ var numDeltas = deltas.length;
+ var pos = offset;
+ while (pos < numDeltas && runLength < 64) {
+ var value = deltas[pos];
+ if (!isByteEncodable(value)) {
+ break;
+ }
+
+ // Within a byte-encoded run of deltas, a single zero is best
+ // stored literally as 0x00 value. However, if we have two or
+ // more zeroes in a sequence, it is better to start a new run.
+ // Fore example, the sequence of deltas [15, 15, 0, 15, 15]
+ // becomes 6 bytes (04 0F 0F 00 0F 0F) when storing the zero
+ // within the current run, but 7 bytes (01 0F 0F 80 01 0F 0F)
+ // when starting a new run.
+ if (value === 0 && pos + 1 < numDeltas && deltas[pos + 1] === 0) {
+ break;
+ }
+
+ ++pos;
+ ++runLength;
+ }
+ result.push(runLength - 1);
+ for (var i = offset; i < pos; ++i) {
+ result.push((deltas[i] + 256) & 0xff);
+ }
+ return pos;
+ }
- return glyphPaths;
-};
+ // Helper for encode.VARDELTAS
+ function encodeVarDeltaRunAsWords(deltas, offset, result) {
+ var runLength = 0;
+ var numDeltas = deltas.length;
+ var pos = offset;
+ while (pos < numDeltas && runLength < 64) {
+ var value = deltas[pos];
+
+ // Within a word-encoded run of deltas, it is easiest to start
+ // a new run (with a different encoding) whenever we encounter
+ // a zero value. For example, the sequence [0x6666, 0, 0x7777]
+ // needs 7 bytes when storing the zero inside the current run
+ // (42 66 66 00 00 77 77), and equally 7 bytes when starting a
+ // new run (40 66 66 80 40 77 77).
+ if (value === 0) {
+ break;
+ }
+
+ // Within a word-encoded run of deltas, a single value in the
+ // range (-128..127) should be encoded within the current run
+ // because it is more compact. For example, the sequence
+ // [0x6666, 2, 0x7777] becomes 7 bytes when storing the value
+ // literally (42 66 66 00 02 77 77), but 8 bytes when starting
+ // a new run (40 66 66 00 02 40 77 77).
+ if (isByteEncodable(value) && pos + 1 < numDeltas && isByteEncodable(deltas[pos + 1])) {
+ break;
+ }
+
+ ++pos;
+ ++runLength;
+ }
+ result.push(0x40 | (runLength - 1));
+ for (var i = offset; i < pos; ++i) {
+ var val = deltas[i];
+ result.push(((val + 0x10000) >> 8) & 0xff, (val + 0x100) & 0xff);
+ }
+ return pos;
+ }
-/**
- * Returns the advance width of a text.
- *
- * This is something different than Path.getBoundingBox() as for example a
- * suffixed whitespace increases the advancewidth but not the bounding box
- * or an overhanging letter like a calligraphic 'f' might have a quite larger
- * bounding box than its advance width.
- *
- * This corresponds to canvas2dContext.measureText(text).width
- *
- * @param {string} text - The text to create.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- * @return advance width
- */
-Font.prototype.getAdvanceWidth = function(text, fontSize, options) {
- return this.forEachGlyph(text, 0, 0, fontSize, options, function() {});
-};
+ /**
+ * Encode a list of variation adjustment deltas.
+ *
+ * Variation adjustment deltas are used in ‘gvar’ and ‘cvar’ tables.
+ * They indicate how points (in ‘gvar’) or values (in ‘cvar’) get adjusted
+ * when generating instances of variation fonts.
+ *
+ * @see https://www.microsoft.com/typography/otspec/gvar.htm
+ * @see https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6gvar.html
+ * @param {Array}
+ * @return {Array}
+ */
+ encode.VARDELTAS = function(deltas) {
+ var pos = 0;
+ var result = [];
+ while (pos < deltas.length) {
+ var value = deltas[pos];
+ if (value === 0) {
+ pos = encodeVarDeltaRunAsZeroes(deltas, pos, result);
+ } else if (value >= -128 && value <= 127) {
+ pos = encodeVarDeltaRunAsBytes(deltas, pos, result);
+ } else {
+ pos = encodeVarDeltaRunAsWords(deltas, pos, result);
+ }
+ }
+ return result;
+ };
+
+ // Convert a list of values to a CFF INDEX structure.
+ // The values should be objects containing name / type / value.
+ /**
+ * @param {Array} l
+ * @returns {Array}
+ */
+ encode.INDEX = function(l) {
+ //var offset, offsets, offsetEncoder, encodedOffsets, encodedOffset, data,
+ // i, v;
+ // Because we have to know which data type to use to encode the offsets,
+ // we have to go through the values twice: once to encode the data and
+ // calculate the offsets, then again to encode the offsets using the fitting data type.
+ var offset = 1; // First offset is always 1.
+ var offsets = [offset];
+ var data = [];
+ for (var i = 0; i < l.length; i += 1) {
+ var v = encode.OBJECT(l[i]);
+ Array.prototype.push.apply(data, v);
+ offset += v.length;
+ offsets.push(offset);
+ }
+
+ if (data.length === 0) {
+ return [0, 0];
+ }
+
+ var encodedOffsets = [];
+ var offSize = (1 + Math.floor(Math.log(offset) / Math.log(2)) / 8) | 0;
+ var offsetEncoder = [undefined, encode.BYTE, encode.USHORT, encode.UINT24, encode.ULONG][offSize];
+ for (var i$1 = 0; i$1 < offsets.length; i$1 += 1) {
+ var encodedOffset = offsetEncoder(offsets[i$1]);
+ Array.prototype.push.apply(encodedOffsets, encodedOffset);
+ }
+
+ return Array.prototype.concat(encode.Card16(l.length),
+ encode.OffSize(offSize),
+ encodedOffsets,
+ data);
+ };
+
+ /**
+ * @param {Array}
+ * @returns {number}
+ */
+ sizeOf.INDEX = function(v) {
+ return encode.INDEX(v).length;
+ };
+
+ /**
+ * Convert an object to a CFF DICT structure.
+ * The keys should be numeric.
+ * The values should be objects containing name / type / value.
+ * @param {Object} m
+ * @returns {Array}
+ */
+ encode.DICT = function(m) {
+ var d = [];
+ var keys = Object.keys(m);
+ var length = keys.length;
+
+ for (var i = 0; i < length; i += 1) {
+ // Object.keys() return string keys, but our keys are always numeric.
+ var k = parseInt(keys[i], 0);
+ var v = m[k];
+ // Value comes before the key.
+ d = d.concat(encode.OPERAND(v.value, v.type));
+ d = d.concat(encode.OPERATOR(k));
+ }
+
+ return d;
+ };
+
+ /**
+ * @param {Object}
+ * @returns {number}
+ */
+ sizeOf.DICT = function(m) {
+ return encode.DICT(m).length;
+ };
+
+ /**
+ * @param {number}
+ * @returns {Array}
+ */
+ encode.OPERATOR = function(v) {
+ if (v < 1200) {
+ return [v];
+ } else {
+ return [12, v - 1200];
+ }
+ };
+
+ /**
+ * @param {Array} v
+ * @param {string}
+ * @returns {Array}
+ */
+ encode.OPERAND = function(v, type) {
+ var d = [];
+ if (Array.isArray(type)) {
+ for (var i = 0; i < type.length; i += 1) {
+ check.argument(v.length === type.length, 'Not enough arguments given for type' + type);
+ d = d.concat(encode.OPERAND(v[i], type[i]));
+ }
+ } else {
+ if (type === 'SID') {
+ d = d.concat(encode.NUMBER(v));
+ } else if (type === 'offset') {
+ // We make it easy for ourselves and always encode offsets as
+ // 4 bytes. This makes offset calculation for the top dict easier.
+ d = d.concat(encode.NUMBER32(v));
+ } else if (type === 'number') {
+ d = d.concat(encode.NUMBER(v));
+ } else if (type === 'real') {
+ d = d.concat(encode.REAL(v));
+ } else {
+ throw new Error('Unknown operand type ' + type);
+ // FIXME Add support for booleans
+ }
+ }
+
+ return d;
+ };
+
+ encode.OP = encode.BYTE;
+ sizeOf.OP = sizeOf.BYTE;
+
+ // memoize charstring encoding using WeakMap if available
+ var wmm = typeof WeakMap === 'function' && new WeakMap();
+
+ /**
+ * Convert a list of CharString operations to bytes.
+ * @param {Array}
+ * @returns {Array}
+ */
+ encode.CHARSTRING = function(ops) {
+ // See encode.MACSTRING for why we don't do "if (wmm && wmm.has(ops))".
+ if (wmm) {
+ var cachedValue = wmm.get(ops);
+ if (cachedValue !== undefined) {
+ return cachedValue;
+ }
+ }
+
+ var d = [];
+ var length = ops.length;
+
+ for (var i = 0; i < length; i += 1) {
+ var op = ops[i];
+ d = d.concat(encode[op.type](op.value));
+ }
+
+ if (wmm) {
+ wmm.set(ops, d);
+ }
+
+ return d;
+ };
+
+ /**
+ * @param {Array}
+ * @returns {number}
+ */
+ sizeOf.CHARSTRING = function(ops) {
+ return encode.CHARSTRING(ops).length;
+ };
+
+ // Utility functions ////////////////////////////////////////////////////////
+
+ /**
+ * Convert an object containing name / type / value to bytes.
+ * @param {Object}
+ * @returns {Array}
+ */
+ encode.OBJECT = function(v) {
+ var encodingFunction = encode[v.type];
+ check.argument(encodingFunction !== undefined, 'No encoding function for type ' + v.type);
+ return encodingFunction(v.value);
+ };
+
+ /**
+ * @param {Object}
+ * @returns {number}
+ */
+ sizeOf.OBJECT = function(v) {
+ var sizeOfFunction = sizeOf[v.type];
+ check.argument(sizeOfFunction !== undefined, 'No sizeOf function for type ' + v.type);
+ return sizeOfFunction(v.value);
+ };
+
+ /**
+ * Convert a table object to bytes.
+ * A table contains a list of fields containing the metadata (name, type and default value).
+ * The table itself has the field values set as attributes.
+ * @param {opentype.Table}
+ * @returns {Array}
+ */
+ encode.TABLE = function(table) {
+ var d = [];
+ var length = table.fields.length;
+ var subtables = [];
+ var subtableOffsets = [];
+
+ for (var i = 0; i < length; i += 1) {
+ var field = table.fields[i];
+ var encodingFunction = encode[field.type];
+ check.argument(encodingFunction !== undefined, 'No encoding function for field type ' + field.type + ' (' + field.name + ')');
+ var value = table[field.name];
+ if (value === undefined) {
+ value = field.value;
+ }
+
+ var bytes = encodingFunction(value);
+
+ if (field.type === 'TABLE') {
+ subtableOffsets.push(d.length);
+ d = d.concat([0, 0]);
+ subtables.push(bytes);
+ } else {
+ d = d.concat(bytes);
+ }
+ }
+
+ for (var i$1 = 0; i$1 < subtables.length; i$1 += 1) {
+ var o = subtableOffsets[i$1];
+ var offset = d.length;
+ check.argument(offset < 65536, 'Table ' + table.tableName + ' too big.');
+ d[o] = offset >> 8;
+ d[o + 1] = offset & 0xff;
+ d = d.concat(subtables[i$1]);
+ }
+
+ return d;
+ };
+
+ /**
+ * @param {opentype.Table}
+ * @returns {number}
+ */
+ sizeOf.TABLE = function(table) {
+ var numBytes = 0;
+ var length = table.fields.length;
+
+ for (var i = 0; i < length; i += 1) {
+ var field = table.fields[i];
+ var sizeOfFunction = sizeOf[field.type];
+ check.argument(sizeOfFunction !== undefined, 'No sizeOf function for field type ' + field.type + ' (' + field.name + ')');
+ var value = table[field.name];
+ if (value === undefined) {
+ value = field.value;
+ }
+
+ numBytes += sizeOfFunction(value);
+
+ // Subtables take 2 more bytes for offsets.
+ if (field.type === 'TABLE') {
+ numBytes += 2;
+ }
+ }
+
+ return numBytes;
+ };
+
+ encode.RECORD = encode.TABLE;
+ sizeOf.RECORD = sizeOf.TABLE;
+
+ // Merge in a list of bytes.
+ encode.LITERAL = function(v) {
+ return v;
+ };
+
+ sizeOf.LITERAL = function(v) {
+ return v.length;
+ };
+
+ // Table metadata
+
+ /**
+ * @exports opentype.Table
+ * @class
+ * @param {string} tableName
+ * @param {Array} fields
+ * @param {Object} options
+ * @constructor
+ */
+ function Table(tableName, fields, options) {
+ var this$1 = this;
+
+ for (var i = 0; i < fields.length; i += 1) {
+ var field = fields[i];
+ this$1[field.name] = field.value;
+ }
+
+ this.tableName = tableName;
+ this.fields = fields;
+ if (options) {
+ var optionKeys = Object.keys(options);
+ for (var i$1 = 0; i$1 < optionKeys.length; i$1 += 1) {
+ var k = optionKeys[i$1];
+ var v = options[k];
+ if (this$1[k] !== undefined) {
+ this$1[k] = v;
+ }
+ }
+ }
+ }
-/**
- * Draw the text on the given drawing context.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
- * @param {string} text - The text to create.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- */
-Font.prototype.draw = function(ctx, text, x, y, fontSize, options) {
- this.getPath(text, x, y, fontSize, options).draw(ctx);
-};
+ /**
+ * Encodes the table and returns an array of bytes
+ * @return {Array}
+ */
+ Table.prototype.encode = function() {
+ return encode.TABLE(this);
+ };
+
+ /**
+ * Get the size of the table.
+ * @return {number}
+ */
+ Table.prototype.sizeOf = function() {
+ return sizeOf.TABLE(this);
+ };
+
+ /**
+ * @private
+ */
+ function ushortList(itemName, list, count) {
+ if (count === undefined) {
+ count = list.length;
+ }
+ var fields = new Array(list.length + 1);
+ fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count};
+ for (var i = 0; i < list.length; i++) {
+ fields[i + 1] = {name: itemName + i, type: 'USHORT', value: list[i]};
+ }
+ return fields;
+ }
-/**
- * Draw the points of all glyphs in the text.
- * On-curve points will be drawn in blue, off-curve points will be drawn in red.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
- * @param {string} text - The text to create.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- */
-Font.prototype.drawPoints = function(ctx, text, x, y, fontSize, options) {
- this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
- glyph.drawPoints(ctx, gX, gY, gFontSize);
- });
-};
+ /**
+ * @private
+ */
+ function tableList(itemName, records, itemCallback) {
+ var count = records.length;
+ var fields = new Array(count + 1);
+ fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count};
+ for (var i = 0; i < count; i++) {
+ fields[i + 1] = {name: itemName + i, type: 'TABLE', value: itemCallback(records[i], i)};
+ }
+ return fields;
+ }
-/**
- * Draw lines indicating important font measurements for all glyphs in the text.
- * Black lines indicate the origin of the coordinate system (point 0,0).
- * Blue lines indicate the glyph bounding box.
- * Green line indicates the advance width of the glyph.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
- * @param {string} text - The text to create.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {GlyphRenderOptions=} options
- */
-Font.prototype.drawMetrics = function(ctx, text, x, y, fontSize, options) {
- this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
- glyph.drawMetrics(ctx, gX, gY, gFontSize);
- });
-};
+ /**
+ * @private
+ */
+ function recordList(itemName, records, itemCallback) {
+ var count = records.length;
+ var fields = [];
+ fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count};
+ for (var i = 0; i < count; i++) {
+ fields = fields.concat(itemCallback(records[i], i));
+ }
+ return fields;
+ }
-/**
- * @param {string}
- * @return {string}
- */
-Font.prototype.getEnglishName = function(name) {
- var translations = this.names[name];
- if (translations) {
- return translations.en;
- }
-};
+ // Common Layout Tables
+
+ /**
+ * @exports opentype.Coverage
+ * @class
+ * @param {opentype.Table}
+ * @constructor
+ * @extends opentype.Table
+ */
+ function Coverage(coverageTable) {
+ if (coverageTable.format === 1) {
+ Table.call(this, 'coverageTable',
+ [{name: 'coverageFormat', type: 'USHORT', value: 1}]
+ .concat(ushortList('glyph', coverageTable.glyphs))
+ );
+ } else {
+ check.assert(false, 'Can\'t create coverage table format 2 yet.');
+ }
+ }
+ Coverage.prototype = Object.create(Table.prototype);
+ Coverage.prototype.constructor = Coverage;
+
+ function ScriptList(scriptListTable) {
+ Table.call(this, 'scriptListTable',
+ recordList('scriptRecord', scriptListTable, function(scriptRecord, i) {
+ var script = scriptRecord.script;
+ var defaultLangSys = script.defaultLangSys;
+ check.assert(!!defaultLangSys, 'Unable to write GSUB: script ' + scriptRecord.tag + ' has no default language system.');
+ return [
+ {name: 'scriptTag' + i, type: 'TAG', value: scriptRecord.tag},
+ {name: 'script' + i, type: 'TABLE', value: new Table('scriptTable', [
+ {name: 'defaultLangSys', type: 'TABLE', value: new Table('defaultLangSys', [
+ {name: 'lookupOrder', type: 'USHORT', value: 0},
+ {name: 'reqFeatureIndex', type: 'USHORT', value: defaultLangSys.reqFeatureIndex}]
+ .concat(ushortList('featureIndex', defaultLangSys.featureIndexes)))}
+ ].concat(recordList('langSys', script.langSysRecords, function(langSysRecord, i) {
+ var langSys = langSysRecord.langSys;
+ return [
+ {name: 'langSysTag' + i, type: 'TAG', value: langSysRecord.tag},
+ {name: 'langSys' + i, type: 'TABLE', value: new Table('langSys', [
+ {name: 'lookupOrder', type: 'USHORT', value: 0},
+ {name: 'reqFeatureIndex', type: 'USHORT', value: langSys.reqFeatureIndex}
+ ].concat(ushortList('featureIndex', langSys.featureIndexes)))}
+ ];
+ })))}
+ ];
+ })
+ );
+ }
+ ScriptList.prototype = Object.create(Table.prototype);
+ ScriptList.prototype.constructor = ScriptList;
+
+ /**
+ * @exports opentype.FeatureList
+ * @class
+ * @param {opentype.Table}
+ * @constructor
+ * @extends opentype.Table
+ */
+ function FeatureList(featureListTable) {
+ Table.call(this, 'featureListTable',
+ recordList('featureRecord', featureListTable, function(featureRecord, i) {
+ var feature = featureRecord.feature;
+ return [
+ {name: 'featureTag' + i, type: 'TAG', value: featureRecord.tag},
+ {name: 'feature' + i, type: 'TABLE', value: new Table('featureTable', [
+ {name: 'featureParams', type: 'USHORT', value: feature.featureParams} ].concat(ushortList('lookupListIndex', feature.lookupListIndexes)))}
+ ];
+ })
+ );
+ }
+ FeatureList.prototype = Object.create(Table.prototype);
+ FeatureList.prototype.constructor = FeatureList;
+
+ /**
+ * @exports opentype.LookupList
+ * @class
+ * @param {opentype.Table}
+ * @param {Object}
+ * @constructor
+ * @extends opentype.Table
+ */
+ function LookupList(lookupListTable, subtableMakers) {
+ Table.call(this, 'lookupListTable', tableList('lookup', lookupListTable, function(lookupTable) {
+ var subtableCallback = subtableMakers[lookupTable.lookupType];
+ check.assert(!!subtableCallback, 'Unable to write GSUB lookup type ' + lookupTable.lookupType + ' tables.');
+ return new Table('lookupTable', [
+ {name: 'lookupType', type: 'USHORT', value: lookupTable.lookupType},
+ {name: 'lookupFlag', type: 'USHORT', value: lookupTable.lookupFlag}
+ ].concat(tableList('subtable', lookupTable.subtables, subtableCallback)));
+ }));
+ }
+ LookupList.prototype = Object.create(Table.prototype);
+ LookupList.prototype.constructor = LookupList;
+
+ // Record = same as Table, but inlined (a Table has an offset and its data is further in the stream)
+ // Don't use offsets inside Records (probable bug), only in Tables.
+ var table = {
+ Table: Table,
+ Record: Table,
+ Coverage: Coverage,
+ ScriptList: ScriptList,
+ FeatureList: FeatureList,
+ LookupList: LookupList,
+ ushortList: ushortList,
+ tableList: tableList,
+ recordList: recordList,
+ };
+
+ // Parsing utility functions
+
+ // Retrieve an unsigned byte from the DataView.
+ function getByte(dataView, offset) {
+ return dataView.getUint8(offset);
+ }
-/**
- * Validate
- */
-Font.prototype.validate = function() {
- var warnings = [];
- var _this = this;
+ // Retrieve an unsigned 16-bit short from the DataView.
+ // The value is stored in big endian.
+ function getUShort(dataView, offset) {
+ return dataView.getUint16(offset, false);
+ }
- function assert(predicate, message) {
- if (!predicate) {
- warnings.push(message);
- }
- }
+ // Retrieve a signed 16-bit short from the DataView.
+ // The value is stored in big endian.
+ function getShort(dataView, offset) {
+ return dataView.getInt16(offset, false);
+ }
- function assertNamePresent(name) {
- var englishName = _this.getEnglishName(name);
- assert(englishName && englishName.trim().length > 0,
- 'No English ' + name + ' specified.');
- }
+ // Retrieve an unsigned 32-bit long from the DataView.
+ // The value is stored in big endian.
+ function getULong(dataView, offset) {
+ return dataView.getUint32(offset, false);
+ }
- // Identification information
- assertNamePresent('fontFamily');
- assertNamePresent('weightName');
- assertNamePresent('manufacturer');
- assertNamePresent('copyright');
- assertNamePresent('version');
+ // Retrieve a 32-bit signed fixed-point number (16.16) from the DataView.
+ // The value is stored in big endian.
+ function getFixed(dataView, offset) {
+ var decimal = dataView.getInt16(offset, false);
+ var fraction = dataView.getUint16(offset + 2, false);
+ return decimal + fraction / 65535;
+ }
- // Dimension information
- assert(this.unitsPerEm > 0, 'No unitsPerEm specified.');
-};
+ // Retrieve a 4-character tag from the DataView.
+ // Tags are used to identify tables.
+ function getTag(dataView, offset) {
+ var tag = '';
+ for (var i = offset; i < offset + 4; i += 1) {
+ tag += String.fromCharCode(dataView.getInt8(i));
+ }
-/**
- * Convert the font object to a SFNT data structure.
- * This structure contains all the necessary tables and metadata to create a binary OTF file.
- * @return {opentype.Table}
- */
-Font.prototype.toTables = function() {
- return sfnt.fontToTable(this);
-};
-/**
- * @deprecated Font.toBuffer is deprecated. Use Font.toArrayBuffer instead.
- */
-Font.prototype.toBuffer = function() {
- console.warn('Font.toBuffer is deprecated. Use Font.toArrayBuffer instead.');
- return this.toArrayBuffer();
-};
-/**
- * Converts a `opentype.Font` into an `ArrayBuffer`
- * @return {ArrayBuffer}
- */
-Font.prototype.toArrayBuffer = function() {
- var sfntTable = this.toTables();
- var bytes = sfntTable.encode();
- var buffer = new ArrayBuffer(bytes.length);
- var intArray = new Uint8Array(buffer);
- for (var i = 0; i < bytes.length; i++) {
- intArray[i] = bytes[i];
- }
+ return tag;
+ }
- return buffer;
-};
+ // Retrieve an offset from the DataView.
+ // Offsets are 1 to 4 bytes in length, depending on the offSize argument.
+ function getOffset(dataView, offset, offSize) {
+ var v = 0;
+ for (var i = 0; i < offSize; i += 1) {
+ v <<= 8;
+ v += dataView.getUint8(offset + i);
+ }
-/**
- * Initiate a download of the OpenType font.
- */
-Font.prototype.download = function(fileName) {
- var familyName = this.getEnglishName('fontFamily');
- var styleName = this.getEnglishName('fontSubfamily');
- fileName = fileName || familyName.replace(/\s/g, '') + '-' + styleName + '.otf';
- var arrayBuffer = this.toArrayBuffer();
+ return v;
+ }
- if (util.isBrowser()) {
- window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem;
- window.requestFileSystem(window.TEMPORARY, arrayBuffer.byteLength, function(fs) {
- fs.root.getFile(fileName, {create: true}, function(fileEntry) {
- fileEntry.createWriter(function(writer) {
- var dataView = new DataView(arrayBuffer);
- var blob = new Blob([dataView], {type: 'font/opentype'});
- writer.write(blob);
+ // Retrieve a number of bytes from start offset to the end offset from the DataView.
+ function getBytes(dataView, startOffset, endOffset) {
+ var bytes = [];
+ for (var i = startOffset; i < endOffset; i += 1) {
+ bytes.push(dataView.getUint8(i));
+ }
- writer.addEventListener('writeend', function() {
- // Navigating to the file will download it.
- location.href = fileEntry.toURL();
- }, false);
- });
- });
- },
- function(err) {
- throw new Error(err.name + ': ' + err.message);
- });
- } else {
- var fs = _dereq_('fs');
- var buffer = util.arrayBufferToNodeBuffer(arrayBuffer);
- fs.writeFileSync(fileName, buffer);
- }
-};
-/**
- * @private
- */
-Font.prototype.fsSelectionValues = {
- ITALIC: 0x001, //1
- UNDERSCORE: 0x002, //2
- NEGATIVE: 0x004, //4
- OUTLINED: 0x008, //8
- STRIKEOUT: 0x010, //16
- BOLD: 0x020, //32
- REGULAR: 0x040, //64
- USER_TYPO_METRICS: 0x080, //128
- WWS: 0x100, //256
- OBLIQUE: 0x200 //512
-};
+ return bytes;
+ }
-/**
- * @private
- */
-Font.prototype.usWidthClasses = {
- ULTRA_CONDENSED: 1,
- EXTRA_CONDENSED: 2,
- CONDENSED: 3,
- SEMI_CONDENSED: 4,
- MEDIUM: 5,
- SEMI_EXPANDED: 6,
- EXPANDED: 7,
- EXTRA_EXPANDED: 8,
- ULTRA_EXPANDED: 9
-};
+ // Convert the list of bytes to a string.
+ function bytesToString(bytes) {
+ var s = '';
+ for (var i = 0; i < bytes.length; i += 1) {
+ s += String.fromCharCode(bytes[i]);
+ }
-/**
- * @private
- */
-Font.prototype.usWeightClasses = {
- THIN: 100,
- EXTRA_LIGHT: 200,
- LIGHT: 300,
- NORMAL: 400,
- MEDIUM: 500,
- SEMI_BOLD: 600,
- BOLD: 700,
- EXTRA_BOLD: 800,
- BLACK: 900
-};
+ return s;
+ }
-exports.Font = Font;
+ var typeOffsets = {
+ byte: 1,
+ uShort: 2,
+ short: 2,
+ uLong: 4,
+ fixed: 4,
+ longDateTime: 8,
+ tag: 4
+ };
+
+ // A stateful parser that changes the offset whenever a value is retrieved.
+ // The data is a DataView.
+ function Parser(data, offset) {
+ this.data = data;
+ this.offset = offset;
+ this.relativeOffset = 0;
+ }
-},{"./encoding":12,"./glyphset":15,"./hintingtt":16,"./path":20,"./substitution":21,"./tables/sfnt":40,"./util":42,"fs":3}],14:[function(_dereq_,module,exports){
-// The Glyph object
+ Parser.prototype.parseByte = function() {
+ var v = this.data.getUint8(this.offset + this.relativeOffset);
+ this.relativeOffset += 1;
+ return v;
+ };
+
+ Parser.prototype.parseChar = function() {
+ var v = this.data.getInt8(this.offset + this.relativeOffset);
+ this.relativeOffset += 1;
+ return v;
+ };
+
+ Parser.prototype.parseCard8 = Parser.prototype.parseByte;
+
+ Parser.prototype.parseUShort = function() {
+ var v = this.data.getUint16(this.offset + this.relativeOffset);
+ this.relativeOffset += 2;
+ return v;
+ };
+
+ Parser.prototype.parseCard16 = Parser.prototype.parseUShort;
+ Parser.prototype.parseSID = Parser.prototype.parseUShort;
+ Parser.prototype.parseOffset16 = Parser.prototype.parseUShort;
+
+ Parser.prototype.parseShort = function() {
+ var v = this.data.getInt16(this.offset + this.relativeOffset);
+ this.relativeOffset += 2;
+ return v;
+ };
+
+ Parser.prototype.parseF2Dot14 = function() {
+ var v = this.data.getInt16(this.offset + this.relativeOffset) / 16384;
+ this.relativeOffset += 2;
+ return v;
+ };
+
+ Parser.prototype.parseULong = function() {
+ var v = getULong(this.data, this.offset + this.relativeOffset);
+ this.relativeOffset += 4;
+ return v;
+ };
+
+ Parser.prototype.parseOffset32 = Parser.prototype.parseULong;
+
+ Parser.prototype.parseFixed = function() {
+ var v = getFixed(this.data, this.offset + this.relativeOffset);
+ this.relativeOffset += 4;
+ return v;
+ };
+
+ Parser.prototype.parseString = function(length) {
+ var dataView = this.data;
+ var offset = this.offset + this.relativeOffset;
+ var string = '';
+ this.relativeOffset += length;
+ for (var i = 0; i < length; i++) {
+ string += String.fromCharCode(dataView.getUint8(offset + i));
+ }
+
+ return string;
+ };
+
+ Parser.prototype.parseTag = function() {
+ return this.parseString(4);
+ };
+
+ // LONGDATETIME is a 64-bit integer.
+ // JavaScript and unix timestamps traditionally use 32 bits, so we
+ // only take the last 32 bits.
+ // + Since until 2038 those bits will be filled by zeros we can ignore them.
+ Parser.prototype.parseLongDateTime = function() {
+ var v = getULong(this.data, this.offset + this.relativeOffset + 4);
+ // Subtract seconds between 01/01/1904 and 01/01/1970
+ // to convert Apple Mac timestamp to Standard Unix timestamp
+ v -= 2082844800;
+ this.relativeOffset += 8;
+ return v;
+ };
+
+ Parser.prototype.parseVersion = function(minorBase) {
+ var major = getUShort(this.data, this.offset + this.relativeOffset);
+
+ // How to interpret the minor version is very vague in the spec. 0x5000 is 5, 0x1000 is 1
+ // Default returns the correct number if minor = 0xN000 where N is 0-9
+ // Set minorBase to 1 for tables that use minor = N where N is 0-9
+ var minor = getUShort(this.data, this.offset + this.relativeOffset + 2);
+ this.relativeOffset += 4;
+ if (minorBase === undefined) { minorBase = 0x1000; }
+ return major + minor / minorBase / 10;
+ };
+
+ Parser.prototype.skip = function(type, amount) {
+ if (amount === undefined) {
+ amount = 1;
+ }
+
+ this.relativeOffset += typeOffsets[type] * amount;
+ };
+
+ ///// Parsing lists and records ///////////////////////////////
+
+ // Parse a list of 32 bit unsigned integers.
+ Parser.prototype.parseULongList = function(count) {
+ if (count === undefined) { count = this.parseULong(); }
+ var offsets = new Array(count);
+ var dataView = this.data;
+ var offset = this.offset + this.relativeOffset;
+ for (var i = 0; i < count; i++) {
+ offsets[i] = dataView.getUint32(offset);
+ offset += 4;
+ }
+
+ this.relativeOffset += count * 4;
+ return offsets;
+ };
+
+ // Parse a list of 16 bit unsigned integers. The length of the list can be read on the stream
+ // or provided as an argument.
+ Parser.prototype.parseOffset16List =
+ Parser.prototype.parseUShortList = function(count) {
+ if (count === undefined) { count = this.parseUShort(); }
+ var offsets = new Array(count);
+ var dataView = this.data;
+ var offset = this.offset + this.relativeOffset;
+ for (var i = 0; i < count; i++) {
+ offsets[i] = dataView.getUint16(offset);
+ offset += 2;
+ }
+
+ this.relativeOffset += count * 2;
+ return offsets;
+ };
+
+ // Parses a list of 16 bit signed integers.
+ Parser.prototype.parseShortList = function(count) {
+ var list = new Array(count);
+ var dataView = this.data;
+ var offset = this.offset + this.relativeOffset;
+ for (var i = 0; i < count; i++) {
+ list[i] = dataView.getInt16(offset);
+ offset += 2;
+ }
+
+ this.relativeOffset += count * 2;
+ return list;
+ };
+
+ // Parses a list of bytes.
+ Parser.prototype.parseByteList = function(count) {
+ var list = new Array(count);
+ var dataView = this.data;
+ var offset = this.offset + this.relativeOffset;
+ for (var i = 0; i < count; i++) {
+ list[i] = dataView.getUint8(offset++);
+ }
+
+ this.relativeOffset += count;
+ return list;
+ };
+
+ /**
+ * Parse a list of items.
+ * Record count is optional, if omitted it is read from the stream.
+ * itemCallback is one of the Parser methods.
+ */
+ Parser.prototype.parseList = function(count, itemCallback) {
+ var this$1 = this;
+
+ if (!itemCallback) {
+ itemCallback = count;
+ count = this.parseUShort();
+ }
+ var list = new Array(count);
+ for (var i = 0; i < count; i++) {
+ list[i] = itemCallback.call(this$1);
+ }
+ return list;
+ };
+
+ Parser.prototype.parseList32 = function(count, itemCallback) {
+ var this$1 = this;
+
+ if (!itemCallback) {
+ itemCallback = count;
+ count = this.parseULong();
+ }
+ var list = new Array(count);
+ for (var i = 0; i < count; i++) {
+ list[i] = itemCallback.call(this$1);
+ }
+ return list;
+ };
+
+ /**
+ * Parse a list of records.
+ * Record count is optional, if omitted it is read from the stream.
+ * Example of recordDescription: { sequenceIndex: Parser.uShort, lookupListIndex: Parser.uShort }
+ */
+ Parser.prototype.parseRecordList = function(count, recordDescription) {
+ var this$1 = this;
+
+ // If the count argument is absent, read it in the stream.
+ if (!recordDescription) {
+ recordDescription = count;
+ count = this.parseUShort();
+ }
+ var records = new Array(count);
+ var fields = Object.keys(recordDescription);
+ for (var i = 0; i < count; i++) {
+ var rec = {};
+ for (var j = 0; j < fields.length; j++) {
+ var fieldName = fields[j];
+ var fieldType = recordDescription[fieldName];
+ rec[fieldName] = fieldType.call(this$1);
+ }
+ records[i] = rec;
+ }
+ return records;
+ };
+
+ Parser.prototype.parseRecordList32 = function(count, recordDescription) {
+ var this$1 = this;
+
+ // If the count argument is absent, read it in the stream.
+ if (!recordDescription) {
+ recordDescription = count;
+ count = this.parseULong();
+ }
+ var records = new Array(count);
+ var fields = Object.keys(recordDescription);
+ for (var i = 0; i < count; i++) {
+ var rec = {};
+ for (var j = 0; j < fields.length; j++) {
+ var fieldName = fields[j];
+ var fieldType = recordDescription[fieldName];
+ rec[fieldName] = fieldType.call(this$1);
+ }
+ records[i] = rec;
+ }
+ return records;
+ };
+
+ // Parse a data structure into an object
+ // Example of description: { sequenceIndex: Parser.uShort, lookupListIndex: Parser.uShort }
+ Parser.prototype.parseStruct = function(description) {
+ var this$1 = this;
+
+ if (typeof description === 'function') {
+ return description.call(this);
+ } else {
+ var fields = Object.keys(description);
+ var struct = {};
+ for (var j = 0; j < fields.length; j++) {
+ var fieldName = fields[j];
+ var fieldType = description[fieldName];
+ struct[fieldName] = fieldType.call(this$1);
+ }
+ return struct;
+ }
+ };
+
+ /**
+ * Parse a GPOS valueRecord
+ * https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#value-record
+ * valueFormat is optional, if omitted it is read from the stream.
+ */
+ Parser.prototype.parseValueRecord = function(valueFormat) {
+ if (valueFormat === undefined) {
+ valueFormat = this.parseUShort();
+ }
+ if (valueFormat === 0) {
+ // valueFormat2 in kerning pairs is most often 0
+ // in this case return undefined instead of an empty object, to save space
+ return;
+ }
+ var valueRecord = {};
+
+ if (valueFormat & 0x0001) { valueRecord.xPlacement = this.parseShort(); }
+ if (valueFormat & 0x0002) { valueRecord.yPlacement = this.parseShort(); }
+ if (valueFormat & 0x0004) { valueRecord.xAdvance = this.parseShort(); }
+ if (valueFormat & 0x0008) { valueRecord.yAdvance = this.parseShort(); }
+
+ // Device table (non-variable font) / VariationIndex table (variable font) not supported
+ // https://docs.microsoft.com/fr-fr/typography/opentype/spec/chapter2#devVarIdxTbls
+ if (valueFormat & 0x0010) { valueRecord.xPlaDevice = undefined; this.parseShort(); }
+ if (valueFormat & 0x0020) { valueRecord.yPlaDevice = undefined; this.parseShort(); }
+ if (valueFormat & 0x0040) { valueRecord.xAdvDevice = undefined; this.parseShort(); }
+ if (valueFormat & 0x0080) { valueRecord.yAdvDevice = undefined; this.parseShort(); }
+
+ return valueRecord;
+ };
+
+ /**
+ * Parse a list of GPOS valueRecords
+ * https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#value-record
+ * valueFormat and valueCount are read from the stream.
+ */
+ Parser.prototype.parseValueRecordList = function() {
+ var this$1 = this;
+
+ var valueFormat = this.parseUShort();
+ var valueCount = this.parseUShort();
+ var values = new Array(valueCount);
+ for (var i = 0; i < valueCount; i++) {
+ values[i] = this$1.parseValueRecord(valueFormat);
+ }
+ return values;
+ };
+
+ Parser.prototype.parsePointer = function(description) {
+ var structOffset = this.parseOffset16();
+ if (structOffset > 0) {
+ // NULL offset => return undefined
+ return new Parser(this.data, this.offset + structOffset).parseStruct(description);
+ }
+ return undefined;
+ };
+
+ Parser.prototype.parsePointer32 = function(description) {
+ var structOffset = this.parseOffset32();
+ if (structOffset > 0) {
+ // NULL offset => return undefined
+ return new Parser(this.data, this.offset + structOffset).parseStruct(description);
+ }
+ return undefined;
+ };
+
+ /**
+ * Parse a list of offsets to lists of 16-bit integers,
+ * or a list of offsets to lists of offsets to any kind of items.
+ * If itemCallback is not provided, a list of list of UShort is assumed.
+ * If provided, itemCallback is called on each item and must parse the item.
+ * See examples in tables/gsub.js
+ */
+ Parser.prototype.parseListOfLists = function(itemCallback) {
+ var this$1 = this;
+
+ var offsets = this.parseOffset16List();
+ var count = offsets.length;
+ var relativeOffset = this.relativeOffset;
+ var list = new Array(count);
+ for (var i = 0; i < count; i++) {
+ var start = offsets[i];
+ if (start === 0) {
+ // NULL offset
+ // Add i as owned property to list. Convenient with assert.
+ list[i] = undefined;
+ continue;
+ }
+ this$1.relativeOffset = start;
+ if (itemCallback) {
+ var subOffsets = this$1.parseOffset16List();
+ var subList = new Array(subOffsets.length);
+ for (var j = 0; j < subOffsets.length; j++) {
+ this$1.relativeOffset = start + subOffsets[j];
+ subList[j] = itemCallback.call(this$1);
+ }
+ list[i] = subList;
+ } else {
+ list[i] = this$1.parseUShortList();
+ }
+ }
+ this.relativeOffset = relativeOffset;
+ return list;
+ };
+
+ ///// Complex tables parsing //////////////////////////////////
+
+ // Parse a coverage table in a GSUB, GPOS or GDEF table.
+ // https://www.microsoft.com/typography/OTSPEC/chapter2.htm
+ // parser.offset must point to the start of the table containing the coverage.
+ Parser.prototype.parseCoverage = function() {
+ var this$1 = this;
+
+ var startOffset = this.offset + this.relativeOffset;
+ var format = this.parseUShort();
+ var count = this.parseUShort();
+ if (format === 1) {
+ return {
+ format: 1,
+ glyphs: this.parseUShortList(count)
+ };
+ } else if (format === 2) {
+ var ranges = new Array(count);
+ for (var i = 0; i < count; i++) {
+ ranges[i] = {
+ start: this$1.parseUShort(),
+ end: this$1.parseUShort(),
+ index: this$1.parseUShort()
+ };
+ }
+ return {
+ format: 2,
+ ranges: ranges
+ };
+ }
+ throw new Error('0x' + startOffset.toString(16) + ': Coverage format must be 1 or 2.');
+ };
+
+ // Parse a Class Definition Table in a GSUB, GPOS or GDEF table.
+ // https://www.microsoft.com/typography/OTSPEC/chapter2.htm
+ Parser.prototype.parseClassDef = function() {
+ var startOffset = this.offset + this.relativeOffset;
+ var format = this.parseUShort();
+ if (format === 1) {
+ return {
+ format: 1,
+ startGlyph: this.parseUShort(),
+ classes: this.parseUShortList()
+ };
+ } else if (format === 2) {
+ return {
+ format: 2,
+ ranges: this.parseRecordList({
+ start: Parser.uShort,
+ end: Parser.uShort,
+ classId: Parser.uShort
+ })
+ };
+ }
+ throw new Error('0x' + startOffset.toString(16) + ': ClassDef format must be 1 or 2.');
+ };
+
+ ///// Static methods ///////////////////////////////////
+ // These convenience methods can be used as callbacks and should be called with "this" context set to a Parser instance.
+
+ Parser.list = function(count, itemCallback) {
+ return function() {
+ return this.parseList(count, itemCallback);
+ };
+ };
+
+ Parser.list32 = function(count, itemCallback) {
+ return function() {
+ return this.parseList32(count, itemCallback);
+ };
+ };
+
+ Parser.recordList = function(count, recordDescription) {
+ return function() {
+ return this.parseRecordList(count, recordDescription);
+ };
+ };
+
+ Parser.recordList32 = function(count, recordDescription) {
+ return function() {
+ return this.parseRecordList32(count, recordDescription);
+ };
+ };
+
+ Parser.pointer = function(description) {
+ return function() {
+ return this.parsePointer(description);
+ };
+ };
+
+ Parser.pointer32 = function(description) {
+ return function() {
+ return this.parsePointer32(description);
+ };
+ };
+
+ Parser.tag = Parser.prototype.parseTag;
+ Parser.byte = Parser.prototype.parseByte;
+ Parser.uShort = Parser.offset16 = Parser.prototype.parseUShort;
+ Parser.uShortList = Parser.prototype.parseUShortList;
+ Parser.uLong = Parser.offset32 = Parser.prototype.parseULong;
+ Parser.uLongList = Parser.prototype.parseULongList;
+ Parser.struct = Parser.prototype.parseStruct;
+ Parser.coverage = Parser.prototype.parseCoverage;
+ Parser.classDef = Parser.prototype.parseClassDef;
+
+ ///// Script, Feature, Lookup lists ///////////////////////////////////////////////
+ // https://www.microsoft.com/typography/OTSPEC/chapter2.htm
+
+ var langSysTable = {
+ reserved: Parser.uShort,
+ reqFeatureIndex: Parser.uShort,
+ featureIndexes: Parser.uShortList
+ };
+
+ Parser.prototype.parseScriptList = function() {
+ return this.parsePointer(Parser.recordList({
+ tag: Parser.tag,
+ script: Parser.pointer({
+ defaultLangSys: Parser.pointer(langSysTable),
+ langSysRecords: Parser.recordList({
+ tag: Parser.tag,
+ langSys: Parser.pointer(langSysTable)
+ })
+ })
+ })) || [];
+ };
+
+ Parser.prototype.parseFeatureList = function() {
+ return this.parsePointer(Parser.recordList({
+ tag: Parser.tag,
+ feature: Parser.pointer({
+ featureParams: Parser.offset16,
+ lookupListIndexes: Parser.uShortList
+ })
+ })) || [];
+ };
+
+ Parser.prototype.parseLookupList = function(lookupTableParsers) {
+ return this.parsePointer(Parser.list(Parser.pointer(function() {
+ var lookupType = this.parseUShort();
+ check.argument(1 <= lookupType && lookupType <= 9, 'GPOS/GSUB lookup type ' + lookupType + ' unknown.');
+ var lookupFlag = this.parseUShort();
+ var useMarkFilteringSet = lookupFlag & 0x10;
+ return {
+ lookupType: lookupType,
+ lookupFlag: lookupFlag,
+ subtables: this.parseList(Parser.pointer(lookupTableParsers[lookupType])),
+ markFilteringSet: useMarkFilteringSet ? this.parseUShort() : undefined
+ };
+ }))) || [];
+ };
+
+ Parser.prototype.parseFeatureVariationsList = function() {
+ return this.parsePointer32(function() {
+ var majorVersion = this.parseUShort();
+ var minorVersion = this.parseUShort();
+ check.argument(majorVersion === 1 && minorVersion < 1, 'GPOS/GSUB feature variations table unknown.');
+ var featureVariations = this.parseRecordList32({
+ conditionSetOffset: Parser.offset32,
+ featureTableSubstitutionOffset: Parser.offset32
+ });
+ return featureVariations;
+ }) || [];
+ };
+
+ var parse = {
+ getByte: getByte,
+ getCard8: getByte,
+ getUShort: getUShort,
+ getCard16: getUShort,
+ getShort: getShort,
+ getULong: getULong,
+ getFixed: getFixed,
+ getTag: getTag,
+ getOffset: getOffset,
+ getBytes: getBytes,
+ bytesToString: bytesToString,
+ Parser: Parser,
+ };
+
+ // The `cmap` table stores the mappings from characters to glyphs.
+
+ function parseCmapTableFormat12(cmap, p) {
+ //Skip reserved.
+ p.parseUShort();
+
+ // Length in bytes of the sub-tables.
+ cmap.length = p.parseULong();
+ cmap.language = p.parseULong();
+
+ var groupCount;
+ cmap.groupCount = groupCount = p.parseULong();
+ cmap.glyphIndexMap = {};
+
+ for (var i = 0; i < groupCount; i += 1) {
+ var startCharCode = p.parseULong();
+ var endCharCode = p.parseULong();
+ var startGlyphId = p.parseULong();
+
+ for (var c = startCharCode; c <= endCharCode; c += 1) {
+ cmap.glyphIndexMap[c] = startGlyphId;
+ startGlyphId++;
+ }
+ }
+ }
-'use strict';
+ function parseCmapTableFormat4(cmap, p, data, start, offset) {
+ // Length in bytes of the sub-tables.
+ cmap.length = p.parseUShort();
+ cmap.language = p.parseUShort();
+
+ // segCount is stored x 2.
+ var segCount;
+ cmap.segCount = segCount = p.parseUShort() >> 1;
+
+ // Skip searchRange, entrySelector, rangeShift.
+ p.skip('uShort', 3);
+
+ // The "unrolled" mapping from character codes to glyph indices.
+ cmap.glyphIndexMap = {};
+ var endCountParser = new parse.Parser(data, start + offset + 14);
+ var startCountParser = new parse.Parser(data, start + offset + 16 + segCount * 2);
+ var idDeltaParser = new parse.Parser(data, start + offset + 16 + segCount * 4);
+ var idRangeOffsetParser = new parse.Parser(data, start + offset + 16 + segCount * 6);
+ var glyphIndexOffset = start + offset + 16 + segCount * 8;
+ for (var i = 0; i < segCount - 1; i += 1) {
+ var glyphIndex = (void 0);
+ var endCount = endCountParser.parseUShort();
+ var startCount = startCountParser.parseUShort();
+ var idDelta = idDeltaParser.parseShort();
+ var idRangeOffset = idRangeOffsetParser.parseUShort();
+ for (var c = startCount; c <= endCount; c += 1) {
+ if (idRangeOffset !== 0) {
+ // The idRangeOffset is relative to the current position in the idRangeOffset array.
+ // Take the current offset in the idRangeOffset array.
+ glyphIndexOffset = (idRangeOffsetParser.offset + idRangeOffsetParser.relativeOffset - 2);
+
+ // Add the value of the idRangeOffset, which will move us into the glyphIndex array.
+ glyphIndexOffset += idRangeOffset;
+
+ // Then add the character index of the current segment, multiplied by 2 for USHORTs.
+ glyphIndexOffset += (c - startCount) * 2;
+ glyphIndex = parse.getUShort(data, glyphIndexOffset);
+ if (glyphIndex !== 0) {
+ glyphIndex = (glyphIndex + idDelta) & 0xFFFF;
+ }
+ } else {
+ glyphIndex = (c + idDelta) & 0xFFFF;
+ }
+
+ cmap.glyphIndexMap[c] = glyphIndex;
+ }
+ }
+ }
-var check = _dereq_('./check');
-var draw = _dereq_('./draw');
-var path = _dereq_('./path');
-var glyf = _dereq_('./tables/glyf');
+ // Parse the `cmap` table. This table stores the mappings from characters to glyphs.
+ // There are many available formats, but we only support the Windows format 4 and 12.
+ // This function returns a `CmapEncoding` object or null if no supported format could be found.
+ function parseCmapTable(data, start) {
+ var cmap = {};
+ cmap.version = parse.getUShort(data, start);
+ check.argument(cmap.version === 0, 'cmap table version should be 0.');
+
+ // The cmap table can contain many sub-tables, each with their own format.
+ // We're only interested in a "platform 0" (Unicode format) and "platform 3" (Windows format) table.
+ cmap.numTables = parse.getUShort(data, start + 2);
+ var offset = -1;
+ for (var i = cmap.numTables - 1; i >= 0; i -= 1) {
+ var platformId = parse.getUShort(data, start + 4 + (i * 8));
+ var encodingId = parse.getUShort(data, start + 4 + (i * 8) + 2);
+ if ((platformId === 3 && (encodingId === 0 || encodingId === 1 || encodingId === 10)) ||
+ (platformId === 0 && (encodingId === 0 || encodingId === 1 || encodingId === 2 || encodingId === 3 || encodingId === 4))) {
+ offset = parse.getULong(data, start + 4 + (i * 8) + 4);
+ break;
+ }
+ }
+
+ if (offset === -1) {
+ // There is no cmap table in the font that we support.
+ throw new Error('No valid cmap sub-tables found.');
+ }
+
+ var p = new parse.Parser(data, start + offset);
+ cmap.format = p.parseUShort();
+
+ if (cmap.format === 12) {
+ parseCmapTableFormat12(cmap, p);
+ } else if (cmap.format === 4) {
+ parseCmapTableFormat4(cmap, p, data, start, offset);
+ } else {
+ throw new Error('Only format 4 and 12 cmap tables are supported (found format ' + cmap.format + ').');
+ }
+
+ return cmap;
+ }
-function getPathDefinition(glyph, path) {
- var _path = path || { commands: [] };
- return {
- configurable: true,
+ function addSegment(t, code, glyphIndex) {
+ t.segments.push({
+ end: code,
+ start: code,
+ delta: -(code - glyphIndex),
+ offset: 0,
+ glyphIndex: glyphIndex
+ });
+ }
- get: function() {
- if (typeof _path === 'function') {
- _path = _path();
- }
+ function addTerminatorSegment(t) {
+ t.segments.push({
+ end: 0xFFFF,
+ start: 0xFFFF,
+ delta: 1,
+ offset: 0
+ });
+ }
- return _path;
- },
+ // Make cmap table, format 4 by default, 12 if needed only
+ function makeCmapTable(glyphs) {
+ // Plan 0 is the base Unicode Plan but emojis, for example are on another plan, and needs cmap 12 format (with 32bit)
+ var isPlan0Only = true;
+ var i;
+
+ // Check if we need to add cmap format 12 or if format 4 only is fine
+ for (i = glyphs.length - 1; i > 0; i -= 1) {
+ var g = glyphs.get(i);
+ if (g.unicode > 65535) {
+ console.log('Adding CMAP format 12 (needed!)');
+ isPlan0Only = false;
+ break;
+ }
+ }
+
+ var cmapTable = [
+ {name: 'version', type: 'USHORT', value: 0},
+ {name: 'numTables', type: 'USHORT', value: isPlan0Only ? 1 : 2},
+
+ // CMAP 4 header
+ {name: 'platformID', type: 'USHORT', value: 3},
+ {name: 'encodingID', type: 'USHORT', value: 1},
+ {name: 'offset', type: 'ULONG', value: isPlan0Only ? 12 : (12 + 8)}
+ ];
+
+ if (!isPlan0Only)
+ { cmapTable = cmapTable.concat([
+ // CMAP 12 header
+ {name: 'cmap12PlatformID', type: 'USHORT', value: 3}, // We encode only for PlatformID = 3 (Windows) because it is supported everywhere
+ {name: 'cmap12EncodingID', type: 'USHORT', value: 10},
+ {name: 'cmap12Offset', type: 'ULONG', value: 0}
+ ]); }
+
+ cmapTable = cmapTable.concat([
+ // CMAP 4 Subtable
+ {name: 'format', type: 'USHORT', value: 4},
+ {name: 'cmap4Length', type: 'USHORT', value: 0},
+ {name: 'language', type: 'USHORT', value: 0},
+ {name: 'segCountX2', type: 'USHORT', value: 0},
+ {name: 'searchRange', type: 'USHORT', value: 0},
+ {name: 'entrySelector', type: 'USHORT', value: 0},
+ {name: 'rangeShift', type: 'USHORT', value: 0}
+ ]);
+
+ var t = new table.Table('cmap', cmapTable);
+
+ t.segments = [];
+ for (i = 0; i < glyphs.length; i += 1) {
+ var glyph = glyphs.get(i);
+ for (var j = 0; j < glyph.unicodes.length; j += 1) {
+ addSegment(t, glyph.unicodes[j], i);
+ }
+
+ t.segments = t.segments.sort(function (a, b) {
+ return a.start - b.start;
+ });
+ }
+
+ addTerminatorSegment(t);
+
+ var segCount = t.segments.length;
+ var segCountToRemove = 0;
+
+ // CMAP 4
+ // Set up parallel segment arrays.
+ var endCounts = [];
+ var startCounts = [];
+ var idDeltas = [];
+ var idRangeOffsets = [];
+ var glyphIds = [];
+
+ // CMAP 12
+ var cmap12Groups = [];
+
+ // Reminder this loop is not following the specification at 100%
+ // The specification -> find suites of characters and make a group
+ // Here we're doing one group for each letter
+ // Doing as the spec can save 8 times (or more) space
+ for (i = 0; i < segCount; i += 1) {
+ var segment = t.segments[i];
+
+ // CMAP 4
+ if (segment.end <= 65535 && segment.start <= 65535) {
+ endCounts = endCounts.concat({name: 'end_' + i, type: 'USHORT', value: segment.end});
+ startCounts = startCounts.concat({name: 'start_' + i, type: 'USHORT', value: segment.start});
+ idDeltas = idDeltas.concat({name: 'idDelta_' + i, type: 'SHORT', value: segment.delta});
+ idRangeOffsets = idRangeOffsets.concat({name: 'idRangeOffset_' + i, type: 'USHORT', value: segment.offset});
+ if (segment.glyphId !== undefined) {
+ glyphIds = glyphIds.concat({name: 'glyph_' + i, type: 'USHORT', value: segment.glyphId});
+ }
+ } else {
+ // Skip Unicode > 65535 (16bit unsigned max) for CMAP 4, will be added in CMAP 12
+ segCountToRemove += 1;
+ }
+
+ // CMAP 12
+ // Skip Terminator Segment
+ if (!isPlan0Only && segment.glyphIndex !== undefined) {
+ cmap12Groups = cmap12Groups.concat({name: 'cmap12Start_' + i, type: 'ULONG', value: segment.start});
+ cmap12Groups = cmap12Groups.concat({name: 'cmap12End_' + i, type: 'ULONG', value: segment.end});
+ cmap12Groups = cmap12Groups.concat({name: 'cmap12Glyph_' + i, type: 'ULONG', value: segment.glyphIndex});
+ }
+ }
+
+ // CMAP 4 Subtable
+ t.segCountX2 = (segCount - segCountToRemove) * 2;
+ t.searchRange = Math.pow(2, Math.floor(Math.log((segCount - segCountToRemove)) / Math.log(2))) * 2;
+ t.entrySelector = Math.log(t.searchRange / 2) / Math.log(2);
+ t.rangeShift = t.segCountX2 - t.searchRange;
+
+ t.fields = t.fields.concat(endCounts);
+ t.fields.push({name: 'reservedPad', type: 'USHORT', value: 0});
+ t.fields = t.fields.concat(startCounts);
+ t.fields = t.fields.concat(idDeltas);
+ t.fields = t.fields.concat(idRangeOffsets);
+ t.fields = t.fields.concat(glyphIds);
+
+ t.cmap4Length = 14 + // Subtable header
+ endCounts.length * 2 +
+ 2 + // reservedPad
+ startCounts.length * 2 +
+ idDeltas.length * 2 +
+ idRangeOffsets.length * 2 +
+ glyphIds.length * 2;
+
+ if (!isPlan0Only) {
+ // CMAP 12 Subtable
+ var cmap12Length = 16 + // Subtable header
+ cmap12Groups.length * 4;
+
+ t.cmap12Offset = 12 + (2 * 2) + 4 + t.cmap4Length;
+ t.fields = t.fields.concat([
+ {name: 'cmap12Format', type: 'USHORT', value: 12},
+ {name: 'cmap12Reserved', type: 'USHORT', value: 0},
+ {name: 'cmap12Length', type: 'ULONG', value: cmap12Length},
+ {name: 'cmap12Language', type: 'ULONG', value: 0},
+ {name: 'cmap12nGroups', type: 'ULONG', value: cmap12Groups.length / 3}
+ ]);
+
+ t.fields = t.fields.concat(cmap12Groups);
+ }
+
+ return t;
+ }
- set: function(p) {
- _path = p;
- }
- };
-}
-/**
- * @typedef GlyphOptions
- * @type Object
- * @property {string} [name] - The glyph name
- * @property {number} [unicode]
- * @property {Array} [unicodes]
- * @property {number} [xMin]
- * @property {number} [yMin]
- * @property {number} [xMax]
- * @property {number} [yMax]
- * @property {number} [advanceWidth]
- */
-
-// A Glyph is an individual mark that often corresponds to a character.
-// Some glyphs, such as ligatures, are a combination of many characters.
-// Glyphs are the basic building blocks of a font.
-//
-// The `Glyph` class contains utility methods for drawing the path and its points.
-/**
- * @exports opentype.Glyph
- * @class
- * @param {GlyphOptions}
- * @constructor
- */
-function Glyph(options) {
- // By putting all the code on a prototype function (which is only declared once)
- // we reduce the memory requirements for larger fonts by some 2%
- this.bindConstructorValues(options);
-}
+ var cmap = { parse: parseCmapTable, make: makeCmapTable };
+
+ // Glyph encoding
+
+ var cffStandardStrings = [
+ '.notdef', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', 'ampersand', 'quoteright',
+ 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', 'zero', 'one', 'two',
+ 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', 'equal', 'greater',
+ 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S',
+ 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', 'asciicircum', 'underscore',
+ 'quoteleft', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't',
+ 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', 'exclamdown', 'cent', 'sterling',
+ 'fraction', 'yen', 'florin', 'section', 'currency', 'quotesingle', 'quotedblleft', 'guillemotleft',
+ 'guilsinglleft', 'guilsinglright', 'fi', 'fl', 'endash', 'dagger', 'daggerdbl', 'periodcentered', 'paragraph',
+ 'bullet', 'quotesinglbase', 'quotedblbase', 'quotedblright', 'guillemotright', 'ellipsis', 'perthousand',
+ 'questiondown', 'grave', 'acute', 'circumflex', 'tilde', 'macron', 'breve', 'dotaccent', 'dieresis', 'ring',
+ 'cedilla', 'hungarumlaut', 'ogonek', 'caron', 'emdash', 'AE', 'ordfeminine', 'Lslash', 'Oslash', 'OE',
+ 'ordmasculine', 'ae', 'dotlessi', 'lslash', 'oslash', 'oe', 'germandbls', 'onesuperior', 'logicalnot', 'mu',
+ 'trademark', 'Eth', 'onehalf', 'plusminus', 'Thorn', 'onequarter', 'divide', 'brokenbar', 'degree', 'thorn',
+ 'threequarters', 'twosuperior', 'registered', 'minus', 'eth', 'multiply', 'threesuperior', 'copyright',
+ 'Aacute', 'Acircumflex', 'Adieresis', 'Agrave', 'Aring', 'Atilde', 'Ccedilla', 'Eacute', 'Ecircumflex',
+ 'Edieresis', 'Egrave', 'Iacute', 'Icircumflex', 'Idieresis', 'Igrave', 'Ntilde', 'Oacute', 'Ocircumflex',
+ 'Odieresis', 'Ograve', 'Otilde', 'Scaron', 'Uacute', 'Ucircumflex', 'Udieresis', 'Ugrave', 'Yacute',
+ 'Ydieresis', 'Zcaron', 'aacute', 'acircumflex', 'adieresis', 'agrave', 'aring', 'atilde', 'ccedilla', 'eacute',
+ 'ecircumflex', 'edieresis', 'egrave', 'iacute', 'icircumflex', 'idieresis', 'igrave', 'ntilde', 'oacute',
+ 'ocircumflex', 'odieresis', 'ograve', 'otilde', 'scaron', 'uacute', 'ucircumflex', 'udieresis', 'ugrave',
+ 'yacute', 'ydieresis', 'zcaron', 'exclamsmall', 'Hungarumlautsmall', 'dollaroldstyle', 'dollarsuperior',
+ 'ampersandsmall', 'Acutesmall', 'parenleftsuperior', 'parenrightsuperior', '266 ff', 'onedotenleader',
+ 'zerooldstyle', 'oneoldstyle', 'twooldstyle', 'threeoldstyle', 'fouroldstyle', 'fiveoldstyle', 'sixoldstyle',
+ 'sevenoldstyle', 'eightoldstyle', 'nineoldstyle', 'commasuperior', 'threequartersemdash', 'periodsuperior',
+ 'questionsmall', 'asuperior', 'bsuperior', 'centsuperior', 'dsuperior', 'esuperior', 'isuperior', 'lsuperior',
+ 'msuperior', 'nsuperior', 'osuperior', 'rsuperior', 'ssuperior', 'tsuperior', 'ff', 'ffi', 'ffl',
+ 'parenleftinferior', 'parenrightinferior', 'Circumflexsmall', 'hyphensuperior', 'Gravesmall', 'Asmall',
+ 'Bsmall', 'Csmall', 'Dsmall', 'Esmall', 'Fsmall', 'Gsmall', 'Hsmall', 'Ismall', 'Jsmall', 'Ksmall', 'Lsmall',
+ 'Msmall', 'Nsmall', 'Osmall', 'Psmall', 'Qsmall', 'Rsmall', 'Ssmall', 'Tsmall', 'Usmall', 'Vsmall', 'Wsmall',
+ 'Xsmall', 'Ysmall', 'Zsmall', 'colonmonetary', 'onefitted', 'rupiah', 'Tildesmall', 'exclamdownsmall',
+ 'centoldstyle', 'Lslashsmall', 'Scaronsmall', 'Zcaronsmall', 'Dieresissmall', 'Brevesmall', 'Caronsmall',
+ 'Dotaccentsmall', 'Macronsmall', 'figuredash', 'hypheninferior', 'Ogoneksmall', 'Ringsmall', 'Cedillasmall',
+ 'questiondownsmall', 'oneeighth', 'threeeighths', 'fiveeighths', 'seveneighths', 'onethird', 'twothirds',
+ 'zerosuperior', 'foursuperior', 'fivesuperior', 'sixsuperior', 'sevensuperior', 'eightsuperior', 'ninesuperior',
+ 'zeroinferior', 'oneinferior', 'twoinferior', 'threeinferior', 'fourinferior', 'fiveinferior', 'sixinferior',
+ 'seveninferior', 'eightinferior', 'nineinferior', 'centinferior', 'dollarinferior', 'periodinferior',
+ 'commainferior', 'Agravesmall', 'Aacutesmall', 'Acircumflexsmall', 'Atildesmall', 'Adieresissmall',
+ 'Aringsmall', 'AEsmall', 'Ccedillasmall', 'Egravesmall', 'Eacutesmall', 'Ecircumflexsmall', 'Edieresissmall',
+ 'Igravesmall', 'Iacutesmall', 'Icircumflexsmall', 'Idieresissmall', 'Ethsmall', 'Ntildesmall', 'Ogravesmall',
+ 'Oacutesmall', 'Ocircumflexsmall', 'Otildesmall', 'Odieresissmall', 'OEsmall', 'Oslashsmall', 'Ugravesmall',
+ 'Uacutesmall', 'Ucircumflexsmall', 'Udieresissmall', 'Yacutesmall', 'Thornsmall', 'Ydieresissmall', '001.000',
+ '001.001', '001.002', '001.003', 'Black', 'Bold', 'Book', 'Light', 'Medium', 'Regular', 'Roman', 'Semibold'];
+
+ var cffStandardEncoding = [
+ '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
+ '', '', '', '', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', 'ampersand', 'quoteright',
+ 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', 'zero', 'one', 'two',
+ 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', 'equal', 'greater',
+ 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S',
+ 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', 'asciicircum', 'underscore',
+ 'quoteleft', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't',
+ 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', '', '', '', '', '', '', '', '',
+ '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
+ 'exclamdown', 'cent', 'sterling', 'fraction', 'yen', 'florin', 'section', 'currency', 'quotesingle',
+ 'quotedblleft', 'guillemotleft', 'guilsinglleft', 'guilsinglright', 'fi', 'fl', '', 'endash', 'dagger',
+ 'daggerdbl', 'periodcentered', '', 'paragraph', 'bullet', 'quotesinglbase', 'quotedblbase', 'quotedblright',
+ 'guillemotright', 'ellipsis', 'perthousand', '', 'questiondown', '', 'grave', 'acute', 'circumflex', 'tilde',
+ 'macron', 'breve', 'dotaccent', 'dieresis', '', 'ring', 'cedilla', '', 'hungarumlaut', 'ogonek', 'caron',
+ 'emdash', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', 'AE', '', 'ordfeminine', '', '', '',
+ '', 'Lslash', 'Oslash', 'OE', 'ordmasculine', '', '', '', '', '', 'ae', '', '', '', 'dotlessi', '', '',
+ 'lslash', 'oslash', 'oe', 'germandbls'];
+
+ var cffExpertEncoding = [
+ '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
+ '', '', '', '', 'space', 'exclamsmall', 'Hungarumlautsmall', '', 'dollaroldstyle', 'dollarsuperior',
+ 'ampersandsmall', 'Acutesmall', 'parenleftsuperior', 'parenrightsuperior', 'twodotenleader', 'onedotenleader',
+ 'comma', 'hyphen', 'period', 'fraction', 'zerooldstyle', 'oneoldstyle', 'twooldstyle', 'threeoldstyle',
+ 'fouroldstyle', 'fiveoldstyle', 'sixoldstyle', 'sevenoldstyle', 'eightoldstyle', 'nineoldstyle', 'colon',
+ 'semicolon', 'commasuperior', 'threequartersemdash', 'periodsuperior', 'questionsmall', '', 'asuperior',
+ 'bsuperior', 'centsuperior', 'dsuperior', 'esuperior', '', '', 'isuperior', '', '', 'lsuperior', 'msuperior',
+ 'nsuperior', 'osuperior', '', '', 'rsuperior', 'ssuperior', 'tsuperior', '', 'ff', 'fi', 'fl', 'ffi', 'ffl',
+ 'parenleftinferior', '', 'parenrightinferior', 'Circumflexsmall', 'hyphensuperior', 'Gravesmall', 'Asmall',
+ 'Bsmall', 'Csmall', 'Dsmall', 'Esmall', 'Fsmall', 'Gsmall', 'Hsmall', 'Ismall', 'Jsmall', 'Ksmall', 'Lsmall',
+ 'Msmall', 'Nsmall', 'Osmall', 'Psmall', 'Qsmall', 'Rsmall', 'Ssmall', 'Tsmall', 'Usmall', 'Vsmall', 'Wsmall',
+ 'Xsmall', 'Ysmall', 'Zsmall', 'colonmonetary', 'onefitted', 'rupiah', 'Tildesmall', '', '', '', '', '', '', '',
+ '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
+ 'exclamdownsmall', 'centoldstyle', 'Lslashsmall', '', '', 'Scaronsmall', 'Zcaronsmall', 'Dieresissmall',
+ 'Brevesmall', 'Caronsmall', '', 'Dotaccentsmall', '', '', 'Macronsmall', '', '', 'figuredash', 'hypheninferior',
+ '', '', 'Ogoneksmall', 'Ringsmall', 'Cedillasmall', '', '', '', 'onequarter', 'onehalf', 'threequarters',
+ 'questiondownsmall', 'oneeighth', 'threeeighths', 'fiveeighths', 'seveneighths', 'onethird', 'twothirds', '',
+ '', 'zerosuperior', 'onesuperior', 'twosuperior', 'threesuperior', 'foursuperior', 'fivesuperior',
+ 'sixsuperior', 'sevensuperior', 'eightsuperior', 'ninesuperior', 'zeroinferior', 'oneinferior', 'twoinferior',
+ 'threeinferior', 'fourinferior', 'fiveinferior', 'sixinferior', 'seveninferior', 'eightinferior',
+ 'nineinferior', 'centinferior', 'dollarinferior', 'periodinferior', 'commainferior', 'Agravesmall',
+ 'Aacutesmall', 'Acircumflexsmall', 'Atildesmall', 'Adieresissmall', 'Aringsmall', 'AEsmall', 'Ccedillasmall',
+ 'Egravesmall', 'Eacutesmall', 'Ecircumflexsmall', 'Edieresissmall', 'Igravesmall', 'Iacutesmall',
+ 'Icircumflexsmall', 'Idieresissmall', 'Ethsmall', 'Ntildesmall', 'Ogravesmall', 'Oacutesmall',
+ 'Ocircumflexsmall', 'Otildesmall', 'Odieresissmall', 'OEsmall', 'Oslashsmall', 'Ugravesmall', 'Uacutesmall',
+ 'Ucircumflexsmall', 'Udieresissmall', 'Yacutesmall', 'Thornsmall', 'Ydieresissmall'];
+
+ var standardNames = [
+ '.notdef', '.null', 'nonmarkingreturn', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent',
+ 'ampersand', 'quotesingle', 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash',
+ 'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less',
+ 'equal', 'greater', 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O',
+ 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright',
+ 'asciicircum', 'underscore', 'grave', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o',
+ 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde',
+ 'Adieresis', 'Aring', 'Ccedilla', 'Eacute', 'Ntilde', 'Odieresis', 'Udieresis', 'aacute', 'agrave',
+ 'acircumflex', 'adieresis', 'atilde', 'aring', 'ccedilla', 'eacute', 'egrave', 'ecircumflex', 'edieresis',
+ 'iacute', 'igrave', 'icircumflex', 'idieresis', 'ntilde', 'oacute', 'ograve', 'ocircumflex', 'odieresis',
+ 'otilde', 'uacute', 'ugrave', 'ucircumflex', 'udieresis', 'dagger', 'degree', 'cent', 'sterling', 'section',
+ 'bullet', 'paragraph', 'germandbls', 'registered', 'copyright', 'trademark', 'acute', 'dieresis', 'notequal',
+ 'AE', 'Oslash', 'infinity', 'plusminus', 'lessequal', 'greaterequal', 'yen', 'mu', 'partialdiff', 'summation',
+ 'product', 'pi', 'integral', 'ordfeminine', 'ordmasculine', 'Omega', 'ae', 'oslash', 'questiondown',
+ 'exclamdown', 'logicalnot', 'radical', 'florin', 'approxequal', 'Delta', 'guillemotleft', 'guillemotright',
+ 'ellipsis', 'nonbreakingspace', 'Agrave', 'Atilde', 'Otilde', 'OE', 'oe', 'endash', 'emdash', 'quotedblleft',
+ 'quotedblright', 'quoteleft', 'quoteright', 'divide', 'lozenge', 'ydieresis', 'Ydieresis', 'fraction',
+ 'currency', 'guilsinglleft', 'guilsinglright', 'fi', 'fl', 'daggerdbl', 'periodcentered', 'quotesinglbase',
+ 'quotedblbase', 'perthousand', 'Acircumflex', 'Ecircumflex', 'Aacute', 'Edieresis', 'Egrave', 'Iacute',
+ 'Icircumflex', 'Idieresis', 'Igrave', 'Oacute', 'Ocircumflex', 'apple', 'Ograve', 'Uacute', 'Ucircumflex',
+ 'Ugrave', 'dotlessi', 'circumflex', 'tilde', 'macron', 'breve', 'dotaccent', 'ring', 'cedilla', 'hungarumlaut',
+ 'ogonek', 'caron', 'Lslash', 'lslash', 'Scaron', 'scaron', 'Zcaron', 'zcaron', 'brokenbar', 'Eth', 'eth',
+ 'Yacute', 'yacute', 'Thorn', 'thorn', 'minus', 'multiply', 'onesuperior', 'twosuperior', 'threesuperior',
+ 'onehalf', 'onequarter', 'threequarters', 'franc', 'Gbreve', 'gbreve', 'Idotaccent', 'Scedilla', 'scedilla',
+ 'Cacute', 'cacute', 'Ccaron', 'ccaron', 'dcroat'];
+
+ /**
+ * This is the encoding used for fonts created from scratch.
+ * It loops through all glyphs and finds the appropriate unicode value.
+ * Since it's linear time, other encodings will be faster.
+ * @exports opentype.DefaultEncoding
+ * @class
+ * @constructor
+ * @param {opentype.Font}
+ */
+ function DefaultEncoding(font) {
+ this.font = font;
+ }
-/**
- * @param {GlyphOptions}
- */
-Glyph.prototype.bindConstructorValues = function(options) {
- this.index = options.index || 0;
+ DefaultEncoding.prototype.charToGlyphIndex = function(c) {
+ var code = c.codePointAt(0);
+ var glyphs = this.font.glyphs;
+ if (glyphs) {
+ for (var i = 0; i < glyphs.length; i += 1) {
+ var glyph = glyphs.get(i);
+ for (var j = 0; j < glyph.unicodes.length; j += 1) {
+ if (glyph.unicodes[j] === code) {
+ return i;
+ }
+ }
+ }
+ }
+ return null;
+ };
+
+ /**
+ * @exports opentype.CmapEncoding
+ * @class
+ * @constructor
+ * @param {Object} cmap - a object with the cmap encoded data
+ */
+ function CmapEncoding(cmap) {
+ this.cmap = cmap;
+ }
- // These three values cannnot be deferred for memory optimization:
- this.name = options.name || null;
- this.unicode = options.unicode || undefined;
- this.unicodes = options.unicodes || options.unicode !== undefined ? [options.unicode] : [];
+ /**
+ * @param {string} c - the character
+ * @return {number} The glyph index.
+ */
+ CmapEncoding.prototype.charToGlyphIndex = function(c) {
+ return this.cmap.glyphIndexMap[c.codePointAt(0)] || 0;
+ };
+
+ /**
+ * @exports opentype.CffEncoding
+ * @class
+ * @constructor
+ * @param {string} encoding - The encoding
+ * @param {Array} charset - The character set.
+ */
+ function CffEncoding(encoding, charset) {
+ this.encoding = encoding;
+ this.charset = charset;
+ }
- // But by binding these values only when necessary, we reduce can
- // the memory requirements by almost 3% for larger fonts.
- if (options.xMin) {
- this.xMin = options.xMin;
- }
+ /**
+ * @param {string} s - The character
+ * @return {number} The index.
+ */
+ CffEncoding.prototype.charToGlyphIndex = function(s) {
+ var code = s.codePointAt(0);
+ var charName = this.encoding[code];
+ return this.charset.indexOf(charName);
+ };
+
+ /**
+ * @exports opentype.GlyphNames
+ * @class
+ * @constructor
+ * @param {Object} post
+ */
+ function GlyphNames(post) {
+ var this$1 = this;
+
+ switch (post.version) {
+ case 1:
+ this.names = standardNames.slice();
+ break;
+ case 2:
+ this.names = new Array(post.numberOfGlyphs);
+ for (var i = 0; i < post.numberOfGlyphs; i++) {
+ if (post.glyphNameIndex[i] < standardNames.length) {
+ this$1.names[i] = standardNames[post.glyphNameIndex[i]];
+ } else {
+ this$1.names[i] = post.names[post.glyphNameIndex[i] - standardNames.length];
+ }
+ }
+
+ break;
+ case 2.5:
+ this.names = new Array(post.numberOfGlyphs);
+ for (var i$1 = 0; i$1 < post.numberOfGlyphs; i$1++) {
+ this$1.names[i$1] = standardNames[i$1 + post.glyphNameIndex[i$1]];
+ }
+
+ break;
+ case 3:
+ this.names = [];
+ break;
+ default:
+ this.names = [];
+ break;
+ }
+ }
- if (options.yMin) {
- this.yMin = options.yMin;
- }
+ /**
+ * Gets the index of a glyph by name.
+ * @param {string} name - The glyph name
+ * @return {number} The index
+ */
+ GlyphNames.prototype.nameToGlyphIndex = function(name) {
+ return this.names.indexOf(name);
+ };
+
+ /**
+ * @param {number} gid
+ * @return {string}
+ */
+ GlyphNames.prototype.glyphIndexToName = function(gid) {
+ return this.names[gid];
+ };
+
+ /**
+ * @alias opentype.addGlyphNames
+ * @param {opentype.Font}
+ */
+ function addGlyphNames(font) {
+ var glyph;
+ var glyphIndexMap = font.tables.cmap.glyphIndexMap;
+ var charCodes = Object.keys(glyphIndexMap);
+
+ for (var i = 0; i < charCodes.length; i += 1) {
+ var c = charCodes[i];
+ var glyphIndex = glyphIndexMap[c];
+ glyph = font.glyphs.get(glyphIndex);
+ glyph.addUnicode(parseInt(c));
+ }
+
+ for (var i$1 = 0; i$1 < font.glyphs.length; i$1 += 1) {
+ glyph = font.glyphs.get(i$1);
+ if (font.cffEncoding) {
+ if (font.isCIDFont) {
+ glyph.name = 'gid' + i$1;
+ } else {
+ glyph.name = font.cffEncoding.charset[i$1];
+ }
+ } else if (font.glyphNames.names) {
+ glyph.name = font.glyphNames.glyphIndexToName(i$1);
+ }
+ }
+ }
- if (options.xMax) {
- this.xMax = options.xMax;
- }
+ // Drawing utility functions.
- if (options.yMax) {
- this.yMax = options.yMax;
- }
+ // Draw a line on the given context from point `x1,y1` to point `x2,y2`.
+ function line(ctx, x1, y1, x2, y2) {
+ ctx.beginPath();
+ ctx.moveTo(x1, y1);
+ ctx.lineTo(x2, y2);
+ ctx.stroke();
+ }
- if (options.advanceWidth) {
- this.advanceWidth = options.advanceWidth;
- }
+ var draw = { line: line };
- // The path for a glyph is the most memory intensive, and is bound as a value
- // with a getter/setter to ensure we actually do path parsing only once the
- // path is actually needed by anything.
- Object.defineProperty(this, 'path', getPathDefinition(this, options.path));
-};
+ // The Glyph object
+ // import glyf from './tables/glyf' Can't be imported here, because it's a circular dependency
-/**
- * @param {number}
- */
-Glyph.prototype.addUnicode = function(unicode) {
- if (this.unicodes.length === 0) {
- this.unicode = unicode;
- }
+ function getPathDefinition(glyph, path) {
+ var _path = path || new Path();
+ return {
+ configurable: true,
- this.unicodes.push(unicode);
-};
+ get: function() {
+ if (typeof _path === 'function') {
+ _path = _path();
+ }
-/**
- * Calculate the minimum bounding box for this glyph.
- * @return {opentype.BoundingBox}
- */
-Glyph.prototype.getBoundingBox = function() {
- return this.path.getBoundingBox();
-};
+ return _path;
+ },
-/**
- * Convert the glyph to a Path we can draw on a drawing context.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {Object=} options - xScale, yScale to strech the glyph.
- * @param {opentype.Font} if hinting is to be used, the font
- * @return {opentype.Path}
- */
-Glyph.prototype.getPath = function(x, y, fontSize, options, font) {
- x = x !== undefined ? x : 0;
- y = y !== undefined ? y : 0;
- fontSize = fontSize !== undefined ? fontSize : 72;
- var commands;
- var hPoints;
- if (!options) options = { };
- var xScale = options.xScale;
- var yScale = options.yScale;
+ set: function(p) {
+ _path = p;
+ }
+ };
+ }
+ /**
+ * @typedef GlyphOptions
+ * @type Object
+ * @property {string} [name] - The glyph name
+ * @property {number} [unicode]
+ * @property {Array} [unicodes]
+ * @property {number} [xMin]
+ * @property {number} [yMin]
+ * @property {number} [xMax]
+ * @property {number} [yMax]
+ * @property {number} [advanceWidth]
+ */
+
+ // A Glyph is an individual mark that often corresponds to a character.
+ // Some glyphs, such as ligatures, are a combination of many characters.
+ // Glyphs are the basic building blocks of a font.
+ //
+ // The `Glyph` class contains utility methods for drawing the path and its points.
+ /**
+ * @exports opentype.Glyph
+ * @class
+ * @param {GlyphOptions}
+ * @constructor
+ */
+ function Glyph(options) {
+ // By putting all the code on a prototype function (which is only declared once)
+ // we reduce the memory requirements for larger fonts by some 2%
+ this.bindConstructorValues(options);
+ }
- if (options.hinting && font && font.hinting) {
- // in case of hinting, the hinting engine takes care
- // of scaling the points (not the path) before hinting.
- hPoints = this.path && font.hinting.exec(this, fontSize);
- // in case the hinting engine failed hPoints is undefined
- // and thus reverts to plain rending
- }
+ /**
+ * @param {GlyphOptions}
+ */
+ Glyph.prototype.bindConstructorValues = function(options) {
+ this.index = options.index || 0;
+
+ // These three values cannot be deferred for memory optimization:
+ this.name = options.name || null;
+ this.unicode = options.unicode || undefined;
+ this.unicodes = options.unicodes || options.unicode !== undefined ? [options.unicode] : [];
+
+ // But by binding these values only when necessary, we reduce can
+ // the memory requirements by almost 3% for larger fonts.
+ if (options.xMin) {
+ this.xMin = options.xMin;
+ }
+
+ if (options.yMin) {
+ this.yMin = options.yMin;
+ }
+
+ if (options.xMax) {
+ this.xMax = options.xMax;
+ }
+
+ if (options.yMax) {
+ this.yMax = options.yMax;
+ }
+
+ if (options.advanceWidth) {
+ this.advanceWidth = options.advanceWidth;
+ }
+
+ // The path for a glyph is the most memory intensive, and is bound as a value
+ // with a getter/setter to ensure we actually do path parsing only once the
+ // path is actually needed by anything.
+ Object.defineProperty(this, 'path', getPathDefinition(this, options.path));
+ };
+
+ /**
+ * @param {number}
+ */
+ Glyph.prototype.addUnicode = function(unicode) {
+ if (this.unicodes.length === 0) {
+ this.unicode = unicode;
+ }
+
+ this.unicodes.push(unicode);
+ };
+
+ /**
+ * Calculate the minimum bounding box for this glyph.
+ * @return {opentype.BoundingBox}
+ */
+ Glyph.prototype.getBoundingBox = function() {
+ return this.path.getBoundingBox();
+ };
+
+ /**
+ * Convert the glyph to a Path we can draw on a drawing context.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {Object=} options - xScale, yScale to stretch the glyph.
+ * @param {opentype.Font} if hinting is to be used, the font
+ * @return {opentype.Path}
+ */
+ Glyph.prototype.getPath = function(x, y, fontSize, options, font) {
+ x = x !== undefined ? x : 0;
+ y = y !== undefined ? y : 0;
+ fontSize = fontSize !== undefined ? fontSize : 72;
+ var commands;
+ var hPoints;
+ if (!options) { options = { }; }
+ var xScale = options.xScale;
+ var yScale = options.yScale;
+
+ if (options.hinting && font && font.hinting) {
+ // in case of hinting, the hinting engine takes care
+ // of scaling the points (not the path) before hinting.
+ hPoints = this.path && font.hinting.exec(this, fontSize);
+ // in case the hinting engine failed hPoints is undefined
+ // and thus reverts to plain rending
+ }
+
+ if (hPoints) {
+ // Call font.hinting.getCommands instead of `glyf.getPath(hPoints).commands` to avoid a circular dependency
+ commands = font.hinting.getCommands(hPoints);
+ x = Math.round(x);
+ y = Math.round(y);
+ // TODO in case of hinting xyScaling is not yet supported
+ xScale = yScale = 1;
+ } else {
+ commands = this.path.commands;
+ var scale = 1 / this.path.unitsPerEm * fontSize;
+ if (xScale === undefined) { xScale = scale; }
+ if (yScale === undefined) { yScale = scale; }
+ }
+
+ var p = new Path();
+ for (var i = 0; i < commands.length; i += 1) {
+ var cmd = commands[i];
+ if (cmd.type === 'M') {
+ p.moveTo(x + (cmd.x * xScale), y + (-cmd.y * yScale));
+ } else if (cmd.type === 'L') {
+ p.lineTo(x + (cmd.x * xScale), y + (-cmd.y * yScale));
+ } else if (cmd.type === 'Q') {
+ p.quadraticCurveTo(x + (cmd.x1 * xScale), y + (-cmd.y1 * yScale),
+ x + (cmd.x * xScale), y + (-cmd.y * yScale));
+ } else if (cmd.type === 'C') {
+ p.curveTo(x + (cmd.x1 * xScale), y + (-cmd.y1 * yScale),
+ x + (cmd.x2 * xScale), y + (-cmd.y2 * yScale),
+ x + (cmd.x * xScale), y + (-cmd.y * yScale));
+ } else if (cmd.type === 'Z') {
+ p.closePath();
+ }
+ }
+
+ return p;
+ };
+
+ /**
+ * Split the glyph into contours.
+ * This function is here for backwards compatibility, and to
+ * provide raw access to the TrueType glyph outlines.
+ * @return {Array}
+ */
+ Glyph.prototype.getContours = function() {
+ var this$1 = this;
+
+ if (this.points === undefined) {
+ return [];
+ }
+
+ var contours = [];
+ var currentContour = [];
+ for (var i = 0; i < this.points.length; i += 1) {
+ var pt = this$1.points[i];
+ currentContour.push(pt);
+ if (pt.lastPointOfContour) {
+ contours.push(currentContour);
+ currentContour = [];
+ }
+ }
+
+ check.argument(currentContour.length === 0, 'There are still points left in the current contour.');
+ return contours;
+ };
+
+ /**
+ * Calculate the xMin/yMin/xMax/yMax/lsb/rsb for a Glyph.
+ * @return {Object}
+ */
+ Glyph.prototype.getMetrics = function() {
+ var commands = this.path.commands;
+ var xCoords = [];
+ var yCoords = [];
+ for (var i = 0; i < commands.length; i += 1) {
+ var cmd = commands[i];
+ if (cmd.type !== 'Z') {
+ xCoords.push(cmd.x);
+ yCoords.push(cmd.y);
+ }
+
+ if (cmd.type === 'Q' || cmd.type === 'C') {
+ xCoords.push(cmd.x1);
+ yCoords.push(cmd.y1);
+ }
+
+ if (cmd.type === 'C') {
+ xCoords.push(cmd.x2);
+ yCoords.push(cmd.y2);
+ }
+ }
+
+ var metrics = {
+ xMin: Math.min.apply(null, xCoords),
+ yMin: Math.min.apply(null, yCoords),
+ xMax: Math.max.apply(null, xCoords),
+ yMax: Math.max.apply(null, yCoords),
+ leftSideBearing: this.leftSideBearing
+ };
+
+ if (!isFinite(metrics.xMin)) {
+ metrics.xMin = 0;
+ }
+
+ if (!isFinite(metrics.xMax)) {
+ metrics.xMax = this.advanceWidth;
+ }
+
+ if (!isFinite(metrics.yMin)) {
+ metrics.yMin = 0;
+ }
+
+ if (!isFinite(metrics.yMax)) {
+ metrics.yMax = 0;
+ }
+
+ metrics.rightSideBearing = this.advanceWidth - metrics.leftSideBearing - (metrics.xMax - metrics.xMin);
+ return metrics;
+ };
+
+ /**
+ * Draw the glyph on the given context.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {Object=} options - xScale, yScale to stretch the glyph.
+ */
+ Glyph.prototype.draw = function(ctx, x, y, fontSize, options) {
+ this.getPath(x, y, fontSize, options).draw(ctx);
+ };
+
+ /**
+ * Draw the points of the glyph.
+ * On-curve points will be drawn in blue, off-curve points will be drawn in red.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ */
+ Glyph.prototype.drawPoints = function(ctx, x, y, fontSize) {
+ function drawCircles(l, x, y, scale) {
+ var PI_SQ = Math.PI * 2;
+ ctx.beginPath();
+ for (var j = 0; j < l.length; j += 1) {
+ ctx.moveTo(x + (l[j].x * scale), y + (l[j].y * scale));
+ ctx.arc(x + (l[j].x * scale), y + (l[j].y * scale), 2, 0, PI_SQ, false);
+ }
+
+ ctx.closePath();
+ ctx.fill();
+ }
+
+ x = x !== undefined ? x : 0;
+ y = y !== undefined ? y : 0;
+ fontSize = fontSize !== undefined ? fontSize : 24;
+ var scale = 1 / this.path.unitsPerEm * fontSize;
+
+ var blueCircles = [];
+ var redCircles = [];
+ var path = this.path;
+ for (var i = 0; i < path.commands.length; i += 1) {
+ var cmd = path.commands[i];
+ if (cmd.x !== undefined) {
+ blueCircles.push({x: cmd.x, y: -cmd.y});
+ }
+
+ if (cmd.x1 !== undefined) {
+ redCircles.push({x: cmd.x1, y: -cmd.y1});
+ }
+
+ if (cmd.x2 !== undefined) {
+ redCircles.push({x: cmd.x2, y: -cmd.y2});
+ }
+ }
+
+ ctx.fillStyle = 'blue';
+ drawCircles(blueCircles, x, y, scale);
+ ctx.fillStyle = 'red';
+ drawCircles(redCircles, x, y, scale);
+ };
+
+ /**
+ * Draw lines indicating important font measurements.
+ * Black lines indicate the origin of the coordinate system (point 0,0).
+ * Blue lines indicate the glyph bounding box.
+ * Green line indicates the advance width of the glyph.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ */
+ Glyph.prototype.drawMetrics = function(ctx, x, y, fontSize) {
+ var scale;
+ x = x !== undefined ? x : 0;
+ y = y !== undefined ? y : 0;
+ fontSize = fontSize !== undefined ? fontSize : 24;
+ scale = 1 / this.path.unitsPerEm * fontSize;
+ ctx.lineWidth = 1;
+
+ // Draw the origin
+ ctx.strokeStyle = 'black';
+ draw.line(ctx, x, -10000, x, 10000);
+ draw.line(ctx, -10000, y, 10000, y);
+
+ // This code is here due to memory optimization: by not using
+ // defaults in the constructor, we save a notable amount of memory.
+ var xMin = this.xMin || 0;
+ var yMin = this.yMin || 0;
+ var xMax = this.xMax || 0;
+ var yMax = this.yMax || 0;
+ var advanceWidth = this.advanceWidth || 0;
+
+ // Draw the glyph box
+ ctx.strokeStyle = 'blue';
+ draw.line(ctx, x + (xMin * scale), -10000, x + (xMin * scale), 10000);
+ draw.line(ctx, x + (xMax * scale), -10000, x + (xMax * scale), 10000);
+ draw.line(ctx, -10000, y + (-yMin * scale), 10000, y + (-yMin * scale));
+ draw.line(ctx, -10000, y + (-yMax * scale), 10000, y + (-yMax * scale));
+
+ // Draw the advance width
+ ctx.strokeStyle = 'green';
+ draw.line(ctx, x + (advanceWidth * scale), -10000, x + (advanceWidth * scale), 10000);
+ };
+
+ // The GlyphSet object
+
+ // Define a property on the glyph that depends on the path being loaded.
+ function defineDependentProperty(glyph, externalName, internalName) {
+ Object.defineProperty(glyph, externalName, {
+ get: function() {
+ // Request the path property to make sure the path is loaded.
+ glyph.path; // jshint ignore:line
+ return glyph[internalName];
+ },
+ set: function(newValue) {
+ glyph[internalName] = newValue;
+ },
+ enumerable: true,
+ configurable: true
+ });
+ }
- if (hPoints) {
- commands = glyf.getPath(hPoints).commands;
- x = Math.round(x);
- y = Math.round(y);
- // TODO in case of hinting xyScaling is not yet supported
- xScale = yScale = 1;
- } else {
- commands = this.path.commands;
- var scale = 1 / this.path.unitsPerEm * fontSize;
- if (xScale === undefined) xScale = scale;
- if (yScale === undefined) yScale = scale;
- }
+ /**
+ * A GlyphSet represents all glyphs available in the font, but modelled using
+ * a deferred glyph loader, for retrieving glyphs only once they are absolutely
+ * necessary, to keep the memory footprint down.
+ * @exports opentype.GlyphSet
+ * @class
+ * @param {opentype.Font}
+ * @param {Array}
+ */
+ function GlyphSet(font, glyphs) {
+ var this$1 = this;
+
+ this.font = font;
+ this.glyphs = {};
+ if (Array.isArray(glyphs)) {
+ for (var i = 0; i < glyphs.length; i++) {
+ this$1.glyphs[i] = glyphs[i];
+ }
+ }
+
+ this.length = (glyphs && glyphs.length) || 0;
+ }
- var p = new path.Path();
- for (var i = 0; i < commands.length; i += 1) {
- var cmd = commands[i];
- if (cmd.type === 'M') {
- p.moveTo(x + (cmd.x * xScale), y + (-cmd.y * yScale));
- } else if (cmd.type === 'L') {
- p.lineTo(x + (cmd.x * xScale), y + (-cmd.y * yScale));
- } else if (cmd.type === 'Q') {
- p.quadraticCurveTo(x + (cmd.x1 * xScale), y + (-cmd.y1 * yScale),
- x + (cmd.x * xScale), y + (-cmd.y * yScale));
- } else if (cmd.type === 'C') {
- p.curveTo(x + (cmd.x1 * xScale), y + (-cmd.y1 * yScale),
- x + (cmd.x2 * xScale), y + (-cmd.y2 * yScale),
- x + (cmd.x * xScale), y + (-cmd.y * yScale));
- } else if (cmd.type === 'Z') {
- p.closePath();
- }
- }
+ /**
+ * @param {number} index
+ * @return {opentype.Glyph}
+ */
+ GlyphSet.prototype.get = function(index) {
+ if (typeof this.glyphs[index] === 'function') {
+ this.glyphs[index] = this.glyphs[index]();
+ }
+
+ return this.glyphs[index];
+ };
+
+ /**
+ * @param {number} index
+ * @param {Object}
+ */
+ GlyphSet.prototype.push = function(index, loader) {
+ this.glyphs[index] = loader;
+ this.length++;
+ };
+
+ /**
+ * @alias opentype.glyphLoader
+ * @param {opentype.Font} font
+ * @param {number} index
+ * @return {opentype.Glyph}
+ */
+ function glyphLoader(font, index) {
+ return new Glyph({index: index, font: font});
+ }
- return p;
-};
+ /**
+ * Generate a stub glyph that can be filled with all metadata *except*
+ * the "points" and "path" properties, which must be loaded only once
+ * the glyph's path is actually requested for text shaping.
+ * @alias opentype.ttfGlyphLoader
+ * @param {opentype.Font} font
+ * @param {number} index
+ * @param {Function} parseGlyph
+ * @param {Object} data
+ * @param {number} position
+ * @param {Function} buildPath
+ * @return {opentype.Glyph}
+ */
+ function ttfGlyphLoader(font, index, parseGlyph, data, position, buildPath) {
+ return function() {
+ var glyph = new Glyph({index: index, font: font});
+
+ glyph.path = function() {
+ parseGlyph(glyph, data, position);
+ var path = buildPath(font.glyphs, glyph);
+ path.unitsPerEm = font.unitsPerEm;
+ return path;
+ };
+
+ defineDependentProperty(glyph, 'xMin', '_xMin');
+ defineDependentProperty(glyph, 'xMax', '_xMax');
+ defineDependentProperty(glyph, 'yMin', '_yMin');
+ defineDependentProperty(glyph, 'yMax', '_yMax');
+
+ return glyph;
+ };
+ }
+ /**
+ * @alias opentype.cffGlyphLoader
+ * @param {opentype.Font} font
+ * @param {number} index
+ * @param {Function} parseCFFCharstring
+ * @param {string} charstring
+ * @return {opentype.Glyph}
+ */
+ function cffGlyphLoader(font, index, parseCFFCharstring, charstring) {
+ return function() {
+ var glyph = new Glyph({index: index, font: font});
+
+ glyph.path = function() {
+ var path = parseCFFCharstring(font, glyph, charstring);
+ path.unitsPerEm = font.unitsPerEm;
+ return path;
+ };
+
+ return glyph;
+ };
+ }
-/**
- * Split the glyph into contours.
- * This function is here for backwards compatibility, and to
- * provide raw access to the TrueType glyph outlines.
- * @return {Array}
- */
-Glyph.prototype.getContours = function() {
- if (this.points === undefined) {
- return [];
- }
+ var glyphset = { GlyphSet: GlyphSet, glyphLoader: glyphLoader, ttfGlyphLoader: ttfGlyphLoader, cffGlyphLoader: cffGlyphLoader };
+
+ // The `CFF` table contains the glyph outlines in PostScript format.
+
+ // Custom equals function that can also check lists.
+ function equals(a, b) {
+ if (a === b) {
+ return true;
+ } else if (Array.isArray(a) && Array.isArray(b)) {
+ if (a.length !== b.length) {
+ return false;
+ }
+
+ for (var i = 0; i < a.length; i += 1) {
+ if (!equals(a[i], b[i])) {
+ return false;
+ }
+ }
+
+ return true;
+ } else {
+ return false;
+ }
+ }
- var contours = [];
- var currentContour = [];
- for (var i = 0; i < this.points.length; i += 1) {
- var pt = this.points[i];
- currentContour.push(pt);
- if (pt.lastPointOfContour) {
- contours.push(currentContour);
- currentContour = [];
- }
- }
+ // Subroutines are encoded using the negative half of the number space.
+ // See type 2 chapter 4.7 "Subroutine operators".
+ function calcCFFSubroutineBias(subrs) {
+ var bias;
+ if (subrs.length < 1240) {
+ bias = 107;
+ } else if (subrs.length < 33900) {
+ bias = 1131;
+ } else {
+ bias = 32768;
+ }
+
+ return bias;
+ }
- check.argument(currentContour.length === 0, 'There are still points left in the current contour.');
- return contours;
-};
+ // Parse a `CFF` INDEX array.
+ // An index array consists of a list of offsets, then a list of objects at those offsets.
+ function parseCFFIndex(data, start, conversionFn) {
+ var offsets = [];
+ var objects = [];
+ var count = parse.getCard16(data, start);
+ var objectOffset;
+ var endOffset;
+ if (count !== 0) {
+ var offsetSize = parse.getByte(data, start + 2);
+ objectOffset = start + ((count + 1) * offsetSize) + 2;
+ var pos = start + 3;
+ for (var i = 0; i < count + 1; i += 1) {
+ offsets.push(parse.getOffset(data, pos, offsetSize));
+ pos += offsetSize;
+ }
+
+ // The total size of the index array is 4 header bytes + the value of the last offset.
+ endOffset = objectOffset + offsets[count];
+ } else {
+ endOffset = start + 2;
+ }
+
+ for (var i$1 = 0; i$1 < offsets.length - 1; i$1 += 1) {
+ var value = parse.getBytes(data, objectOffset + offsets[i$1], objectOffset + offsets[i$1 + 1]);
+ if (conversionFn) {
+ value = conversionFn(value);
+ }
+
+ objects.push(value);
+ }
+
+ return {objects: objects, startOffset: start, endOffset: endOffset};
+ }
-/**
- * Calculate the xMin/yMin/xMax/yMax/lsb/rsb for a Glyph.
- * @return {Object}
- */
-Glyph.prototype.getMetrics = function() {
- var commands = this.path.commands;
- var xCoords = [];
- var yCoords = [];
- for (var i = 0; i < commands.length; i += 1) {
- var cmd = commands[i];
- if (cmd.type !== 'Z') {
- xCoords.push(cmd.x);
- yCoords.push(cmd.y);
- }
+ // Parse a `CFF` DICT real value.
+ function parseFloatOperand(parser) {
+ var s = '';
+ var eof = 15;
+ var lookup = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '.', 'E', 'E-', null, '-'];
+ while (true) {
+ var b = parser.parseByte();
+ var n1 = b >> 4;
+ var n2 = b & 15;
- if (cmd.type === 'Q' || cmd.type === 'C') {
- xCoords.push(cmd.x1);
- yCoords.push(cmd.y1);
- }
+ if (n1 === eof) {
+ break;
+ }
- if (cmd.type === 'C') {
- xCoords.push(cmd.x2);
- yCoords.push(cmd.y2);
- }
- }
+ s += lookup[n1];
- var metrics = {
- xMin: Math.min.apply(null, xCoords),
- yMin: Math.min.apply(null, yCoords),
- xMax: Math.max.apply(null, xCoords),
- yMax: Math.max.apply(null, yCoords),
- leftSideBearing: this.leftSideBearing
- };
+ if (n2 === eof) {
+ break;
+ }
- if (!isFinite(metrics.xMin)) {
- metrics.xMin = 0;
- }
+ s += lookup[n2];
+ }
- if (!isFinite(metrics.xMax)) {
- metrics.xMax = this.advanceWidth;
- }
+ return parseFloat(s);
+ }
- if (!isFinite(metrics.yMin)) {
- metrics.yMin = 0;
- }
+ // Parse a `CFF` DICT operand.
+ function parseOperand(parser, b0) {
+ var b1;
+ var b2;
+ var b3;
+ var b4;
+ if (b0 === 28) {
+ b1 = parser.parseByte();
+ b2 = parser.parseByte();
+ return b1 << 8 | b2;
+ }
+
+ if (b0 === 29) {
+ b1 = parser.parseByte();
+ b2 = parser.parseByte();
+ b3 = parser.parseByte();
+ b4 = parser.parseByte();
+ return b1 << 24 | b2 << 16 | b3 << 8 | b4;
+ }
+
+ if (b0 === 30) {
+ return parseFloatOperand(parser);
+ }
+
+ if (b0 >= 32 && b0 <= 246) {
+ return b0 - 139;
+ }
+
+ if (b0 >= 247 && b0 <= 250) {
+ b1 = parser.parseByte();
+ return (b0 - 247) * 256 + b1 + 108;
+ }
+
+ if (b0 >= 251 && b0 <= 254) {
+ b1 = parser.parseByte();
+ return -(b0 - 251) * 256 - b1 - 108;
+ }
+
+ throw new Error('Invalid b0 ' + b0);
+ }
- if (!isFinite(metrics.yMax)) {
- metrics.yMax = 0;
- }
+ // Convert the entries returned by `parseDict` to a proper dictionary.
+ // If a value is a list of one, it is unpacked.
+ function entriesToObject(entries) {
+ var o = {};
+ for (var i = 0; i < entries.length; i += 1) {
+ var key = entries[i][0];
+ var values = entries[i][1];
+ var value = (void 0);
+ if (values.length === 1) {
+ value = values[0];
+ } else {
+ value = values;
+ }
+
+ if (o.hasOwnProperty(key) && !isNaN(o[key])) {
+ throw new Error('Object ' + o + ' already has key ' + key);
+ }
+
+ o[key] = value;
+ }
+
+ return o;
+ }
- metrics.rightSideBearing = this.advanceWidth - metrics.leftSideBearing - (metrics.xMax - metrics.xMin);
- return metrics;
-};
+ // Parse a `CFF` DICT object.
+ // A dictionary contains key-value pairs in a compact tokenized format.
+ function parseCFFDict(data, start, size) {
+ start = start !== undefined ? start : 0;
+ var parser = new parse.Parser(data, start);
+ var entries = [];
+ var operands = [];
+ size = size !== undefined ? size : data.length;
+
+ while (parser.relativeOffset < size) {
+ var op = parser.parseByte();
+
+ // The first byte for each dict item distinguishes between operator (key) and operand (value).
+ // Values <= 21 are operators.
+ if (op <= 21) {
+ // Two-byte operators have an initial escape byte of 12.
+ if (op === 12) {
+ op = 1200 + parser.parseByte();
+ }
+
+ entries.push([op, operands]);
+ operands = [];
+ } else {
+ // Since the operands (values) come before the operators (keys), we store all operands in a list
+ // until we encounter an operator.
+ operands.push(parseOperand(parser, op));
+ }
+ }
+
+ return entriesToObject(entries);
+ }
-/**
- * Draw the glyph on the given context.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- * @param {Object=} options - xScale, yScale to strech the glyph.
- */
-Glyph.prototype.draw = function(ctx, x, y, fontSize, options) {
- this.getPath(x, y, fontSize, options).draw(ctx);
-};
+ // Given a String Index (SID), return the value of the string.
+ // Strings below index 392 are standard CFF strings and are not encoded in the font.
+ function getCFFString(strings, index) {
+ if (index <= 390) {
+ index = cffStandardStrings[index];
+ } else {
+ index = strings[index - 391];
+ }
-/**
- * Draw the points of the glyph.
- * On-curve points will be drawn in blue, off-curve points will be drawn in red.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- */
-Glyph.prototype.drawPoints = function(ctx, x, y, fontSize) {
+ return index;
+ }
- function drawCircles(l, x, y, scale) {
- var PI_SQ = Math.PI * 2;
- ctx.beginPath();
- for (var j = 0; j < l.length; j += 1) {
- ctx.moveTo(x + (l[j].x * scale), y + (l[j].y * scale));
- ctx.arc(x + (l[j].x * scale), y + (l[j].y * scale), 2, 0, PI_SQ, false);
- }
+ // Interpret a dictionary and return a new dictionary with readable keys and values for missing entries.
+ // This function takes `meta` which is a list of objects containing `operand`, `name` and `default`.
+ function interpretDict(dict, meta, strings) {
+ var newDict = {};
+ var value;
+
+ // Because we also want to include missing values, we start out from the meta list
+ // and lookup values in the dict.
+ for (var i = 0; i < meta.length; i += 1) {
+ var m = meta[i];
+
+ if (Array.isArray(m.type)) {
+ var values = [];
+ values.length = m.type.length;
+ for (var j = 0; j < m.type.length; j++) {
+ value = dict[m.op] !== undefined ? dict[m.op][j] : undefined;
+ if (value === undefined) {
+ value = m.value !== undefined && m.value[j] !== undefined ? m.value[j] : null;
+ }
+ if (m.type[j] === 'SID') {
+ value = getCFFString(strings, value);
+ }
+ values[j] = value;
+ }
+ newDict[m.name] = values;
+ } else {
+ value = dict[m.op];
+ if (value === undefined) {
+ value = m.value !== undefined ? m.value : null;
+ }
+
+ if (m.type === 'SID') {
+ value = getCFFString(strings, value);
+ }
+ newDict[m.name] = value;
+ }
+ }
+
+ return newDict;
+ }
- ctx.closePath();
- ctx.fill();
- }
+ // Parse the CFF header.
+ function parseCFFHeader(data, start) {
+ var header = {};
+ header.formatMajor = parse.getCard8(data, start);
+ header.formatMinor = parse.getCard8(data, start + 1);
+ header.size = parse.getCard8(data, start + 2);
+ header.offsetSize = parse.getCard8(data, start + 3);
+ header.startOffset = start;
+ header.endOffset = start + 4;
+ return header;
+ }
- x = x !== undefined ? x : 0;
- y = y !== undefined ? y : 0;
- fontSize = fontSize !== undefined ? fontSize : 24;
- var scale = 1 / this.path.unitsPerEm * fontSize;
-
- var blueCircles = [];
- var redCircles = [];
- var path = this.path;
- for (var i = 0; i < path.commands.length; i += 1) {
- var cmd = path.commands[i];
- if (cmd.x !== undefined) {
- blueCircles.push({x: cmd.x, y: -cmd.y});
- }
+ var TOP_DICT_META = [
+ {name: 'version', op: 0, type: 'SID'},
+ {name: 'notice', op: 1, type: 'SID'},
+ {name: 'copyright', op: 1200, type: 'SID'},
+ {name: 'fullName', op: 2, type: 'SID'},
+ {name: 'familyName', op: 3, type: 'SID'},
+ {name: 'weight', op: 4, type: 'SID'},
+ {name: 'isFixedPitch', op: 1201, type: 'number', value: 0},
+ {name: 'italicAngle', op: 1202, type: 'number', value: 0},
+ {name: 'underlinePosition', op: 1203, type: 'number', value: -100},
+ {name: 'underlineThickness', op: 1204, type: 'number', value: 50},
+ {name: 'paintType', op: 1205, type: 'number', value: 0},
+ {name: 'charstringType', op: 1206, type: 'number', value: 2},
+ {
+ name: 'fontMatrix',
+ op: 1207,
+ type: ['real', 'real', 'real', 'real', 'real', 'real'],
+ value: [0.001, 0, 0, 0.001, 0, 0]
+ },
+ {name: 'uniqueId', op: 13, type: 'number'},
+ {name: 'fontBBox', op: 5, type: ['number', 'number', 'number', 'number'], value: [0, 0, 0, 0]},
+ {name: 'strokeWidth', op: 1208, type: 'number', value: 0},
+ {name: 'xuid', op: 14, type: [], value: null},
+ {name: 'charset', op: 15, type: 'offset', value: 0},
+ {name: 'encoding', op: 16, type: 'offset', value: 0},
+ {name: 'charStrings', op: 17, type: 'offset', value: 0},
+ {name: 'private', op: 18, type: ['number', 'offset'], value: [0, 0]},
+ {name: 'ros', op: 1230, type: ['SID', 'SID', 'number']},
+ {name: 'cidFontVersion', op: 1231, type: 'number', value: 0},
+ {name: 'cidFontRevision', op: 1232, type: 'number', value: 0},
+ {name: 'cidFontType', op: 1233, type: 'number', value: 0},
+ {name: 'cidCount', op: 1234, type: 'number', value: 8720},
+ {name: 'uidBase', op: 1235, type: 'number'},
+ {name: 'fdArray', op: 1236, type: 'offset'},
+ {name: 'fdSelect', op: 1237, type: 'offset'},
+ {name: 'fontName', op: 1238, type: 'SID'}
+ ];
+
+ var PRIVATE_DICT_META = [
+ {name: 'subrs', op: 19, type: 'offset', value: 0},
+ {name: 'defaultWidthX', op: 20, type: 'number', value: 0},
+ {name: 'nominalWidthX', op: 21, type: 'number', value: 0}
+ ];
+
+ // Parse the CFF top dictionary. A CFF table can contain multiple fonts, each with their own top dictionary.
+ // The top dictionary contains the essential metadata for the font, together with the private dictionary.
+ function parseCFFTopDict(data, strings) {
+ var dict = parseCFFDict(data, 0, data.byteLength);
+ return interpretDict(dict, TOP_DICT_META, strings);
+ }
- if (cmd.x1 !== undefined) {
- redCircles.push({x: cmd.x1, y: -cmd.y1});
- }
+ // Parse the CFF private dictionary. We don't fully parse out all the values, only the ones we need.
+ function parseCFFPrivateDict(data, start, size, strings) {
+ var dict = parseCFFDict(data, start, size);
+ return interpretDict(dict, PRIVATE_DICT_META, strings);
+ }
- if (cmd.x2 !== undefined) {
- redCircles.push({x: cmd.x2, y: -cmd.y2});
- }
- }
+ // Returns a list of "Top DICT"s found using an INDEX list.
+ // Used to read both the usual high-level Top DICTs and also the FDArray
+ // discovered inside CID-keyed fonts. When a Top DICT has a reference to
+ // a Private DICT that is read and saved into the Top DICT.
+ //
+ // In addition to the expected/optional values as outlined in TOP_DICT_META
+ // the following values might be saved into the Top DICT.
+ //
+ // _subrs [] array of local CFF subroutines from Private DICT
+ // _subrsBias bias value computed from number of subroutines
+ // (see calcCFFSubroutineBias() and parseCFFCharstring())
+ // _defaultWidthX default widths for CFF characters
+ // _nominalWidthX bias added to width embedded within glyph description
+ //
+ // _privateDict saved copy of parsed Private DICT from Top DICT
+ function gatherCFFTopDicts(data, start, cffIndex, strings) {
+ var topDictArray = [];
+ for (var iTopDict = 0; iTopDict < cffIndex.length; iTopDict += 1) {
+ var topDictData = new DataView(new Uint8Array(cffIndex[iTopDict]).buffer);
+ var topDict = parseCFFTopDict(topDictData, strings);
+ topDict._subrs = [];
+ topDict._subrsBias = 0;
+ var privateSize = topDict.private[0];
+ var privateOffset = topDict.private[1];
+ if (privateSize !== 0 && privateOffset !== 0) {
+ var privateDict = parseCFFPrivateDict(data, privateOffset + start, privateSize, strings);
+ topDict._defaultWidthX = privateDict.defaultWidthX;
+ topDict._nominalWidthX = privateDict.nominalWidthX;
+ if (privateDict.subrs !== 0) {
+ var subrOffset = privateOffset + privateDict.subrs;
+ var subrIndex = parseCFFIndex(data, subrOffset + start);
+ topDict._subrs = subrIndex.objects;
+ topDict._subrsBias = calcCFFSubroutineBias(topDict._subrs);
+ }
+ topDict._privateDict = privateDict;
+ }
+ topDictArray.push(topDict);
+ }
+ return topDictArray;
+ }
- ctx.fillStyle = 'blue';
- drawCircles(blueCircles, x, y, scale);
- ctx.fillStyle = 'red';
- drawCircles(redCircles, x, y, scale);
-};
+ // Parse the CFF charset table, which contains internal names for all the glyphs.
+ // This function will return a list of glyph names.
+ // See Adobe TN #5176 chapter 13, "Charsets".
+ function parseCFFCharset(data, start, nGlyphs, strings) {
+ var sid;
+ var count;
+ var parser = new parse.Parser(data, start);
+
+ // The .notdef glyph is not included, so subtract 1.
+ nGlyphs -= 1;
+ var charset = ['.notdef'];
+
+ var format = parser.parseCard8();
+ if (format === 0) {
+ for (var i = 0; i < nGlyphs; i += 1) {
+ sid = parser.parseSID();
+ charset.push(getCFFString(strings, sid));
+ }
+ } else if (format === 1) {
+ while (charset.length <= nGlyphs) {
+ sid = parser.parseSID();
+ count = parser.parseCard8();
+ for (var i$1 = 0; i$1 <= count; i$1 += 1) {
+ charset.push(getCFFString(strings, sid));
+ sid += 1;
+ }
+ }
+ } else if (format === 2) {
+ while (charset.length <= nGlyphs) {
+ sid = parser.parseSID();
+ count = parser.parseCard16();
+ for (var i$2 = 0; i$2 <= count; i$2 += 1) {
+ charset.push(getCFFString(strings, sid));
+ sid += 1;
+ }
+ }
+ } else {
+ throw new Error('Unknown charset format ' + format);
+ }
+
+ return charset;
+ }
-/**
- * Draw lines indicating important font measurements.
- * Black lines indicate the origin of the coordinate system (point 0,0).
- * Blue lines indicate the glyph bounding box.
- * Green line indicates the advance width of the glyph.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
- * @param {number} [x=0] - Horizontal position of the beginning of the text.
- * @param {number} [y=0] - Vertical position of the *baseline* of the text.
- * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
- */
-Glyph.prototype.drawMetrics = function(ctx, x, y, fontSize) {
- var scale;
- x = x !== undefined ? x : 0;
- y = y !== undefined ? y : 0;
- fontSize = fontSize !== undefined ? fontSize : 24;
- scale = 1 / this.path.unitsPerEm * fontSize;
- ctx.lineWidth = 1;
+ // Parse the CFF encoding data. Only one encoding can be specified per font.
+ // See Adobe TN #5176 chapter 12, "Encodings".
+ function parseCFFEncoding(data, start, charset) {
+ var code;
+ var enc = {};
+ var parser = new parse.Parser(data, start);
+ var format = parser.parseCard8();
+ if (format === 0) {
+ var nCodes = parser.parseCard8();
+ for (var i = 0; i < nCodes; i += 1) {
+ code = parser.parseCard8();
+ enc[code] = i;
+ }
+ } else if (format === 1) {
+ var nRanges = parser.parseCard8();
+ code = 1;
+ for (var i$1 = 0; i$1 < nRanges; i$1 += 1) {
+ var first = parser.parseCard8();
+ var nLeft = parser.parseCard8();
+ for (var j = first; j <= first + nLeft; j += 1) {
+ enc[j] = code;
+ code += 1;
+ }
+ }
+ } else {
+ throw new Error('Unknown encoding format ' + format);
+ }
+
+ return new CffEncoding(enc, charset);
+ }
- // Draw the origin
- ctx.strokeStyle = 'black';
- draw.line(ctx, x, -10000, x, 10000);
- draw.line(ctx, -10000, y, 10000, y);
+ // Take in charstring code and return a Glyph object.
+ // The encoding is described in the Type 2 Charstring Format
+ // https://www.microsoft.com/typography/OTSPEC/charstr2.htm
+ function parseCFFCharstring(font, glyph, code) {
+ var c1x;
+ var c1y;
+ var c2x;
+ var c2y;
+ var p = new Path();
+ var stack = [];
+ var nStems = 0;
+ var haveWidth = false;
+ var open = false;
+ var x = 0;
+ var y = 0;
+ var subrs;
+ var subrsBias;
+ var defaultWidthX;
+ var nominalWidthX;
+ if (font.isCIDFont) {
+ var fdIndex = font.tables.cff.topDict._fdSelect[glyph.index];
+ var fdDict = font.tables.cff.topDict._fdArray[fdIndex];
+ subrs = fdDict._subrs;
+ subrsBias = fdDict._subrsBias;
+ defaultWidthX = fdDict._defaultWidthX;
+ nominalWidthX = fdDict._nominalWidthX;
+ } else {
+ subrs = font.tables.cff.topDict._subrs;
+ subrsBias = font.tables.cff.topDict._subrsBias;
+ defaultWidthX = font.tables.cff.topDict._defaultWidthX;
+ nominalWidthX = font.tables.cff.topDict._nominalWidthX;
+ }
+ var width = defaultWidthX;
+
+ function newContour(x, y) {
+ if (open) {
+ p.closePath();
+ }
+
+ p.moveTo(x, y);
+ open = true;
+ }
+
+ function parseStems() {
+ var hasWidthArg;
+
+ // The number of stem operators on the stack is always even.
+ // If the value is uneven, that means a width is specified.
+ hasWidthArg = stack.length % 2 !== 0;
+ if (hasWidthArg && !haveWidth) {
+ width = stack.shift() + nominalWidthX;
+ }
+
+ nStems += stack.length >> 1;
+ stack.length = 0;
+ haveWidth = true;
+ }
+
+ function parse$$1(code) {
+ var b1;
+ var b2;
+ var b3;
+ var b4;
+ var codeIndex;
+ var subrCode;
+ var jpx;
+ var jpy;
+ var c3x;
+ var c3y;
+ var c4x;
+ var c4y;
+
+ var i = 0;
+ while (i < code.length) {
+ var v = code[i];
+ i += 1;
+ switch (v) {
+ case 1: // hstem
+ parseStems();
+ break;
+ case 3: // vstem
+ parseStems();
+ break;
+ case 4: // vmoveto
+ if (stack.length > 1 && !haveWidth) {
+ width = stack.shift() + nominalWidthX;
+ haveWidth = true;
+ }
+
+ y += stack.pop();
+ newContour(x, y);
+ break;
+ case 5: // rlineto
+ while (stack.length > 0) {
+ x += stack.shift();
+ y += stack.shift();
+ p.lineTo(x, y);
+ }
+
+ break;
+ case 6: // hlineto
+ while (stack.length > 0) {
+ x += stack.shift();
+ p.lineTo(x, y);
+ if (stack.length === 0) {
+ break;
+ }
+
+ y += stack.shift();
+ p.lineTo(x, y);
+ }
+
+ break;
+ case 7: // vlineto
+ while (stack.length > 0) {
+ y += stack.shift();
+ p.lineTo(x, y);
+ if (stack.length === 0) {
+ break;
+ }
+
+ x += stack.shift();
+ p.lineTo(x, y);
+ }
+
+ break;
+ case 8: // rrcurveto
+ while (stack.length > 0) {
+ c1x = x + stack.shift();
+ c1y = y + stack.shift();
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x + stack.shift();
+ y = c2y + stack.shift();
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ }
+
+ break;
+ case 10: // callsubr
+ codeIndex = stack.pop() + subrsBias;
+ subrCode = subrs[codeIndex];
+ if (subrCode) {
+ parse$$1(subrCode);
+ }
+
+ break;
+ case 11: // return
+ return;
+ case 12: // flex operators
+ v = code[i];
+ i += 1;
+ switch (v) {
+ case 35: // flex
+ // |- dx1 dy1 dx2 dy2 dx3 dy3 dx4 dy4 dx5 dy5 dx6 dy6 fd flex (12 35) |-
+ c1x = x + stack.shift(); // dx1
+ c1y = y + stack.shift(); // dy1
+ c2x = c1x + stack.shift(); // dx2
+ c2y = c1y + stack.shift(); // dy2
+ jpx = c2x + stack.shift(); // dx3
+ jpy = c2y + stack.shift(); // dy3
+ c3x = jpx + stack.shift(); // dx4
+ c3y = jpy + stack.shift(); // dy4
+ c4x = c3x + stack.shift(); // dx5
+ c4y = c3y + stack.shift(); // dy5
+ x = c4x + stack.shift(); // dx6
+ y = c4y + stack.shift(); // dy6
+ stack.shift(); // flex depth
+ p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
+ p.curveTo(c3x, c3y, c4x, c4y, x, y);
+ break;
+ case 34: // hflex
+ // |- dx1 dx2 dy2 dx3 dx4 dx5 dx6 hflex (12 34) |-
+ c1x = x + stack.shift(); // dx1
+ c1y = y; // dy1
+ c2x = c1x + stack.shift(); // dx2
+ c2y = c1y + stack.shift(); // dy2
+ jpx = c2x + stack.shift(); // dx3
+ jpy = c2y; // dy3
+ c3x = jpx + stack.shift(); // dx4
+ c3y = c2y; // dy4
+ c4x = c3x + stack.shift(); // dx5
+ c4y = y; // dy5
+ x = c4x + stack.shift(); // dx6
+ p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
+ p.curveTo(c3x, c3y, c4x, c4y, x, y);
+ break;
+ case 36: // hflex1
+ // |- dx1 dy1 dx2 dy2 dx3 dx4 dx5 dy5 dx6 hflex1 (12 36) |-
+ c1x = x + stack.shift(); // dx1
+ c1y = y + stack.shift(); // dy1
+ c2x = c1x + stack.shift(); // dx2
+ c2y = c1y + stack.shift(); // dy2
+ jpx = c2x + stack.shift(); // dx3
+ jpy = c2y; // dy3
+ c3x = jpx + stack.shift(); // dx4
+ c3y = c2y; // dy4
+ c4x = c3x + stack.shift(); // dx5
+ c4y = c3y + stack.shift(); // dy5
+ x = c4x + stack.shift(); // dx6
+ p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
+ p.curveTo(c3x, c3y, c4x, c4y, x, y);
+ break;
+ case 37: // flex1
+ // |- dx1 dy1 dx2 dy2 dx3 dy3 dx4 dy4 dx5 dy5 d6 flex1 (12 37) |-
+ c1x = x + stack.shift(); // dx1
+ c1y = y + stack.shift(); // dy1
+ c2x = c1x + stack.shift(); // dx2
+ c2y = c1y + stack.shift(); // dy2
+ jpx = c2x + stack.shift(); // dx3
+ jpy = c2y + stack.shift(); // dy3
+ c3x = jpx + stack.shift(); // dx4
+ c3y = jpy + stack.shift(); // dy4
+ c4x = c3x + stack.shift(); // dx5
+ c4y = c3y + stack.shift(); // dy5
+ if (Math.abs(c4x - x) > Math.abs(c4y - y)) {
+ x = c4x + stack.shift();
+ } else {
+ y = c4y + stack.shift();
+ }
+
+ p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
+ p.curveTo(c3x, c3y, c4x, c4y, x, y);
+ break;
+ default:
+ console.log('Glyph ' + glyph.index + ': unknown operator ' + 1200 + v);
+ stack.length = 0;
+ }
+ break;
+ case 14: // endchar
+ if (stack.length > 0 && !haveWidth) {
+ width = stack.shift() + nominalWidthX;
+ haveWidth = true;
+ }
+
+ if (open) {
+ p.closePath();
+ open = false;
+ }
+
+ break;
+ case 18: // hstemhm
+ parseStems();
+ break;
+ case 19: // hintmask
+ case 20: // cntrmask
+ parseStems();
+ i += (nStems + 7) >> 3;
+ break;
+ case 21: // rmoveto
+ if (stack.length > 2 && !haveWidth) {
+ width = stack.shift() + nominalWidthX;
+ haveWidth = true;
+ }
+
+ y += stack.pop();
+ x += stack.pop();
+ newContour(x, y);
+ break;
+ case 22: // hmoveto
+ if (stack.length > 1 && !haveWidth) {
+ width = stack.shift() + nominalWidthX;
+ haveWidth = true;
+ }
+
+ x += stack.pop();
+ newContour(x, y);
+ break;
+ case 23: // vstemhm
+ parseStems();
+ break;
+ case 24: // rcurveline
+ while (stack.length > 2) {
+ c1x = x + stack.shift();
+ c1y = y + stack.shift();
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x + stack.shift();
+ y = c2y + stack.shift();
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ }
+
+ x += stack.shift();
+ y += stack.shift();
+ p.lineTo(x, y);
+ break;
+ case 25: // rlinecurve
+ while (stack.length > 6) {
+ x += stack.shift();
+ y += stack.shift();
+ p.lineTo(x, y);
+ }
+
+ c1x = x + stack.shift();
+ c1y = y + stack.shift();
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x + stack.shift();
+ y = c2y + stack.shift();
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ break;
+ case 26: // vvcurveto
+ if (stack.length % 2) {
+ x += stack.shift();
+ }
+
+ while (stack.length > 0) {
+ c1x = x;
+ c1y = y + stack.shift();
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x;
+ y = c2y + stack.shift();
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ }
+
+ break;
+ case 27: // hhcurveto
+ if (stack.length % 2) {
+ y += stack.shift();
+ }
+
+ while (stack.length > 0) {
+ c1x = x + stack.shift();
+ c1y = y;
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x + stack.shift();
+ y = c2y;
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ }
+
+ break;
+ case 28: // shortint
+ b1 = code[i];
+ b2 = code[i + 1];
+ stack.push(((b1 << 24) | (b2 << 16)) >> 16);
+ i += 2;
+ break;
+ case 29: // callgsubr
+ codeIndex = stack.pop() + font.gsubrsBias;
+ subrCode = font.gsubrs[codeIndex];
+ if (subrCode) {
+ parse$$1(subrCode);
+ }
+
+ break;
+ case 30: // vhcurveto
+ while (stack.length > 0) {
+ c1x = x;
+ c1y = y + stack.shift();
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x + stack.shift();
+ y = c2y + (stack.length === 1 ? stack.shift() : 0);
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ if (stack.length === 0) {
+ break;
+ }
+
+ c1x = x + stack.shift();
+ c1y = y;
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ y = c2y + stack.shift();
+ x = c2x + (stack.length === 1 ? stack.shift() : 0);
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ }
+
+ break;
+ case 31: // hvcurveto
+ while (stack.length > 0) {
+ c1x = x + stack.shift();
+ c1y = y;
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ y = c2y + stack.shift();
+ x = c2x + (stack.length === 1 ? stack.shift() : 0);
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ if (stack.length === 0) {
+ break;
+ }
+
+ c1x = x;
+ c1y = y + stack.shift();
+ c2x = c1x + stack.shift();
+ c2y = c1y + stack.shift();
+ x = c2x + stack.shift();
+ y = c2y + (stack.length === 1 ? stack.shift() : 0);
+ p.curveTo(c1x, c1y, c2x, c2y, x, y);
+ }
+
+ break;
+ default:
+ if (v < 32) {
+ console.log('Glyph ' + glyph.index + ': unknown operator ' + v);
+ } else if (v < 247) {
+ stack.push(v - 139);
+ } else if (v < 251) {
+ b1 = code[i];
+ i += 1;
+ stack.push((v - 247) * 256 + b1 + 108);
+ } else if (v < 255) {
+ b1 = code[i];
+ i += 1;
+ stack.push(-(v - 251) * 256 - b1 - 108);
+ } else {
+ b1 = code[i];
+ b2 = code[i + 1];
+ b3 = code[i + 2];
+ b4 = code[i + 3];
+ i += 4;
+ stack.push(((b1 << 24) | (b2 << 16) | (b3 << 8) | b4) / 65536);
+ }
+ }
+ }
+ }
+
+ parse$$1(code);
+
+ glyph.advanceWidth = width;
+ return p;
+ }
- // This code is here due to memory optimization: by not using
- // defaults in the constructor, we save a notable amount of memory.
- var xMin = this.xMin || 0;
- var yMin = this.yMin || 0;
- var xMax = this.xMax || 0;
- var yMax = this.yMax || 0;
- var advanceWidth = this.advanceWidth || 0;
+ function parseCFFFDSelect(data, start, nGlyphs, fdArrayCount) {
+ var fdSelect = [];
+ var fdIndex;
+ var parser = new parse.Parser(data, start);
+ var format = parser.parseCard8();
+ if (format === 0) {
+ // Simple list of nGlyphs elements
+ for (var iGid = 0; iGid < nGlyphs; iGid++) {
+ fdIndex = parser.parseCard8();
+ if (fdIndex >= fdArrayCount) {
+ throw new Error('CFF table CID Font FDSelect has bad FD index value ' + fdIndex + ' (FD count ' + fdArrayCount + ')');
+ }
+ fdSelect.push(fdIndex);
+ }
+ } else if (format === 3) {
+ // Ranges
+ var nRanges = parser.parseCard16();
+ var first = parser.parseCard16();
+ if (first !== 0) {
+ throw new Error('CFF Table CID Font FDSelect format 3 range has bad initial GID ' + first);
+ }
+ var next;
+ for (var iRange = 0; iRange < nRanges; iRange++) {
+ fdIndex = parser.parseCard8();
+ next = parser.parseCard16();
+ if (fdIndex >= fdArrayCount) {
+ throw new Error('CFF table CID Font FDSelect has bad FD index value ' + fdIndex + ' (FD count ' + fdArrayCount + ')');
+ }
+ if (next > nGlyphs) {
+ throw new Error('CFF Table CID Font FDSelect format 3 range has bad GID ' + next);
+ }
+ for (; first < next; first++) {
+ fdSelect.push(fdIndex);
+ }
+ first = next;
+ }
+ if (next !== nGlyphs) {
+ throw new Error('CFF Table CID Font FDSelect format 3 range has bad final GID ' + next);
+ }
+ } else {
+ throw new Error('CFF Table CID Font FDSelect table has unsupported format ' + format);
+ }
+ return fdSelect;
+ }
- // Draw the glyph box
- ctx.strokeStyle = 'blue';
- draw.line(ctx, x + (xMin * scale), -10000, x + (xMin * scale), 10000);
- draw.line(ctx, x + (xMax * scale), -10000, x + (xMax * scale), 10000);
- draw.line(ctx, -10000, y + (-yMin * scale), 10000, y + (-yMin * scale));
- draw.line(ctx, -10000, y + (-yMax * scale), 10000, y + (-yMax * scale));
+ // Parse the `CFF` table, which contains the glyph outlines in PostScript format.
+ function parseCFFTable(data, start, font) {
+ font.tables.cff = {};
+ var header = parseCFFHeader(data, start);
+ var nameIndex = parseCFFIndex(data, header.endOffset, parse.bytesToString);
+ var topDictIndex = parseCFFIndex(data, nameIndex.endOffset);
+ var stringIndex = parseCFFIndex(data, topDictIndex.endOffset, parse.bytesToString);
+ var globalSubrIndex = parseCFFIndex(data, stringIndex.endOffset);
+ font.gsubrs = globalSubrIndex.objects;
+ font.gsubrsBias = calcCFFSubroutineBias(font.gsubrs);
+
+ var topDictArray = gatherCFFTopDicts(data, start, topDictIndex.objects, stringIndex.objects);
+ if (topDictArray.length !== 1) {
+ throw new Error('CFF table has too many fonts in \'FontSet\' - count of fonts NameIndex.length = ' + topDictArray.length);
+ }
+
+ var topDict = topDictArray[0];
+ font.tables.cff.topDict = topDict;
+
+ if (topDict._privateDict) {
+ font.defaultWidthX = topDict._privateDict.defaultWidthX;
+ font.nominalWidthX = topDict._privateDict.nominalWidthX;
+ }
+
+ if (topDict.ros[0] !== undefined && topDict.ros[1] !== undefined) {
+ font.isCIDFont = true;
+ }
+
+ if (font.isCIDFont) {
+ var fdArrayOffset = topDict.fdArray;
+ var fdSelectOffset = topDict.fdSelect;
+ if (fdArrayOffset === 0 || fdSelectOffset === 0) {
+ throw new Error('Font is marked as a CID font, but FDArray and/or FDSelect information is missing');
+ }
+ fdArrayOffset += start;
+ var fdArrayIndex = parseCFFIndex(data, fdArrayOffset);
+ var fdArray = gatherCFFTopDicts(data, start, fdArrayIndex.objects, stringIndex.objects);
+ topDict._fdArray = fdArray;
+ fdSelectOffset += start;
+ topDict._fdSelect = parseCFFFDSelect(data, fdSelectOffset, font.numGlyphs, fdArray.length);
+ }
+
+ var privateDictOffset = start + topDict.private[1];
+ var privateDict = parseCFFPrivateDict(data, privateDictOffset, topDict.private[0], stringIndex.objects);
+ font.defaultWidthX = privateDict.defaultWidthX;
+ font.nominalWidthX = privateDict.nominalWidthX;
+
+ if (privateDict.subrs !== 0) {
+ var subrOffset = privateDictOffset + privateDict.subrs;
+ var subrIndex = parseCFFIndex(data, subrOffset);
+ font.subrs = subrIndex.objects;
+ font.subrsBias = calcCFFSubroutineBias(font.subrs);
+ } else {
+ font.subrs = [];
+ font.subrsBias = 0;
+ }
+
+ // Offsets in the top dict are relative to the beginning of the CFF data, so add the CFF start offset.
+ var charStringsIndex = parseCFFIndex(data, start + topDict.charStrings);
+ font.nGlyphs = charStringsIndex.objects.length;
+
+ var charset = parseCFFCharset(data, start + topDict.charset, font.nGlyphs, stringIndex.objects);
+ if (topDict.encoding === 0) {
+ // Standard encoding
+ font.cffEncoding = new CffEncoding(cffStandardEncoding, charset);
+ } else if (topDict.encoding === 1) {
+ // Expert encoding
+ font.cffEncoding = new CffEncoding(cffExpertEncoding, charset);
+ } else {
+ font.cffEncoding = parseCFFEncoding(data, start + topDict.encoding, charset);
+ }
+
+ // Prefer the CMAP encoding to the CFF encoding.
+ font.encoding = font.encoding || font.cffEncoding;
+
+ font.glyphs = new glyphset.GlyphSet(font);
+ for (var i = 0; i < font.nGlyphs; i += 1) {
+ var charString = charStringsIndex.objects[i];
+ font.glyphs.push(i, glyphset.cffGlyphLoader(font, i, parseCFFCharstring, charString));
+ }
+ }
- // Draw the advance width
- ctx.strokeStyle = 'green';
- draw.line(ctx, x + (advanceWidth * scale), -10000, x + (advanceWidth * scale), 10000);
-};
+ // Convert a string to a String ID (SID).
+ // The list of strings is modified in place.
+ function encodeString(s, strings) {
+ var sid;
+
+ // Is the string in the CFF standard strings?
+ var i = cffStandardStrings.indexOf(s);
+ if (i >= 0) {
+ sid = i;
+ }
+
+ // Is the string already in the string index?
+ i = strings.indexOf(s);
+ if (i >= 0) {
+ sid = i + cffStandardStrings.length;
+ } else {
+ sid = cffStandardStrings.length + strings.length;
+ strings.push(s);
+ }
+
+ return sid;
+ }
-exports.Glyph = Glyph;
+ function makeHeader() {
+ return new table.Record('Header', [
+ {name: 'major', type: 'Card8', value: 1},
+ {name: 'minor', type: 'Card8', value: 0},
+ {name: 'hdrSize', type: 'Card8', value: 4},
+ {name: 'major', type: 'Card8', value: 1}
+ ]);
+ }
-},{"./check":10,"./draw":11,"./path":20,"./tables/glyf":26}],15:[function(_dereq_,module,exports){
-// The GlyphSet object
+ function makeNameIndex(fontNames) {
+ var t = new table.Record('Name INDEX', [
+ {name: 'names', type: 'INDEX', value: []}
+ ]);
+ t.names = [];
+ for (var i = 0; i < fontNames.length; i += 1) {
+ t.names.push({name: 'name_' + i, type: 'NAME', value: fontNames[i]});
+ }
-'use strict';
+ return t;
+ }
-var _glyph = _dereq_('./glyph');
+ // Given a dictionary's metadata, create a DICT structure.
+ function makeDict(meta, attrs, strings) {
+ var m = {};
+ for (var i = 0; i < meta.length; i += 1) {
+ var entry = meta[i];
+ var value = attrs[entry.name];
+ if (value !== undefined && !equals(value, entry.value)) {
+ if (entry.type === 'SID') {
+ value = encodeString(value, strings);
+ }
+
+ m[entry.op] = {name: entry.name, type: entry.type, value: value};
+ }
+ }
+
+ return m;
+ }
-// Define a property on the glyph that depends on the path being loaded.
-function defineDependentProperty(glyph, externalName, internalName) {
- Object.defineProperty(glyph, externalName, {
- get: function() {
- // Request the path property to make sure the path is loaded.
- glyph.path; // jshint ignore:line
- return glyph[internalName];
- },
- set: function(newValue) {
- glyph[internalName] = newValue;
- },
- enumerable: true,
- configurable: true
- });
-}
+ // The Top DICT houses the global font attributes.
+ function makeTopDict(attrs, strings) {
+ var t = new table.Record('Top DICT', [
+ {name: 'dict', type: 'DICT', value: {}}
+ ]);
+ t.dict = makeDict(TOP_DICT_META, attrs, strings);
+ return t;
+ }
-/**
- * A GlyphSet represents all glyphs available in the font, but modelled using
- * a deferred glyph loader, for retrieving glyphs only once they are absolutely
- * necessary, to keep the memory footprint down.
- * @exports opentype.GlyphSet
- * @class
- * @param {opentype.Font}
- * @param {Array}
- */
-function GlyphSet(font, glyphs) {
- this.font = font;
- this.glyphs = {};
- if (Array.isArray(glyphs)) {
- for (var i = 0; i < glyphs.length; i++) {
- this.glyphs[i] = glyphs[i];
- }
- }
+ function makeTopDictIndex(topDict) {
+ var t = new table.Record('Top DICT INDEX', [
+ {name: 'topDicts', type: 'INDEX', value: []}
+ ]);
+ t.topDicts = [{name: 'topDict_0', type: 'TABLE', value: topDict}];
+ return t;
+ }
- this.length = (glyphs && glyphs.length) || 0;
-}
+ function makeStringIndex(strings) {
+ var t = new table.Record('String INDEX', [
+ {name: 'strings', type: 'INDEX', value: []}
+ ]);
+ t.strings = [];
+ for (var i = 0; i < strings.length; i += 1) {
+ t.strings.push({name: 'string_' + i, type: 'STRING', value: strings[i]});
+ }
-/**
- * @param {number} index
- * @return {opentype.Glyph}
- */
-GlyphSet.prototype.get = function(index) {
- if (typeof this.glyphs[index] === 'function') {
- this.glyphs[index] = this.glyphs[index]();
- }
+ return t;
+ }
- return this.glyphs[index];
-};
+ function makeGlobalSubrIndex() {
+ // Currently we don't use subroutines.
+ return new table.Record('Global Subr INDEX', [
+ {name: 'subrs', type: 'INDEX', value: []}
+ ]);
+ }
-/**
- * @param {number} index
- * @param {Object}
- */
-GlyphSet.prototype.push = function(index, loader) {
- this.glyphs[index] = loader;
- this.length++;
-};
+ function makeCharsets(glyphNames, strings) {
+ var t = new table.Record('Charsets', [
+ {name: 'format', type: 'Card8', value: 0}
+ ]);
+ for (var i = 0; i < glyphNames.length; i += 1) {
+ var glyphName = glyphNames[i];
+ var glyphSID = encodeString(glyphName, strings);
+ t.fields.push({name: 'glyph_' + i, type: 'SID', value: glyphSID});
+ }
+
+ return t;
+ }
-/**
- * @alias opentype.glyphLoader
- * @param {opentype.Font} font
- * @param {number} index
- * @return {opentype.Glyph}
- */
-function glyphLoader(font, index) {
- return new _glyph.Glyph({index: index, font: font});
-}
+ function glyphToOps(glyph) {
+ var ops = [];
+ var path = glyph.path;
+ ops.push({name: 'width', type: 'NUMBER', value: glyph.advanceWidth});
+ var x = 0;
+ var y = 0;
+ for (var i = 0; i < path.commands.length; i += 1) {
+ var dx = (void 0);
+ var dy = (void 0);
+ var cmd = path.commands[i];
+ if (cmd.type === 'Q') {
+ // CFF only supports bézier curves, so convert the quad to a bézier.
+ var _13 = 1 / 3;
+ var _23 = 2 / 3;
+
+ // We're going to create a new command so we don't change the original path.
+ cmd = {
+ type: 'C',
+ x: cmd.x,
+ y: cmd.y,
+ x1: _13 * x + _23 * cmd.x1,
+ y1: _13 * y + _23 * cmd.y1,
+ x2: _13 * cmd.x + _23 * cmd.x1,
+ y2: _13 * cmd.y + _23 * cmd.y1
+ };
+ }
+
+ if (cmd.type === 'M') {
+ dx = Math.round(cmd.x - x);
+ dy = Math.round(cmd.y - y);
+ ops.push({name: 'dx', type: 'NUMBER', value: dx});
+ ops.push({name: 'dy', type: 'NUMBER', value: dy});
+ ops.push({name: 'rmoveto', type: 'OP', value: 21});
+ x = Math.round(cmd.x);
+ y = Math.round(cmd.y);
+ } else if (cmd.type === 'L') {
+ dx = Math.round(cmd.x - x);
+ dy = Math.round(cmd.y - y);
+ ops.push({name: 'dx', type: 'NUMBER', value: dx});
+ ops.push({name: 'dy', type: 'NUMBER', value: dy});
+ ops.push({name: 'rlineto', type: 'OP', value: 5});
+ x = Math.round(cmd.x);
+ y = Math.round(cmd.y);
+ } else if (cmd.type === 'C') {
+ var dx1 = Math.round(cmd.x1 - x);
+ var dy1 = Math.round(cmd.y1 - y);
+ var dx2 = Math.round(cmd.x2 - cmd.x1);
+ var dy2 = Math.round(cmd.y2 - cmd.y1);
+ dx = Math.round(cmd.x - cmd.x2);
+ dy = Math.round(cmd.y - cmd.y2);
+ ops.push({name: 'dx1', type: 'NUMBER', value: dx1});
+ ops.push({name: 'dy1', type: 'NUMBER', value: dy1});
+ ops.push({name: 'dx2', type: 'NUMBER', value: dx2});
+ ops.push({name: 'dy2', type: 'NUMBER', value: dy2});
+ ops.push({name: 'dx', type: 'NUMBER', value: dx});
+ ops.push({name: 'dy', type: 'NUMBER', value: dy});
+ ops.push({name: 'rrcurveto', type: 'OP', value: 8});
+ x = Math.round(cmd.x);
+ y = Math.round(cmd.y);
+ }
+
+ // Contours are closed automatically.
+ }
+
+ ops.push({name: 'endchar', type: 'OP', value: 14});
+ return ops;
+ }
-/**
- * Generate a stub glyph that can be filled with all metadata *except*
- * the "points" and "path" properties, which must be loaded only once
- * the glyph's path is actually requested for text shaping.
- * @alias opentype.ttfGlyphLoader
- * @param {opentype.Font} font
- * @param {number} index
- * @param {Function} parseGlyph
- * @param {Object} data
- * @param {number} position
- * @param {Function} buildPath
- * @return {opentype.Glyph}
- */
-function ttfGlyphLoader(font, index, parseGlyph, data, position, buildPath) {
- return function() {
- var glyph = new _glyph.Glyph({index: index, font: font});
+ function makeCharStringsIndex(glyphs) {
+ var t = new table.Record('CharStrings INDEX', [
+ {name: 'charStrings', type: 'INDEX', value: []}
+ ]);
- glyph.path = function() {
- parseGlyph(glyph, data, position);
- var path = buildPath(font.glyphs, glyph);
- path.unitsPerEm = font.unitsPerEm;
- return path;
- };
+ for (var i = 0; i < glyphs.length; i += 1) {
+ var glyph = glyphs.get(i);
+ var ops = glyphToOps(glyph);
+ t.charStrings.push({name: glyph.name, type: 'CHARSTRING', value: ops});
+ }
- defineDependentProperty(glyph, 'xMin', '_xMin');
- defineDependentProperty(glyph, 'xMax', '_xMax');
- defineDependentProperty(glyph, 'yMin', '_yMin');
- defineDependentProperty(glyph, 'yMax', '_yMax');
+ return t;
+ }
- return glyph;
- };
-}
-/**
- * @alias opentype.cffGlyphLoader
- * @param {opentype.Font} font
- * @param {number} index
- * @param {Function} parseCFFCharstring
- * @param {string} charstring
- * @return {opentype.Glyph}
- */
-function cffGlyphLoader(font, index, parseCFFCharstring, charstring) {
- return function() {
- var glyph = new _glyph.Glyph({index: index, font: font});
+ function makePrivateDict(attrs, strings) {
+ var t = new table.Record('Private DICT', [
+ {name: 'dict', type: 'DICT', value: {}}
+ ]);
+ t.dict = makeDict(PRIVATE_DICT_META, attrs, strings);
+ return t;
+ }
- glyph.path = function() {
- var path = parseCFFCharstring(font, glyph, charstring);
- path.unitsPerEm = font.unitsPerEm;
- return path;
- };
+ function makeCFFTable(glyphs, options) {
+ var t = new table.Table('CFF ', [
+ {name: 'header', type: 'RECORD'},
+ {name: 'nameIndex', type: 'RECORD'},
+ {name: 'topDictIndex', type: 'RECORD'},
+ {name: 'stringIndex', type: 'RECORD'},
+ {name: 'globalSubrIndex', type: 'RECORD'},
+ {name: 'charsets', type: 'RECORD'},
+ {name: 'charStringsIndex', type: 'RECORD'},
+ {name: 'privateDict', type: 'RECORD'}
+ ]);
+
+ var fontScale = 1 / options.unitsPerEm;
+ // We use non-zero values for the offsets so that the DICT encodes them.
+ // This is important because the size of the Top DICT plays a role in offset calculation,
+ // and the size shouldn't change after we've written correct offsets.
+ var attrs = {
+ version: options.version,
+ fullName: options.fullName,
+ familyName: options.familyName,
+ weight: options.weightName,
+ fontBBox: options.fontBBox || [0, 0, 0, 0],
+ fontMatrix: [fontScale, 0, 0, fontScale, 0, 0],
+ charset: 999,
+ encoding: 0,
+ charStrings: 999,
+ private: [0, 999]
+ };
+
+ var privateAttrs = {};
+
+ var glyphNames = [];
+ var glyph;
+
+ // Skip first glyph (.notdef)
+ for (var i = 1; i < glyphs.length; i += 1) {
+ glyph = glyphs.get(i);
+ glyphNames.push(glyph.name);
+ }
+
+ var strings = [];
+
+ t.header = makeHeader();
+ t.nameIndex = makeNameIndex([options.postScriptName]);
+ var topDict = makeTopDict(attrs, strings);
+ t.topDictIndex = makeTopDictIndex(topDict);
+ t.globalSubrIndex = makeGlobalSubrIndex();
+ t.charsets = makeCharsets(glyphNames, strings);
+ t.charStringsIndex = makeCharStringsIndex(glyphs);
+ t.privateDict = makePrivateDict(privateAttrs, strings);
+
+ // Needs to come at the end, to encode all custom strings used in the font.
+ t.stringIndex = makeStringIndex(strings);
+
+ var startOffset = t.header.sizeOf() +
+ t.nameIndex.sizeOf() +
+ t.topDictIndex.sizeOf() +
+ t.stringIndex.sizeOf() +
+ t.globalSubrIndex.sizeOf();
+ attrs.charset = startOffset;
+
+ // We use the CFF standard encoding; proper encoding will be handled in cmap.
+ attrs.encoding = 0;
+ attrs.charStrings = attrs.charset + t.charsets.sizeOf();
+ attrs.private[1] = attrs.charStrings + t.charStringsIndex.sizeOf();
+
+ // Recreate the Top DICT INDEX with the correct offsets.
+ topDict = makeTopDict(attrs, strings);
+ t.topDictIndex = makeTopDictIndex(topDict);
+
+ return t;
+ }
- return glyph;
- };
-}
+ var cff = { parse: parseCFFTable, make: makeCFFTable };
+
+ // The `head` table contains global information about the font.
+
+ // Parse the header `head` table
+ function parseHeadTable(data, start) {
+ var head = {};
+ var p = new parse.Parser(data, start);
+ head.version = p.parseVersion();
+ head.fontRevision = Math.round(p.parseFixed() * 1000) / 1000;
+ head.checkSumAdjustment = p.parseULong();
+ head.magicNumber = p.parseULong();
+ check.argument(head.magicNumber === 0x5F0F3CF5, 'Font header has wrong magic number.');
+ head.flags = p.parseUShort();
+ head.unitsPerEm = p.parseUShort();
+ head.created = p.parseLongDateTime();
+ head.modified = p.parseLongDateTime();
+ head.xMin = p.parseShort();
+ head.yMin = p.parseShort();
+ head.xMax = p.parseShort();
+ head.yMax = p.parseShort();
+ head.macStyle = p.parseUShort();
+ head.lowestRecPPEM = p.parseUShort();
+ head.fontDirectionHint = p.parseShort();
+ head.indexToLocFormat = p.parseShort();
+ head.glyphDataFormat = p.parseShort();
+ return head;
+ }
-exports.GlyphSet = GlyphSet;
-exports.glyphLoader = glyphLoader;
-exports.ttfGlyphLoader = ttfGlyphLoader;
-exports.cffGlyphLoader = cffGlyphLoader;
-
-},{"./glyph":14}],16:[function(_dereq_,module,exports){
-/* A TrueType font hinting interpreter.
-*
-* (c) 2017 Axel Kittenberger
-*
-* This interpreter has been implemented according to this documentation:
-* https://developer.apple.com/fonts/TrueType-Reference-Manual/RM05/Chap5.html
-*
-* According to the documentation F24DOT6 values are used for pixels.
-* That means calculation is 1/64 pixel accurate and uses integer operations.
-* However, Javascript has floating point operations by default and only
-* those are available. One could make a case to simulate the 1/64 accuracy
-* exactly by truncating after every division operation
-* (for example with << 0) to get pixel exacty results as other TrueType
-* implementations. It may make sense since some fonts are pixel optimized
-* by hand using DELTAP instructions. The current implementation doesn't
-* and rather uses full floating point precission.
-*
-* xScale, yScale and rotation is currently ignored.
-*
-* A few non-trivial instructions are missing as I didn't encounter yet
-* a font that used them to test a possible implementation.
-*
-* Some fonts seem to use undocumented features regarding the twilight zone.
-* Only some of them are implemented as they were encountered.
-*
-* The DEBUG statements can be removed, manually or for example with "uglify"
-* fixing DEBUG to false.
-*/
-'use strict';
+ function makeHeadTable(options) {
+ // Apple Mac timestamp epoch is 01/01/1904 not 01/01/1970
+ var timestamp = Math.round(new Date().getTime() / 1000) + 2082844800;
+ var createdTimestamp = timestamp;
+
+ if (options.createdTimestamp) {
+ createdTimestamp = options.createdTimestamp + 2082844800;
+ }
+
+ return new table.Table('head', [
+ {name: 'version', type: 'FIXED', value: 0x00010000},
+ {name: 'fontRevision', type: 'FIXED', value: 0x00010000},
+ {name: 'checkSumAdjustment', type: 'ULONG', value: 0},
+ {name: 'magicNumber', type: 'ULONG', value: 0x5F0F3CF5},
+ {name: 'flags', type: 'USHORT', value: 0},
+ {name: 'unitsPerEm', type: 'USHORT', value: 1000},
+ {name: 'created', type: 'LONGDATETIME', value: createdTimestamp},
+ {name: 'modified', type: 'LONGDATETIME', value: timestamp},
+ {name: 'xMin', type: 'SHORT', value: 0},
+ {name: 'yMin', type: 'SHORT', value: 0},
+ {name: 'xMax', type: 'SHORT', value: 0},
+ {name: 'yMax', type: 'SHORT', value: 0},
+ {name: 'macStyle', type: 'USHORT', value: 0},
+ {name: 'lowestRecPPEM', type: 'USHORT', value: 0},
+ {name: 'fontDirectionHint', type: 'SHORT', value: 2},
+ {name: 'indexToLocFormat', type: 'SHORT', value: 0},
+ {name: 'glyphDataFormat', type: 'SHORT', value: 0}
+ ], options);
+ }
-var DEBUG = false;
+ var head = { parse: parseHeadTable, make: makeHeadTable };
+
+ // The `hhea` table contains information for horizontal layout.
+
+ // Parse the horizontal header `hhea` table
+ function parseHheaTable(data, start) {
+ var hhea = {};
+ var p = new parse.Parser(data, start);
+ hhea.version = p.parseVersion();
+ hhea.ascender = p.parseShort();
+ hhea.descender = p.parseShort();
+ hhea.lineGap = p.parseShort();
+ hhea.advanceWidthMax = p.parseUShort();
+ hhea.minLeftSideBearing = p.parseShort();
+ hhea.minRightSideBearing = p.parseShort();
+ hhea.xMaxExtent = p.parseShort();
+ hhea.caretSlopeRise = p.parseShort();
+ hhea.caretSlopeRun = p.parseShort();
+ hhea.caretOffset = p.parseShort();
+ p.relativeOffset += 8;
+ hhea.metricDataFormat = p.parseShort();
+ hhea.numberOfHMetrics = p.parseUShort();
+ return hhea;
+ }
-var instructionTable;
-var exec;
-var execComponent;
-var execGlyph;
+ function makeHheaTable(options) {
+ return new table.Table('hhea', [
+ {name: 'version', type: 'FIXED', value: 0x00010000},
+ {name: 'ascender', type: 'FWORD', value: 0},
+ {name: 'descender', type: 'FWORD', value: 0},
+ {name: 'lineGap', type: 'FWORD', value: 0},
+ {name: 'advanceWidthMax', type: 'UFWORD', value: 0},
+ {name: 'minLeftSideBearing', type: 'FWORD', value: 0},
+ {name: 'minRightSideBearing', type: 'FWORD', value: 0},
+ {name: 'xMaxExtent', type: 'FWORD', value: 0},
+ {name: 'caretSlopeRise', type: 'SHORT', value: 1},
+ {name: 'caretSlopeRun', type: 'SHORT', value: 0},
+ {name: 'caretOffset', type: 'SHORT', value: 0},
+ {name: 'reserved1', type: 'SHORT', value: 0},
+ {name: 'reserved2', type: 'SHORT', value: 0},
+ {name: 'reserved3', type: 'SHORT', value: 0},
+ {name: 'reserved4', type: 'SHORT', value: 0},
+ {name: 'metricDataFormat', type: 'SHORT', value: 0},
+ {name: 'numberOfHMetrics', type: 'USHORT', value: 0}
+ ], options);
+ }
-/*
-* Creates a hinting object.
-*
-* There ought to be exactly one
-* for each truetype font that is used for hinting.
-*/
-function Hinting(font) {
- // the font this hinting object is for
- this.font = font;
-
- // cached states
- this._fpgmState =
- this._prepState =
- undefined;
-
- // errorState
- // 0 ... all okay
- // 1 ... had an error in a glyf,
- // continue working but stop spamming
- // the console
- // 2 ... error at prep, stop hinting at this ppem
- // 3 ... error at fpeg, stop hinting for this font at all
- this._errorState = 0;
-}
+ var hhea = { parse: parseHheaTable, make: makeHheaTable };
+
+ // The `hmtx` table contains the horizontal metrics for all glyphs.
+
+ // Parse the `hmtx` table, which contains the horizontal metrics for all glyphs.
+ // This function augments the glyph array, adding the advanceWidth and leftSideBearing to each glyph.
+ function parseHmtxTable(data, start, numMetrics, numGlyphs, glyphs) {
+ var advanceWidth;
+ var leftSideBearing;
+ var p = new parse.Parser(data, start);
+ for (var i = 0; i < numGlyphs; i += 1) {
+ // If the font is monospaced, only one entry is needed. This last entry applies to all subsequent glyphs.
+ if (i < numMetrics) {
+ advanceWidth = p.parseUShort();
+ leftSideBearing = p.parseShort();
+ }
+
+ var glyph = glyphs.get(i);
+ glyph.advanceWidth = advanceWidth;
+ glyph.leftSideBearing = leftSideBearing;
+ }
+ }
-/*
-* Not rounding.
-*/
-function roundOff(v) {
- return v;
-}
+ function makeHmtxTable(glyphs) {
+ var t = new table.Table('hmtx', []);
+ for (var i = 0; i < glyphs.length; i += 1) {
+ var glyph = glyphs.get(i);
+ var advanceWidth = glyph.advanceWidth || 0;
+ var leftSideBearing = glyph.leftSideBearing || 0;
+ t.fields.push({name: 'advanceWidth_' + i, type: 'USHORT', value: advanceWidth});
+ t.fields.push({name: 'leftSideBearing_' + i, type: 'SHORT', value: leftSideBearing});
+ }
+
+ return t;
+ }
-/*
-* Rounding to grid.
-*/
-function roundToGrid(v) {
- //Rounding in TT is supposed to "symmetrical around zero"
- return Math.sign(v) * Math.round(Math.abs(v));
-}
+ var hmtx = { parse: parseHmtxTable, make: makeHmtxTable };
-/*
-* Rounding to double grid.
-*/
-function roundToDoubleGrid(v) {
- return Math.sign(v) * Math.round(Math.abs(v * 2)) / 2;
-}
+ // The `ltag` table stores IETF BCP-47 language tags. It allows supporting
-/*
-* Rounding to half grid.
-*/
-function roundToHalfGrid(v) {
- return Math.sign(v) * (Math.round(Math.abs(v) + 0.5) - 0.5);
-}
+ function makeLtagTable(tags) {
+ var result = new table.Table('ltag', [
+ {name: 'version', type: 'ULONG', value: 1},
+ {name: 'flags', type: 'ULONG', value: 0},
+ {name: 'numTags', type: 'ULONG', value: tags.length}
+ ]);
-/*
-* Rounding to up to grid.
-*/
-function roundUpToGrid(v) {
- return Math.sign(v) * Math.ceil(Math.abs(v));
-}
+ var stringPool = '';
+ var stringPoolOffset = 12 + tags.length * 4;
+ for (var i = 0; i < tags.length; ++i) {
+ var pos = stringPool.indexOf(tags[i]);
+ if (pos < 0) {
+ pos = stringPool.length;
+ stringPool += tags[i];
+ }
-/*
-* Rounding to down to grid.
-*/
-function roundDownToGrid(v) {
- return Math.sign(v) * Math.floor(Math.abs(v));
-}
+ result.fields.push({name: 'offset ' + i, type: 'USHORT', value: stringPoolOffset + pos});
+ result.fields.push({name: 'length ' + i, type: 'USHORT', value: tags[i].length});
+ }
-/*
-* Super rounding.
-*/
-var roundSuper = function(v) {
- var period = this.srPeriod;
- var phase = this.srPhase;
- var threshold = this.srThreshold;
- var sign = 1;
-
- if (v < 0) {
- v = -v;
- sign = -1;
- }
+ result.fields.push({name: 'stringPool', type: 'CHARARRAY', value: stringPool});
+ return result;
+ }
- v += threshold - phase;
+ function parseLtagTable(data, start) {
+ var p = new parse.Parser(data, start);
+ var tableVersion = p.parseULong();
+ check.argument(tableVersion === 1, 'Unsupported ltag table version.');
+ // The 'ltag' specification does not define any flags; skip the field.
+ p.skip('uLong', 1);
+ var numTags = p.parseULong();
+
+ var tags = [];
+ for (var i = 0; i < numTags; i++) {
+ var tag = '';
+ var offset = start + p.parseUShort();
+ var length = p.parseUShort();
+ for (var j = offset; j < offset + length; ++j) {
+ tag += String.fromCharCode(data.getInt8(j));
+ }
+
+ tags.push(tag);
+ }
+
+ return tags;
+ }
- v = Math.trunc(v / period) * period;
+ var ltag = { make: makeLtagTable, parse: parseLtagTable };
+
+ // The `maxp` table establishes the memory requirements for the font.
+
+ // Parse the maximum profile `maxp` table.
+ function parseMaxpTable(data, start) {
+ var maxp = {};
+ var p = new parse.Parser(data, start);
+ maxp.version = p.parseVersion();
+ maxp.numGlyphs = p.parseUShort();
+ if (maxp.version === 1.0) {
+ maxp.maxPoints = p.parseUShort();
+ maxp.maxContours = p.parseUShort();
+ maxp.maxCompositePoints = p.parseUShort();
+ maxp.maxCompositeContours = p.parseUShort();
+ maxp.maxZones = p.parseUShort();
+ maxp.maxTwilightPoints = p.parseUShort();
+ maxp.maxStorage = p.parseUShort();
+ maxp.maxFunctionDefs = p.parseUShort();
+ maxp.maxInstructionDefs = p.parseUShort();
+ maxp.maxStackElements = p.parseUShort();
+ maxp.maxSizeOfInstructions = p.parseUShort();
+ maxp.maxComponentElements = p.parseUShort();
+ maxp.maxComponentDepth = p.parseUShort();
+ }
+
+ return maxp;
+ }
- v += phase;
+ function makeMaxpTable(numGlyphs) {
+ return new table.Table('maxp', [
+ {name: 'version', type: 'FIXED', value: 0x00005000},
+ {name: 'numGlyphs', type: 'USHORT', value: numGlyphs}
+ ]);
+ }
- // according to http://xgridfit.sourceforge.net/round.html
- if (sign > 0 && v < 0) return phase;
- if (sign < 0 && v > 0) return -phase;
+ var maxp = { parse: parseMaxpTable, make: makeMaxpTable };
+
+ // The `name` naming table.
+
+ // NameIDs for the name table.
+ var nameTableNames = [
+ 'copyright', // 0
+ 'fontFamily', // 1
+ 'fontSubfamily', // 2
+ 'uniqueID', // 3
+ 'fullName', // 4
+ 'version', // 5
+ 'postScriptName', // 6
+ 'trademark', // 7
+ 'manufacturer', // 8
+ 'designer', // 9
+ 'description', // 10
+ 'manufacturerURL', // 11
+ 'designerURL', // 12
+ 'license', // 13
+ 'licenseURL', // 14
+ 'reserved', // 15
+ 'preferredFamily', // 16
+ 'preferredSubfamily', // 17
+ 'compatibleFullName', // 18
+ 'sampleText', // 19
+ 'postScriptFindFontName', // 20
+ 'wwsFamily', // 21
+ 'wwsSubfamily' // 22
+ ];
+
+ var macLanguages = {
+ 0: 'en',
+ 1: 'fr',
+ 2: 'de',
+ 3: 'it',
+ 4: 'nl',
+ 5: 'sv',
+ 6: 'es',
+ 7: 'da',
+ 8: 'pt',
+ 9: 'no',
+ 10: 'he',
+ 11: 'ja',
+ 12: 'ar',
+ 13: 'fi',
+ 14: 'el',
+ 15: 'is',
+ 16: 'mt',
+ 17: 'tr',
+ 18: 'hr',
+ 19: 'zh-Hant',
+ 20: 'ur',
+ 21: 'hi',
+ 22: 'th',
+ 23: 'ko',
+ 24: 'lt',
+ 25: 'pl',
+ 26: 'hu',
+ 27: 'es',
+ 28: 'lv',
+ 29: 'se',
+ 30: 'fo',
+ 31: 'fa',
+ 32: 'ru',
+ 33: 'zh',
+ 34: 'nl-BE',
+ 35: 'ga',
+ 36: 'sq',
+ 37: 'ro',
+ 38: 'cz',
+ 39: 'sk',
+ 40: 'si',
+ 41: 'yi',
+ 42: 'sr',
+ 43: 'mk',
+ 44: 'bg',
+ 45: 'uk',
+ 46: 'be',
+ 47: 'uz',
+ 48: 'kk',
+ 49: 'az-Cyrl',
+ 50: 'az-Arab',
+ 51: 'hy',
+ 52: 'ka',
+ 53: 'mo',
+ 54: 'ky',
+ 55: 'tg',
+ 56: 'tk',
+ 57: 'mn-CN',
+ 58: 'mn',
+ 59: 'ps',
+ 60: 'ks',
+ 61: 'ku',
+ 62: 'sd',
+ 63: 'bo',
+ 64: 'ne',
+ 65: 'sa',
+ 66: 'mr',
+ 67: 'bn',
+ 68: 'as',
+ 69: 'gu',
+ 70: 'pa',
+ 71: 'or',
+ 72: 'ml',
+ 73: 'kn',
+ 74: 'ta',
+ 75: 'te',
+ 76: 'si',
+ 77: 'my',
+ 78: 'km',
+ 79: 'lo',
+ 80: 'vi',
+ 81: 'id',
+ 82: 'tl',
+ 83: 'ms',
+ 84: 'ms-Arab',
+ 85: 'am',
+ 86: 'ti',
+ 87: 'om',
+ 88: 'so',
+ 89: 'sw',
+ 90: 'rw',
+ 91: 'rn',
+ 92: 'ny',
+ 93: 'mg',
+ 94: 'eo',
+ 128: 'cy',
+ 129: 'eu',
+ 130: 'ca',
+ 131: 'la',
+ 132: 'qu',
+ 133: 'gn',
+ 134: 'ay',
+ 135: 'tt',
+ 136: 'ug',
+ 137: 'dz',
+ 138: 'jv',
+ 139: 'su',
+ 140: 'gl',
+ 141: 'af',
+ 142: 'br',
+ 143: 'iu',
+ 144: 'gd',
+ 145: 'gv',
+ 146: 'ga',
+ 147: 'to',
+ 148: 'el-polyton',
+ 149: 'kl',
+ 150: 'az',
+ 151: 'nn'
+ };
+
+ // MacOS language ID → MacOS script ID
+ //
+ // Note that the script ID is not sufficient to determine what encoding
+ // to use in TrueType files. For some languages, MacOS used a modification
+ // of a mainstream script. For example, an Icelandic name would be stored
+ // with smRoman in the TrueType naming table, but the actual encoding
+ // is a special Icelandic version of the normal Macintosh Roman encoding.
+ // As another example, Inuktitut uses an 8-bit encoding for Canadian Aboriginal
+ // Syllables but MacOS had run out of available script codes, so this was
+ // done as a (pretty radical) "modification" of Ethiopic.
+ //
+ // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/Readme.txt
+ var macLanguageToScript = {
+ 0: 0, // langEnglish → smRoman
+ 1: 0, // langFrench → smRoman
+ 2: 0, // langGerman → smRoman
+ 3: 0, // langItalian → smRoman
+ 4: 0, // langDutch → smRoman
+ 5: 0, // langSwedish → smRoman
+ 6: 0, // langSpanish → smRoman
+ 7: 0, // langDanish → smRoman
+ 8: 0, // langPortuguese → smRoman
+ 9: 0, // langNorwegian → smRoman
+ 10: 5, // langHebrew → smHebrew
+ 11: 1, // langJapanese → smJapanese
+ 12: 4, // langArabic → smArabic
+ 13: 0, // langFinnish → smRoman
+ 14: 6, // langGreek → smGreek
+ 15: 0, // langIcelandic → smRoman (modified)
+ 16: 0, // langMaltese → smRoman
+ 17: 0, // langTurkish → smRoman (modified)
+ 18: 0, // langCroatian → smRoman (modified)
+ 19: 2, // langTradChinese → smTradChinese
+ 20: 4, // langUrdu → smArabic
+ 21: 9, // langHindi → smDevanagari
+ 22: 21, // langThai → smThai
+ 23: 3, // langKorean → smKorean
+ 24: 29, // langLithuanian → smCentralEuroRoman
+ 25: 29, // langPolish → smCentralEuroRoman
+ 26: 29, // langHungarian → smCentralEuroRoman
+ 27: 29, // langEstonian → smCentralEuroRoman
+ 28: 29, // langLatvian → smCentralEuroRoman
+ 29: 0, // langSami → smRoman
+ 30: 0, // langFaroese → smRoman (modified)
+ 31: 4, // langFarsi → smArabic (modified)
+ 32: 7, // langRussian → smCyrillic
+ 33: 25, // langSimpChinese → smSimpChinese
+ 34: 0, // langFlemish → smRoman
+ 35: 0, // langIrishGaelic → smRoman (modified)
+ 36: 0, // langAlbanian → smRoman
+ 37: 0, // langRomanian → smRoman (modified)
+ 38: 29, // langCzech → smCentralEuroRoman
+ 39: 29, // langSlovak → smCentralEuroRoman
+ 40: 0, // langSlovenian → smRoman (modified)
+ 41: 5, // langYiddish → smHebrew
+ 42: 7, // langSerbian → smCyrillic
+ 43: 7, // langMacedonian → smCyrillic
+ 44: 7, // langBulgarian → smCyrillic
+ 45: 7, // langUkrainian → smCyrillic (modified)
+ 46: 7, // langByelorussian → smCyrillic
+ 47: 7, // langUzbek → smCyrillic
+ 48: 7, // langKazakh → smCyrillic
+ 49: 7, // langAzerbaijani → smCyrillic
+ 50: 4, // langAzerbaijanAr → smArabic
+ 51: 24, // langArmenian → smArmenian
+ 52: 23, // langGeorgian → smGeorgian
+ 53: 7, // langMoldavian → smCyrillic
+ 54: 7, // langKirghiz → smCyrillic
+ 55: 7, // langTajiki → smCyrillic
+ 56: 7, // langTurkmen → smCyrillic
+ 57: 27, // langMongolian → smMongolian
+ 58: 7, // langMongolianCyr → smCyrillic
+ 59: 4, // langPashto → smArabic
+ 60: 4, // langKurdish → smArabic
+ 61: 4, // langKashmiri → smArabic
+ 62: 4, // langSindhi → smArabic
+ 63: 26, // langTibetan → smTibetan
+ 64: 9, // langNepali → smDevanagari
+ 65: 9, // langSanskrit → smDevanagari
+ 66: 9, // langMarathi → smDevanagari
+ 67: 13, // langBengali → smBengali
+ 68: 13, // langAssamese → smBengali
+ 69: 11, // langGujarati → smGujarati
+ 70: 10, // langPunjabi → smGurmukhi
+ 71: 12, // langOriya → smOriya
+ 72: 17, // langMalayalam → smMalayalam
+ 73: 16, // langKannada → smKannada
+ 74: 14, // langTamil → smTamil
+ 75: 15, // langTelugu → smTelugu
+ 76: 18, // langSinhalese → smSinhalese
+ 77: 19, // langBurmese → smBurmese
+ 78: 20, // langKhmer → smKhmer
+ 79: 22, // langLao → smLao
+ 80: 30, // langVietnamese → smVietnamese
+ 81: 0, // langIndonesian → smRoman
+ 82: 0, // langTagalog → smRoman
+ 83: 0, // langMalayRoman → smRoman
+ 84: 4, // langMalayArabic → smArabic
+ 85: 28, // langAmharic → smEthiopic
+ 86: 28, // langTigrinya → smEthiopic
+ 87: 28, // langOromo → smEthiopic
+ 88: 0, // langSomali → smRoman
+ 89: 0, // langSwahili → smRoman
+ 90: 0, // langKinyarwanda → smRoman
+ 91: 0, // langRundi → smRoman
+ 92: 0, // langNyanja → smRoman
+ 93: 0, // langMalagasy → smRoman
+ 94: 0, // langEsperanto → smRoman
+ 128: 0, // langWelsh → smRoman (modified)
+ 129: 0, // langBasque → smRoman
+ 130: 0, // langCatalan → smRoman
+ 131: 0, // langLatin → smRoman
+ 132: 0, // langQuechua → smRoman
+ 133: 0, // langGuarani → smRoman
+ 134: 0, // langAymara → smRoman
+ 135: 7, // langTatar → smCyrillic
+ 136: 4, // langUighur → smArabic
+ 137: 26, // langDzongkha → smTibetan
+ 138: 0, // langJavaneseRom → smRoman
+ 139: 0, // langSundaneseRom → smRoman
+ 140: 0, // langGalician → smRoman
+ 141: 0, // langAfrikaans → smRoman
+ 142: 0, // langBreton → smRoman (modified)
+ 143: 28, // langInuktitut → smEthiopic (modified)
+ 144: 0, // langScottishGaelic → smRoman (modified)
+ 145: 0, // langManxGaelic → smRoman (modified)
+ 146: 0, // langIrishGaelicScript → smRoman (modified)
+ 147: 0, // langTongan → smRoman
+ 148: 6, // langGreekAncient → smRoman
+ 149: 0, // langGreenlandic → smRoman
+ 150: 0, // langAzerbaijanRoman → smRoman
+ 151: 0 // langNynorsk → smRoman
+ };
+
+ // While Microsoft indicates a region/country for all its language
+ // IDs, we omit the region code if it's equal to the "most likely
+ // region subtag" according to Unicode CLDR. For scripts, we omit
+ // the subtag if it is equal to the Suppress-Script entry in the
+ // IANA language subtag registry for IETF BCP 47.
+ //
+ // For example, Microsoft states that its language code 0x041A is
+ // Croatian in Croatia. We transform this to the BCP 47 language code 'hr'
+ // and not 'hr-HR' because Croatia is the default country for Croatian,
+ // according to Unicode CLDR. As another example, Microsoft states
+ // that 0x101A is Croatian (Latin) in Bosnia-Herzegovina. We transform
+ // this to 'hr-BA' and not 'hr-Latn-BA' because Latin is the default script
+ // for the Croatian language, according to IANA.
+ //
+ // http://www.unicode.org/cldr/charts/latest/supplemental/likely_subtags.html
+ // http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
+ var windowsLanguages = {
+ 0x0436: 'af',
+ 0x041C: 'sq',
+ 0x0484: 'gsw',
+ 0x045E: 'am',
+ 0x1401: 'ar-DZ',
+ 0x3C01: 'ar-BH',
+ 0x0C01: 'ar',
+ 0x0801: 'ar-IQ',
+ 0x2C01: 'ar-JO',
+ 0x3401: 'ar-KW',
+ 0x3001: 'ar-LB',
+ 0x1001: 'ar-LY',
+ 0x1801: 'ary',
+ 0x2001: 'ar-OM',
+ 0x4001: 'ar-QA',
+ 0x0401: 'ar-SA',
+ 0x2801: 'ar-SY',
+ 0x1C01: 'aeb',
+ 0x3801: 'ar-AE',
+ 0x2401: 'ar-YE',
+ 0x042B: 'hy',
+ 0x044D: 'as',
+ 0x082C: 'az-Cyrl',
+ 0x042C: 'az',
+ 0x046D: 'ba',
+ 0x042D: 'eu',
+ 0x0423: 'be',
+ 0x0845: 'bn',
+ 0x0445: 'bn-IN',
+ 0x201A: 'bs-Cyrl',
+ 0x141A: 'bs',
+ 0x047E: 'br',
+ 0x0402: 'bg',
+ 0x0403: 'ca',
+ 0x0C04: 'zh-HK',
+ 0x1404: 'zh-MO',
+ 0x0804: 'zh',
+ 0x1004: 'zh-SG',
+ 0x0404: 'zh-TW',
+ 0x0483: 'co',
+ 0x041A: 'hr',
+ 0x101A: 'hr-BA',
+ 0x0405: 'cs',
+ 0x0406: 'da',
+ 0x048C: 'prs',
+ 0x0465: 'dv',
+ 0x0813: 'nl-BE',
+ 0x0413: 'nl',
+ 0x0C09: 'en-AU',
+ 0x2809: 'en-BZ',
+ 0x1009: 'en-CA',
+ 0x2409: 'en-029',
+ 0x4009: 'en-IN',
+ 0x1809: 'en-IE',
+ 0x2009: 'en-JM',
+ 0x4409: 'en-MY',
+ 0x1409: 'en-NZ',
+ 0x3409: 'en-PH',
+ 0x4809: 'en-SG',
+ 0x1C09: 'en-ZA',
+ 0x2C09: 'en-TT',
+ 0x0809: 'en-GB',
+ 0x0409: 'en',
+ 0x3009: 'en-ZW',
+ 0x0425: 'et',
+ 0x0438: 'fo',
+ 0x0464: 'fil',
+ 0x040B: 'fi',
+ 0x080C: 'fr-BE',
+ 0x0C0C: 'fr-CA',
+ 0x040C: 'fr',
+ 0x140C: 'fr-LU',
+ 0x180C: 'fr-MC',
+ 0x100C: 'fr-CH',
+ 0x0462: 'fy',
+ 0x0456: 'gl',
+ 0x0437: 'ka',
+ 0x0C07: 'de-AT',
+ 0x0407: 'de',
+ 0x1407: 'de-LI',
+ 0x1007: 'de-LU',
+ 0x0807: 'de-CH',
+ 0x0408: 'el',
+ 0x046F: 'kl',
+ 0x0447: 'gu',
+ 0x0468: 'ha',
+ 0x040D: 'he',
+ 0x0439: 'hi',
+ 0x040E: 'hu',
+ 0x040F: 'is',
+ 0x0470: 'ig',
+ 0x0421: 'id',
+ 0x045D: 'iu',
+ 0x085D: 'iu-Latn',
+ 0x083C: 'ga',
+ 0x0434: 'xh',
+ 0x0435: 'zu',
+ 0x0410: 'it',
+ 0x0810: 'it-CH',
+ 0x0411: 'ja',
+ 0x044B: 'kn',
+ 0x043F: 'kk',
+ 0x0453: 'km',
+ 0x0486: 'quc',
+ 0x0487: 'rw',
+ 0x0441: 'sw',
+ 0x0457: 'kok',
+ 0x0412: 'ko',
+ 0x0440: 'ky',
+ 0x0454: 'lo',
+ 0x0426: 'lv',
+ 0x0427: 'lt',
+ 0x082E: 'dsb',
+ 0x046E: 'lb',
+ 0x042F: 'mk',
+ 0x083E: 'ms-BN',
+ 0x043E: 'ms',
+ 0x044C: 'ml',
+ 0x043A: 'mt',
+ 0x0481: 'mi',
+ 0x047A: 'arn',
+ 0x044E: 'mr',
+ 0x047C: 'moh',
+ 0x0450: 'mn',
+ 0x0850: 'mn-CN',
+ 0x0461: 'ne',
+ 0x0414: 'nb',
+ 0x0814: 'nn',
+ 0x0482: 'oc',
+ 0x0448: 'or',
+ 0x0463: 'ps',
+ 0x0415: 'pl',
+ 0x0416: 'pt',
+ 0x0816: 'pt-PT',
+ 0x0446: 'pa',
+ 0x046B: 'qu-BO',
+ 0x086B: 'qu-EC',
+ 0x0C6B: 'qu',
+ 0x0418: 'ro',
+ 0x0417: 'rm',
+ 0x0419: 'ru',
+ 0x243B: 'smn',
+ 0x103B: 'smj-NO',
+ 0x143B: 'smj',
+ 0x0C3B: 'se-FI',
+ 0x043B: 'se',
+ 0x083B: 'se-SE',
+ 0x203B: 'sms',
+ 0x183B: 'sma-NO',
+ 0x1C3B: 'sms',
+ 0x044F: 'sa',
+ 0x1C1A: 'sr-Cyrl-BA',
+ 0x0C1A: 'sr',
+ 0x181A: 'sr-Latn-BA',
+ 0x081A: 'sr-Latn',
+ 0x046C: 'nso',
+ 0x0432: 'tn',
+ 0x045B: 'si',
+ 0x041B: 'sk',
+ 0x0424: 'sl',
+ 0x2C0A: 'es-AR',
+ 0x400A: 'es-BO',
+ 0x340A: 'es-CL',
+ 0x240A: 'es-CO',
+ 0x140A: 'es-CR',
+ 0x1C0A: 'es-DO',
+ 0x300A: 'es-EC',
+ 0x440A: 'es-SV',
+ 0x100A: 'es-GT',
+ 0x480A: 'es-HN',
+ 0x080A: 'es-MX',
+ 0x4C0A: 'es-NI',
+ 0x180A: 'es-PA',
+ 0x3C0A: 'es-PY',
+ 0x280A: 'es-PE',
+ 0x500A: 'es-PR',
+
+ // Microsoft has defined two different language codes for
+ // “Spanish with modern sorting” and “Spanish with traditional
+ // sorting”. This makes sense for collation APIs, and it would be
+ // possible to express this in BCP 47 language tags via Unicode
+ // extensions (eg., es-u-co-trad is Spanish with traditional
+ // sorting). However, for storing names in fonts, the distinction
+ // does not make sense, so we give “es” in both cases.
+ 0x0C0A: 'es',
+ 0x040A: 'es',
+
+ 0x540A: 'es-US',
+ 0x380A: 'es-UY',
+ 0x200A: 'es-VE',
+ 0x081D: 'sv-FI',
+ 0x041D: 'sv',
+ 0x045A: 'syr',
+ 0x0428: 'tg',
+ 0x085F: 'tzm',
+ 0x0449: 'ta',
+ 0x0444: 'tt',
+ 0x044A: 'te',
+ 0x041E: 'th',
+ 0x0451: 'bo',
+ 0x041F: 'tr',
+ 0x0442: 'tk',
+ 0x0480: 'ug',
+ 0x0422: 'uk',
+ 0x042E: 'hsb',
+ 0x0420: 'ur',
+ 0x0843: 'uz-Cyrl',
+ 0x0443: 'uz',
+ 0x042A: 'vi',
+ 0x0452: 'cy',
+ 0x0488: 'wo',
+ 0x0485: 'sah',
+ 0x0478: 'ii',
+ 0x046A: 'yo'
+ };
+
+ // Returns a IETF BCP 47 language code, for example 'zh-Hant'
+ // for 'Chinese in the traditional script'.
+ function getLanguageCode(platformID, languageID, ltag) {
+ switch (platformID) {
+ case 0: // Unicode
+ if (languageID === 0xFFFF) {
+ return 'und';
+ } else if (ltag) {
+ return ltag[languageID];
+ }
+
+ break;
+
+ case 1: // Macintosh
+ return macLanguages[languageID];
+
+ case 3: // Windows
+ return windowsLanguages[languageID];
+ }
+
+ return undefined;
+ }
- return v * sign;
-};
+ var utf16 = 'utf-16';
+
+ // MacOS script ID → encoding. This table stores the default case,
+ // which can be overridden by macLanguageEncodings.
+ var macScriptEncodings = {
+ 0: 'macintosh', // smRoman
+ 1: 'x-mac-japanese', // smJapanese
+ 2: 'x-mac-chinesetrad', // smTradChinese
+ 3: 'x-mac-korean', // smKorean
+ 6: 'x-mac-greek', // smGreek
+ 7: 'x-mac-cyrillic', // smCyrillic
+ 9: 'x-mac-devanagai', // smDevanagari
+ 10: 'x-mac-gurmukhi', // smGurmukhi
+ 11: 'x-mac-gujarati', // smGujarati
+ 12: 'x-mac-oriya', // smOriya
+ 13: 'x-mac-bengali', // smBengali
+ 14: 'x-mac-tamil', // smTamil
+ 15: 'x-mac-telugu', // smTelugu
+ 16: 'x-mac-kannada', // smKannada
+ 17: 'x-mac-malayalam', // smMalayalam
+ 18: 'x-mac-sinhalese', // smSinhalese
+ 19: 'x-mac-burmese', // smBurmese
+ 20: 'x-mac-khmer', // smKhmer
+ 21: 'x-mac-thai', // smThai
+ 22: 'x-mac-lao', // smLao
+ 23: 'x-mac-georgian', // smGeorgian
+ 24: 'x-mac-armenian', // smArmenian
+ 25: 'x-mac-chinesesimp', // smSimpChinese
+ 26: 'x-mac-tibetan', // smTibetan
+ 27: 'x-mac-mongolian', // smMongolian
+ 28: 'x-mac-ethiopic', // smEthiopic
+ 29: 'x-mac-ce', // smCentralEuroRoman
+ 30: 'x-mac-vietnamese', // smVietnamese
+ 31: 'x-mac-extarabic' // smExtArabic
+ };
+
+ // MacOS language ID → encoding. This table stores the exceptional
+ // cases, which override macScriptEncodings. For writing MacOS naming
+ // tables, we need to emit a MacOS script ID. Therefore, we cannot
+ // merge macScriptEncodings into macLanguageEncodings.
+ //
+ // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/Readme.txt
+ var macLanguageEncodings = {
+ 15: 'x-mac-icelandic', // langIcelandic
+ 17: 'x-mac-turkish', // langTurkish
+ 18: 'x-mac-croatian', // langCroatian
+ 24: 'x-mac-ce', // langLithuanian
+ 25: 'x-mac-ce', // langPolish
+ 26: 'x-mac-ce', // langHungarian
+ 27: 'x-mac-ce', // langEstonian
+ 28: 'x-mac-ce', // langLatvian
+ 30: 'x-mac-icelandic', // langFaroese
+ 37: 'x-mac-romanian', // langRomanian
+ 38: 'x-mac-ce', // langCzech
+ 39: 'x-mac-ce', // langSlovak
+ 40: 'x-mac-ce', // langSlovenian
+ 143: 'x-mac-inuit', // langInuktitut
+ 146: 'x-mac-gaelic' // langIrishGaelicScript
+ };
+
+ function getEncoding(platformID, encodingID, languageID) {
+ switch (platformID) {
+ case 0: // Unicode
+ return utf16;
+
+ case 1: // Apple Macintosh
+ return macLanguageEncodings[languageID] || macScriptEncodings[encodingID];
+
+ case 3: // Microsoft Windows
+ if (encodingID === 1 || encodingID === 10) {
+ return utf16;
+ }
+
+ break;
+ }
+
+ return undefined;
+ }
-/*
-* Unit vector of x-axis.
-*/
-var xUnitVector = {
- x: 1,
+ // Parse the naming `name` table.
+ // FIXME: Format 1 additional fields are not supported yet.
+ // ltag is the content of the `ltag' table, such as ['en', 'zh-Hans', 'de-CH-1904'].
+ function parseNameTable(data, start, ltag) {
+ var name = {};
+ var p = new parse.Parser(data, start);
+ var format = p.parseUShort();
+ var count = p.parseUShort();
+ var stringOffset = p.offset + p.parseUShort();
+ for (var i = 0; i < count; i++) {
+ var platformID = p.parseUShort();
+ var encodingID = p.parseUShort();
+ var languageID = p.parseUShort();
+ var nameID = p.parseUShort();
+ var property = nameTableNames[nameID] || nameID;
+ var byteLength = p.parseUShort();
+ var offset = p.parseUShort();
+ var language = getLanguageCode(platformID, languageID, ltag);
+ var encoding = getEncoding(platformID, encodingID, languageID);
+ if (encoding !== undefined && language !== undefined) {
+ var text = (void 0);
+ if (encoding === utf16) {
+ text = decode.UTF16(data, stringOffset + offset, byteLength);
+ } else {
+ text = decode.MACSTRING(data, stringOffset + offset, byteLength, encoding);
+ }
+
+ if (text) {
+ var translations = name[property];
+ if (translations === undefined) {
+ translations = name[property] = {};
+ }
+
+ translations[language] = text;
+ }
+ }
+ }
+
+ var langTagCount = 0;
+ if (format === 1) {
+ // FIXME: Also handle Microsoft's 'name' table 1.
+ langTagCount = p.parseUShort();
+ }
+
+ return name;
+ }
- y: 0,
+ // {23: 'foo'} → {'foo': 23}
+ // ['bar', 'baz'] → {'bar': 0, 'baz': 1}
+ function reverseDict(dict) {
+ var result = {};
+ for (var key in dict) {
+ result[dict[key]] = parseInt(key);
+ }
- axis: 'x',
+ return result;
+ }
- // Gets the projected distance between two points.
- // o1/o2 ... if true, respective original position is used.
- distance: function(p1, p2, o1, o2) {
- return (o1 ? p1.xo : p1.x) - (o2 ? p2.xo : p2.x);
- },
+ function makeNameRecord(platformID, encodingID, languageID, nameID, length, offset) {
+ return new table.Record('NameRecord', [
+ {name: 'platformID', type: 'USHORT', value: platformID},
+ {name: 'encodingID', type: 'USHORT', value: encodingID},
+ {name: 'languageID', type: 'USHORT', value: languageID},
+ {name: 'nameID', type: 'USHORT', value: nameID},
+ {name: 'length', type: 'USHORT', value: length},
+ {name: 'offset', type: 'USHORT', value: offset}
+ ]);
+ }
- // Moves point p so the moved position has the same relative
- // position to the moved positions of rp1 and rp2 than the
- // original positions had.
- //
- // See APPENDIX on INTERPOLATE at the bottom of this file.
- interpolate: function(p, rp1, rp2, pv) {
- var do1;
- var do2;
- var doa1;
- var doa2;
- var dm1;
- var dm2;
- var dt;
-
- if (!pv || pv === this) {
- do1 = p.xo - rp1.xo;
- do2 = p.xo - rp2.xo;
- dm1 = rp1.x - rp1.xo;
- dm2 = rp2.x - rp2.xo;
- doa1 = Math.abs(do1);
- doa2 = Math.abs(do2);
- dt = doa1 + doa2;
-
- if (dt === 0) {
- p.x = p.xo + (dm1 + dm2) / 2;
- return;
- }
+ // Finds the position of needle in haystack, or -1 if not there.
+ // Like String.indexOf(), but for arrays.
+ function findSubArray(needle, haystack) {
+ var needleLength = needle.length;
+ var limit = haystack.length - needleLength + 1;
+
+ loop:
+ for (var pos = 0; pos < limit; pos++) {
+ for (; pos < limit; pos++) {
+ for (var k = 0; k < needleLength; k++) {
+ if (haystack[pos + k] !== needle[k]) {
+ continue loop;
+ }
+ }
+
+ return pos;
+ }
+ }
+
+ return -1;
+ }
- p.x = p.xo + (dm1 * doa2 + dm2 * doa1) / dt;
- return;
- }
+ function addStringToPool(s, pool) {
+ var offset = findSubArray(s, pool);
+ if (offset < 0) {
+ offset = pool.length;
+ var i = 0;
+ var len = s.length;
+ for (; i < len; ++i) {
+ pool.push(s[i]);
+ }
- do1 = pv.distance(p, rp1, true, true);
- do2 = pv.distance(p, rp2, true, true);
- dm1 = pv.distance(rp1, rp1, false, true);
- dm2 = pv.distance(rp2, rp2, false, true);
- doa1 = Math.abs(do1);
- doa2 = Math.abs(do2);
- dt = doa1 + doa2;
+ }
- if (dt === 0) {
- xUnitVector.setRelative(p, p, (dm1 + dm2) / 2, pv, true);
- return;
- }
+ return offset;
+ }
- xUnitVector.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true);
- },
+ function makeNameTable(names, ltag) {
+ var nameID;
+ var nameIDs = [];
+
+ var namesWithNumericKeys = {};
+ var nameTableIds = reverseDict(nameTableNames);
+ for (var key in names) {
+ var id = nameTableIds[key];
+ if (id === undefined) {
+ id = key;
+ }
+
+ nameID = parseInt(id);
+
+ if (isNaN(nameID)) {
+ throw new Error('Name table entry "' + key + '" does not exist, see nameTableNames for complete list.');
+ }
+
+ namesWithNumericKeys[nameID] = names[key];
+ nameIDs.push(nameID);
+ }
+
+ var macLanguageIds = reverseDict(macLanguages);
+ var windowsLanguageIds = reverseDict(windowsLanguages);
+
+ var nameRecords = [];
+ var stringPool = [];
+
+ for (var i = 0; i < nameIDs.length; i++) {
+ nameID = nameIDs[i];
+ var translations = namesWithNumericKeys[nameID];
+ for (var lang in translations) {
+ var text = translations[lang];
+
+ // For MacOS, we try to emit the name in the form that was introduced
+ // in the initial version of the TrueType spec (in the late 1980s).
+ // However, this can fail for various reasons: the requested BCP 47
+ // language code might not have an old-style Mac equivalent;
+ // we might not have a codec for the needed character encoding;
+ // or the name might contain characters that cannot be expressed
+ // in the old-style Macintosh encoding. In case of failure, we emit
+ // the name in a more modern fashion (Unicode encoding with BCP 47
+ // language tags) that is recognized by MacOS 10.5, released in 2009.
+ // If fonts were only read by operating systems, we could simply
+ // emit all names in the modern form; this would be much easier.
+ // However, there are many applications and libraries that read
+ // 'name' tables directly, and these will usually only recognize
+ // the ancient form (silently skipping the unrecognized names).
+ var macPlatform = 1; // Macintosh
+ var macLanguage = macLanguageIds[lang];
+ var macScript = macLanguageToScript[macLanguage];
+ var macEncoding = getEncoding(macPlatform, macScript, macLanguage);
+ var macName = encode.MACSTRING(text, macEncoding);
+ if (macName === undefined) {
+ macPlatform = 0; // Unicode
+ macLanguage = ltag.indexOf(lang);
+ if (macLanguage < 0) {
+ macLanguage = ltag.length;
+ ltag.push(lang);
+ }
+
+ macScript = 4; // Unicode 2.0 and later
+ macName = encode.UTF16(text);
+ }
+
+ var macNameOffset = addStringToPool(macName, stringPool);
+ nameRecords.push(makeNameRecord(macPlatform, macScript, macLanguage,
+ nameID, macName.length, macNameOffset));
+
+ var winLanguage = windowsLanguageIds[lang];
+ if (winLanguage !== undefined) {
+ var winName = encode.UTF16(text);
+ var winNameOffset = addStringToPool(winName, stringPool);
+ nameRecords.push(makeNameRecord(3, 1, winLanguage,
+ nameID, winName.length, winNameOffset));
+ }
+ }
+ }
+
+ nameRecords.sort(function(a, b) {
+ return ((a.platformID - b.platformID) ||
+ (a.encodingID - b.encodingID) ||
+ (a.languageID - b.languageID) ||
+ (a.nameID - b.nameID));
+ });
+
+ var t = new table.Table('name', [
+ {name: 'format', type: 'USHORT', value: 0},
+ {name: 'count', type: 'USHORT', value: nameRecords.length},
+ {name: 'stringOffset', type: 'USHORT', value: 6 + nameRecords.length * 12}
+ ]);
+
+ for (var r = 0; r < nameRecords.length; r++) {
+ t.fields.push({name: 'record_' + r, type: 'RECORD', value: nameRecords[r]});
+ }
+
+ t.fields.push({name: 'strings', type: 'LITERAL', value: stringPool});
+ return t;
+ }
- // Slope of line normal to this
- normalSlope: Number.NEGATIVE_INFINITY,
+ var _name = { parse: parseNameTable, make: makeNameTable };
+
+ // The `OS/2` table contains metrics required in OpenType fonts.
+
+ var unicodeRanges = [
+ {begin: 0x0000, end: 0x007F}, // Basic Latin
+ {begin: 0x0080, end: 0x00FF}, // Latin-1 Supplement
+ {begin: 0x0100, end: 0x017F}, // Latin Extended-A
+ {begin: 0x0180, end: 0x024F}, // Latin Extended-B
+ {begin: 0x0250, end: 0x02AF}, // IPA Extensions
+ {begin: 0x02B0, end: 0x02FF}, // Spacing Modifier Letters
+ {begin: 0x0300, end: 0x036F}, // Combining Diacritical Marks
+ {begin: 0x0370, end: 0x03FF}, // Greek and Coptic
+ {begin: 0x2C80, end: 0x2CFF}, // Coptic
+ {begin: 0x0400, end: 0x04FF}, // Cyrillic
+ {begin: 0x0530, end: 0x058F}, // Armenian
+ {begin: 0x0590, end: 0x05FF}, // Hebrew
+ {begin: 0xA500, end: 0xA63F}, // Vai
+ {begin: 0x0600, end: 0x06FF}, // Arabic
+ {begin: 0x07C0, end: 0x07FF}, // NKo
+ {begin: 0x0900, end: 0x097F}, // Devanagari
+ {begin: 0x0980, end: 0x09FF}, // Bengali
+ {begin: 0x0A00, end: 0x0A7F}, // Gurmukhi
+ {begin: 0x0A80, end: 0x0AFF}, // Gujarati
+ {begin: 0x0B00, end: 0x0B7F}, // Oriya
+ {begin: 0x0B80, end: 0x0BFF}, // Tamil
+ {begin: 0x0C00, end: 0x0C7F}, // Telugu
+ {begin: 0x0C80, end: 0x0CFF}, // Kannada
+ {begin: 0x0D00, end: 0x0D7F}, // Malayalam
+ {begin: 0x0E00, end: 0x0E7F}, // Thai
+ {begin: 0x0E80, end: 0x0EFF}, // Lao
+ {begin: 0x10A0, end: 0x10FF}, // Georgian
+ {begin: 0x1B00, end: 0x1B7F}, // Balinese
+ {begin: 0x1100, end: 0x11FF}, // Hangul Jamo
+ {begin: 0x1E00, end: 0x1EFF}, // Latin Extended Additional
+ {begin: 0x1F00, end: 0x1FFF}, // Greek Extended
+ {begin: 0x2000, end: 0x206F}, // General Punctuation
+ {begin: 0x2070, end: 0x209F}, // Superscripts And Subscripts
+ {begin: 0x20A0, end: 0x20CF}, // Currency Symbol
+ {begin: 0x20D0, end: 0x20FF}, // Combining Diacritical Marks For Symbols
+ {begin: 0x2100, end: 0x214F}, // Letterlike Symbols
+ {begin: 0x2150, end: 0x218F}, // Number Forms
+ {begin: 0x2190, end: 0x21FF}, // Arrows
+ {begin: 0x2200, end: 0x22FF}, // Mathematical Operators
+ {begin: 0x2300, end: 0x23FF}, // Miscellaneous Technical
+ {begin: 0x2400, end: 0x243F}, // Control Pictures
+ {begin: 0x2440, end: 0x245F}, // Optical Character Recognition
+ {begin: 0x2460, end: 0x24FF}, // Enclosed Alphanumerics
+ {begin: 0x2500, end: 0x257F}, // Box Drawing
+ {begin: 0x2580, end: 0x259F}, // Block Elements
+ {begin: 0x25A0, end: 0x25FF}, // Geometric Shapes
+ {begin: 0x2600, end: 0x26FF}, // Miscellaneous Symbols
+ {begin: 0x2700, end: 0x27BF}, // Dingbats
+ {begin: 0x3000, end: 0x303F}, // CJK Symbols And Punctuation
+ {begin: 0x3040, end: 0x309F}, // Hiragana
+ {begin: 0x30A0, end: 0x30FF}, // Katakana
+ {begin: 0x3100, end: 0x312F}, // Bopomofo
+ {begin: 0x3130, end: 0x318F}, // Hangul Compatibility Jamo
+ {begin: 0xA840, end: 0xA87F}, // Phags-pa
+ {begin: 0x3200, end: 0x32FF}, // Enclosed CJK Letters And Months
+ {begin: 0x3300, end: 0x33FF}, // CJK Compatibility
+ {begin: 0xAC00, end: 0xD7AF}, // Hangul Syllables
+ {begin: 0xD800, end: 0xDFFF}, // Non-Plane 0 *
+ {begin: 0x10900, end: 0x1091F}, // Phoenicia
+ {begin: 0x4E00, end: 0x9FFF}, // CJK Unified Ideographs
+ {begin: 0xE000, end: 0xF8FF}, // Private Use Area (plane 0)
+ {begin: 0x31C0, end: 0x31EF}, // CJK Strokes
+ {begin: 0xFB00, end: 0xFB4F}, // Alphabetic Presentation Forms
+ {begin: 0xFB50, end: 0xFDFF}, // Arabic Presentation Forms-A
+ {begin: 0xFE20, end: 0xFE2F}, // Combining Half Marks
+ {begin: 0xFE10, end: 0xFE1F}, // Vertical Forms
+ {begin: 0xFE50, end: 0xFE6F}, // Small Form Variants
+ {begin: 0xFE70, end: 0xFEFF}, // Arabic Presentation Forms-B
+ {begin: 0xFF00, end: 0xFFEF}, // Halfwidth And Fullwidth Forms
+ {begin: 0xFFF0, end: 0xFFFF}, // Specials
+ {begin: 0x0F00, end: 0x0FFF}, // Tibetan
+ {begin: 0x0700, end: 0x074F}, // Syriac
+ {begin: 0x0780, end: 0x07BF}, // Thaana
+ {begin: 0x0D80, end: 0x0DFF}, // Sinhala
+ {begin: 0x1000, end: 0x109F}, // Myanmar
+ {begin: 0x1200, end: 0x137F}, // Ethiopic
+ {begin: 0x13A0, end: 0x13FF}, // Cherokee
+ {begin: 0x1400, end: 0x167F}, // Unified Canadian Aboriginal Syllabics
+ {begin: 0x1680, end: 0x169F}, // Ogham
+ {begin: 0x16A0, end: 0x16FF}, // Runic
+ {begin: 0x1780, end: 0x17FF}, // Khmer
+ {begin: 0x1800, end: 0x18AF}, // Mongolian
+ {begin: 0x2800, end: 0x28FF}, // Braille Patterns
+ {begin: 0xA000, end: 0xA48F}, // Yi Syllables
+ {begin: 0x1700, end: 0x171F}, // Tagalog
+ {begin: 0x10300, end: 0x1032F}, // Old Italic
+ {begin: 0x10330, end: 0x1034F}, // Gothic
+ {begin: 0x10400, end: 0x1044F}, // Deseret
+ {begin: 0x1D000, end: 0x1D0FF}, // Byzantine Musical Symbols
+ {begin: 0x1D400, end: 0x1D7FF}, // Mathematical Alphanumeric Symbols
+ {begin: 0xFF000, end: 0xFFFFD}, // Private Use (plane 15)
+ {begin: 0xFE00, end: 0xFE0F}, // Variation Selectors
+ {begin: 0xE0000, end: 0xE007F}, // Tags
+ {begin: 0x1900, end: 0x194F}, // Limbu
+ {begin: 0x1950, end: 0x197F}, // Tai Le
+ {begin: 0x1980, end: 0x19DF}, // New Tai Lue
+ {begin: 0x1A00, end: 0x1A1F}, // Buginese
+ {begin: 0x2C00, end: 0x2C5F}, // Glagolitic
+ {begin: 0x2D30, end: 0x2D7F}, // Tifinagh
+ {begin: 0x4DC0, end: 0x4DFF}, // Yijing Hexagram Symbols
+ {begin: 0xA800, end: 0xA82F}, // Syloti Nagri
+ {begin: 0x10000, end: 0x1007F}, // Linear B Syllabary
+ {begin: 0x10140, end: 0x1018F}, // Ancient Greek Numbers
+ {begin: 0x10380, end: 0x1039F}, // Ugaritic
+ {begin: 0x103A0, end: 0x103DF}, // Old Persian
+ {begin: 0x10450, end: 0x1047F}, // Shavian
+ {begin: 0x10480, end: 0x104AF}, // Osmanya
+ {begin: 0x10800, end: 0x1083F}, // Cypriot Syllabary
+ {begin: 0x10A00, end: 0x10A5F}, // Kharoshthi
+ {begin: 0x1D300, end: 0x1D35F}, // Tai Xuan Jing Symbols
+ {begin: 0x12000, end: 0x123FF}, // Cuneiform
+ {begin: 0x1D360, end: 0x1D37F}, // Counting Rod Numerals
+ {begin: 0x1B80, end: 0x1BBF}, // Sundanese
+ {begin: 0x1C00, end: 0x1C4F}, // Lepcha
+ {begin: 0x1C50, end: 0x1C7F}, // Ol Chiki
+ {begin: 0xA880, end: 0xA8DF}, // Saurashtra
+ {begin: 0xA900, end: 0xA92F}, // Kayah Li
+ {begin: 0xA930, end: 0xA95F}, // Rejang
+ {begin: 0xAA00, end: 0xAA5F}, // Cham
+ {begin: 0x10190, end: 0x101CF}, // Ancient Symbols
+ {begin: 0x101D0, end: 0x101FF}, // Phaistos Disc
+ {begin: 0x102A0, end: 0x102DF}, // Carian
+ {begin: 0x1F030, end: 0x1F09F} // Domino Tiles
+ ];
+
+ function getUnicodeRange(unicode) {
+ for (var i = 0; i < unicodeRanges.length; i += 1) {
+ var range = unicodeRanges[i];
+ if (unicode >= range.begin && unicode < range.end) {
+ return i;
+ }
+ }
+
+ return -1;
+ }
- // Sets the point 'p' relative to point 'rp'
- // by the distance 'd'.
- //
- // See APPENDIX on SETRELATIVE at the bottom of this file.
- //
- // p ... point to set
- // rp ... reference point
- // d ... distance on projection vector
- // pv ... projection vector (undefined = this)
- // org ... if true, uses the original position of rp as reference.
- setRelative: function(p, rp, d, pv, org) {
- if (!pv || pv === this) {
- p.x = (org ? rp.xo : rp.x) + d;
- return;
- }
+ // Parse the OS/2 and Windows metrics `OS/2` table
+ function parseOS2Table(data, start) {
+ var os2 = {};
+ var p = new parse.Parser(data, start);
+ os2.version = p.parseUShort();
+ os2.xAvgCharWidth = p.parseShort();
+ os2.usWeightClass = p.parseUShort();
+ os2.usWidthClass = p.parseUShort();
+ os2.fsType = p.parseUShort();
+ os2.ySubscriptXSize = p.parseShort();
+ os2.ySubscriptYSize = p.parseShort();
+ os2.ySubscriptXOffset = p.parseShort();
+ os2.ySubscriptYOffset = p.parseShort();
+ os2.ySuperscriptXSize = p.parseShort();
+ os2.ySuperscriptYSize = p.parseShort();
+ os2.ySuperscriptXOffset = p.parseShort();
+ os2.ySuperscriptYOffset = p.parseShort();
+ os2.yStrikeoutSize = p.parseShort();
+ os2.yStrikeoutPosition = p.parseShort();
+ os2.sFamilyClass = p.parseShort();
+ os2.panose = [];
+ for (var i = 0; i < 10; i++) {
+ os2.panose[i] = p.parseByte();
+ }
+
+ os2.ulUnicodeRange1 = p.parseULong();
+ os2.ulUnicodeRange2 = p.parseULong();
+ os2.ulUnicodeRange3 = p.parseULong();
+ os2.ulUnicodeRange4 = p.parseULong();
+ os2.achVendID = String.fromCharCode(p.parseByte(), p.parseByte(), p.parseByte(), p.parseByte());
+ os2.fsSelection = p.parseUShort();
+ os2.usFirstCharIndex = p.parseUShort();
+ os2.usLastCharIndex = p.parseUShort();
+ os2.sTypoAscender = p.parseShort();
+ os2.sTypoDescender = p.parseShort();
+ os2.sTypoLineGap = p.parseShort();
+ os2.usWinAscent = p.parseUShort();
+ os2.usWinDescent = p.parseUShort();
+ if (os2.version >= 1) {
+ os2.ulCodePageRange1 = p.parseULong();
+ os2.ulCodePageRange2 = p.parseULong();
+ }
+
+ if (os2.version >= 2) {
+ os2.sxHeight = p.parseShort();
+ os2.sCapHeight = p.parseShort();
+ os2.usDefaultChar = p.parseUShort();
+ os2.usBreakChar = p.parseUShort();
+ os2.usMaxContent = p.parseUShort();
+ }
+
+ return os2;
+ }
- var rpx = org ? rp.xo : rp.x;
- var rpy = org ? rp.yo : rp.y;
- var rpdx = rpx + d * pv.x;
- var rpdy = rpy + d * pv.y;
+ function makeOS2Table(options) {
+ return new table.Table('OS/2', [
+ {name: 'version', type: 'USHORT', value: 0x0003},
+ {name: 'xAvgCharWidth', type: 'SHORT', value: 0},
+ {name: 'usWeightClass', type: 'USHORT', value: 0},
+ {name: 'usWidthClass', type: 'USHORT', value: 0},
+ {name: 'fsType', type: 'USHORT', value: 0},
+ {name: 'ySubscriptXSize', type: 'SHORT', value: 650},
+ {name: 'ySubscriptYSize', type: 'SHORT', value: 699},
+ {name: 'ySubscriptXOffset', type: 'SHORT', value: 0},
+ {name: 'ySubscriptYOffset', type: 'SHORT', value: 140},
+ {name: 'ySuperscriptXSize', type: 'SHORT', value: 650},
+ {name: 'ySuperscriptYSize', type: 'SHORT', value: 699},
+ {name: 'ySuperscriptXOffset', type: 'SHORT', value: 0},
+ {name: 'ySuperscriptYOffset', type: 'SHORT', value: 479},
+ {name: 'yStrikeoutSize', type: 'SHORT', value: 49},
+ {name: 'yStrikeoutPosition', type: 'SHORT', value: 258},
+ {name: 'sFamilyClass', type: 'SHORT', value: 0},
+ {name: 'bFamilyType', type: 'BYTE', value: 0},
+ {name: 'bSerifStyle', type: 'BYTE', value: 0},
+ {name: 'bWeight', type: 'BYTE', value: 0},
+ {name: 'bProportion', type: 'BYTE', value: 0},
+ {name: 'bContrast', type: 'BYTE', value: 0},
+ {name: 'bStrokeVariation', type: 'BYTE', value: 0},
+ {name: 'bArmStyle', type: 'BYTE', value: 0},
+ {name: 'bLetterform', type: 'BYTE', value: 0},
+ {name: 'bMidline', type: 'BYTE', value: 0},
+ {name: 'bXHeight', type: 'BYTE', value: 0},
+ {name: 'ulUnicodeRange1', type: 'ULONG', value: 0},
+ {name: 'ulUnicodeRange2', type: 'ULONG', value: 0},
+ {name: 'ulUnicodeRange3', type: 'ULONG', value: 0},
+ {name: 'ulUnicodeRange4', type: 'ULONG', value: 0},
+ {name: 'achVendID', type: 'CHARARRAY', value: 'XXXX'},
+ {name: 'fsSelection', type: 'USHORT', value: 0},
+ {name: 'usFirstCharIndex', type: 'USHORT', value: 0},
+ {name: 'usLastCharIndex', type: 'USHORT', value: 0},
+ {name: 'sTypoAscender', type: 'SHORT', value: 0},
+ {name: 'sTypoDescender', type: 'SHORT', value: 0},
+ {name: 'sTypoLineGap', type: 'SHORT', value: 0},
+ {name: 'usWinAscent', type: 'USHORT', value: 0},
+ {name: 'usWinDescent', type: 'USHORT', value: 0},
+ {name: 'ulCodePageRange1', type: 'ULONG', value: 0},
+ {name: 'ulCodePageRange2', type: 'ULONG', value: 0},
+ {name: 'sxHeight', type: 'SHORT', value: 0},
+ {name: 'sCapHeight', type: 'SHORT', value: 0},
+ {name: 'usDefaultChar', type: 'USHORT', value: 0},
+ {name: 'usBreakChar', type: 'USHORT', value: 0},
+ {name: 'usMaxContext', type: 'USHORT', value: 0}
+ ], options);
+ }
- p.x = rpdx + (p.y - rpdy) / pv.normalSlope;
- },
+ var os2 = { parse: parseOS2Table, make: makeOS2Table, unicodeRanges: unicodeRanges, getUnicodeRange: getUnicodeRange };
+
+ // The `post` table stores additional PostScript information, such as glyph names.
+
+ // Parse the PostScript `post` table
+ function parsePostTable(data, start) {
+ var post = {};
+ var p = new parse.Parser(data, start);
+ post.version = p.parseVersion();
+ post.italicAngle = p.parseFixed();
+ post.underlinePosition = p.parseShort();
+ post.underlineThickness = p.parseShort();
+ post.isFixedPitch = p.parseULong();
+ post.minMemType42 = p.parseULong();
+ post.maxMemType42 = p.parseULong();
+ post.minMemType1 = p.parseULong();
+ post.maxMemType1 = p.parseULong();
+ switch (post.version) {
+ case 1:
+ post.names = standardNames.slice();
+ break;
+ case 2:
+ post.numberOfGlyphs = p.parseUShort();
+ post.glyphNameIndex = new Array(post.numberOfGlyphs);
+ for (var i = 0; i < post.numberOfGlyphs; i++) {
+ post.glyphNameIndex[i] = p.parseUShort();
+ }
+
+ post.names = [];
+ for (var i$1 = 0; i$1 < post.numberOfGlyphs; i$1++) {
+ if (post.glyphNameIndex[i$1] >= standardNames.length) {
+ var nameLength = p.parseChar();
+ post.names.push(p.parseString(nameLength));
+ }
+ }
+
+ break;
+ case 2.5:
+ post.numberOfGlyphs = p.parseUShort();
+ post.offset = new Array(post.numberOfGlyphs);
+ for (var i$2 = 0; i$2 < post.numberOfGlyphs; i$2++) {
+ post.offset[i$2] = p.parseChar();
+ }
+
+ break;
+ }
+ return post;
+ }
- // Slope of vector line.
- slope: 0,
+ function makePostTable() {
+ return new table.Table('post', [
+ {name: 'version', type: 'FIXED', value: 0x00030000},
+ {name: 'italicAngle', type: 'FIXED', value: 0},
+ {name: 'underlinePosition', type: 'FWORD', value: 0},
+ {name: 'underlineThickness', type: 'FWORD', value: 0},
+ {name: 'isFixedPitch', type: 'ULONG', value: 0},
+ {name: 'minMemType42', type: 'ULONG', value: 0},
+ {name: 'maxMemType42', type: 'ULONG', value: 0},
+ {name: 'minMemType1', type: 'ULONG', value: 0},
+ {name: 'maxMemType1', type: 'ULONG', value: 0}
+ ]);
+ }
- // Touches the point p.
- touch: function(p) { p.xTouched = true; },
+ var post = { parse: parsePostTable, make: makePostTable };
+
+ // The `GSUB` table contains ligatures, among other things.
+
+ var subtableParsers = new Array(9); // subtableParsers[0] is unused
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#SS
+ subtableParsers[1] = function parseLookup1() {
+ var start = this.offset + this.relativeOffset;
+ var substFormat = this.parseUShort();
+ if (substFormat === 1) {
+ return {
+ substFormat: 1,
+ coverage: this.parsePointer(Parser.coverage),
+ deltaGlyphId: this.parseUShort()
+ };
+ } else if (substFormat === 2) {
+ return {
+ substFormat: 2,
+ coverage: this.parsePointer(Parser.coverage),
+ substitute: this.parseOffset16List()
+ };
+ }
+ check.assert(false, '0x' + start.toString(16) + ': lookup type 1 format must be 1 or 2.');
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#MS
+ subtableParsers[2] = function parseLookup2() {
+ var substFormat = this.parseUShort();
+ check.argument(substFormat === 1, 'GSUB Multiple Substitution Subtable identifier-format must be 1');
+ return {
+ substFormat: substFormat,
+ coverage: this.parsePointer(Parser.coverage),
+ sequences: this.parseListOfLists()
+ };
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#AS
+ subtableParsers[3] = function parseLookup3() {
+ var substFormat = this.parseUShort();
+ check.argument(substFormat === 1, 'GSUB Alternate Substitution Subtable identifier-format must be 1');
+ return {
+ substFormat: substFormat,
+ coverage: this.parsePointer(Parser.coverage),
+ alternateSets: this.parseListOfLists()
+ };
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#LS
+ subtableParsers[4] = function parseLookup4() {
+ var substFormat = this.parseUShort();
+ check.argument(substFormat === 1, 'GSUB ligature table identifier-format must be 1');
+ return {
+ substFormat: substFormat,
+ coverage: this.parsePointer(Parser.coverage),
+ ligatureSets: this.parseListOfLists(function() {
+ return {
+ ligGlyph: this.parseUShort(),
+ components: this.parseUShortList(this.parseUShort() - 1)
+ };
+ })
+ };
+ };
+
+ var lookupRecordDesc = {
+ sequenceIndex: Parser.uShort,
+ lookupListIndex: Parser.uShort
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#CSF
+ subtableParsers[5] = function parseLookup5() {
+ var start = this.offset + this.relativeOffset;
+ var substFormat = this.parseUShort();
+
+ if (substFormat === 1) {
+ return {
+ substFormat: substFormat,
+ coverage: this.parsePointer(Parser.coverage),
+ ruleSets: this.parseListOfLists(function() {
+ var glyphCount = this.parseUShort();
+ var substCount = this.parseUShort();
+ return {
+ input: this.parseUShortList(glyphCount - 1),
+ lookupRecords: this.parseRecordList(substCount, lookupRecordDesc)
+ };
+ })
+ };
+ } else if (substFormat === 2) {
+ return {
+ substFormat: substFormat,
+ coverage: this.parsePointer(Parser.coverage),
+ classDef: this.parsePointer(Parser.classDef),
+ classSets: this.parseListOfLists(function() {
+ var glyphCount = this.parseUShort();
+ var substCount = this.parseUShort();
+ return {
+ classes: this.parseUShortList(glyphCount - 1),
+ lookupRecords: this.parseRecordList(substCount, lookupRecordDesc)
+ };
+ })
+ };
+ } else if (substFormat === 3) {
+ var glyphCount = this.parseUShort();
+ var substCount = this.parseUShort();
+ return {
+ substFormat: substFormat,
+ coverages: this.parseList(glyphCount, Parser.pointer(Parser.coverage)),
+ lookupRecords: this.parseRecordList(substCount, lookupRecordDesc)
+ };
+ }
+ check.assert(false, '0x' + start.toString(16) + ': lookup type 5 format must be 1, 2 or 3.');
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#CC
+ subtableParsers[6] = function parseLookup6() {
+ var start = this.offset + this.relativeOffset;
+ var substFormat = this.parseUShort();
+ if (substFormat === 1) {
+ return {
+ substFormat: 1,
+ coverage: this.parsePointer(Parser.coverage),
+ chainRuleSets: this.parseListOfLists(function() {
+ return {
+ backtrack: this.parseUShortList(),
+ input: this.parseUShortList(this.parseShort() - 1),
+ lookahead: this.parseUShortList(),
+ lookupRecords: this.parseRecordList(lookupRecordDesc)
+ };
+ })
+ };
+ } else if (substFormat === 2) {
+ return {
+ substFormat: 2,
+ coverage: this.parsePointer(Parser.coverage),
+ backtrackClassDef: this.parsePointer(Parser.classDef),
+ inputClassDef: this.parsePointer(Parser.classDef),
+ lookaheadClassDef: this.parsePointer(Parser.classDef),
+ chainClassSet: this.parseListOfLists(function() {
+ return {
+ backtrack: this.parseUShortList(),
+ input: this.parseUShortList(this.parseShort() - 1),
+ lookahead: this.parseUShortList(),
+ lookupRecords: this.parseRecordList(lookupRecordDesc)
+ };
+ })
+ };
+ } else if (substFormat === 3) {
+ return {
+ substFormat: 3,
+ backtrackCoverage: this.parseList(Parser.pointer(Parser.coverage)),
+ inputCoverage: this.parseList(Parser.pointer(Parser.coverage)),
+ lookaheadCoverage: this.parseList(Parser.pointer(Parser.coverage)),
+ lookupRecords: this.parseRecordList(lookupRecordDesc)
+ };
+ }
+ check.assert(false, '0x' + start.toString(16) + ': lookup type 6 format must be 1, 2 or 3.');
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#ES
+ subtableParsers[7] = function parseLookup7() {
+ // Extension Substitution subtable
+ var substFormat = this.parseUShort();
+ check.argument(substFormat === 1, 'GSUB Extension Substitution subtable identifier-format must be 1');
+ var extensionLookupType = this.parseUShort();
+ var extensionParser = new Parser(this.data, this.offset + this.parseULong());
+ return {
+ substFormat: 1,
+ lookupType: extensionLookupType,
+ extension: subtableParsers[extensionLookupType].call(extensionParser)
+ };
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#RCCS
+ subtableParsers[8] = function parseLookup8() {
+ var substFormat = this.parseUShort();
+ check.argument(substFormat === 1, 'GSUB Reverse Chaining Contextual Single Substitution Subtable identifier-format must be 1');
+ return {
+ substFormat: substFormat,
+ coverage: this.parsePointer(Parser.coverage),
+ backtrackCoverage: this.parseList(Parser.pointer(Parser.coverage)),
+ lookaheadCoverage: this.parseList(Parser.pointer(Parser.coverage)),
+ substitutes: this.parseUShortList()
+ };
+ };
+
+ // https://www.microsoft.com/typography/OTSPEC/gsub.htm
+ function parseGsubTable(data, start) {
+ start = start || 0;
+ var p = new Parser(data, start);
+ var tableVersion = p.parseVersion(1);
+ check.argument(tableVersion === 1 || tableVersion === 1.1, 'Unsupported GSUB table version.');
+ if (tableVersion === 1) {
+ return {
+ version: tableVersion,
+ scripts: p.parseScriptList(),
+ features: p.parseFeatureList(),
+ lookups: p.parseLookupList(subtableParsers)
+ };
+ } else {
+ return {
+ version: tableVersion,
+ scripts: p.parseScriptList(),
+ features: p.parseFeatureList(),
+ lookups: p.parseLookupList(subtableParsers),
+ variations: p.parseFeatureVariationsList()
+ };
+ }
- // Tests if a point p is touched.
- touched: function(p) { return p.xTouched; },
+ }
- // Untouches the point p.
- untouch: function(p) { p.xTouched = false; }
-};
+ // GSUB Writing //////////////////////////////////////////////
+ var subtableMakers = new Array(9);
+
+ subtableMakers[1] = function makeLookup1(subtable) {
+ if (subtable.substFormat === 1) {
+ return new table.Table('substitutionTable', [
+ {name: 'substFormat', type: 'USHORT', value: 1},
+ {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)},
+ {name: 'deltaGlyphID', type: 'USHORT', value: subtable.deltaGlyphId}
+ ]);
+ } else {
+ return new table.Table('substitutionTable', [
+ {name: 'substFormat', type: 'USHORT', value: 2},
+ {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}
+ ].concat(table.ushortList('substitute', subtable.substitute)));
+ }
+ check.fail('Lookup type 1 substFormat must be 1 or 2.');
+ };
+
+ subtableMakers[3] = function makeLookup3(subtable) {
+ check.assert(subtable.substFormat === 1, 'Lookup type 3 substFormat must be 1.');
+ return new table.Table('substitutionTable', [
+ {name: 'substFormat', type: 'USHORT', value: 1},
+ {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}
+ ].concat(table.tableList('altSet', subtable.alternateSets, function(alternateSet) {
+ return new table.Table('alternateSetTable', table.ushortList('alternate', alternateSet));
+ })));
+ };
+
+ subtableMakers[4] = function makeLookup4(subtable) {
+ check.assert(subtable.substFormat === 1, 'Lookup type 4 substFormat must be 1.');
+ return new table.Table('substitutionTable', [
+ {name: 'substFormat', type: 'USHORT', value: 1},
+ {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}
+ ].concat(table.tableList('ligSet', subtable.ligatureSets, function(ligatureSet) {
+ return new table.Table('ligatureSetTable', table.tableList('ligature', ligatureSet, function(ligature) {
+ return new table.Table('ligatureTable',
+ [{name: 'ligGlyph', type: 'USHORT', value: ligature.ligGlyph}]
+ .concat(table.ushortList('component', ligature.components, ligature.components.length + 1))
+ );
+ }));
+ })));
+ };
+
+ function makeGsubTable(gsub) {
+ return new table.Table('GSUB', [
+ {name: 'version', type: 'ULONG', value: 0x10000},
+ {name: 'scripts', type: 'TABLE', value: new table.ScriptList(gsub.scripts)},
+ {name: 'features', type: 'TABLE', value: new table.FeatureList(gsub.features)},
+ {name: 'lookups', type: 'TABLE', value: new table.LookupList(gsub.lookups, subtableMakers)}
+ ]);
+ }
-/*
-* Unit vector of y-axis.
-*/
-var yUnitVector = {
- x: 0,
+ var gsub = { parse: parseGsubTable, make: makeGsubTable };
+
+ // The `GPOS` table contains kerning pairs, among other things.
+
+ // Parse the metadata `meta` table.
+ // https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6meta.html
+ function parseMetaTable(data, start) {
+ var p = new parse.Parser(data, start);
+ var tableVersion = p.parseULong();
+ check.argument(tableVersion === 1, 'Unsupported META table version.');
+ p.parseULong(); // flags - currently unused and set to 0
+ p.parseULong(); // tableOffset
+ var numDataMaps = p.parseULong();
+
+ var tags = {};
+ for (var i = 0; i < numDataMaps; i++) {
+ var tag = p.parseTag();
+ var dataOffset = p.parseULong();
+ var dataLength = p.parseULong();
+ var text = decode.UTF8(data, start + dataOffset, dataLength);
+
+ tags[tag] = text;
+ }
+ return tags;
+ }
- y: 1,
+ function makeMetaTable(tags) {
+ var numTags = Object.keys(tags).length;
+ var stringPool = '';
+ var stringPoolOffset = 16 + numTags * 12;
- axis: 'y',
+ var result = new table.Table('meta', [
+ {name: 'version', type: 'ULONG', value: 1},
+ {name: 'flags', type: 'ULONG', value: 0},
+ {name: 'offset', type: 'ULONG', value: stringPoolOffset},
+ {name: 'numTags', type: 'ULONG', value: numTags}
+ ]);
- // Gets the projected distance between two points.
- // o1/o2 ... if true, respective original position is used.
- distance: function(p1, p2, o1, o2) {
- return (o1 ? p1.yo : p1.y) - (o2 ? p2.yo : p2.y);
- },
+ for (var tag in tags) {
+ var pos = stringPool.length;
+ stringPool += tags[tag];
- // Moves point p so the moved position has the same relative
- // position to the moved positions of rp1 and rp2 than the
- // original positions had.
- //
- // See APPENDIX on INTERPOLATE at the bottom of this file.
- interpolate: function(p, rp1, rp2, pv) {
- var do1;
- var do2;
- var doa1;
- var doa2;
- var dm1;
- var dm2;
- var dt;
-
- if (!pv || pv === this) {
- do1 = p.yo - rp1.yo;
- do2 = p.yo - rp2.yo;
- dm1 = rp1.y - rp1.yo;
- dm2 = rp2.y - rp2.yo;
- doa1 = Math.abs(do1);
- doa2 = Math.abs(do2);
- dt = doa1 + doa2;
-
- if (dt === 0) {
- p.y = p.yo + (dm1 + dm2) / 2;
- return;
- }
+ result.fields.push({name: 'tag ' + tag, type: 'TAG', value: tag});
+ result.fields.push({name: 'offset ' + tag, type: 'ULONG', value: stringPoolOffset + pos});
+ result.fields.push({name: 'length ' + tag, type: 'ULONG', value: tags[tag].length});
+ }
- p.y = p.yo + (dm1 * doa2 + dm2 * doa1) / dt;
- return;
- }
+ result.fields.push({name: 'stringPool', type: 'CHARARRAY', value: stringPool});
- do1 = pv.distance(p, rp1, true, true);
- do2 = pv.distance(p, rp2, true, true);
- dm1 = pv.distance(rp1, rp1, false, true);
- dm2 = pv.distance(rp2, rp2, false, true);
- doa1 = Math.abs(do1);
- doa2 = Math.abs(do2);
- dt = doa1 + doa2;
+ return result;
+ }
- if (dt === 0) {
- yUnitVector.setRelative(p, p, (dm1 + dm2) / 2, pv, true);
- return;
- }
+ var meta = { parse: parseMetaTable, make: makeMetaTable };
- yUnitVector.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true);
- },
+ // The `sfnt` wrapper provides organization for the tables in the font.
- // Slope of line normal to this.
- normalSlope: 0,
+ function log2(v) {
+ return Math.log(v) / Math.log(2) | 0;
+ }
- // Sets the point 'p' relative to point 'rp'
- // by the distance 'd'
- //
- // See APPENDIX on SETRELATIVE at the bottom of this file.
- //
- // p ... point to set
- // rp ... reference point
- // d ... distance on projection vector
- // pv ... projection vector (undefined = this)
- // org ... if true, uses the original position of rp as reference.
- setRelative: function(p, rp, d, pv, org) {
- if (!pv || pv === this) {
- p.y = (org ? rp.yo : rp.y) + d;
- return;
- }
+ function computeCheckSum(bytes) {
+ while (bytes.length % 4 !== 0) {
+ bytes.push(0);
+ }
+
+ var sum = 0;
+ for (var i = 0; i < bytes.length; i += 4) {
+ sum += (bytes[i] << 24) +
+ (bytes[i + 1] << 16) +
+ (bytes[i + 2] << 8) +
+ (bytes[i + 3]);
+ }
+
+ sum %= Math.pow(2, 32);
+ return sum;
+ }
- var rpx = org ? rp.xo : rp.x;
- var rpy = org ? rp.yo : rp.y;
- var rpdx = rpx + d * pv.x;
- var rpdy = rpy + d * pv.y;
-
- p.y = rpdy + pv.normalSlope * (p.x - rpdx);
- },
-
- // Slope of vector line.
- slope: Number.POSITIVE_INFINITY,
-
- // Touches the point p.
- touch: function(p) { p.yTouched = true; },
-
- // Tests if a point p is touched.
- touched: function(p) { return p.yTouched; },
-
- // Untouches the point p.
- untouch: function(p) { p.yTouched = false; }
-};
-
-Object.freeze(xUnitVector);
-Object.freeze(yUnitVector);
-
-/*
-* Creates a unit vector that is not x- or y-axis.
-*/
-function UnitVector(x, y) {
- this.x = x;
- this.y = y;
- this.axis = undefined;
- this.slope = y / x;
- this.normalSlope = -x / y;
- Object.freeze(this);
-}
-
-/*
-* Gets the projected distance between two points.
-* o1/o2 ... if true, respective original position is used.
-*/
-UnitVector.prototype.distance = function(p1, p2, o1, o2) {
- return (
- this.x * xUnitVector.distance(p1, p2, o1, o2) +
- this.y * yUnitVector.distance(p1, p2, o1, o2)
- );
-};
-
-/*
-* Moves point p so the moved position has the same relative
-* position to the moved positions of rp1 and rp2 than the
-* original positions had.
-*
-* See APPENDIX on INTERPOLATE at the bottom of this file.
-*/
-UnitVector.prototype.interpolate = function(p, rp1, rp2, pv) {
- var dm1;
- var dm2;
- var do1;
- var do2;
- var doa1;
- var doa2;
- var dt;
-
- do1 = pv.distance(p, rp1, true, true);
- do2 = pv.distance(p, rp2, true, true);
- dm1 = pv.distance(rp1, rp1, false, true);
- dm2 = pv.distance(rp2, rp2, false, true);
- doa1 = Math.abs(do1);
- doa2 = Math.abs(do2);
- dt = doa1 + doa2;
-
- if (dt === 0) {
- this.setRelative(p, p, (dm1 + dm2) / 2, pv, true);
- return;
- }
-
- this.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true);
-};
-
-/*
-* Sets the point 'p' relative to point 'rp'
-* by the distance 'd'
-*
-* See APPENDIX on SETRELATIVE at the bottom of this file.
-*
-* p ... point to set
-* rp ... reference point
-* d ... distance on projection vector
-* pv ... projection vector (undefined = this)
-* org ... if true, uses the original position of rp as reference.
-*/
-UnitVector.prototype.setRelative = function(p, rp, d, pv, org) {
- pv = pv || this;
-
- var rpx = org ? rp.xo : rp.x;
- var rpy = org ? rp.yo : rp.y;
- var rpdx = rpx + d * pv.x;
- var rpdy = rpy + d * pv.y;
-
- var pvns = pv.normalSlope;
- var fvs = this.slope;
-
- var px = p.x;
- var py = p.y;
-
- p.x = (fvs * px - pvns * rpdx + rpdy - py) / (fvs - pvns);
- p.y = fvs * (p.x - px) + py;
-};
-
-/*
-* Touches the point p.
-*/
-UnitVector.prototype.touch = function(p) {
- p.xTouched = true;
- p.yTouched = true;
-};
-
-/*
-* Returns a unit vector with x/y coordinates.
-*/
-function getUnitVector(x, y) {
- var d = Math.sqrt(x * x + y * y);
-
- x /= d;
- y /= d;
-
- if (x === 1 && y === 0) return xUnitVector;
- else if (x === 0 && y === 1) return yUnitVector;
- else return new UnitVector(x, y);
-}
-
-/*
-* Creates a point in the hinting engine.
-*/
-function HPoint(
- x,
- y,
- lastPointOfContour,
- onCurve
-) {
- this.x = this.xo = Math.round(x * 64) / 64; // hinted x value and original x-value
- this.y = this.yo = Math.round(y * 64) / 64; // hinted y value and original y-value
-
- this.lastPointOfContour = lastPointOfContour;
- this.onCurve = onCurve;
- this.prevPointOnContour = undefined;
- this.nextPointOnContour = undefined;
- this.xTouched = false;
- this.yTouched = false;
-
- Object.preventExtensions(this);
-}
-
-/*
-* Returns the next touched point on the contour.
-*
-* v ... unit vector to test touch axis.
-*/
-HPoint.prototype.nextTouched = function(v) {
- var p = this.nextPointOnContour;
-
- while (!v.touched(p) && p !== this) p = p.nextPointOnContour;
-
- return p;
-};
-
-/*
-* Returns the previous touched point on the contour
-*
-* v ... unit vector to test touch axis.
-*/
-HPoint.prototype.prevTouched = function(v) {
- var p = this.prevPointOnContour;
-
- while (!v.touched(p) && p !== this) p = p.prevPointOnContour;
-
- return p;
-};
-
-/*
-* The zero point.
-*/
-var HPZero = Object.freeze(new HPoint(0, 0));
-
-/*
-* The default state of the interpreter.
-*
-* Note: Freezing the defaultState and then deriving from it
-* makes the V8 Javascript engine going akward,
-* so this is avoided, albeit the defaultState shouldn't
-* ever change.
-*/
-var defaultState = {
- cvCutIn: 17 / 16, // control value cut in
- deltaBase: 9,
- deltaShift: 0.125,
- loop: 1, // loops some instructions
- minDis: 1, // minimum distance
- autoFlip: true
-};
-
-/*
-* The current state of the interpreter.
-*
-* env ... 'fpgm' or 'prep' or 'glyf'
-* prog ... the program
-*/
-function State(env, prog) {
- this.env = env;
- this.stack = [];
- this.prog = prog;
-
- switch (env) {
- case 'glyf' :
- this.zp0 = this.zp1 = this.zp2 = 1;
- this.rp0 = this.rp1 = this.rp2 = 0;
- /* fall through */
- case 'prep' :
- this.fv = this.pv = this.dpv = xUnitVector;
- this.round = roundToGrid;
- }
-}
-
-/*
-* Executes a glyph program.
-*
-* This does the hinting for each glyph.
-*
-* Returns an array of moved points.
-*
-* glyph: the glyph to hint
-* ppem: the size the glyph is rendered for
-*/
-Hinting.prototype.exec = function(glyph, ppem) {
- if (typeof ppem !== 'number') {
- throw new Error('Point size is not a number!');
- }
-
- // Received a fatal error, don't do any hinting anymore.
- if (this._errorState > 2) return;
-
- var font = this.font;
- var prepState = this._prepState;
-
- if (!prepState || prepState.ppem !== ppem) {
- var fpgmState = this._fpgmState;
-
- if (!fpgmState) {
- // Executes the fpgm state.
- // This is used by fonts to define functions.
- State.prototype = defaultState;
-
- fpgmState =
- this._fpgmState =
- new State('fpgm', font.tables.fpgm);
-
- fpgmState.funcs = [ ];
- fpgmState.font = font;
-
- if (DEBUG) {
- console.log('---EXEC FPGM---');
- fpgmState.step = -1;
- }
-
- try {
- exec(fpgmState);
- } catch (e) {
- console.log('Hinting error in FPGM:' + e);
- this._errorState = 3;
- return;
- }
- }
+ function makeTableRecord(tag, checkSum, offset, length) {
+ return new table.Record('Table Record', [
+ {name: 'tag', type: 'TAG', value: tag !== undefined ? tag : ''},
+ {name: 'checkSum', type: 'ULONG', value: checkSum !== undefined ? checkSum : 0},
+ {name: 'offset', type: 'ULONG', value: offset !== undefined ? offset : 0},
+ {name: 'length', type: 'ULONG', value: length !== undefined ? length : 0}
+ ]);
+ }
- // Executes the prep program for this ppem setting.
- // This is used by fonts to set cvt values
- // depending on to be rendered font size.
-
- State.prototype = fpgmState;
- prepState =
- this._prepState =
- new State('prep', font.tables.prep);
-
- prepState.ppem = ppem;
-
- // Creates a copy of the cvt table
- // and scales it to the current ppem setting.
- var oCvt = font.tables.cvt;
- if (oCvt) {
- var cvt = prepState.cvt = new Array(oCvt.length);
- var scale = ppem / font.unitsPerEm;
- for (var c = 0; c < oCvt.length; c++) {
- cvt[c] = oCvt[c] * scale;
- }
- } else {
- prepState.cvt = [];
- }
+ function makeSfntTable(tables) {
+ var sfnt = new table.Table('sfnt', [
+ {name: 'version', type: 'TAG', value: 'OTTO'},
+ {name: 'numTables', type: 'USHORT', value: 0},
+ {name: 'searchRange', type: 'USHORT', value: 0},
+ {name: 'entrySelector', type: 'USHORT', value: 0},
+ {name: 'rangeShift', type: 'USHORT', value: 0}
+ ]);
+ sfnt.tables = tables;
+ sfnt.numTables = tables.length;
+ var highestPowerOf2 = Math.pow(2, log2(sfnt.numTables));
+ sfnt.searchRange = 16 * highestPowerOf2;
+ sfnt.entrySelector = log2(highestPowerOf2);
+ sfnt.rangeShift = sfnt.numTables * 16 - sfnt.searchRange;
+
+ var recordFields = [];
+ var tableFields = [];
+
+ var offset = sfnt.sizeOf() + (makeTableRecord().sizeOf() * sfnt.numTables);
+ while (offset % 4 !== 0) {
+ offset += 1;
+ tableFields.push({name: 'padding', type: 'BYTE', value: 0});
+ }
+
+ for (var i = 0; i < tables.length; i += 1) {
+ var t = tables[i];
+ check.argument(t.tableName.length === 4, 'Table name' + t.tableName + ' is invalid.');
+ var tableLength = t.sizeOf();
+ var tableRecord = makeTableRecord(t.tableName, computeCheckSum(t.encode()), offset, tableLength);
+ recordFields.push({name: tableRecord.tag + ' Table Record', type: 'RECORD', value: tableRecord});
+ tableFields.push({name: t.tableName + ' table', type: 'RECORD', value: t});
+ offset += tableLength;
+ check.argument(!isNaN(offset), 'Something went wrong calculating the offset.');
+ while (offset % 4 !== 0) {
+ offset += 1;
+ tableFields.push({name: 'padding', type: 'BYTE', value: 0});
+ }
+ }
+
+ // Table records need to be sorted alphabetically.
+ recordFields.sort(function(r1, r2) {
+ if (r1.value.tag > r2.value.tag) {
+ return 1;
+ } else {
+ return -1;
+ }
+ });
+
+ sfnt.fields = sfnt.fields.concat(recordFields);
+ sfnt.fields = sfnt.fields.concat(tableFields);
+ return sfnt;
+ }
- if (DEBUG) {
- console.log('---EXEC PREP---');
- prepState.step = -1;
- }
+ // Get the metrics for a character. If the string has more than one character
+ // this function returns metrics for the first available character.
+ // You can provide optional fallback metrics if no characters are available.
+ function metricsForChar(font, chars, notFoundMetrics) {
+ for (var i = 0; i < chars.length; i += 1) {
+ var glyphIndex = font.charToGlyphIndex(chars[i]);
+ if (glyphIndex > 0) {
+ var glyph = font.glyphs.get(glyphIndex);
+ return glyph.getMetrics();
+ }
+ }
+
+ return notFoundMetrics;
+ }
- try {
- exec(prepState);
- } catch (e) {
- if (this._errorState < 2) {
- console.log('Hinting error in PREP:' + e);
- }
- this._errorState = 2;
- }
- }
+ function average(vs) {
+ var sum = 0;
+ for (var i = 0; i < vs.length; i += 1) {
+ sum += vs[i];
+ }
- if (this._errorState > 1) return;
+ return sum / vs.length;
+ }
- try {
- return execGlyph(glyph, prepState);
- } catch (e) {
- if (this._errorState < 1) {
- console.log('Hinting error:' + e);
- console.log('Note: further hinting errors are silenced');
- }
- this._errorState = 1;
- return;
- }
-};
+ // Convert the font object to a SFNT data structure.
+ // This structure contains all the necessary tables and metadata to create a binary OTF file.
+ function fontToSfntTable(font) {
+ var xMins = [];
+ var yMins = [];
+ var xMaxs = [];
+ var yMaxs = [];
+ var advanceWidths = [];
+ var leftSideBearings = [];
+ var rightSideBearings = [];
+ var firstCharIndex;
+ var lastCharIndex = 0;
+ var ulUnicodeRange1 = 0;
+ var ulUnicodeRange2 = 0;
+ var ulUnicodeRange3 = 0;
+ var ulUnicodeRange4 = 0;
+
+ for (var i = 0; i < font.glyphs.length; i += 1) {
+ var glyph = font.glyphs.get(i);
+ var unicode = glyph.unicode | 0;
+
+ if (isNaN(glyph.advanceWidth)) {
+ throw new Error('Glyph ' + glyph.name + ' (' + i + '): advanceWidth is not a number.');
+ }
+
+ if (firstCharIndex > unicode || firstCharIndex === undefined) {
+ // ignore .notdef char
+ if (unicode > 0) {
+ firstCharIndex = unicode;
+ }
+ }
+
+ if (lastCharIndex < unicode) {
+ lastCharIndex = unicode;
+ }
+
+ var position = os2.getUnicodeRange(unicode);
+ if (position < 32) {
+ ulUnicodeRange1 |= 1 << position;
+ } else if (position < 64) {
+ ulUnicodeRange2 |= 1 << position - 32;
+ } else if (position < 96) {
+ ulUnicodeRange3 |= 1 << position - 64;
+ } else if (position < 123) {
+ ulUnicodeRange4 |= 1 << position - 96;
+ } else {
+ throw new Error('Unicode ranges bits > 123 are reserved for internal usage');
+ }
+ // Skip non-important characters.
+ if (glyph.name === '.notdef') { continue; }
+ var metrics = glyph.getMetrics();
+ xMins.push(metrics.xMin);
+ yMins.push(metrics.yMin);
+ xMaxs.push(metrics.xMax);
+ yMaxs.push(metrics.yMax);
+ leftSideBearings.push(metrics.leftSideBearing);
+ rightSideBearings.push(metrics.rightSideBearing);
+ advanceWidths.push(glyph.advanceWidth);
+ }
+
+ var globals = {
+ xMin: Math.min.apply(null, xMins),
+ yMin: Math.min.apply(null, yMins),
+ xMax: Math.max.apply(null, xMaxs),
+ yMax: Math.max.apply(null, yMaxs),
+ advanceWidthMax: Math.max.apply(null, advanceWidths),
+ advanceWidthAvg: average(advanceWidths),
+ minLeftSideBearing: Math.min.apply(null, leftSideBearings),
+ maxLeftSideBearing: Math.max.apply(null, leftSideBearings),
+ minRightSideBearing: Math.min.apply(null, rightSideBearings)
+ };
+ globals.ascender = font.ascender;
+ globals.descender = font.descender;
+
+ var headTable = head.make({
+ flags: 3, // 00000011 (baseline for font at y=0; left sidebearing point at x=0)
+ unitsPerEm: font.unitsPerEm,
+ xMin: globals.xMin,
+ yMin: globals.yMin,
+ xMax: globals.xMax,
+ yMax: globals.yMax,
+ lowestRecPPEM: 3,
+ createdTimestamp: font.createdTimestamp
+ });
+
+ var hheaTable = hhea.make({
+ ascender: globals.ascender,
+ descender: globals.descender,
+ advanceWidthMax: globals.advanceWidthMax,
+ minLeftSideBearing: globals.minLeftSideBearing,
+ minRightSideBearing: globals.minRightSideBearing,
+ xMaxExtent: globals.maxLeftSideBearing + (globals.xMax - globals.xMin),
+ numberOfHMetrics: font.glyphs.length
+ });
+
+ var maxpTable = maxp.make(font.glyphs.length);
+
+ var os2Table = os2.make({
+ xAvgCharWidth: Math.round(globals.advanceWidthAvg),
+ usWeightClass: font.tables.os2.usWeightClass,
+ usWidthClass: font.tables.os2.usWidthClass,
+ usFirstCharIndex: firstCharIndex,
+ usLastCharIndex: lastCharIndex,
+ ulUnicodeRange1: ulUnicodeRange1,
+ ulUnicodeRange2: ulUnicodeRange2,
+ ulUnicodeRange3: ulUnicodeRange3,
+ ulUnicodeRange4: ulUnicodeRange4,
+ fsSelection: font.tables.os2.fsSelection, // REGULAR
+ // See http://typophile.com/node/13081 for more info on vertical metrics.
+ // We get metrics for typical characters (such as "x" for xHeight).
+ // We provide some fallback characters if characters are unavailable: their
+ // ordering was chosen experimentally.
+ sTypoAscender: globals.ascender,
+ sTypoDescender: globals.descender,
+ sTypoLineGap: 0,
+ usWinAscent: globals.yMax,
+ usWinDescent: Math.abs(globals.yMin),
+ ulCodePageRange1: 1, // FIXME: hard-code Latin 1 support for now
+ sxHeight: metricsForChar(font, 'xyvw', {yMax: Math.round(globals.ascender / 2)}).yMax,
+ sCapHeight: metricsForChar(font, 'HIKLEFJMNTZBDPRAGOQSUVWXY', globals).yMax,
+ usDefaultChar: font.hasChar(' ') ? 32 : 0, // Use space as the default character, if available.
+ usBreakChar: font.hasChar(' ') ? 32 : 0 // Use space as the break character, if available.
+ });
+
+ var hmtxTable = hmtx.make(font.glyphs);
+ var cmapTable = cmap.make(font.glyphs);
+
+ var englishFamilyName = font.getEnglishName('fontFamily');
+ var englishStyleName = font.getEnglishName('fontSubfamily');
+ var englishFullName = englishFamilyName + ' ' + englishStyleName;
+ var postScriptName = font.getEnglishName('postScriptName');
+ if (!postScriptName) {
+ postScriptName = englishFamilyName.replace(/\s/g, '') + '-' + englishStyleName;
+ }
+
+ var names = {};
+ for (var n in font.names) {
+ names[n] = font.names[n];
+ }
+
+ if (!names.uniqueID) {
+ names.uniqueID = {en: font.getEnglishName('manufacturer') + ':' + englishFullName};
+ }
+
+ if (!names.postScriptName) {
+ names.postScriptName = {en: postScriptName};
+ }
+
+ if (!names.preferredFamily) {
+ names.preferredFamily = font.names.fontFamily;
+ }
+
+ if (!names.preferredSubfamily) {
+ names.preferredSubfamily = font.names.fontSubfamily;
+ }
+
+ var languageTags = [];
+ var nameTable = _name.make(names, languageTags);
+ var ltagTable = (languageTags.length > 0 ? ltag.make(languageTags) : undefined);
+
+ var postTable = post.make();
+ var cffTable = cff.make(font.glyphs, {
+ version: font.getEnglishName('version'),
+ fullName: englishFullName,
+ familyName: englishFamilyName,
+ weightName: englishStyleName,
+ postScriptName: postScriptName,
+ unitsPerEm: font.unitsPerEm,
+ fontBBox: [0, globals.yMin, globals.ascender, globals.advanceWidthMax]
+ });
+
+ var metaTable = (font.metas && Object.keys(font.metas).length > 0) ? meta.make(font.metas) : undefined;
+
+ // The order does not matter because makeSfntTable() will sort them.
+ var tables = [headTable, hheaTable, maxpTable, os2Table, nameTable, cmapTable, postTable, cffTable, hmtxTable];
+ if (ltagTable) {
+ tables.push(ltagTable);
+ }
+ // Optional tables
+ if (font.tables.gsub) {
+ tables.push(gsub.make(font.tables.gsub));
+ }
+ if (metaTable) {
+ tables.push(metaTable);
+ }
+
+ var sfntTable = makeSfntTable(tables);
+
+ // Compute the font's checkSum and store it in head.checkSumAdjustment.
+ var bytes = sfntTable.encode();
+ var checkSum = computeCheckSum(bytes);
+ var tableFields = sfntTable.fields;
+ var checkSumAdjusted = false;
+ for (var i$1 = 0; i$1 < tableFields.length; i$1 += 1) {
+ if (tableFields[i$1].name === 'head table') {
+ tableFields[i$1].value.checkSumAdjustment = 0xB1B0AFBA - checkSum;
+ checkSumAdjusted = true;
+ break;
+ }
+ }
+
+ if (!checkSumAdjusted) {
+ throw new Error('Could not find head table with checkSum to adjust.');
+ }
+
+ return sfntTable;
+ }
-/*
-* Executes the hinting program for a glyph.
-*/
-function execGlyph(glyph, prepState) {
- // original point positions
- var xScale = prepState.ppem / prepState.font.unitsPerEm;
- var yScale = xScale;
- var components = glyph.components;
- var contours;
- var gZone;
- var state;
-
- State.prototype = prepState;
- if (!components) {
- state = new State('glyf', glyph.instructions);
- if (DEBUG) {
- console.log('---EXEC GLYPH---');
- state.step = -1;
- }
- execComponent(glyph, state, xScale, yScale);
- gZone = state.gZone;
- } else {
- var font = prepState.font;
- gZone = [];
- contours = [];
- for (var i = 0; i < components.length; i++) {
- var c = components[i];
- var cg = font.glyphs.get(c.glyphIndex);
-
- state = new State('glyf', cg.instructions);
-
- if (DEBUG) {
- console.log('---EXEC COMP ' + i + '---');
- state.step = -1;
- }
+ var sfnt = { make: makeSfntTable, fontToTable: fontToSfntTable, computeCheckSum: computeCheckSum };
+
+ // The Layout object is the prototype of Substitution objects, and provides
+
+ function searchTag(arr, tag) {
+ /* jshint bitwise: false */
+ var imin = 0;
+ var imax = arr.length - 1;
+ while (imin <= imax) {
+ var imid = (imin + imax) >>> 1;
+ var val = arr[imid].tag;
+ if (val === tag) {
+ return imid;
+ } else if (val < tag) {
+ imin = imid + 1;
+ } else { imax = imid - 1; }
+ }
+ // Not found: return -1-insertion point
+ return -imin - 1;
+ }
- execComponent(cg, state, xScale, yScale);
- // appends the computed points to the result array
- // post processes the component points
- var dx = Math.round(c.dx * xScale);
- var dy = Math.round(c.dy * yScale);
- var gz = state.gZone;
- var cc = state.contours;
- for (var pi = 0; pi < gz.length; pi++) {
- var p = gz[pi];
- p.xTouched = p.yTouched = false;
- p.xo = p.x = p.x + dx;
- p.yo = p.y = p.y + dy;
- }
+ function binSearch(arr, value) {
+ /* jshint bitwise: false */
+ var imin = 0;
+ var imax = arr.length - 1;
+ while (imin <= imax) {
+ var imid = (imin + imax) >>> 1;
+ var val = arr[imid];
+ if (val === value) {
+ return imid;
+ } else if (val < value) {
+ imin = imid + 1;
+ } else { imax = imid - 1; }
+ }
+ // Not found: return -1-insertion point
+ return -imin - 1;
+ }
- var gLen = gZone.length;
- gZone.push.apply(gZone, gz);
- for (var j = 0; j < cc.length; j++) {
- contours.push(cc[j] + gLen);
- }
- }
+ // binary search in a list of ranges (coverage, class definition)
+ function searchRange(ranges, value) {
+ // jshint bitwise: false
+ var range;
+ var imin = 0;
+ var imax = ranges.length - 1;
+ while (imin <= imax) {
+ var imid = (imin + imax) >>> 1;
+ range = ranges[imid];
+ var start = range.start;
+ if (start === value) {
+ return range;
+ } else if (start < value) {
+ imin = imid + 1;
+ } else { imax = imid - 1; }
+ }
+ if (imin > 0) {
+ range = ranges[imin - 1];
+ if (value > range.end) { return 0; }
+ return range;
+ }
+ }
- if (glyph.instructions && !state.inhibitGridFit) {
- // the composite has instructions on its own
- state = new State('glyf', glyph.instructions);
+ /**
+ * @exports opentype.Layout
+ * @class
+ */
+ function Layout(font, tableName) {
+ this.font = font;
+ this.tableName = tableName;
+ }
- state.gZone = state.z0 = state.z1 = state.z2 = gZone;
+ Layout.prototype = {
+
+ /**
+ * Binary search an object by "tag" property
+ * @instance
+ * @function searchTag
+ * @memberof opentype.Layout
+ * @param {Array} arr
+ * @param {string} tag
+ * @return {number}
+ */
+ searchTag: searchTag,
+
+ /**
+ * Binary search in a list of numbers
+ * @instance
+ * @function binSearch
+ * @memberof opentype.Layout
+ * @param {Array} arr
+ * @param {number} value
+ * @return {number}
+ */
+ binSearch: binSearch,
+
+ /**
+ * Get or create the Layout table (GSUB, GPOS etc).
+ * @param {boolean} create - Whether to create a new one.
+ * @return {Object} The GSUB or GPOS table.
+ */
+ getTable: function(create) {
+ var layout = this.font.tables[this.tableName];
+ if (!layout && create) {
+ layout = this.font.tables[this.tableName] = this.createDefaultTable();
+ }
+ return layout;
+ },
+
+ /**
+ * Returns all scripts in the substitution table.
+ * @instance
+ * @return {Array}
+ */
+ getScriptNames: function() {
+ var layout = this.getTable();
+ if (!layout) { return []; }
+ return layout.scripts.map(function(script) {
+ return script.tag;
+ });
+ },
+
+ /**
+ * Returns the best bet for a script name.
+ * Returns 'DFLT' if it exists.
+ * If not, returns 'latn' if it exists.
+ * If neither exist, returns undefined.
+ */
+ getDefaultScriptName: function() {
+ var layout = this.getTable();
+ if (!layout) { return; }
+ var hasLatn = false;
+ for (var i = 0; i < layout.scripts.length; i++) {
+ var name = layout.scripts[i].tag;
+ if (name === 'DFLT') { return name; }
+ if (name === 'latn') { hasLatn = true; }
+ }
+ if (hasLatn) { return 'latn'; }
+ },
+
+ /**
+ * Returns all LangSysRecords in the given script.
+ * @instance
+ * @param {string} [script='DFLT']
+ * @param {boolean} create - forces the creation of this script table if it doesn't exist.
+ * @return {Object} An object with tag and script properties.
+ */
+ getScriptTable: function(script, create) {
+ var layout = this.getTable(create);
+ if (layout) {
+ script = script || 'DFLT';
+ var scripts = layout.scripts;
+ var pos = searchTag(layout.scripts, script);
+ if (pos >= 0) {
+ return scripts[pos].script;
+ } else if (create) {
+ var scr = {
+ tag: script,
+ script: {
+ defaultLangSys: {reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: []},
+ langSysRecords: []
+ }
+ };
+ scripts.splice(-1 - pos, 0, scr);
+ return scr.script;
+ }
+ }
+ },
+
+ /**
+ * Returns a language system table
+ * @instance
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dlft']
+ * @param {boolean} create - forces the creation of this langSysTable if it doesn't exist.
+ * @return {Object}
+ */
+ getLangSysTable: function(script, language, create) {
+ var scriptTable = this.getScriptTable(script, create);
+ if (scriptTable) {
+ if (!language || language === 'dflt' || language === 'DFLT') {
+ return scriptTable.defaultLangSys;
+ }
+ var pos = searchTag(scriptTable.langSysRecords, language);
+ if (pos >= 0) {
+ return scriptTable.langSysRecords[pos].langSys;
+ } else if (create) {
+ var langSysRecord = {
+ tag: language,
+ langSys: {reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: []}
+ };
+ scriptTable.langSysRecords.splice(-1 - pos, 0, langSysRecord);
+ return langSysRecord.langSys;
+ }
+ }
+ },
+
+ /**
+ * Get a specific feature table.
+ * @instance
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dlft']
+ * @param {string} feature - One of the codes listed at https://www.microsoft.com/typography/OTSPEC/featurelist.htm
+ * @param {boolean} create - forces the creation of the feature table if it doesn't exist.
+ * @return {Object}
+ */
+ getFeatureTable: function(script, language, feature, create) {
+ var langSysTable = this.getLangSysTable(script, language, create);
+ if (langSysTable) {
+ var featureRecord;
+ var featIndexes = langSysTable.featureIndexes;
+ var allFeatures = this.font.tables[this.tableName].features;
+ // The FeatureIndex array of indices is in arbitrary order,
+ // even if allFeatures is sorted alphabetically by feature tag.
+ for (var i = 0; i < featIndexes.length; i++) {
+ featureRecord = allFeatures[featIndexes[i]];
+ if (featureRecord.tag === feature) {
+ return featureRecord.feature;
+ }
+ }
+ if (create) {
+ var index = allFeatures.length;
+ // Automatic ordering of features would require to shift feature indexes in the script list.
+ check.assert(index === 0 || feature >= allFeatures[index - 1].tag, 'Features must be added in alphabetical order.');
+ featureRecord = {
+ tag: feature,
+ feature: { params: 0, lookupListIndexes: [] }
+ };
+ allFeatures.push(featureRecord);
+ featIndexes.push(index);
+ return featureRecord.feature;
+ }
+ }
+ },
+
+ /**
+ * Get the lookup tables of a given type for a script/language/feature.
+ * @instance
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dlft']
+ * @param {string} feature - 4-letter feature code
+ * @param {number} lookupType - 1 to 9
+ * @param {boolean} create - forces the creation of the lookup table if it doesn't exist, with no subtables.
+ * @return {Object[]}
+ */
+ getLookupTables: function(script, language, feature, lookupType, create) {
+ var featureTable = this.getFeatureTable(script, language, feature, create);
+ var tables = [];
+ if (featureTable) {
+ var lookupTable;
+ var lookupListIndexes = featureTable.lookupListIndexes;
+ var allLookups = this.font.tables[this.tableName].lookups;
+ // lookupListIndexes are in no particular order, so use naive search.
+ for (var i = 0; i < lookupListIndexes.length; i++) {
+ lookupTable = allLookups[lookupListIndexes[i]];
+ if (lookupTable.lookupType === lookupType) {
+ tables.push(lookupTable);
+ }
+ }
+ if (tables.length === 0 && create) {
+ lookupTable = {
+ lookupType: lookupType,
+ lookupFlag: 0,
+ subtables: [],
+ markFilteringSet: undefined
+ };
+ var index = allLookups.length;
+ allLookups.push(lookupTable);
+ lookupListIndexes.push(index);
+ return [lookupTable];
+ }
+ }
+ return tables;
+ },
+
+ /**
+ * Find a glyph in a class definition table
+ * https://docs.microsoft.com/en-us/typography/opentype/spec/chapter2#class-definition-table
+ * @param {object} classDefTable - an OpenType Layout class definition table
+ * @param {number} glyphIndex - the index of the glyph to find
+ * @returns {number} -1 if not found
+ */
+ getGlyphClass: function(classDefTable, glyphIndex) {
+ switch (classDefTable.format) {
+ case 1:
+ if (classDefTable.startGlyph <= glyphIndex && glyphIndex < classDefTable.startGlyph + classDefTable.classes.length) {
+ return classDefTable.classes[glyphIndex - classDefTable.startGlyph];
+ }
+ return 0;
+ case 2:
+ var range = searchRange(classDefTable.ranges, glyphIndex);
+ return range ? range.classId : 0;
+ }
+ },
+
+ /**
+ * Find a glyph in a coverage table
+ * https://docs.microsoft.com/en-us/typography/opentype/spec/chapter2#coverage-table
+ * @param {object} coverageTable - an OpenType Layout coverage table
+ * @param {number} glyphIndex - the index of the glyph to find
+ * @returns {number} -1 if not found
+ */
+ getCoverageIndex: function(coverageTable, glyphIndex) {
+ switch (coverageTable.format) {
+ case 1:
+ var index = binSearch(coverageTable.glyphs, glyphIndex);
+ return index >= 0 ? index : -1;
+ case 2:
+ var range = searchRange(coverageTable.ranges, glyphIndex);
+ return range ? range.index + glyphIndex - range.start : -1;
+ }
+ },
+
+ /**
+ * Returns the list of glyph indexes of a coverage table.
+ * Format 1: the list is stored raw
+ * Format 2: compact list as range records.
+ * @instance
+ * @param {Object} coverageTable
+ * @return {Array}
+ */
+ expandCoverage: function(coverageTable) {
+ if (coverageTable.format === 1) {
+ return coverageTable.glyphs;
+ } else {
+ var glyphs = [];
+ var ranges = coverageTable.ranges;
+ for (var i = 0; i < ranges.length; i++) {
+ var range = ranges[i];
+ var start = range.start;
+ var end = range.end;
+ for (var j = start; j <= end; j++) {
+ glyphs.push(j);
+ }
+ }
+ return glyphs;
+ }
+ }
+
+ };
+
+ // The Position object provides utility methods to manipulate
+
+ /**
+ * @exports opentype.Position
+ * @class
+ * @extends opentype.Layout
+ * @param {opentype.Font}
+ * @constructor
+ */
+ function Position(font) {
+ Layout.call(this, font, 'gpos');
+ }
- state.contours = contours;
+ Position.prototype = Layout.prototype;
+
+ /**
+ * Init some data for faster and easier access later.
+ */
+ Position.prototype.init = function() {
+ var script = this.getDefaultScriptName();
+ this.defaultKerningTables = this.getKerningTables(script);
+ };
+
+ /**
+ * Find a glyph pair in a list of lookup tables of type 2 and retrieve the xAdvance kerning value.
+ *
+ * @param {integer} leftIndex - left glyph index
+ * @param {integer} rightIndex - right glyph index
+ * @returns {integer}
+ */
+ Position.prototype.getKerningValue = function(kerningLookups, leftIndex, rightIndex) {
+ var this$1 = this;
+
+ for (var i = 0; i < kerningLookups.length; i++) {
+ var subtables = kerningLookups[i].subtables;
+ for (var j = 0; j < subtables.length; j++) {
+ var subtable = subtables[j];
+ var covIndex = this$1.getCoverageIndex(subtable.coverage, leftIndex);
+ if (covIndex < 0) { continue; }
+ switch (subtable.posFormat) {
+ case 1:
+ // Search Pair Adjustment Positioning Format 1
+ var pairSet = subtable.pairSets[covIndex];
+ for (var k = 0; k < pairSet.length; k++) {
+ var pair = pairSet[k];
+ if (pair.secondGlyph === rightIndex) {
+ return pair.value1 && pair.value1.xAdvance || 0;
+ }
+ }
+ break; // left glyph found, not right glyph - try next subtable
+ case 2:
+ // Search Pair Adjustment Positioning Format 2
+ var class1 = this$1.getGlyphClass(subtable.classDef1, leftIndex);
+ var class2 = this$1.getGlyphClass(subtable.classDef2, rightIndex);
+ var pair$1 = subtable.classRecords[class1][class2];
+ return pair$1.value1 && pair$1.value1.xAdvance || 0;
+ }
+ }
+ }
+ return 0;
+ };
+
+ /**
+ * List all kerning lookup tables.
+ *
+ * @param {string} [script='DFLT'] - use font.position.getDefaultScriptName() for a better default value
+ * @param {string} [language='dflt']
+ * @return {object[]} The list of kerning lookup tables (may be empty), or undefined if there is no GPOS table (and we should use the kern table)
+ */
+ Position.prototype.getKerningTables = function(script, language) {
+ if (this.font.tables.gpos) {
+ return this.getLookupTables(script, language, 'kern', 2);
+ }
+ };
+
+ // The Substitution object provides utility methods to manipulate
+
+ /**
+ * @exports opentype.Substitution
+ * @class
+ * @extends opentype.Layout
+ * @param {opentype.Font}
+ * @constructor
+ */
+ function Substitution(font) {
+ Layout.call(this, font, 'gsub');
+ }
- // note: HPZero cannot be used here, since
- // the point might be modified
- gZone.push(
- new HPoint(0, 0),
- new HPoint(Math.round(glyph.advanceWidth * xScale), 0)
- );
+ // Check if 2 arrays of primitives are equal.
+ function arraysEqual(ar1, ar2) {
+ var n = ar1.length;
+ if (n !== ar2.length) { return false; }
+ for (var i = 0; i < n; i++) {
+ if (ar1[i] !== ar2[i]) { return false; }
+ }
+ return true;
+ }
- if (DEBUG) {
- console.log('---EXEC COMPOSITE---');
- state.step = -1;
- }
+ // Find the first subtable of a lookup table in a particular format.
+ function getSubstFormat(lookupTable, format, defaultSubtable) {
+ var subtables = lookupTable.subtables;
+ for (var i = 0; i < subtables.length; i++) {
+ var subtable = subtables[i];
+ if (subtable.substFormat === format) {
+ return subtable;
+ }
+ }
+ if (defaultSubtable) {
+ subtables.push(defaultSubtable);
+ return defaultSubtable;
+ }
+ return undefined;
+ }
- exec(state);
+ Substitution.prototype = Layout.prototype;
+
+ /**
+ * Create a default GSUB table.
+ * @return {Object} gsub - The GSUB table.
+ */
+ Substitution.prototype.createDefaultTable = function() {
+ // Generate a default empty GSUB table with just a DFLT script and dflt lang sys.
+ return {
+ version: 1,
+ scripts: [{
+ tag: 'DFLT',
+ script: {
+ defaultLangSys: { reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: [] },
+ langSysRecords: []
+ }
+ }],
+ features: [],
+ lookups: []
+ };
+ };
+
+ /**
+ * List all single substitutions (lookup type 1) for a given script, language, and feature.
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ * @param {string} feature - 4-character feature name ('aalt', 'salt', 'ss01'...)
+ * @return {Array} substitutions - The list of substitutions.
+ */
+ Substitution.prototype.getSingle = function(feature, script, language) {
+ var this$1 = this;
+
+ var substitutions = [];
+ var lookupTables = this.getLookupTables(script, language, feature, 1);
+ for (var idx = 0; idx < lookupTables.length; idx++) {
+ var subtables = lookupTables[idx].subtables;
+ for (var i = 0; i < subtables.length; i++) {
+ var subtable = subtables[i];
+ var glyphs = this$1.expandCoverage(subtable.coverage);
+ var j = (void 0);
+ if (subtable.substFormat === 1) {
+ var delta = subtable.deltaGlyphId;
+ for (j = 0; j < glyphs.length; j++) {
+ var glyph = glyphs[j];
+ substitutions.push({ sub: glyph, by: glyph + delta });
+ }
+ } else {
+ var substitute = subtable.substitute;
+ for (j = 0; j < glyphs.length; j++) {
+ substitutions.push({ sub: glyphs[j], by: substitute[j] });
+ }
+ }
+ }
+ }
+ return substitutions;
+ };
+
+ /**
+ * List all alternates (lookup type 3) for a given script, language, and feature.
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ * @param {string} feature - 4-character feature name ('aalt', 'salt'...)
+ * @return {Array} alternates - The list of alternates
+ */
+ Substitution.prototype.getAlternates = function(feature, script, language) {
+ var this$1 = this;
+
+ var alternates = [];
+ var lookupTables = this.getLookupTables(script, language, feature, 3);
+ for (var idx = 0; idx < lookupTables.length; idx++) {
+ var subtables = lookupTables[idx].subtables;
+ for (var i = 0; i < subtables.length; i++) {
+ var subtable = subtables[i];
+ var glyphs = this$1.expandCoverage(subtable.coverage);
+ var alternateSets = subtable.alternateSets;
+ for (var j = 0; j < glyphs.length; j++) {
+ alternates.push({ sub: glyphs[j], by: alternateSets[j] });
+ }
+ }
+ }
+ return alternates;
+ };
+
+ /**
+ * List all ligatures (lookup type 4) for a given script, language, and feature.
+ * The result is an array of ligature objects like { sub: [ids], by: id }
+ * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...)
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ * @return {Array} ligatures - The list of ligatures.
+ */
+ Substitution.prototype.getLigatures = function(feature, script, language) {
+ var this$1 = this;
+
+ var ligatures = [];
+ var lookupTables = this.getLookupTables(script, language, feature, 4);
+ for (var idx = 0; idx < lookupTables.length; idx++) {
+ var subtables = lookupTables[idx].subtables;
+ for (var i = 0; i < subtables.length; i++) {
+ var subtable = subtables[i];
+ var glyphs = this$1.expandCoverage(subtable.coverage);
+ var ligatureSets = subtable.ligatureSets;
+ for (var j = 0; j < glyphs.length; j++) {
+ var startGlyph = glyphs[j];
+ var ligSet = ligatureSets[j];
+ for (var k = 0; k < ligSet.length; k++) {
+ var lig = ligSet[k];
+ ligatures.push({
+ sub: [startGlyph].concat(lig.components),
+ by: lig.ligGlyph
+ });
+ }
+ }
+ }
+ }
+ return ligatures;
+ };
+
+ /**
+ * Add or modify a single substitution (lookup type 1)
+ * Format 2, more flexible, is always used.
+ * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...)
+ * @param {Object} substitution - { sub: id, delta: number } for format 1 or { sub: id, by: id } for format 2.
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ */
+ Substitution.prototype.addSingle = function(feature, substitution, script, language) {
+ var lookupTable = this.getLookupTables(script, language, feature, 1, true)[0];
+ var subtable = getSubstFormat(lookupTable, 2, { // lookup type 1 subtable, format 2, coverage format 1
+ substFormat: 2,
+ coverage: {format: 1, glyphs: []},
+ substitute: []
+ });
+ check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format);
+ var coverageGlyph = substitution.sub;
+ var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph);
+ if (pos < 0) {
+ pos = -1 - pos;
+ subtable.coverage.glyphs.splice(pos, 0, coverageGlyph);
+ subtable.substitute.splice(pos, 0, 0);
+ }
+ subtable.substitute[pos] = substitution.by;
+ };
+
+ /**
+ * Add or modify an alternate substitution (lookup type 1)
+ * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...)
+ * @param {Object} substitution - { sub: id, by: [ids] }
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ */
+ Substitution.prototype.addAlternate = function(feature, substitution, script, language) {
+ var lookupTable = this.getLookupTables(script, language, feature, 3, true)[0];
+ var subtable = getSubstFormat(lookupTable, 1, { // lookup type 3 subtable, format 1, coverage format 1
+ substFormat: 1,
+ coverage: {format: 1, glyphs: []},
+ alternateSets: []
+ });
+ check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format);
+ var coverageGlyph = substitution.sub;
+ var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph);
+ if (pos < 0) {
+ pos = -1 - pos;
+ subtable.coverage.glyphs.splice(pos, 0, coverageGlyph);
+ subtable.alternateSets.splice(pos, 0, 0);
+ }
+ subtable.alternateSets[pos] = substitution.by;
+ };
+
+ /**
+ * Add a ligature (lookup type 4)
+ * Ligatures with more components must be stored ahead of those with fewer components in order to be found
+ * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...)
+ * @param {Object} ligature - { sub: [ids], by: id }
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ */
+ Substitution.prototype.addLigature = function(feature, ligature, script, language) {
+ var lookupTable = this.getLookupTables(script, language, feature, 4, true)[0];
+ var subtable = lookupTable.subtables[0];
+ if (!subtable) {
+ subtable = { // lookup type 4 subtable, format 1, coverage format 1
+ substFormat: 1,
+ coverage: { format: 1, glyphs: [] },
+ ligatureSets: []
+ };
+ lookupTable.subtables[0] = subtable;
+ }
+ check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format);
+ var coverageGlyph = ligature.sub[0];
+ var ligComponents = ligature.sub.slice(1);
+ var ligatureTable = {
+ ligGlyph: ligature.by,
+ components: ligComponents
+ };
+ var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph);
+ if (pos >= 0) {
+ // ligatureSet already exists
+ var ligatureSet = subtable.ligatureSets[pos];
+ for (var i = 0; i < ligatureSet.length; i++) {
+ // If ligature already exists, return.
+ if (arraysEqual(ligatureSet[i].components, ligComponents)) {
+ return;
+ }
+ }
+ // ligature does not exist: add it.
+ ligatureSet.push(ligatureTable);
+ } else {
+ // Create a new ligatureSet and add coverage for the first glyph.
+ pos = -1 - pos;
+ subtable.coverage.glyphs.splice(pos, 0, coverageGlyph);
+ subtable.ligatureSets.splice(pos, 0, [ligatureTable]);
+ }
+ };
+
+ /**
+ * List all feature data for a given script and language.
+ * @param {string} feature - 4-letter feature name
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ * @return {Array} substitutions - The list of substitutions.
+ */
+ Substitution.prototype.getFeature = function(feature, script, language) {
+ if (/ss\d\d/.test(feature)) {
+ // ss01 - ss20
+ return this.getSingle(feature, script, language);
+ }
+ switch (feature) {
+ case 'aalt':
+ case 'salt':
+ return this.getSingle(feature, script, language)
+ .concat(this.getAlternates(feature, script, language));
+ case 'dlig':
+ case 'liga':
+ case 'rlig': return this.getLigatures(feature, script, language);
+ }
+ return undefined;
+ };
+
+ /**
+ * Add a substitution to a feature for a given script and language.
+ * @param {string} feature - 4-letter feature name
+ * @param {Object} sub - the substitution to add (an object like { sub: id or [ids], by: id or [ids] })
+ * @param {string} [script='DFLT']
+ * @param {string} [language='dflt']
+ */
+ Substitution.prototype.add = function(feature, sub, script, language) {
+ if (/ss\d\d/.test(feature)) {
+ // ss01 - ss20
+ return this.addSingle(feature, sub, script, language);
+ }
+ switch (feature) {
+ case 'aalt':
+ case 'salt':
+ if (typeof sub.by === 'number') {
+ return this.addSingle(feature, sub, script, language);
+ }
+ return this.addAlternate(feature, sub, script, language);
+ case 'dlig':
+ case 'liga':
+ case 'rlig':
+ return this.addLigature(feature, sub, script, language);
+ }
+ return undefined;
+ };
+
+ function isBrowser() {
+ return typeof window !== 'undefined';
+ }
- gZone.length -= 2;
- }
- }
+ function nodeBufferToArrayBuffer(buffer) {
+ var ab = new ArrayBuffer(buffer.length);
+ var view = new Uint8Array(ab);
+ for (var i = 0; i < buffer.length; ++i) {
+ view[i] = buffer[i];
+ }
- return gZone;
-}
+ return ab;
+ }
-/*
-* Executes the hinting program for a componenet of a multi-component glyph
-* or of the glyph itself by a non-component glyph.
-*/
-function execComponent(glyph, state, xScale, yScale)
-{
- var points = glyph.points || [];
- var pLen = points.length;
- var gZone = state.gZone = state.z0 = state.z1 = state.z2 = [];
- var contours = state.contours = [];
- var i;
+ function arrayBufferToNodeBuffer(ab) {
+ var buffer = new Buffer(ab.byteLength);
+ var view = new Uint8Array(ab);
+ for (var i = 0; i < buffer.length; ++i) {
+ buffer[i] = view[i];
+ }
- // Scales the original points and
- // makes copies for the hinted points.
- var cp; // current point
- for (i = 0; i < pLen; i++) {
- cp = points[i];
-
- gZone[i] = new HPoint(
- cp.x * xScale,
- cp.y * yScale,
- cp.lastPointOfContour,
- cp.onCurve
- );
- }
+ return buffer;
+ }
- // Chain links the contours.
- var sp; // start point
- var np; // next point
+ function checkArgument(expression, message) {
+ if (!expression) {
+ throw message;
+ }
+ }
- for (i = 0; i < pLen; i++) {
- cp = gZone[i];
+ // The `glyf` table describes the glyphs in TrueType outline format.
+
+ // Parse the coordinate data for a glyph.
+ function parseGlyphCoordinate(p, flag, previousValue, shortVectorBitMask, sameBitMask) {
+ var v;
+ if ((flag & shortVectorBitMask) > 0) {
+ // The coordinate is 1 byte long.
+ v = p.parseByte();
+ // The `same` bit is re-used for short values to signify the sign of the value.
+ if ((flag & sameBitMask) === 0) {
+ v = -v;
+ }
+
+ v = previousValue + v;
+ } else {
+ // The coordinate is 2 bytes long.
+ // If the `same` bit is set, the coordinate is the same as the previous coordinate.
+ if ((flag & sameBitMask) > 0) {
+ v = previousValue;
+ } else {
+ // Parse the coordinate as a signed 16-bit delta value.
+ v = previousValue + p.parseShort();
+ }
+ }
+
+ return v;
+ }
- if (!sp) {
- sp = cp;
- contours.push(i);
- }
+ // Parse a TrueType glyph.
+ function parseGlyph(glyph, data, start) {
+ var p = new parse.Parser(data, start);
+ glyph.numberOfContours = p.parseShort();
+ glyph._xMin = p.parseShort();
+ glyph._yMin = p.parseShort();
+ glyph._xMax = p.parseShort();
+ glyph._yMax = p.parseShort();
+ var flags;
+ var flag;
+
+ if (glyph.numberOfContours > 0) {
+ // This glyph is not a composite.
+ var endPointIndices = glyph.endPointIndices = [];
+ for (var i = 0; i < glyph.numberOfContours; i += 1) {
+ endPointIndices.push(p.parseUShort());
+ }
+
+ glyph.instructionLength = p.parseUShort();
+ glyph.instructions = [];
+ for (var i$1 = 0; i$1 < glyph.instructionLength; i$1 += 1) {
+ glyph.instructions.push(p.parseByte());
+ }
+
+ var numberOfCoordinates = endPointIndices[endPointIndices.length - 1] + 1;
+ flags = [];
+ for (var i$2 = 0; i$2 < numberOfCoordinates; i$2 += 1) {
+ flag = p.parseByte();
+ flags.push(flag);
+ // If bit 3 is set, we repeat this flag n times, where n is the next byte.
+ if ((flag & 8) > 0) {
+ var repeatCount = p.parseByte();
+ for (var j = 0; j < repeatCount; j += 1) {
+ flags.push(flag);
+ i$2 += 1;
+ }
+ }
+ }
+
+ check.argument(flags.length === numberOfCoordinates, 'Bad flags.');
+
+ if (endPointIndices.length > 0) {
+ var points = [];
+ var point;
+ // X/Y coordinates are relative to the previous point, except for the first point which is relative to 0,0.
+ if (numberOfCoordinates > 0) {
+ for (var i$3 = 0; i$3 < numberOfCoordinates; i$3 += 1) {
+ flag = flags[i$3];
+ point = {};
+ point.onCurve = !!(flag & 1);
+ point.lastPointOfContour = endPointIndices.indexOf(i$3) >= 0;
+ points.push(point);
+ }
+
+ var px = 0;
+ for (var i$4 = 0; i$4 < numberOfCoordinates; i$4 += 1) {
+ flag = flags[i$4];
+ point = points[i$4];
+ point.x = parseGlyphCoordinate(p, flag, px, 2, 16);
+ px = point.x;
+ }
+
+ var py = 0;
+ for (var i$5 = 0; i$5 < numberOfCoordinates; i$5 += 1) {
+ flag = flags[i$5];
+ point = points[i$5];
+ point.y = parseGlyphCoordinate(p, flag, py, 4, 32);
+ py = point.y;
+ }
+ }
+
+ glyph.points = points;
+ } else {
+ glyph.points = [];
+ }
+ } else if (glyph.numberOfContours === 0) {
+ glyph.points = [];
+ } else {
+ glyph.isComposite = true;
+ glyph.points = [];
+ glyph.components = [];
+ var moreComponents = true;
+ while (moreComponents) {
+ flags = p.parseUShort();
+ var component = {
+ glyphIndex: p.parseUShort(),
+ xScale: 1,
+ scale01: 0,
+ scale10: 0,
+ yScale: 1,
+ dx: 0,
+ dy: 0
+ };
+ if ((flags & 1) > 0) {
+ // The arguments are words
+ if ((flags & 2) > 0) {
+ // values are offset
+ component.dx = p.parseShort();
+ component.dy = p.parseShort();
+ } else {
+ // values are matched points
+ component.matchedPoints = [p.parseUShort(), p.parseUShort()];
+ }
+
+ } else {
+ // The arguments are bytes
+ if ((flags & 2) > 0) {
+ // values are offset
+ component.dx = p.parseChar();
+ component.dy = p.parseChar();
+ } else {
+ // values are matched points
+ component.matchedPoints = [p.parseByte(), p.parseByte()];
+ }
+ }
+
+ if ((flags & 8) > 0) {
+ // We have a scale
+ component.xScale = component.yScale = p.parseF2Dot14();
+ } else if ((flags & 64) > 0) {
+ // We have an X / Y scale
+ component.xScale = p.parseF2Dot14();
+ component.yScale = p.parseF2Dot14();
+ } else if ((flags & 128) > 0) {
+ // We have a 2x2 transformation
+ component.xScale = p.parseF2Dot14();
+ component.scale01 = p.parseF2Dot14();
+ component.scale10 = p.parseF2Dot14();
+ component.yScale = p.parseF2Dot14();
+ }
+
+ glyph.components.push(component);
+ moreComponents = !!(flags & 32);
+ }
+ if (flags & 0x100) {
+ // We have instructions
+ glyph.instructionLength = p.parseUShort();
+ glyph.instructions = [];
+ for (var i$6 = 0; i$6 < glyph.instructionLength; i$6 += 1) {
+ glyph.instructions.push(p.parseByte());
+ }
+ }
+ }
+ }
- if (cp.lastPointOfContour) {
- cp.nextPointOnContour = sp;
- sp.prevPointOnContour = cp;
- sp = undefined;
- } else {
- np = gZone[i + 1];
- cp.nextPointOnContour = np;
- np.prevPointOnContour = cp;
- }
- }
+ // Transform an array of points and return a new array.
+ function transformPoints(points, transform) {
+ var newPoints = [];
+ for (var i = 0; i < points.length; i += 1) {
+ var pt = points[i];
+ var newPt = {
+ x: transform.xScale * pt.x + transform.scale01 * pt.y + transform.dx,
+ y: transform.scale10 * pt.x + transform.yScale * pt.y + transform.dy,
+ onCurve: pt.onCurve,
+ lastPointOfContour: pt.lastPointOfContour
+ };
+ newPoints.push(newPt);
+ }
+
+ return newPoints;
+ }
- if (state.inhibitGridFit) return;
+ function getContours(points) {
+ var contours = [];
+ var currentContour = [];
+ for (var i = 0; i < points.length; i += 1) {
+ var pt = points[i];
+ currentContour.push(pt);
+ if (pt.lastPointOfContour) {
+ contours.push(currentContour);
+ currentContour = [];
+ }
+ }
+
+ check.argument(currentContour.length === 0, 'There are still points left in the current contour.');
+ return contours;
+ }
- gZone.push(
- new HPoint(0, 0),
- new HPoint(Math.round(glyph.advanceWidth * xScale), 0)
- );
+ // Convert the TrueType glyph outline to a Path.
+ function getPath(points) {
+ var p = new Path();
+ if (!points) {
+ return p;
+ }
+
+ var contours = getContours(points);
+
+ for (var contourIndex = 0; contourIndex < contours.length; ++contourIndex) {
+ var contour = contours[contourIndex];
+
+ var prev = null;
+ var curr = contour[contour.length - 1];
+ var next = contour[0];
+
+ if (curr.onCurve) {
+ p.moveTo(curr.x, curr.y);
+ } else {
+ if (next.onCurve) {
+ p.moveTo(next.x, next.y);
+ } else {
+ // If both first and last points are off-curve, start at their middle.
+ var start = {x: (curr.x + next.x) * 0.5, y: (curr.y + next.y) * 0.5};
+ p.moveTo(start.x, start.y);
+ }
+ }
+
+ for (var i = 0; i < contour.length; ++i) {
+ prev = curr;
+ curr = next;
+ next = contour[(i + 1) % contour.length];
+
+ if (curr.onCurve) {
+ // This is a straight line.
+ p.lineTo(curr.x, curr.y);
+ } else {
+ var prev2 = prev;
+ var next2 = next;
+
+ if (!prev.onCurve) {
+ prev2 = { x: (curr.x + prev.x) * 0.5, y: (curr.y + prev.y) * 0.5 };
+ }
+
+ if (!next.onCurve) {
+ next2 = { x: (curr.x + next.x) * 0.5, y: (curr.y + next.y) * 0.5 };
+ }
+
+ p.quadraticCurveTo(curr.x, curr.y, next2.x, next2.y);
+ }
+ }
+
+ p.closePath();
+ }
+ return p;
+ }
- exec(state);
+ function buildPath(glyphs, glyph) {
+ if (glyph.isComposite) {
+ for (var j = 0; j < glyph.components.length; j += 1) {
+ var component = glyph.components[j];
+ var componentGlyph = glyphs.get(component.glyphIndex);
+ // Force the ttfGlyphLoader to parse the glyph.
+ componentGlyph.getPath();
+ if (componentGlyph.points) {
+ var transformedPoints = (void 0);
+ if (component.matchedPoints === undefined) {
+ // component positioned by offset
+ transformedPoints = transformPoints(componentGlyph.points, component);
+ } else {
+ // component positioned by matched points
+ if ((component.matchedPoints[0] > glyph.points.length - 1) ||
+ (component.matchedPoints[1] > componentGlyph.points.length - 1)) {
+ throw Error('Matched points out of range in ' + glyph.name);
+ }
+ var firstPt = glyph.points[component.matchedPoints[0]];
+ var secondPt = componentGlyph.points[component.matchedPoints[1]];
+ var transform = {
+ xScale: component.xScale, scale01: component.scale01,
+ scale10: component.scale10, yScale: component.yScale,
+ dx: 0, dy: 0
+ };
+ secondPt = transformPoints([secondPt], transform)[0];
+ transform.dx = firstPt.x - secondPt.x;
+ transform.dy = firstPt.y - secondPt.y;
+ transformedPoints = transformPoints(componentGlyph.points, transform);
+ }
+ glyph.points = glyph.points.concat(transformedPoints);
+ }
+ }
+ }
+
+ return getPath(glyph.points);
+ }
- // Removes the extra points.
- gZone.length -= 2;
+ // Parse all the glyphs according to the offsets from the `loca` table.
+ function parseGlyfTable(data, start, loca, font) {
+ var glyphs = new glyphset.GlyphSet(font);
+
+ // The last element of the loca table is invalid.
+ for (var i = 0; i < loca.length - 1; i += 1) {
+ var offset = loca[i];
+ var nextOffset = loca[i + 1];
+ if (offset !== nextOffset) {
+ glyphs.push(i, glyphset.ttfGlyphLoader(font, i, parseGlyph, data, start + offset, buildPath));
+ } else {
+ glyphs.push(i, glyphset.glyphLoader(font, i));
+ }
+ }
+
+ return glyphs;
+ }
- if (DEBUG) {
- console.log('FINISHED GLYPH', state.stack);
- for (i = 0; i < pLen; i++) {
- console.log(i, gZone[i].x, gZone[i].y);
- }
- }
-}
+ var glyf = { getPath: getPath, parse: parseGlyfTable };
-/*
-* Executes the program loaded in state.
-*/
-function exec(state) {
- var prog = state.prog;
+ /* A TrueType font hinting interpreter.
+ *
+ * (c) 2017 Axel Kittenberger
+ *
+ * This interpreter has been implemented according to this documentation:
+ * https://developer.apple.com/fonts/TrueType-Reference-Manual/RM05/Chap5.html
+ *
+ * According to the documentation F24DOT6 values are used for pixels.
+ * That means calculation is 1/64 pixel accurate and uses integer operations.
+ * However, Javascript has floating point operations by default and only
+ * those are available. One could make a case to simulate the 1/64 accuracy
+ * exactly by truncating after every division operation
+ * (for example with << 0) to get pixel exactly results as other TrueType
+ * implementations. It may make sense since some fonts are pixel optimized
+ * by hand using DELTAP instructions. The current implementation doesn't
+ * and rather uses full floating point precision.
+ *
+ * xScale, yScale and rotation is currently ignored.
+ *
+ * A few non-trivial instructions are missing as I didn't encounter yet
+ * a font that used them to test a possible implementation.
+ *
+ * Some fonts seem to use undocumented features regarding the twilight zone.
+ * Only some of them are implemented as they were encountered.
+ *
+ * The exports.DEBUG statements are removed on the minified distribution file.
+ */
- if (!prog) return;
+ var instructionTable;
+ var exec;
+ var execGlyph;
+ var execComponent;
- var pLen = prog.length;
- var ins;
+ /*
+ * Creates a hinting object.
+ *
+ * There ought to be exactly one
+ * for each truetype font that is used for hinting.
+ */
+ function Hinting(font) {
+ // the font this hinting object is for
+ this.font = font;
+
+ this.getCommands = function (hPoints) {
+ return glyf.getPath(hPoints).commands;
+ };
+
+ // cached states
+ this._fpgmState =
+ this._prepState =
+ undefined;
+
+ // errorState
+ // 0 ... all okay
+ // 1 ... had an error in a glyf,
+ // continue working but stop spamming
+ // the console
+ // 2 ... error at prep, stop hinting at this ppem
+ // 3 ... error at fpeg, stop hinting for this font at all
+ this._errorState = 0;
+ }
- for (state.ip = 0; state.ip < pLen; state.ip++) {
- if (DEBUG) state.step++;
- ins = instructionTable[prog[state.ip]];
+ /*
+ * Not rounding.
+ */
+ function roundOff(v) {
+ return v;
+ }
- if (!ins) {
- throw new Error(
- 'unknown instruction: 0x' +
- Number(prog[state.ip]).toString(16)
- );
- }
+ /*
+ * Rounding to grid.
+ */
+ function roundToGrid(v) {
+ //Rounding in TT is supposed to "symmetrical around zero"
+ return Math.sign(v) * Math.round(Math.abs(v));
+ }
- ins(state);
-
- // very extensive debugging for each step
- /*
- if (DEBUG) {
- var da;
- var i;
- if (state.gZone) {
- da = [];
- for (i = 0; i < state.gZone.length; i++)
- {
- da.push(i + ' ' +
- state.gZone[i].x * 64 + ' ' +
- state.gZone[i].y * 64 + ' ' +
- (state.gZone[i].xTouched ? 'x' : '') +
- (state.gZone[i].yTouched ? 'y' : '')
- );
- }
- console.log('GZ', da);
- }
+ /*
+ * Rounding to double grid.
+ */
+ function roundToDoubleGrid(v) {
+ return Math.sign(v) * Math.round(Math.abs(v * 2)) / 2;
+ }
- if (state.tZone) {
- da = [];
- for (i = 0; i < state.tZone.length; i++) {
- da.push(i + ' ' +
- state.tZone[i].x * 64 + ' ' +
- state.tZone[i].y * 64 + ' ' +
- (state.tZone[i].xTouched ? 'x' : '') +
- (state.tZone[i].yTouched ? 'y' : '')
- );
- }
- console.log('TZ', da);
- }
+ /*
+ * Rounding to half grid.
+ */
+ function roundToHalfGrid(v) {
+ return Math.sign(v) * (Math.round(Math.abs(v) + 0.5) - 0.5);
+ }
- if (state.stack.length > 10) {
- console.log(
- state.stack.length,
- '...', state.stack.slice(state.stack.length - 10)
- );
- } else {
- console.log(state.stack.length, state.stack);
- }
- }
- */
- }
-}
+ /*
+ * Rounding to up to grid.
+ */
+ function roundUpToGrid(v) {
+ return Math.sign(v) * Math.ceil(Math.abs(v));
+ }
-/*
-* Initializes the twilight zone.
-*
-* This is only done if a SZPx instruction
-* refers to the twilight zone.
-*/
-function initTZone(state)
-{
- var tZone = state.tZone = new Array(state.gZone.length);
-
- // no idea if this is actually correct...
- for (var i = 0; i < tZone.length; i++)
- {
- tZone[i] = new HPoint(0, 0);
- }
-}
+ /*
+ * Rounding to down to grid.
+ */
+ function roundDownToGrid(v) {
+ return Math.sign(v) * Math.floor(Math.abs(v));
+ }
-/*
-* Skips the instruction pointer ahead over an IF/ELSE block.
-* handleElse .. if true breaks on mathing ELSE
-*/
-function skip(state, handleElse)
-{
- var prog = state.prog;
- var ip = state.ip;
- var nesting = 1;
- var ins;
+ /*
+ * Super rounding.
+ */
+ var roundSuper = function (v) {
+ var period = this.srPeriod;
+ var phase = this.srPhase;
+ var threshold = this.srThreshold;
+ var sign = 1;
+
+ if (v < 0) {
+ v = -v;
+ sign = -1;
+ }
+
+ v += threshold - phase;
+
+ v = Math.trunc(v / period) * period;
+
+ v += phase;
+
+ // according to http://xgridfit.sourceforge.net/round.html
+ if (v < 0) { return phase * sign; }
+
+ return v * sign;
+ };
+
+ /*
+ * Unit vector of x-axis.
+ */
+ var xUnitVector = {
+ x: 1,
+
+ y: 0,
+
+ axis: 'x',
+
+ // Gets the projected distance between two points.
+ // o1/o2 ... if true, respective original position is used.
+ distance: function (p1, p2, o1, o2) {
+ return (o1 ? p1.xo : p1.x) - (o2 ? p2.xo : p2.x);
+ },
+
+ // Moves point p so the moved position has the same relative
+ // position to the moved positions of rp1 and rp2 than the
+ // original positions had.
+ //
+ // See APPENDIX on INTERPOLATE at the bottom of this file.
+ interpolate: function (p, rp1, rp2, pv) {
+ var do1;
+ var do2;
+ var doa1;
+ var doa2;
+ var dm1;
+ var dm2;
+ var dt;
+
+ if (!pv || pv === this) {
+ do1 = p.xo - rp1.xo;
+ do2 = p.xo - rp2.xo;
+ dm1 = rp1.x - rp1.xo;
+ dm2 = rp2.x - rp2.xo;
+ doa1 = Math.abs(do1);
+ doa2 = Math.abs(do2);
+ dt = doa1 + doa2;
+
+ if (dt === 0) {
+ p.x = p.xo + (dm1 + dm2) / 2;
+ return;
+ }
+
+ p.x = p.xo + (dm1 * doa2 + dm2 * doa1) / dt;
+ return;
+ }
+
+ do1 = pv.distance(p, rp1, true, true);
+ do2 = pv.distance(p, rp2, true, true);
+ dm1 = pv.distance(rp1, rp1, false, true);
+ dm2 = pv.distance(rp2, rp2, false, true);
+ doa1 = Math.abs(do1);
+ doa2 = Math.abs(do2);
+ dt = doa1 + doa2;
+
+ if (dt === 0) {
+ xUnitVector.setRelative(p, p, (dm1 + dm2) / 2, pv, true);
+ return;
+ }
+
+ xUnitVector.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true);
+ },
+
+ // Slope of line normal to this
+ normalSlope: Number.NEGATIVE_INFINITY,
+
+ // Sets the point 'p' relative to point 'rp'
+ // by the distance 'd'.
+ //
+ // See APPENDIX on SETRELATIVE at the bottom of this file.
+ //
+ // p ... point to set
+ // rp ... reference point
+ // d ... distance on projection vector
+ // pv ... projection vector (undefined = this)
+ // org ... if true, uses the original position of rp as reference.
+ setRelative: function (p, rp, d, pv, org) {
+ if (!pv || pv === this) {
+ p.x = (org ? rp.xo : rp.x) + d;
+ return;
+ }
+
+ var rpx = org ? rp.xo : rp.x;
+ var rpy = org ? rp.yo : rp.y;
+ var rpdx = rpx + d * pv.x;
+ var rpdy = rpy + d * pv.y;
+
+ p.x = rpdx + (p.y - rpdy) / pv.normalSlope;
+ },
+
+ // Slope of vector line.
+ slope: 0,
+
+ // Touches the point p.
+ touch: function (p) {
+ p.xTouched = true;
+ },
+
+ // Tests if a point p is touched.
+ touched: function (p) {
+ return p.xTouched;
+ },
+
+ // Untouches the point p.
+ untouch: function (p) {
+ p.xTouched = false;
+ }
+ };
+
+ /*
+ * Unit vector of y-axis.
+ */
+ var yUnitVector = {
+ x: 0,
+
+ y: 1,
+
+ axis: 'y',
+
+ // Gets the projected distance between two points.
+ // o1/o2 ... if true, respective original position is used.
+ distance: function (p1, p2, o1, o2) {
+ return (o1 ? p1.yo : p1.y) - (o2 ? p2.yo : p2.y);
+ },
+
+ // Moves point p so the moved position has the same relative
+ // position to the moved positions of rp1 and rp2 than the
+ // original positions had.
+ //
+ // See APPENDIX on INTERPOLATE at the bottom of this file.
+ interpolate: function (p, rp1, rp2, pv) {
+ var do1;
+ var do2;
+ var doa1;
+ var doa2;
+ var dm1;
+ var dm2;
+ var dt;
+
+ if (!pv || pv === this) {
+ do1 = p.yo - rp1.yo;
+ do2 = p.yo - rp2.yo;
+ dm1 = rp1.y - rp1.yo;
+ dm2 = rp2.y - rp2.yo;
+ doa1 = Math.abs(do1);
+ doa2 = Math.abs(do2);
+ dt = doa1 + doa2;
+
+ if (dt === 0) {
+ p.y = p.yo + (dm1 + dm2) / 2;
+ return;
+ }
+
+ p.y = p.yo + (dm1 * doa2 + dm2 * doa1) / dt;
+ return;
+ }
+
+ do1 = pv.distance(p, rp1, true, true);
+ do2 = pv.distance(p, rp2, true, true);
+ dm1 = pv.distance(rp1, rp1, false, true);
+ dm2 = pv.distance(rp2, rp2, false, true);
+ doa1 = Math.abs(do1);
+ doa2 = Math.abs(do2);
+ dt = doa1 + doa2;
+
+ if (dt === 0) {
+ yUnitVector.setRelative(p, p, (dm1 + dm2) / 2, pv, true);
+ return;
+ }
+
+ yUnitVector.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true);
+ },
+
+ // Slope of line normal to this.
+ normalSlope: 0,
+
+ // Sets the point 'p' relative to point 'rp'
+ // by the distance 'd'
+ //
+ // See APPENDIX on SETRELATIVE at the bottom of this file.
+ //
+ // p ... point to set
+ // rp ... reference point
+ // d ... distance on projection vector
+ // pv ... projection vector (undefined = this)
+ // org ... if true, uses the original position of rp as reference.
+ setRelative: function (p, rp, d, pv, org) {
+ if (!pv || pv === this) {
+ p.y = (org ? rp.yo : rp.y) + d;
+ return;
+ }
+
+ var rpx = org ? rp.xo : rp.x;
+ var rpy = org ? rp.yo : rp.y;
+ var rpdx = rpx + d * pv.x;
+ var rpdy = rpy + d * pv.y;
+
+ p.y = rpdy + pv.normalSlope * (p.x - rpdx);
+ },
+
+ // Slope of vector line.
+ slope: Number.POSITIVE_INFINITY,
+
+ // Touches the point p.
+ touch: function (p) {
+ p.yTouched = true;
+ },
+
+ // Tests if a point p is touched.
+ touched: function (p) {
+ return p.yTouched;
+ },
+
+ // Untouches the point p.
+ untouch: function (p) {
+ p.yTouched = false;
+ }
+ };
+
+ Object.freeze(xUnitVector);
+ Object.freeze(yUnitVector);
+
+ /*
+ * Creates a unit vector that is not x- or y-axis.
+ */
+ function UnitVector(x, y) {
+ this.x = x;
+ this.y = y;
+ this.axis = undefined;
+ this.slope = y / x;
+ this.normalSlope = -x / y;
+ Object.freeze(this);
+ }
- do {
- ins = prog[++ip];
- if (ins === 0x58) // IF
- nesting++;
- else if (ins === 0x59) // EIF
- nesting--;
- else if (ins === 0x40) // NPUSHB
- ip += prog[ip + 1] + 1;
- else if (ins === 0x41) // NPUSHW
- ip += 2 * prog[ip + 1] + 1;
- else if (ins >= 0xB0 && ins <= 0xB7) // PUSHB
- ip += ins - 0xB0 + 1;
- else if (ins >= 0xB8 && ins <= 0xBF) // PUSHW
- ip += (ins - 0xB8 + 1) * 2;
- else if (handleElse && nesting === 1 && ins === 0x1B) // ELSE
- break;
- } while (nesting > 0);
+ /*
+ * Gets the projected distance between two points.
+ * o1/o2 ... if true, respective original position is used.
+ */
+ UnitVector.prototype.distance = function(p1, p2, o1, o2) {
+ return (
+ this.x * xUnitVector.distance(p1, p2, o1, o2) +
+ this.y * yUnitVector.distance(p1, p2, o1, o2)
+ );
+ };
+
+ /*
+ * Moves point p so the moved position has the same relative
+ * position to the moved positions of rp1 and rp2 than the
+ * original positions had.
+ *
+ * See APPENDIX on INTERPOLATE at the bottom of this file.
+ */
+ UnitVector.prototype.interpolate = function(p, rp1, rp2, pv) {
+ var dm1;
+ var dm2;
+ var do1;
+ var do2;
+ var doa1;
+ var doa2;
+ var dt;
+
+ do1 = pv.distance(p, rp1, true, true);
+ do2 = pv.distance(p, rp2, true, true);
+ dm1 = pv.distance(rp1, rp1, false, true);
+ dm2 = pv.distance(rp2, rp2, false, true);
+ doa1 = Math.abs(do1);
+ doa2 = Math.abs(do2);
+ dt = doa1 + doa2;
+
+ if (dt === 0) {
+ this.setRelative(p, p, (dm1 + dm2) / 2, pv, true);
+ return;
+ }
+
+ this.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true);
+ };
+
+ /*
+ * Sets the point 'p' relative to point 'rp'
+ * by the distance 'd'
+ *
+ * See APPENDIX on SETRELATIVE at the bottom of this file.
+ *
+ * p ... point to set
+ * rp ... reference point
+ * d ... distance on projection vector
+ * pv ... projection vector (undefined = this)
+ * org ... if true, uses the original position of rp as reference.
+ */
+ UnitVector.prototype.setRelative = function(p, rp, d, pv, org) {
+ pv = pv || this;
+
+ var rpx = org ? rp.xo : rp.x;
+ var rpy = org ? rp.yo : rp.y;
+ var rpdx = rpx + d * pv.x;
+ var rpdy = rpy + d * pv.y;
+
+ var pvns = pv.normalSlope;
+ var fvs = this.slope;
+
+ var px = p.x;
+ var py = p.y;
+
+ p.x = (fvs * px - pvns * rpdx + rpdy - py) / (fvs - pvns);
+ p.y = fvs * (p.x - px) + py;
+ };
+
+ /*
+ * Touches the point p.
+ */
+ UnitVector.prototype.touch = function(p) {
+ p.xTouched = true;
+ p.yTouched = true;
+ };
+
+ /*
+ * Returns a unit vector with x/y coordinates.
+ */
+ function getUnitVector(x, y) {
+ var d = Math.sqrt(x * x + y * y);
+
+ x /= d;
+ y /= d;
+
+ if (x === 1 && y === 0) { return xUnitVector; }
+ else if (x === 0 && y === 1) { return yUnitVector; }
+ else { return new UnitVector(x, y); }
+ }
- state.ip = ip;
-}
+ /*
+ * Creates a point in the hinting engine.
+ */
+ function HPoint(
+ x,
+ y,
+ lastPointOfContour,
+ onCurve
+ ) {
+ this.x = this.xo = Math.round(x * 64) / 64; // hinted x value and original x-value
+ this.y = this.yo = Math.round(y * 64) / 64; // hinted y value and original y-value
+
+ this.lastPointOfContour = lastPointOfContour;
+ this.onCurve = onCurve;
+ this.prevPointOnContour = undefined;
+ this.nextPointOnContour = undefined;
+ this.xTouched = false;
+ this.yTouched = false;
+
+ Object.preventExtensions(this);
+ }
-/*----------------------------------------------------------*
-* And then a lot of instructions... *
-*----------------------------------------------------------*/
+ /*
+ * Returns the next touched point on the contour.
+ *
+ * v ... unit vector to test touch axis.
+ */
+ HPoint.prototype.nextTouched = function(v) {
+ var p = this.nextPointOnContour;
-// SVTCA[a] Set freedom and projection Vectors To Coordinate Axis
-// 0x00-0x01
-function SVTCA(v, state) {
- if (DEBUG) console.log(state.step, 'SVTCA[' + v.axis + ']');
+ while (!v.touched(p) && p !== this) { p = p.nextPointOnContour; }
- state.fv = state.pv = state.dpv = v;
-}
+ return p;
+ };
-// SPVTCA[a] Set Projection Vector to Coordinate Axis
-// 0x02-0x03
-function SPVTCA(v, state) {
- if (DEBUG) console.log(state.step, 'SPVTCA[' + v.axis + ']');
+ /*
+ * Returns the previous touched point on the contour
+ *
+ * v ... unit vector to test touch axis.
+ */
+ HPoint.prototype.prevTouched = function(v) {
+ var p = this.prevPointOnContour;
- state.pv = state.dpv = v;
-}
+ while (!v.touched(p) && p !== this) { p = p.prevPointOnContour; }
-// SFVTCA[a] Set Freedom Vector to Coordinate Axis
-// 0x04-0x05
-function SFVTCA(v, state) {
- if (DEBUG) console.log(state.step, 'SFVTCA[' + v.axis + ']');
+ return p;
+ };
- state.fv = v;
-}
+ /*
+ * The zero point.
+ */
+ var HPZero = Object.freeze(new HPoint(0, 0));
-// SPVTL[a] Set Projection Vector To Line
-// 0x06-0x07
-function SPVTL(a, state) {
- var stack = state.stack;
- var p2i = stack.pop();
- var p1i = stack.pop();
- var p2 = state.z2[p2i];
- var p1 = state.z1[p1i];
+ /*
+ * The default state of the interpreter.
+ *
+ * Note: Freezing the defaultState and then deriving from it
+ * makes the V8 Javascript engine going awkward,
+ * so this is avoided, albeit the defaultState shouldn't
+ * ever change.
+ */
+ var defaultState = {
+ cvCutIn: 17 / 16, // control value cut in
+ deltaBase: 9,
+ deltaShift: 0.125,
+ loop: 1, // loops some instructions
+ minDis: 1, // minimum distance
+ autoFlip: true
+ };
+
+ /*
+ * The current state of the interpreter.
+ *
+ * env ... 'fpgm' or 'prep' or 'glyf'
+ * prog ... the program
+ */
+ function State(env, prog) {
+ this.env = env;
+ this.stack = [];
+ this.prog = prog;
+
+ switch (env) {
+ case 'glyf' :
+ this.zp0 = this.zp1 = this.zp2 = 1;
+ this.rp0 = this.rp1 = this.rp2 = 0;
+ /* fall through */
+ case 'prep' :
+ this.fv = this.pv = this.dpv = xUnitVector;
+ this.round = roundToGrid;
+ }
+ }
- if (DEBUG) console.log('SPVTL[' + a + ']', p2i, p1i);
+ /*
+ * Executes a glyph program.
+ *
+ * This does the hinting for each glyph.
+ *
+ * Returns an array of moved points.
+ *
+ * glyph: the glyph to hint
+ * ppem: the size the glyph is rendered for
+ */
+ Hinting.prototype.exec = function(glyph, ppem) {
+ if (typeof ppem !== 'number') {
+ throw new Error('Point size is not a number!');
+ }
+
+ // Received a fatal error, don't do any hinting anymore.
+ if (this._errorState > 2) { return; }
+
+ var font = this.font;
+ var prepState = this._prepState;
+
+ if (!prepState || prepState.ppem !== ppem) {
+ var fpgmState = this._fpgmState;
+
+ if (!fpgmState) {
+ // Executes the fpgm state.
+ // This is used by fonts to define functions.
+ State.prototype = defaultState;
+
+ fpgmState =
+ this._fpgmState =
+ new State('fpgm', font.tables.fpgm);
+
+ fpgmState.funcs = [ ];
+ fpgmState.font = font;
+
+ if (exports.DEBUG) {
+ console.log('---EXEC FPGM---');
+ fpgmState.step = -1;
+ }
+
+ try {
+ exec(fpgmState);
+ } catch (e) {
+ console.log('Hinting error in FPGM:' + e);
+ this._errorState = 3;
+ return;
+ }
+ }
+
+ // Executes the prep program for this ppem setting.
+ // This is used by fonts to set cvt values
+ // depending on to be rendered font size.
+
+ State.prototype = fpgmState;
+ prepState =
+ this._prepState =
+ new State('prep', font.tables.prep);
+
+ prepState.ppem = ppem;
+
+ // Creates a copy of the cvt table
+ // and scales it to the current ppem setting.
+ var oCvt = font.tables.cvt;
+ if (oCvt) {
+ var cvt = prepState.cvt = new Array(oCvt.length);
+ var scale = ppem / font.unitsPerEm;
+ for (var c = 0; c < oCvt.length; c++) {
+ cvt[c] = oCvt[c] * scale;
+ }
+ } else {
+ prepState.cvt = [];
+ }
+
+ if (exports.DEBUG) {
+ console.log('---EXEC PREP---');
+ prepState.step = -1;
+ }
+
+ try {
+ exec(prepState);
+ } catch (e) {
+ if (this._errorState < 2) {
+ console.log('Hinting error in PREP:' + e);
+ }
+ this._errorState = 2;
+ }
+ }
+
+ if (this._errorState > 1) { return; }
+
+ try {
+ return execGlyph(glyph, prepState);
+ } catch (e) {
+ if (this._errorState < 1) {
+ console.log('Hinting error:' + e);
+ console.log('Note: further hinting errors are silenced');
+ }
+ this._errorState = 1;
+ return undefined;
+ }
+ };
+
+ /*
+ * Executes the hinting program for a glyph.
+ */
+ execGlyph = function(glyph, prepState) {
+ // original point positions
+ var xScale = prepState.ppem / prepState.font.unitsPerEm;
+ var yScale = xScale;
+ var components = glyph.components;
+ var contours;
+ var gZone;
+ var state;
+
+ State.prototype = prepState;
+ if (!components) {
+ state = new State('glyf', glyph.instructions);
+ if (exports.DEBUG) {
+ console.log('---EXEC GLYPH---');
+ state.step = -1;
+ }
+ execComponent(glyph, state, xScale, yScale);
+ gZone = state.gZone;
+ } else {
+ var font = prepState.font;
+ gZone = [];
+ contours = [];
+ for (var i = 0; i < components.length; i++) {
+ var c = components[i];
+ var cg = font.glyphs.get(c.glyphIndex);
+
+ state = new State('glyf', cg.instructions);
+
+ if (exports.DEBUG) {
+ console.log('---EXEC COMP ' + i + '---');
+ state.step = -1;
+ }
+
+ execComponent(cg, state, xScale, yScale);
+ // appends the computed points to the result array
+ // post processes the component points
+ var dx = Math.round(c.dx * xScale);
+ var dy = Math.round(c.dy * yScale);
+ var gz = state.gZone;
+ var cc = state.contours;
+ for (var pi = 0; pi < gz.length; pi++) {
+ var p = gz[pi];
+ p.xTouched = p.yTouched = false;
+ p.xo = p.x = p.x + dx;
+ p.yo = p.y = p.y + dy;
+ }
+
+ var gLen = gZone.length;
+ gZone.push.apply(gZone, gz);
+ for (var j = 0; j < cc.length; j++) {
+ contours.push(cc[j] + gLen);
+ }
+ }
+
+ if (glyph.instructions && !state.inhibitGridFit) {
+ // the composite has instructions on its own
+ state = new State('glyf', glyph.instructions);
+
+ state.gZone = state.z0 = state.z1 = state.z2 = gZone;
+
+ state.contours = contours;
+
+ // note: HPZero cannot be used here, since
+ // the point might be modified
+ gZone.push(
+ new HPoint(0, 0),
+ new HPoint(Math.round(glyph.advanceWidth * xScale), 0)
+ );
+
+ if (exports.DEBUG) {
+ console.log('---EXEC COMPOSITE---');
+ state.step = -1;
+ }
+
+ exec(state);
+
+ gZone.length -= 2;
+ }
+ }
+
+ return gZone;
+ };
+
+ /*
+ * Executes the hinting program for a component of a multi-component glyph
+ * or of the glyph itself for a non-component glyph.
+ */
+ execComponent = function(glyph, state, xScale, yScale)
+ {
+ var points = glyph.points || [];
+ var pLen = points.length;
+ var gZone = state.gZone = state.z0 = state.z1 = state.z2 = [];
+ var contours = state.contours = [];
+
+ // Scales the original points and
+ // makes copies for the hinted points.
+ var cp; // current point
+ for (var i = 0; i < pLen; i++) {
+ cp = points[i];
+
+ gZone[i] = new HPoint(
+ cp.x * xScale,
+ cp.y * yScale,
+ cp.lastPointOfContour,
+ cp.onCurve
+ );
+ }
+
+ // Chain links the contours.
+ var sp; // start point
+ var np; // next point
+
+ for (var i$1 = 0; i$1 < pLen; i$1++) {
+ cp = gZone[i$1];
+
+ if (!sp) {
+ sp = cp;
+ contours.push(i$1);
+ }
+
+ if (cp.lastPointOfContour) {
+ cp.nextPointOnContour = sp;
+ sp.prevPointOnContour = cp;
+ sp = undefined;
+ } else {
+ np = gZone[i$1 + 1];
+ cp.nextPointOnContour = np;
+ np.prevPointOnContour = cp;
+ }
+ }
+
+ if (state.inhibitGridFit) { return; }
+
+ if (exports.DEBUG) {
+ console.log('PROCESSING GLYPH', state.stack);
+ for (var i$2 = 0; i$2 < pLen; i$2++) {
+ console.log(i$2, gZone[i$2].x, gZone[i$2].y);
+ }
+ }
+
+ gZone.push(
+ new HPoint(0, 0),
+ new HPoint(Math.round(glyph.advanceWidth * xScale), 0)
+ );
+
+ exec(state);
+
+ // Removes the extra points.
+ gZone.length -= 2;
+
+ if (exports.DEBUG) {
+ console.log('FINISHED GLYPH', state.stack);
+ for (var i$3 = 0; i$3 < pLen; i$3++) {
+ console.log(i$3, gZone[i$3].x, gZone[i$3].y);
+ }
+ }
+ };
+
+ /*
+ * Executes the program loaded in state.
+ */
+ exec = function(state) {
+ var prog = state.prog;
+
+ if (!prog) { return; }
+
+ var pLen = prog.length;
+ var ins;
+
+ for (state.ip = 0; state.ip < pLen; state.ip++) {
+ if (exports.DEBUG) { state.step++; }
+ ins = instructionTable[prog[state.ip]];
+
+ if (!ins) {
+ throw new Error(
+ 'unknown instruction: 0x' +
+ Number(prog[state.ip]).toString(16)
+ );
+ }
+
+ ins(state);
+
+ // very extensive debugging for each step
+ /*
+ if (exports.DEBUG) {
+ var da;
+ if (state.gZone) {
+ da = [];
+ for (let i = 0; i < state.gZone.length; i++)
+ {
+ da.push(i + ' ' +
+ state.gZone[i].x * 64 + ' ' +
+ state.gZone[i].y * 64 + ' ' +
+ (state.gZone[i].xTouched ? 'x' : '') +
+ (state.gZone[i].yTouched ? 'y' : '')
+ );
+ }
+ console.log('GZ', da);
+ }
+
+ if (state.tZone) {
+ da = [];
+ for (let i = 0; i < state.tZone.length; i++) {
+ da.push(i + ' ' +
+ state.tZone[i].x * 64 + ' ' +
+ state.tZone[i].y * 64 + ' ' +
+ (state.tZone[i].xTouched ? 'x' : '') +
+ (state.tZone[i].yTouched ? 'y' : '')
+ );
+ }
+ console.log('TZ', da);
+ }
+
+ if (state.stack.length > 10) {
+ console.log(
+ state.stack.length,
+ '...', state.stack.slice(state.stack.length - 10)
+ );
+ } else {
+ console.log(state.stack.length, state.stack);
+ }
+ }
+ */
+ }
+ };
+
+ /*
+ * Initializes the twilight zone.
+ *
+ * This is only done if a SZPx instruction
+ * refers to the twilight zone.
+ */
+ function initTZone(state)
+ {
+ var tZone = state.tZone = new Array(state.gZone.length);
+
+ // no idea if this is actually correct...
+ for (var i = 0; i < tZone.length; i++)
+ {
+ tZone[i] = new HPoint(0, 0);
+ }
+ }
- var dx;
- var dy;
+ /*
+ * Skips the instruction pointer ahead over an IF/ELSE block.
+ * handleElse .. if true breaks on matching ELSE
+ */
+ function skip(state, handleElse)
+ {
+ var prog = state.prog;
+ var ip = state.ip;
+ var nesting = 1;
+ var ins;
+
+ do {
+ ins = prog[++ip];
+ if (ins === 0x58) // IF
+ { nesting++; }
+ else if (ins === 0x59) // EIF
+ { nesting--; }
+ else if (ins === 0x40) // NPUSHB
+ { ip += prog[ip + 1] + 1; }
+ else if (ins === 0x41) // NPUSHW
+ { ip += 2 * prog[ip + 1] + 1; }
+ else if (ins >= 0xB0 && ins <= 0xB7) // PUSHB
+ { ip += ins - 0xB0 + 1; }
+ else if (ins >= 0xB8 && ins <= 0xBF) // PUSHW
+ { ip += (ins - 0xB8 + 1) * 2; }
+ else if (handleElse && nesting === 1 && ins === 0x1B) // ELSE
+ { break; }
+ } while (nesting > 0);
+
+ state.ip = ip;
+ }
- if (!a) {
- dx = p1.x - p2.x;
- dy = p1.y - p2.y;
- } else {
- dx = p2.y - p1.y;
- dy = p1.x - p2.x;
- }
+ /*----------------------------------------------------------*
+ * And then a lot of instructions... *
+ *----------------------------------------------------------*/
- state.pv = state.dpv = getUnitVector(dx, dy);
-}
+ // SVTCA[a] Set freedom and projection Vectors To Coordinate Axis
+ // 0x00-0x01
+ function SVTCA(v, state) {
+ if (exports.DEBUG) { console.log(state.step, 'SVTCA[' + v.axis + ']'); }
-// SFVTL[a] Set Freedom Vector To Line
-// 0x08-0x09
-function SFVTL(a, state) {
- var stack = state.stack;
- var p2i = stack.pop();
- var p1i = stack.pop();
- var p2 = state.z2[p2i];
- var p1 = state.z1[p1i];
+ state.fv = state.pv = state.dpv = v;
+ }
- if (DEBUG) console.log('SFVTL[' + a + ']', p2i, p1i);
+ // SPVTCA[a] Set Projection Vector to Coordinate Axis
+ // 0x02-0x03
+ function SPVTCA(v, state) {
+ if (exports.DEBUG) { console.log(state.step, 'SPVTCA[' + v.axis + ']'); }
- var dx;
- var dy;
+ state.pv = state.dpv = v;
+ }
- if (!a) {
- dx = p1.x - p2.x;
- dy = p1.y - p2.y;
- } else {
- dx = p2.y - p1.y;
- dy = p1.x - p2.x;
- }
+ // SFVTCA[a] Set Freedom Vector to Coordinate Axis
+ // 0x04-0x05
+ function SFVTCA(v, state) {
+ if (exports.DEBUG) { console.log(state.step, 'SFVTCA[' + v.axis + ']'); }
- state.fv = getUnitVector(dx, dy);
-}
+ state.fv = v;
+ }
-// SPVFS[] Set Projection Vector From Stack
-// 0x0A
-function SPVFS(state) {
- var stack = state.stack;
- var y = stack.pop();
- var x = stack.pop();
+ // SPVTL[a] Set Projection Vector To Line
+ // 0x06-0x07
+ function SPVTL(a, state) {
+ var stack = state.stack;
+ var p2i = stack.pop();
+ var p1i = stack.pop();
+ var p2 = state.z2[p2i];
+ var p1 = state.z1[p1i];
+
+ if (exports.DEBUG) { console.log('SPVTL[' + a + ']', p2i, p1i); }
+
+ var dx;
+ var dy;
+
+ if (!a) {
+ dx = p1.x - p2.x;
+ dy = p1.y - p2.y;
+ } else {
+ dx = p2.y - p1.y;
+ dy = p1.x - p2.x;
+ }
+
+ state.pv = state.dpv = getUnitVector(dx, dy);
+ }
- if (DEBUG) console.log(state.step, 'SPVFS[]', y, x);
+ // SFVTL[a] Set Freedom Vector To Line
+ // 0x08-0x09
+ function SFVTL(a, state) {
+ var stack = state.stack;
+ var p2i = stack.pop();
+ var p1i = stack.pop();
+ var p2 = state.z2[p2i];
+ var p1 = state.z1[p1i];
+
+ if (exports.DEBUG) { console.log('SFVTL[' + a + ']', p2i, p1i); }
+
+ var dx;
+ var dy;
+
+ if (!a) {
+ dx = p1.x - p2.x;
+ dy = p1.y - p2.y;
+ } else {
+ dx = p2.y - p1.y;
+ dy = p1.x - p2.x;
+ }
+
+ state.fv = getUnitVector(dx, dy);
+ }
- state.pv = state.dpv = getUnitVector(x, y);
-}
+ // SPVFS[] Set Projection Vector From Stack
+ // 0x0A
+ function SPVFS(state) {
+ var stack = state.stack;
+ var y = stack.pop();
+ var x = stack.pop();
-// SFVFS[] Set Freedom Vector From Stack
-// 0x0B
-function SFVFS(state) {
- var stack = state.stack;
- var y = stack.pop();
- var x = stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'SPVFS[]', y, x); }
- if (DEBUG) console.log(state.step, 'SPVFS[]', y, x);
+ state.pv = state.dpv = getUnitVector(x, y);
+ }
- state.fv = getUnitVector(x, y);
-}
+ // SFVFS[] Set Freedom Vector From Stack
+ // 0x0B
+ function SFVFS(state) {
+ var stack = state.stack;
+ var y = stack.pop();
+ var x = stack.pop();
-// GPV[] Get Projection Vector
-// 0x0C
-function GPV(state) {
- var stack = state.stack;
- var pv = state.pv;
+ if (exports.DEBUG) { console.log(state.step, 'SPVFS[]', y, x); }
- if (DEBUG) console.log(state.step, 'GPV[]');
+ state.fv = getUnitVector(x, y);
+ }
- stack.push(pv.x * 0x4000);
- stack.push(pv.y * 0x4000);
-}
+ // GPV[] Get Projection Vector
+ // 0x0C
+ function GPV(state) {
+ var stack = state.stack;
+ var pv = state.pv;
-// GFV[] Get Freedom Vector
-// 0x0C
-function GFV(state) {
- var stack = state.stack;
- var fv = state.fv;
+ if (exports.DEBUG) { console.log(state.step, 'GPV[]'); }
- if (DEBUG) console.log(state.step, 'GFV[]');
+ stack.push(pv.x * 0x4000);
+ stack.push(pv.y * 0x4000);
+ }
- stack.push(fv.x * 0x4000);
- stack.push(fv.y * 0x4000);
-}
+ // GFV[] Get Freedom Vector
+ // 0x0C
+ function GFV(state) {
+ var stack = state.stack;
+ var fv = state.fv;
-// SFVTPV[] Set Freedom Vector To Projection Vector
-// 0x0E
-function SFVTPV(state) {
- state.fv = state.pv;
+ if (exports.DEBUG) { console.log(state.step, 'GFV[]'); }
- if (DEBUG) console.log(state.step, 'SFVTPV[]');
-}
+ stack.push(fv.x * 0x4000);
+ stack.push(fv.y * 0x4000);
+ }
-// ISECT[] moves point p to the InterSECTion of two lines
-// 0x0F
-function ISECT(state)
-{
- var stack = state.stack;
- var pa0i = stack.pop();
- var pa1i = stack.pop();
- var pb0i = stack.pop();
- var pb1i = stack.pop();
- var pi = stack.pop();
- var z0 = state.z0;
- var z1 = state.z1;
- var pa0 = z0[pa0i];
- var pa1 = z0[pa1i];
- var pb0 = z1[pb0i];
- var pb1 = z1[pb1i];
- var p = state.z2[pi];
-
- if (DEBUG) console.log('ISECT[], ', pa0i, pa1i, pb0i, pb1i, pi);
-
- // math from
- // en.wikipedia.org/wiki/Line%E2%80%93line_intersection#Given_two_points_on_each_line
-
- var x1 = pa0.x;
- var y1 = pa0.y;
- var x2 = pa1.x;
- var y2 = pa1.y;
- var x3 = pb0.x;
- var y3 = pb0.y;
- var x4 = pb1.x;
- var y4 = pb1.y;
-
- var div = (x1 - x2) * (y3 - y4) - (y1 - y2) * (x3 - x4);
- var f1 = x1 * y2 - y1 * x2;
- var f2 = x3 * y4 - y3 * x4;
-
- p.x = (f1 * (x3 - x4) - f2 * (x1 - x2)) / div;
- p.y = (f1 * (y3 - y4) - f2 * (y1 - y2)) / div;
-}
+ // SFVTPV[] Set Freedom Vector To Projection Vector
+ // 0x0E
+ function SFVTPV(state) {
+ state.fv = state.pv;
-// SRP0[] Set Reference Point 0
-// 0x10
-function SRP0(state) {
- state.rp0 = state.stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'SFVTPV[]'); }
+ }
- if (DEBUG) console.log(state.step, 'SRP0[]', state.rp0);
-}
+ // ISECT[] moves point p to the InterSECTion of two lines
+ // 0x0F
+ function ISECT(state)
+ {
+ var stack = state.stack;
+ var pa0i = stack.pop();
+ var pa1i = stack.pop();
+ var pb0i = stack.pop();
+ var pb1i = stack.pop();
+ var pi = stack.pop();
+ var z0 = state.z0;
+ var z1 = state.z1;
+ var pa0 = z0[pa0i];
+ var pa1 = z0[pa1i];
+ var pb0 = z1[pb0i];
+ var pb1 = z1[pb1i];
+ var p = state.z2[pi];
+
+ if (exports.DEBUG) { console.log('ISECT[], ', pa0i, pa1i, pb0i, pb1i, pi); }
+
+ // math from
+ // en.wikipedia.org/wiki/Line%E2%80%93line_intersection#Given_two_points_on_each_line
+
+ var x1 = pa0.x;
+ var y1 = pa0.y;
+ var x2 = pa1.x;
+ var y2 = pa1.y;
+ var x3 = pb0.x;
+ var y3 = pb0.y;
+ var x4 = pb1.x;
+ var y4 = pb1.y;
+
+ var div = (x1 - x2) * (y3 - y4) - (y1 - y2) * (x3 - x4);
+ var f1 = x1 * y2 - y1 * x2;
+ var f2 = x3 * y4 - y3 * x4;
+
+ p.x = (f1 * (x3 - x4) - f2 * (x1 - x2)) / div;
+ p.y = (f1 * (y3 - y4) - f2 * (y1 - y2)) / div;
+ }
-// SRP1[] Set Reference Point 1
-// 0x11
-function SRP1(state) {
- state.rp1 = state.stack.pop();
+ // SRP0[] Set Reference Point 0
+ // 0x10
+ function SRP0(state) {
+ state.rp0 = state.stack.pop();
- if (DEBUG) console.log(state.step, 'SRP1[]', state.rp1);
-}
+ if (exports.DEBUG) { console.log(state.step, 'SRP0[]', state.rp0); }
+ }
-// SRP1[] Set Reference Point 2
-// 0x12
-function SRP2(state) {
- state.rp2 = state.stack.pop();
+ // SRP1[] Set Reference Point 1
+ // 0x11
+ function SRP1(state) {
+ state.rp1 = state.stack.pop();
- if (DEBUG) console.log(state.step, 'SRP2[]', state.rp2);
-}
+ if (exports.DEBUG) { console.log(state.step, 'SRP1[]', state.rp1); }
+ }
-// SZP0[] Set Zone Pointer 0
-// 0x13
-function SZP0(state) {
- var n = state.stack.pop();
+ // SRP1[] Set Reference Point 2
+ // 0x12
+ function SRP2(state) {
+ state.rp2 = state.stack.pop();
- if (DEBUG) console.log(state.step, 'SZP0[]', n);
+ if (exports.DEBUG) { console.log(state.step, 'SRP2[]', state.rp2); }
+ }
- state.zp0 = n;
+ // SZP0[] Set Zone Pointer 0
+ // 0x13
+ function SZP0(state) {
+ var n = state.stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'SZP0[]', n); }
+
+ state.zp0 = n;
+
+ switch (n) {
+ case 0:
+ if (!state.tZone) { initTZone(state); }
+ state.z0 = state.tZone;
+ break;
+ case 1 :
+ state.z0 = state.gZone;
+ break;
+ default :
+ throw new Error('Invalid zone pointer');
+ }
+ }
- switch (n) {
- case 0:
- if (!state.tZone) initTZone(state);
- state.z0 = state.tZone;
- break;
- case 1 :
- state.z0 = state.gZone;
- break;
- default :
- throw new Error('Invalid zone pointer');
- }
-}
+ // SZP1[] Set Zone Pointer 1
+ // 0x14
+ function SZP1(state) {
+ var n = state.stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'SZP1[]', n); }
+
+ state.zp1 = n;
+
+ switch (n) {
+ case 0:
+ if (!state.tZone) { initTZone(state); }
+ state.z1 = state.tZone;
+ break;
+ case 1 :
+ state.z1 = state.gZone;
+ break;
+ default :
+ throw new Error('Invalid zone pointer');
+ }
+ }
-// SZP1[] Set Zone Pointer 1
-// 0x14
-function SZP1(state) {
- var n = state.stack.pop();
+ // SZP2[] Set Zone Pointer 2
+ // 0x15
+ function SZP2(state) {
+ var n = state.stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'SZP2[]', n); }
+
+ state.zp2 = n;
+
+ switch (n) {
+ case 0:
+ if (!state.tZone) { initTZone(state); }
+ state.z2 = state.tZone;
+ break;
+ case 1 :
+ state.z2 = state.gZone;
+ break;
+ default :
+ throw new Error('Invalid zone pointer');
+ }
+ }
- if (DEBUG) console.log(state.step, 'SZP1[]', n);
+ // SZPS[] Set Zone PointerS
+ // 0x16
+ function SZPS(state) {
+ var n = state.stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'SZPS[]', n); }
+
+ state.zp0 = state.zp1 = state.zp2 = n;
+
+ switch (n) {
+ case 0:
+ if (!state.tZone) { initTZone(state); }
+ state.z0 = state.z1 = state.z2 = state.tZone;
+ break;
+ case 1 :
+ state.z0 = state.z1 = state.z2 = state.gZone;
+ break;
+ default :
+ throw new Error('Invalid zone pointer');
+ }
+ }
- state.zp1 = n;
+ // SLOOP[] Set LOOP variable
+ // 0x17
+ function SLOOP(state) {
+ state.loop = state.stack.pop();
- switch (n) {
- case 0:
- if (!state.tZone) initTZone(state);
- state.z1 = state.tZone;
- break;
- case 1 :
- state.z1 = state.gZone;
- break;
- default :
- throw new Error('Invalid zone pointer');
- }
-}
+ if (exports.DEBUG) { console.log(state.step, 'SLOOP[]', state.loop); }
+ }
-// SZP2[] Set Zone Pointer 2
-// 0x15
-function SZP2(state) {
- var n = state.stack.pop();
+ // RTG[] Round To Grid
+ // 0x18
+ function RTG(state) {
+ if (exports.DEBUG) { console.log(state.step, 'RTG[]'); }
- if (DEBUG) console.log(state.step, 'SZP2[]', n);
+ state.round = roundToGrid;
+ }
- state.zp2 = n;
+ // RTHG[] Round To Half Grid
+ // 0x19
+ function RTHG(state) {
+ if (exports.DEBUG) { console.log(state.step, 'RTHG[]'); }
- switch (n) {
- case 0:
- if (!state.tZone) initTZone(state);
- state.z2 = state.tZone;
- break;
- case 1 :
- state.z2 = state.gZone;
- break;
- default :
- throw new Error('Invalid zone pointer');
- }
-}
+ state.round = roundToHalfGrid;
+ }
-// SZPS[] Set Zone PointerS
-// 0x16
-function SZPS(state) {
- var n = state.stack.pop();
+ // SMD[] Set Minimum Distance
+ // 0x1A
+ function SMD(state) {
+ var d = state.stack.pop();
- if (DEBUG) console.log(state.step, 'SZPS[]', n);
+ if (exports.DEBUG) { console.log(state.step, 'SMD[]', d); }
- state.zp0 = state.zp1 = state.zp2 = n;
+ state.minDis = d / 0x40;
+ }
- switch (n) {
- case 0:
- if (!state.tZone) initTZone(state);
- state.z0 = state.z1 = state.z2 = state.tZone;
- break;
- case 1 :
- state.z0 = state.z1 = state.z2 = state.gZone;
- break;
- default :
- throw new Error('Invalid zone pointer');
- }
-}
+ // ELSE[] ELSE clause
+ // 0x1B
+ function ELSE(state) {
+ // This instruction has been reached by executing a then branch
+ // so it just skips ahead until matching EIF.
+ //
+ // In case the IF was negative the IF[] instruction already
+ // skipped forward over the ELSE[]
-// SLOOP[] Set LOOP variable
-// 0x17
-function SLOOP(state) {
- state.loop = state.stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'ELSE[]'); }
- if (DEBUG) console.log(state.step, 'SLOOP[]', state.loop);
-}
+ skip(state, false);
+ }
-// RTG[] Round To Grid
-// 0x18
-function RTG(state) {
- if (DEBUG) console.log(state.step, 'RTG[]');
+ // JMPR[] JuMP Relative
+ // 0x1C
+ function JMPR(state) {
+ var o = state.stack.pop();
- state.round = roundToGrid;
-}
+ if (exports.DEBUG) { console.log(state.step, 'JMPR[]', o); }
-// RTHG[] Round To Half Grid
-// 0x19
-function RTHG(state) {
- if (DEBUG) console.log(state.step, 'RTHG[]');
+ // A jump by 1 would do nothing.
+ state.ip += o - 1;
+ }
- state.round = roundToHalfGrid;
-}
+ // SCVTCI[] Set Control Value Table Cut-In
+ // 0x1D
+ function SCVTCI(state) {
+ var n = state.stack.pop();
-// SMD[] Set Minimum Distance
-// 0x1A
-function SMD(state) {
- var d = state.stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'SCVTCI[]', n); }
- if (DEBUG) console.log(state.step, 'SMD[]', d);
+ state.cvCutIn = n / 0x40;
+ }
- state.minDis = d / 0x40;
-}
+ // DUP[] DUPlicate top stack element
+ // 0x20
+ function DUP(state) {
+ var stack = state.stack;
-// ELSE[] ELSE clause
-// 0x1B
-function ELSE(state) {
- // This instruction has been reached by executing a then branch
- // so it just skips ahead until mathing EIF.
- //
- // In case the IF was negative the IF[] instruction already
- // skipped forward over the ELSE[]
+ if (exports.DEBUG) { console.log(state.step, 'DUP[]'); }
- if (DEBUG) console.log(state.step, 'ELSE[]');
+ stack.push(stack[stack.length - 1]);
+ }
- skip(state, false);
-}
+ // POP[] POP top stack element
+ // 0x21
+ function POP(state) {
+ if (exports.DEBUG) { console.log(state.step, 'POP[]'); }
-// JMPR[] JuMP Relative
-// 0x1C
-function JMPR(state) {
- var o = state.stack.pop();
+ state.stack.pop();
+ }
- if (DEBUG) console.log(state.step, 'JMPR[]', o);
+ // CLEAR[] CLEAR the stack
+ // 0x22
+ function CLEAR(state) {
+ if (exports.DEBUG) { console.log(state.step, 'CLEAR[]'); }
- // A jump by 1 would do nothing.
- state.ip += o - 1;
-}
+ state.stack.length = 0;
+ }
-// SCVTCI[] Set Control Value Table Cut-In
-// 0x1D
-function SCVTCI(state) {
- var n = state.stack.pop();
+ // SWAP[] SWAP the top two elements on the stack
+ // 0x23
+ function SWAP(state) {
+ var stack = state.stack;
- if (DEBUG) console.log(state.step, 'SCVTCI[]', n);
+ var a = stack.pop();
+ var b = stack.pop();
- state.cvCutIn = n / 0x40;
-}
+ if (exports.DEBUG) { console.log(state.step, 'SWAP[]'); }
-// DUP[] DUPlicate top stack element
-// 0x20
-function DUP(state) {
- var stack = state.stack;
+ stack.push(a);
+ stack.push(b);
+ }
- if (DEBUG) console.log(state.step, 'DUP[]');
+ // DEPTH[] DEPTH of the stack
+ // 0x24
+ function DEPTH(state) {
+ var stack = state.stack;
- stack.push(stack[stack.length - 1]);
-}
+ if (exports.DEBUG) { console.log(state.step, 'DEPTH[]'); }
-// POP[] POP top stack element
-// 0x21
-function POP(state) {
- if (DEBUG) console.log(state.step, 'POP[]');
+ stack.push(stack.length);
+ }
- state.stack.pop();
-}
+ // LOOPCALL[] LOOPCALL function
+ // 0x2A
+ function LOOPCALL(state) {
+ var stack = state.stack;
+ var fn = stack.pop();
+ var c = stack.pop();
-// CLEAR[] CLEAR the stack
-// 0x22
-function CLEAR(state) {
- if (DEBUG) console.log(state.step, 'CLEAR[]');
+ if (exports.DEBUG) { console.log(state.step, 'LOOPCALL[]', fn, c); }
- state.stack.length = 0;
-}
+ // saves callers program
+ var cip = state.ip;
+ var cprog = state.prog;
-// SWAP[] SWAP the top two elements on the stack
-// 0x23
-function SWAP(state) {
- var stack = state.stack;
+ state.prog = state.funcs[fn];
- var a = stack.pop();
- var b = stack.pop();
+ // executes the function
+ for (var i = 0; i < c; i++) {
+ exec(state);
- if (DEBUG) console.log(state.step, 'SWAP[]');
+ if (exports.DEBUG) { console.log(
+ ++state.step,
+ i + 1 < c ? 'next loopcall' : 'done loopcall',
+ i
+ ); }
+ }
- stack.push(a);
- stack.push(b);
-}
+ // restores the callers program
+ state.ip = cip;
+ state.prog = cprog;
+ }
-// DEPTH[] DEPTH of the stack
-// 0x24
-function DEPTH(state) {
- var stack = state.stack;
+ // CALL[] CALL function
+ // 0x2B
+ function CALL(state) {
+ var fn = state.stack.pop();
- if (DEBUG) console.log(state.step, 'DEPTH[]');
+ if (exports.DEBUG) { console.log(state.step, 'CALL[]', fn); }
- stack.push(stack.length);
-}
+ // saves callers program
+ var cip = state.ip;
+ var cprog = state.prog;
-// LOOPCALL[] LOOPCALL function
-// 0x2A
-function LOOPCALL(state) {
- var stack = state.stack;
- var fn = stack.pop();
- var c = stack.pop();
+ state.prog = state.funcs[fn];
- if (DEBUG) console.log(state.step, 'LOOPCALL[]', fn, c);
+ // executes the function
+ exec(state);
- // saves callers program
- var cip = state.ip;
- var cprog = state.prog;
+ // restores the callers program
+ state.ip = cip;
+ state.prog = cprog;
- state.prog = state.funcs[fn];
+ if (exports.DEBUG) { console.log(++state.step, 'returning from', fn); }
+ }
- // executes the function
- for (var i = 0; i < c; i++) {
- exec(state);
+ // CINDEX[] Copy the INDEXed element to the top of the stack
+ // 0x25
+ function CINDEX(state) {
+ var stack = state.stack;
+ var k = stack.pop();
- if (DEBUG) console.log(
- ++state.step,
- i + 1 < c ? 'next loopcall' : 'done loopcall',
- i
- );
- }
+ if (exports.DEBUG) { console.log(state.step, 'CINDEX[]', k); }
- // restores the callers program
- state.ip = cip;
- state.prog = cprog;
-}
+ // In case of k == 1, it copies the last element after popping
+ // thus stack.length - k.
+ stack.push(stack[stack.length - k]);
+ }
-// CALL[] CALL function
-// 0x2B
-function CALL(state) {
- var fn = state.stack.pop();
+ // MINDEX[] Move the INDEXed element to the top of the stack
+ // 0x26
+ function MINDEX(state) {
+ var stack = state.stack;
+ var k = stack.pop();
- if (DEBUG) console.log(state.step, 'CALL[]', fn);
+ if (exports.DEBUG) { console.log(state.step, 'MINDEX[]', k); }
- // saves callers program
- var cip = state.ip;
- var cprog = state.prog;
+ stack.push(stack.splice(stack.length - k, 1)[0]);
+ }
- state.prog = state.funcs[fn];
+ // FDEF[] Function DEFinition
+ // 0x2C
+ function FDEF(state) {
+ if (state.env !== 'fpgm') { throw new Error('FDEF not allowed here'); }
+ var stack = state.stack;
+ var prog = state.prog;
+ var ip = state.ip;
- // executes the function
- exec(state);
+ var fn = stack.pop();
+ var ipBegin = ip;
- // restores the callers program
- state.ip = cip;
- state.prog = cprog;
+ if (exports.DEBUG) { console.log(state.step, 'FDEF[]', fn); }
- if (DEBUG) console.log(++state.step, 'returning from', fn);
-}
+ while (prog[++ip] !== 0x2D){ }
-// CINDEX[] Copy the INDEXed element to the top of the stack
-// 0x25
-function CINDEX(state) {
- var stack = state.stack;
- var k = stack.pop();
+ state.ip = ip;
+ state.funcs[fn] = prog.slice(ipBegin + 1, ip);
+ }
- if (DEBUG) console.log(state.step, 'CINDEX[]', k);
+ // MDAP[a] Move Direct Absolute Point
+ // 0x2E-0x2F
+ function MDAP(round, state) {
+ var pi = state.stack.pop();
+ var p = state.z0[pi];
+ var fv = state.fv;
+ var pv = state.pv;
- // In case of k == 1, it copies the last element after poping
- // thus stack.length - k.
- stack.push(stack[stack.length - k]);
-}
+ if (exports.DEBUG) { console.log(state.step, 'MDAP[' + round + ']', pi); }
-// MINDEX[] Move the INDEXed element to the top of the stack
-// 0x26
-function MINDEX(state) {
- var stack = state.stack;
- var k = stack.pop();
+ var d = pv.distance(p, HPZero);
- if (DEBUG) console.log(state.step, 'MINDEX[]', k);
+ if (round) { d = state.round(d); }
- stack.push(stack.splice(stack.length - k, 1)[0]);
-}
+ fv.setRelative(p, HPZero, d, pv);
+ fv.touch(p);
-// FDEF[] Function DEFinition
-// 0x2C
-function FDEF(state) {
- if (state.env !== 'fpgm') throw new Error('FDEF not allowed here');
- var stack = state.stack;
- var prog = state.prog;
- var ip = state.ip;
+ state.rp0 = state.rp1 = pi;
+ }
- var fn = stack.pop();
- var ipBegin = ip;
+ // IUP[a] Interpolate Untouched Points through the outline
+ // 0x30
+ function IUP(v, state) {
+ var z2 = state.z2;
+ var pLen = z2.length - 2;
+ var cp;
+ var pp;
+ var np;
- if (DEBUG) console.log(state.step, 'FDEF[]', fn);
+ if (exports.DEBUG) { console.log(state.step, 'IUP[' + v.axis + ']'); }
- while (prog[++ip] !== 0x2D);
+ for (var i = 0; i < pLen; i++) {
+ cp = z2[i]; // current point
- state.ip = ip;
- state.funcs[fn] = prog.slice(ipBegin + 1, ip);
-}
+ // if this point has been touched go on
+ if (v.touched(cp)) { continue; }
-// MDAP[a] Move Direct Absolute Point
-// 0x2E-0x2F
-function MDAP(round, state) {
- var pi = state.stack.pop();
- var p = state.z0[pi];
- var fv = state.fv;
- var pv = state.pv;
+ pp = cp.prevTouched(v);
- if (DEBUG) console.log(state.step, 'MDAP[' + round + ']', pi);
+ // no point on the contour has been touched?
+ if (pp === cp) { continue; }
- var d = pv.distance(p, HPZero);
+ np = cp.nextTouched(v);
- if (round) d = state.round(d);
+ if (pp === np) {
+ // only one point on the contour has been touched
+ // so simply moves the point like that
- fv.setRelative(p, HPZero, d, pv);
- fv.touch(p);
+ v.setRelative(cp, cp, v.distance(pp, pp, false, true), v, true);
+ }
- state.rp0 = state.rp1 = pi;
-}
+ v.interpolate(cp, pp, np, v);
+ }
+ }
-// IUP[a] Interpolate Untouched Points through the outline
-// 0x30
-function IUP(v, state) {
- var z2 = state.z2;
- var pLen = z2.length - 2;
- var cp;
- var pp;
- var np;
+ // SHP[] SHift Point using reference point
+ // 0x32-0x33
+ function SHP(a, state) {
+ var stack = state.stack;
+ var rpi = a ? state.rp1 : state.rp2;
+ var rp = (a ? state.z0 : state.z1)[rpi];
+ var fv = state.fv;
+ var pv = state.pv;
+ var loop = state.loop;
+ var z2 = state.z2;
+
+ while (loop--)
+ {
+ var pi = stack.pop();
+ var p = z2[pi];
+
+ var d = pv.distance(rp, rp, false, true);
+ fv.setRelative(p, p, d, pv);
+ fv.touch(p);
+
+ if (exports.DEBUG) {
+ console.log(
+ state.step,
+ (state.loop > 1 ?
+ 'loop ' + (state.loop - loop) + ': ' :
+ ''
+ ) +
+ 'SHP[' + (a ? 'rp1' : 'rp2') + ']', pi
+ );
+ }
+ }
+
+ state.loop = 1;
+ }
- if (DEBUG) console.log(state.step, 'IUP[' + v.axis + ']');
+ // SHC[] SHift Contour using reference point
+ // 0x36-0x37
+ function SHC(a, state) {
+ var stack = state.stack;
+ var rpi = a ? state.rp1 : state.rp2;
+ var rp = (a ? state.z0 : state.z1)[rpi];
+ var fv = state.fv;
+ var pv = state.pv;
+ var ci = stack.pop();
+ var sp = state.z2[state.contours[ci]];
+ var p = sp;
+
+ if (exports.DEBUG) { console.log(state.step, 'SHC[' + a + ']', ci); }
+
+ var d = pv.distance(rp, rp, false, true);
+
+ do {
+ if (p !== rp) { fv.setRelative(p, p, d, pv); }
+ p = p.nextPointOnContour;
+ } while (p !== sp);
+ }
- for (var i = 0; i < pLen; i++) {
- cp = z2[i]; // current point
+ // SHZ[] SHift Zone using reference point
+ // 0x36-0x37
+ function SHZ(a, state) {
+ var stack = state.stack;
+ var rpi = a ? state.rp1 : state.rp2;
+ var rp = (a ? state.z0 : state.z1)[rpi];
+ var fv = state.fv;
+ var pv = state.pv;
+
+ var e = stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'SHZ[' + a + ']', e); }
+
+ var z;
+ switch (e) {
+ case 0 : z = state.tZone; break;
+ case 1 : z = state.gZone; break;
+ default : throw new Error('Invalid zone');
+ }
+
+ var p;
+ var d = pv.distance(rp, rp, false, true);
+ var pLen = z.length - 2;
+ for (var i = 0; i < pLen; i++)
+ {
+ p = z[i];
+ fv.setRelative(p, p, d, pv);
+ //if (p !== rp) fv.setRelative(p, p, d, pv);
+ }
+ }
- // if this point has been touched go on
- if (v.touched(cp)) continue;
+ // SHPIX[] SHift point by a PIXel amount
+ // 0x38
+ function SHPIX(state) {
+ var stack = state.stack;
+ var loop = state.loop;
+ var fv = state.fv;
+ var d = stack.pop() / 0x40;
+ var z2 = state.z2;
+
+ while (loop--) {
+ var pi = stack.pop();
+ var p = z2[pi];
+
+ if (exports.DEBUG) {
+ console.log(
+ state.step,
+ (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') +
+ 'SHPIX[]', pi, d
+ );
+ }
+
+ fv.setRelative(p, p, d);
+ fv.touch(p);
+ }
+
+ state.loop = 1;
+ }
- pp = cp.prevTouched(v);
+ // IP[] Interpolate Point
+ // 0x39
+ function IP(state) {
+ var stack = state.stack;
+ var rp1i = state.rp1;
+ var rp2i = state.rp2;
+ var loop = state.loop;
+ var rp1 = state.z0[rp1i];
+ var rp2 = state.z1[rp2i];
+ var fv = state.fv;
+ var pv = state.dpv;
+ var z2 = state.z2;
+
+ while (loop--) {
+ var pi = stack.pop();
+ var p = z2[pi];
+
+ if (exports.DEBUG) {
+ console.log(
+ state.step,
+ (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') +
+ 'IP[]', pi, rp1i, '<->', rp2i
+ );
+ }
+
+ fv.interpolate(p, rp1, rp2, pv);
+
+ fv.touch(p);
+ }
+
+ state.loop = 1;
+ }
- // no point on the contour has been touched?
- if (pp === cp) continue;
+ // MSIRP[a] Move Stack Indirect Relative Point
+ // 0x3A-0x3B
+ function MSIRP(a, state) {
+ var stack = state.stack;
+ var d = stack.pop() / 64;
+ var pi = stack.pop();
+ var p = state.z1[pi];
+ var rp0 = state.z0[state.rp0];
+ var fv = state.fv;
+ var pv = state.pv;
+
+ fv.setRelative(p, rp0, d, pv);
+ fv.touch(p);
+
+ if (exports.DEBUG) { console.log(state.step, 'MSIRP[' + a + ']', d, pi); }
+
+ state.rp1 = state.rp0;
+ state.rp2 = pi;
+ if (a) { state.rp0 = pi; }
+ }
- np = cp.nextTouched(v);
+ // ALIGNRP[] Align to reference point.
+ // 0x3C
+ function ALIGNRP(state) {
+ var stack = state.stack;
+ var rp0i = state.rp0;
+ var rp0 = state.z0[rp0i];
+ var loop = state.loop;
+ var fv = state.fv;
+ var pv = state.pv;
+ var z1 = state.z1;
+
+ while (loop--) {
+ var pi = stack.pop();
+ var p = z1[pi];
+
+ if (exports.DEBUG) {
+ console.log(
+ state.step,
+ (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') +
+ 'ALIGNRP[]', pi
+ );
+ }
+
+ fv.setRelative(p, rp0, 0, pv);
+ fv.touch(p);
+ }
+
+ state.loop = 1;
+ }
- if (pp === np) {
- // only one point on the contour has been touched
- // so simply moves the point like that
+ // RTG[] Round To Double Grid
+ // 0x3D
+ function RTDG(state) {
+ if (exports.DEBUG) { console.log(state.step, 'RTDG[]'); }
- v.setRelative(cp, cp, v.distance(pp, pp, false, true), v, true);
- }
+ state.round = roundToDoubleGrid;
+ }
- v.interpolate(cp, pp, np, v);
- }
-}
+ // MIAP[a] Move Indirect Absolute Point
+ // 0x3E-0x3F
+ function MIAP(round, state) {
+ var stack = state.stack;
+ var n = stack.pop();
+ var pi = stack.pop();
+ var p = state.z0[pi];
+ var fv = state.fv;
+ var pv = state.pv;
+ var cv = state.cvt[n];
-// SHP[] SHift Point using reference point
-// 0x32-0x33
-function SHP(a, state) {
- var stack = state.stack;
- var rpi = a ? state.rp1 : state.rp2;
- var rp = (a ? state.z0 : state.z1)[rpi];
- var fv = state.fv;
- var pv = state.pv;
- var loop = state.loop;
- var z2 = state.z2;
-
- while (loop--)
- {
- var pi = stack.pop();
- var p = z2[pi];
-
- var d = pv.distance(rp, rp, false, true);
- fv.setRelative(p, p, d, pv);
- fv.touch(p);
-
- if (DEBUG) {
- console.log(
- state.step,
- (state.loop > 1 ?
- 'loop ' + (state.loop - loop) + ': ' :
- ''
- ) +
- 'SHP[' + (a ? 'rp1' : 'rp2') + ']', pi
- );
- }
- }
+ if (exports.DEBUG) {
+ console.log(
+ state.step,
+ 'MIAP[' + round + ']',
+ n, '(', cv, ')', pi
+ );
+ }
- state.loop = 1;
-}
+ var d = pv.distance(p, HPZero);
-// SHC[] SHift Contour using reference point
-// 0x36-0x37
-function SHC(a, state) {
- var stack = state.stack;
- var rpi = a ? state.rp1 : state.rp2;
- var rp = (a ? state.z0 : state.z1)[rpi];
- var fv = state.fv;
- var pv = state.pv;
- var ci = stack.pop();
- var sp = state.z2[state.contours[ci]];
- var p = sp;
+ if (round) {
+ if (Math.abs(d - cv) < state.cvCutIn) { d = cv; }
- if (DEBUG) console.log(state.step, 'SHC[' + a + ']', ci);
+ d = state.round(d);
+ }
- var d = pv.distance(rp, rp, false, true);
+ fv.setRelative(p, HPZero, d, pv);
- do {
- if (p !== rp) fv.setRelative(p, p, d, pv);
- p = p.nextPointOnContour;
- } while (p !== sp);
-}
+ if (state.zp0 === 0) {
+ p.xo = p.x;
+ p.yo = p.y;
+ }
-// SHZ[] SHift Zone using reference point
-// 0x36-0x37
-function SHZ(a, state) {
- var stack = state.stack;
- var rpi = a ? state.rp1 : state.rp2;
- var rp = (a ? state.z0 : state.z1)[rpi];
- var fv = state.fv;
- var pv = state.pv;
+ fv.touch(p);
- var e = stack.pop();
+ state.rp0 = state.rp1 = pi;
+ }
- if (DEBUG) console.log(state.step, 'SHZ[' + a + ']', e);
+ // NPUSB[] PUSH N Bytes
+ // 0x40
+ function NPUSHB(state) {
+ var prog = state.prog;
+ var ip = state.ip;
+ var stack = state.stack;
- var z;
- switch (e) {
- case 0 : z = state.tZone; break;
- case 1 : z = state.gZone; break;
- default : throw new Error('Invalid zone');
- }
+ var n = prog[++ip];
- var p;
- var d = pv.distance(rp, rp, false, true);
- var pLen = z.length - 2;
- for (var i = 0; i < pLen; i++)
- {
- p = z[i];
- if (p !== rp) fv.setRelative(p, p, d, pv);
- }
-}
+ if (exports.DEBUG) { console.log(state.step, 'NPUSHB[]', n); }
-// SHPIX[] SHift point by a PIXel amount
-// 0x38
-function SHPIX(state) {
- var stack = state.stack;
- var loop = state.loop;
- var fv = state.fv;
- var d = stack.pop() / 0x40;
- var z2 = state.z2;
-
- while (loop--) {
- var pi = stack.pop();
- var p = z2[pi];
-
- if (DEBUG) console.log(
- state.step,
- (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') +
- 'SHPIX[]', pi, d
- );
+ for (var i = 0; i < n; i++) { stack.push(prog[++ip]); }
- fv.setRelative(p, p, d);
- fv.touch(p);
- }
+ state.ip = ip;
+ }
- state.loop = 1;
-}
+ // NPUSHW[] PUSH N Words
+ // 0x41
+ function NPUSHW(state) {
+ var ip = state.ip;
+ var prog = state.prog;
+ var stack = state.stack;
+ var n = prog[++ip];
-// IP[] Interpolate Point
-// 0x39
-function IP(state) {
- var stack = state.stack;
- var rp1i = state.rp1;
- var rp2i = state.rp2;
- var loop = state.loop;
- var rp1 = state.z0[rp1i];
- var rp2 = state.z1[rp2i];
- var fv = state.fv;
- var pv = state.dpv;
- var z2 = state.z2;
-
- while (loop--) {
- var pi = stack.pop();
- var p = z2[pi];
-
- if (DEBUG) console.log(
- state.step,
- (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') +
- 'IP[]', pi, rp1i, '<->', rp2i
- );
+ if (exports.DEBUG) { console.log(state.step, 'NPUSHW[]', n); }
- fv.interpolate(p, rp1, rp2, pv);
+ for (var i = 0; i < n; i++) {
+ var w = (prog[++ip] << 8) | prog[++ip];
+ if (w & 0x8000) { w = -((w ^ 0xffff) + 1); }
+ stack.push(w);
+ }
- fv.touch(p);
- }
+ state.ip = ip;
+ }
- state.loop = 1;
-}
+ // WS[] Write Store
+ // 0x42
+ function WS(state) {
+ var stack = state.stack;
+ var store = state.store;
-// MSIRP[a] Move Stack Indirect Relative Point
-// 0x3A-0x3B
-function MSIRP(a, state) {
- var stack = state.stack;
- var d = stack.pop() / 64;
- var pi = stack.pop();
- var p = state.z1[pi];
- var rp0 = state.z0[state.rp0];
- var fv = state.fv;
- var pv = state.pv;
-
- fv.setRelative(p, rp0, d, pv);
- fv.touch(p);
-
- if (DEBUG) console.log(state.step, 'MSIRP[' + a + ']', d, pi);
-
- state.rp1 = state.rp0;
- state.rp2 = pi;
- if (a) state.rp0 = pi;
-}
+ if (!store) { store = state.store = []; }
-// ALIGNRP[] Align to reference point.
-// 0x3C
-function ALIGNRP(state) {
- var stack = state.stack;
- var rp0i = state.rp0;
- var rp0 = state.z0[rp0i];
- var loop = state.loop;
- var fv = state.fv;
- var pv = state.pv;
- var z1 = state.z1;
-
- while (loop--) {
- var pi = stack.pop();
- var p = z1[pi];
-
- if (DEBUG) console.log(
- state.step,
- (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') +
- 'ALIGNRP[]', pi
- );
+ var v = stack.pop();
+ var l = stack.pop();
- fv.setRelative(p, rp0, 0, pv);
- fv.touch(p);
- }
+ if (exports.DEBUG) { console.log(state.step, 'WS', v, l); }
- state.loop = 1;
-}
+ store[l] = v;
+ }
-// RTG[] Round To Double Grid
-// 0x3D
-function RTDG(state) {
- if (DEBUG) console.log(state.step, 'RTDG[]');
+ // RS[] Read Store
+ // 0x43
+ function RS(state) {
+ var stack = state.stack;
+ var store = state.store;
- state.round = roundToDoubleGrid;
-}
+ var l = stack.pop();
-// MIAP[a] Move Indirect Absolute Point
-// 0x3E-0x3F
-function MIAP(round, state) {
- var stack = state.stack;
- var n = stack.pop();
- var pi = stack.pop();
- var p = state.z0[pi];
- var fv = state.fv;
- var pv = state.pv;
- var cv = state.cvt[n];
-
- // TODO cvtcutin should be considered here
- if (round) cv = state.round(cv);
-
- if (DEBUG) {
- console.log(
- state.step,
- 'MIAP[' + round + ']',
- n, '(', cv, ')', pi
- );
- }
+ if (exports.DEBUG) { console.log(state.step, 'RS', l); }
- fv.setRelative(p, HPZero, cv, pv);
+ var v = (store && store[l]) || 0;
- if (state.zp0 === 0) {
- p.xo = p.x;
- p.yo = p.y;
- }
+ stack.push(v);
+ }
- fv.touch(p);
+ // WCVTP[] Write Control Value Table in Pixel units
+ // 0x44
+ function WCVTP(state) {
+ var stack = state.stack;
- state.rp0 = state.rp1 = pi;
-}
+ var v = stack.pop();
+ var l = stack.pop();
-// NPUSB[] PUSH N Bytes
-// 0x40
-function NPUSHB(state) {
- var prog = state.prog;
- var ip = state.ip;
- var stack = state.stack;
+ if (exports.DEBUG) { console.log(state.step, 'WCVTP', v, l); }
- var n = prog[++ip];
+ state.cvt[l] = v / 0x40;
+ }
- if (DEBUG) console.log(state.step, 'NPUSHB[]', n);
+ // RCVT[] Read Control Value Table entry
+ // 0x45
+ function RCVT(state) {
+ var stack = state.stack;
+ var cvte = stack.pop();
- for (var i = 0; i < n; i++) stack.push(prog[++ip]);
+ if (exports.DEBUG) { console.log(state.step, 'RCVT', cvte); }
- state.ip = ip;
-}
+ stack.push(state.cvt[cvte] * 0x40);
+ }
-// NPUSHW[] PUSH N Words
-// 0x41
-function NPUSHW(state) {
- var ip = state.ip;
- var prog = state.prog;
- var stack = state.stack;
- var n = prog[++ip];
+ // GC[] Get Coordinate projected onto the projection vector
+ // 0x46-0x47
+ function GC(a, state) {
+ var stack = state.stack;
+ var pi = stack.pop();
+ var p = state.z2[pi];
- if (DEBUG) console.log(state.step, 'NPUSHW[]', n);
+ if (exports.DEBUG) { console.log(state.step, 'GC[' + a + ']', pi); }
- for (var i = 0; i < n; i++) {
- var w = (prog[++ip] << 8) | prog[++ip];
- if (w & 0x8000) w = -((w ^ 0xffff) + 1);
- stack.push(w);
- }
+ stack.push(state.dpv.distance(p, HPZero, a, false) * 0x40);
+ }
- state.ip = ip;
-}
+ // MD[a] Measure Distance
+ // 0x49-0x4A
+ function MD(a, state) {
+ var stack = state.stack;
+ var pi2 = stack.pop();
+ var pi1 = stack.pop();
+ var p2 = state.z1[pi2];
+ var p1 = state.z0[pi1];
+ var d = state.dpv.distance(p1, p2, a, a);
-// WS[] Write Store
-// 0x42
-function WS(state) {
- var stack = state.stack;
- var store = state.store;
+ if (exports.DEBUG) { console.log(state.step, 'MD[' + a + ']', pi2, pi1, '->', d); }
- if (!store) store = state.store = [];
+ state.stack.push(Math.round(d * 64));
+ }
- var v = stack.pop();
- var l = stack.pop();
+ // MPPEM[] Measure Pixels Per EM
+ // 0x4B
+ function MPPEM(state) {
+ if (exports.DEBUG) { console.log(state.step, 'MPPEM[]'); }
+ state.stack.push(state.ppem);
+ }
- if (DEBUG) console.log(state.step, 'WS', v, l);
+ // FLIPON[] set the auto FLIP Boolean to ON
+ // 0x4D
+ function FLIPON(state) {
+ if (exports.DEBUG) { console.log(state.step, 'FLIPON[]'); }
+ state.autoFlip = true;
+ }
- store[l] = v;
-}
+ // LT[] Less Than
+ // 0x50
+ function LT(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
-// RS[] Read Store
-// 0x43
-function RS(state) {
- var stack = state.stack;
- var store = state.store;
+ if (exports.DEBUG) { console.log(state.step, 'LT[]', e2, e1); }
- var l = stack.pop();
+ stack.push(e1 < e2 ? 1 : 0);
+ }
- if (DEBUG) console.log(state.step, 'RS', l);
+ // LTEQ[] Less Than or EQual
+ // 0x53
+ function LTEQ(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
- var v = (store && store[l]) || 0;
+ if (exports.DEBUG) { console.log(state.step, 'LTEQ[]', e2, e1); }
- stack.push(v);
-}
+ stack.push(e1 <= e2 ? 1 : 0);
+ }
-// WCVTP[] Write Control Value Table in Pixel units
-// 0x44
-function WCVTP(state) {
- var stack = state.stack;
+ // GTEQ[] Greater Than
+ // 0x52
+ function GT(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
- var v = stack.pop();
- var l = stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'GT[]', e2, e1); }
- if (DEBUG) console.log(state.step, 'WCVTP', v, l);
+ stack.push(e1 > e2 ? 1 : 0);
+ }
- state.cvt[l] = v / 0x40;
-}
+ // GTEQ[] Greater Than or EQual
+ // 0x53
+ function GTEQ(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
-// RCVT[] Read Control Value Table entry
-// 0x45
-function RCVT(state) {
- var stack = state.stack;
- var cvte = stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'GTEQ[]', e2, e1); }
- if (DEBUG) console.log(state.step, 'RCVT', cvte);
+ stack.push(e1 >= e2 ? 1 : 0);
+ }
- stack.push(state.cvt[cvte] * 0x40);
-}
+ // EQ[] EQual
+ // 0x54
+ function EQ(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
-// GC[] Get Coordinate projected onto the projection vector
-// 0x46-0x47
-function GC(a, state) {
- var stack = state.stack;
- var pi = stack.pop();
- var p = state.z2[pi];
+ if (exports.DEBUG) { console.log(state.step, 'EQ[]', e2, e1); }
- if (DEBUG) console.log(state.step, 'GC[' + a + ']', pi);
+ stack.push(e2 === e1 ? 1 : 0);
+ }
- stack.push(state.dpv.distance(p, HPZero, a, false) * 0x40);
-}
+ // NEQ[] Not EQual
+ // 0x55
+ function NEQ(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
-// MD[a] Measure Distance
-// 0x49-0x4A
-function MD(a, state) {
- var stack = state.stack;
- var pi2 = stack.pop();
- var pi1 = stack.pop();
- var p2 = state.z1[pi2];
- var p1 = state.z0[pi1];
- var d = state.dpv.distance(p1, p2, a, a);
+ if (exports.DEBUG) { console.log(state.step, 'NEQ[]', e2, e1); }
- if (DEBUG) console.log(state.step, 'MD[' + a + ']', pi2, pi1, '->', d);
+ stack.push(e2 !== e1 ? 1 : 0);
+ }
- state.stack.push(Math.round(d * 64));
-}
+ // ODD[] ODD
+ // 0x56
+ function ODD(state) {
+ var stack = state.stack;
+ var n = stack.pop();
-// MPPEM[] Measure Pixels Per EM
-// 0x4B
-function MPPEM(state) {
- if (DEBUG) console.log(state.step, 'MPPEM[]');
- state.stack.push(state.ppem);
-}
+ if (exports.DEBUG) { console.log(state.step, 'ODD[]', n); }
-// FLIPON[] set the auto FLIP Boolean to ON
-// 0x4D
-function FLIPON(state) {
- if (DEBUG) console.log(state.step, 'FLIPON[]');
- state.autoFlip = true;
-}
+ stack.push(Math.trunc(n) % 2 ? 1 : 0);
+ }
-// LT[] Less Than
-// 0x50
-function LT(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ // EVEN[] EVEN
+ // 0x57
+ function EVEN(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- if (DEBUG) console.log(state.step, 'LT[]', e2, e1);
+ if (exports.DEBUG) { console.log(state.step, 'EVEN[]', n); }
- stack.push(e1 < e2 ? 1 : 0);
-}
+ stack.push(Math.trunc(n) % 2 ? 0 : 1);
+ }
-// LTEQ[] Less Than or EQual
-// 0x53
-function LTEQ(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ // IF[] IF test
+ // 0x58
+ function IF(state) {
+ var test = state.stack.pop();
- if (DEBUG) console.log(state.step, 'LTEQ[]', e2, e1);
+ if (exports.DEBUG) { console.log(state.step, 'IF[]', test); }
- stack.push(e1 <= e2 ? 1 : 0);
-}
+ // if test is true it just continues
+ // if not the ip is skipped until matching ELSE or EIF
+ if (!test) {
+ skip(state, true);
-// GTEQ[] Greater Than
-// 0x52
-function GT(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ if (exports.DEBUG) { console.log(state.step, 'EIF[]'); }
+ }
+ }
- if (DEBUG) console.log(state.step, 'GT[]', e2, e1);
+ // EIF[] End IF
+ // 0x59
+ function EIF(state) {
+ // this can be reached normally when
+ // executing an else branch.
+ // -> just ignore it
- stack.push(e1 > e2 ? 1 : 0);
-}
+ if (exports.DEBUG) { console.log(state.step, 'EIF[]'); }
+ }
-// GTEQ[] Greater Than or EQual
-// 0x53
-function GTEQ(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ // AND[] logical AND
+ // 0x5A
+ function AND(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
- if (DEBUG) console.log(state.step, 'GTEQ[]', e2, e1);
+ if (exports.DEBUG) { console.log(state.step, 'AND[]', e2, e1); }
- stack.push(e1 >= e2 ? 1 : 0);
-}
+ stack.push(e2 && e1 ? 1 : 0);
+ }
-// EQ[] EQual
-// 0x54
-function EQ(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ // OR[] logical OR
+ // 0x5B
+ function OR(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
- if (DEBUG) console.log(state.step, 'EQ[]', e2, e1);
+ if (exports.DEBUG) { console.log(state.step, 'OR[]', e2, e1); }
- stack.push(e2 === e1 ? 1 : 0);
-}
+ stack.push(e2 || e1 ? 1 : 0);
+ }
-// NEQ[] Not EQual
-// 0x55
-function NEQ(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ // NOT[] logical NOT
+ // 0x5C
+ function NOT(state) {
+ var stack = state.stack;
+ var e = stack.pop();
- if (DEBUG) console.log(state.step, 'NEQ[]', e2, e1);
+ if (exports.DEBUG) { console.log(state.step, 'NOT[]', e); }
- stack.push(e2 !== e1 ? 1 : 0);
-}
+ stack.push(e ? 0 : 1);
+ }
-// ODD[] ODD
-// 0x56
-function ODD(state) {
- var stack = state.stack;
- var n = stack.pop();
+ // DELTAP1[] DELTA exception P1
+ // DELTAP2[] DELTA exception P2
+ // DELTAP3[] DELTA exception P3
+ // 0x5D, 0x71, 0x72
+ function DELTAP123(b, state) {
+ var stack = state.stack;
+ var n = stack.pop();
+ var fv = state.fv;
+ var pv = state.pv;
+ var ppem = state.ppem;
+ var base = state.deltaBase + (b - 1) * 16;
+ var ds = state.deltaShift;
+ var z0 = state.z0;
+
+ if (exports.DEBUG) { console.log(state.step, 'DELTAP[' + b + ']', n, stack); }
+
+ for (var i = 0; i < n; i++) {
+ var pi = stack.pop();
+ var arg = stack.pop();
+ var appem = base + ((arg & 0xF0) >> 4);
+ if (appem !== ppem) { continue; }
+
+ var mag = (arg & 0x0F) - 8;
+ if (mag >= 0) { mag++; }
+ if (exports.DEBUG) { console.log(state.step, 'DELTAPFIX', pi, 'by', mag * ds); }
+
+ var p = z0[pi];
+ fv.setRelative(p, p, mag * ds, pv);
+ }
+ }
- if (DEBUG) console.log(state.step, 'ODD[]', n);
+ // SDB[] Set Delta Base in the graphics state
+ // 0x5E
+ function SDB(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- stack.push(Math.trunc(n) % 2 ? 1 : 0);
-}
+ if (exports.DEBUG) { console.log(state.step, 'SDB[]', n); }
-// EVEN[] EVEN
-// 0x57
-function EVEN(state) {
- var stack = state.stack;
- var n = stack.pop();
+ state.deltaBase = n;
+ }
- if (DEBUG) console.log(state.step, 'EVEN[]', n);
+ // SDS[] Set Delta Shift in the graphics state
+ // 0x5F
+ function SDS(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- stack.push(Math.trunc(n) % 2 ? 0 : 1);
-}
+ if (exports.DEBUG) { console.log(state.step, 'SDS[]', n); }
-// IF[] IF test
-// 0x58
-function IF(state) {
- var test = state.stack.pop();
- var ins;
+ state.deltaShift = Math.pow(0.5, n);
+ }
- if (DEBUG) console.log(state.step, 'IF[]', test);
+ // ADD[] ADD
+ // 0x60
+ function ADD(state) {
+ var stack = state.stack;
+ var n2 = stack.pop();
+ var n1 = stack.pop();
- // if test is true it just continues
- // if not the ip is skipped until matching ELSE or EIF
- if (!test) {
- skip(state, true);
+ if (exports.DEBUG) { console.log(state.step, 'ADD[]', n2, n1); }
- if (DEBUG) console.log(state.step, ins === 0x1B ? 'ELSE[]' : 'EIF[]');
- }
-}
+ stack.push(n1 + n2);
+ }
-// EIF[] End IF
-// 0x59
-function EIF(state) {
- // this can be reached normally when
- // executing an else branch.
- // -> just ignore it
+ // SUB[] SUB
+ // 0x61
+ function SUB(state) {
+ var stack = state.stack;
+ var n2 = stack.pop();
+ var n1 = stack.pop();
- if (DEBUG) console.log(state.step, 'EIF[]');
-}
+ if (exports.DEBUG) { console.log(state.step, 'SUB[]', n2, n1); }
-// AND[] logical AND
-// 0x5A
-function AND(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ stack.push(n1 - n2);
+ }
- if (DEBUG) console.log(state.step, 'AND[]', e2, e1);
+ // DIV[] DIV
+ // 0x62
+ function DIV(state) {
+ var stack = state.stack;
+ var n2 = stack.pop();
+ var n1 = stack.pop();
- stack.push(e2 && e1 ? 1 : 0);
-}
+ if (exports.DEBUG) { console.log(state.step, 'DIV[]', n2, n1); }
-// OR[] logical OR
-// 0x5B
-function OR(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ stack.push(n1 * 64 / n2);
+ }
- if (DEBUG) console.log(state.step, 'OR[]', e2, e1);
+ // MUL[] MUL
+ // 0x63
+ function MUL(state) {
+ var stack = state.stack;
+ var n2 = stack.pop();
+ var n1 = stack.pop();
- stack.push(e2 || e1 ? 1 : 0);
-}
+ if (exports.DEBUG) { console.log(state.step, 'MUL[]', n2, n1); }
-// NOT[] logical NOT
-// 0x5C
-function NOT(state) {
- var stack = state.stack;
- var e = stack.pop();
+ stack.push(n1 * n2 / 64);
+ }
- if (DEBUG) console.log(state.step, 'NOT[]', e);
+ // ABS[] ABSolute value
+ // 0x64
+ function ABS(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- stack.push(e ? 0 : 1);
-}
+ if (exports.DEBUG) { console.log(state.step, 'ABS[]', n); }
-// DELTAP1[] DELTA exception P1
-// DELTAP2[] DELTA exception P2
-// DELTAP3[] DELTA exception P3
-// 0x5D, 0x71, 0x72
-function DELTAP123(b, state) {
- var stack = state.stack;
- var n = stack.pop();
- var fv = state.fv;
- var pv = state.pv;
- var ppem = state.ppem;
- var base = state.deltaBase + (b - 1) * 16;
- var ds = state.deltaShift;
- var z0 = state.z0;
-
- if (DEBUG) console.log(state.step, 'DELTAP[' + b + ']', n, stack);
-
- for (var i = 0; i < n; i++)
- {
- var pi = stack.pop();
- var arg = stack.pop();
- var appem = base + ((arg & 0xF0) >> 4);
- if (appem !== ppem) continue;
-
- var mag = (arg & 0x0F) - 8;
- if (mag >= 0) mag++;
- if (DEBUG) console.log(state.step, 'DELTAPFIX', pi, 'by', mag * ds);
-
- var p = z0[pi];
- fv.setRelative(p, p, mag * ds, pv);
- }
-}
+ stack.push(Math.abs(n));
+ }
-// SDB[] Set Delta Base in the graphics state
-// 0x5E
-function SDB(state) {
- var stack = state.stack;
- var n = stack.pop();
+ // NEG[] NEGate
+ // 0x65
+ function NEG(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- if (DEBUG) console.log(state.step, 'SDB[]', n);
+ if (exports.DEBUG) { console.log(state.step, 'NEG[]', n); }
- state.deltaBase = n;
-}
+ stack.push(-n);
+ }
-// SDS[] Set Delta Shift in the graphics state
-// 0x5F
-function SDS(state) {
- var stack = state.stack;
- var n = stack.pop();
+ // FLOOR[] FLOOR
+ // 0x66
+ function FLOOR(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- if (DEBUG) console.log(state.step, 'SDS[]', n);
+ if (exports.DEBUG) { console.log(state.step, 'FLOOR[]', n); }
- state.deltaShift = Math.pow(0.5, n);
-}
+ stack.push(Math.floor(n / 0x40) * 0x40);
+ }
-// ADD[] ADD
-// 0x60
-function ADD(state) {
- var stack = state.stack;
- var n2 = stack.pop();
- var n1 = stack.pop();
+ // CEILING[] CEILING
+ // 0x67
+ function CEILING(state) {
+ var stack = state.stack;
+ var n = stack.pop();
- if (DEBUG) console.log(state.step, 'ADD[]', n2, n1);
+ if (exports.DEBUG) { console.log(state.step, 'CEILING[]', n); }
- stack.push(n1 + n2);
-}
+ stack.push(Math.ceil(n / 0x40) * 0x40);
+ }
-// SUB[] SUB
-// 0x61
-function SUB(state) {
- var stack = state.stack;
- var n2 = stack.pop();
- var n1 = stack.pop();
+ // ROUND[ab] ROUND value
+ // 0x68-0x6B
+ function ROUND(dt, state) {
+ var stack = state.stack;
+ var n = stack.pop();
- if (DEBUG) console.log(state.step, 'SUB[]', n2, n1);
+ if (exports.DEBUG) { console.log(state.step, 'ROUND[]'); }
- stack.push(n1 - n2);
-}
+ stack.push(state.round(n / 0x40) * 0x40);
+ }
-// DIV[] DIV
-// 0x62
-function DIV(state) {
- var stack = state.stack;
- var n2 = stack.pop();
- var n1 = stack.pop();
+ // WCVTF[] Write Control Value Table in Funits
+ // 0x70
+ function WCVTF(state) {
+ var stack = state.stack;
+ var v = stack.pop();
+ var l = stack.pop();
- if (DEBUG) console.log(state.step, 'DIV[]', n2, n1);
+ if (exports.DEBUG) { console.log(state.step, 'WCVTF[]', v, l); }
- stack.push(n1 * 64 / n2);
-}
+ state.cvt[l] = v * state.ppem / state.font.unitsPerEm;
+ }
-// MUL[] MUL
-// 0x63
-function MUL(state) {
- var stack = state.stack;
- var n2 = stack.pop();
- var n1 = stack.pop();
+ // DELTAC1[] DELTA exception C1
+ // DELTAC2[] DELTA exception C2
+ // DELTAC3[] DELTA exception C3
+ // 0x73, 0x74, 0x75
+ function DELTAC123(b, state) {
+ var stack = state.stack;
+ var n = stack.pop();
+ var ppem = state.ppem;
+ var base = state.deltaBase + (b - 1) * 16;
+ var ds = state.deltaShift;
- if (DEBUG) console.log(state.step, 'MUL[]', n2, n1);
+ if (exports.DEBUG) { console.log(state.step, 'DELTAC[' + b + ']', n, stack); }
- stack.push(n1 * n2 / 64);
-}
+ for (var i = 0; i < n; i++) {
+ var c = stack.pop();
+ var arg = stack.pop();
+ var appem = base + ((arg & 0xF0) >> 4);
+ if (appem !== ppem) { continue; }
-// ABS[] ABSolute value
-// 0x64
-function ABS(state) {
- var stack = state.stack;
- var n = stack.pop();
+ var mag = (arg & 0x0F) - 8;
+ if (mag >= 0) { mag++; }
- if (DEBUG) console.log(state.step, 'ABS[]', n);
+ var delta = mag * ds;
- stack.push(Math.abs(n));
-}
+ if (exports.DEBUG) { console.log(state.step, 'DELTACFIX', c, 'by', delta); }
-// NEG[] NEGate
-// 0x65
-function NEG(state) {
- var stack = state.stack;
- var n = stack.pop();
+ state.cvt[c] += delta;
+ }
+ }
- if (DEBUG) console.log(state.step, 'NEG[]', n);
+ // SROUND[] Super ROUND
+ // 0x76
+ function SROUND(state) {
+ var n = state.stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'SROUND[]', n); }
+
+ state.round = roundSuper;
+
+ var period;
+
+ switch (n & 0xC0) {
+ case 0x00:
+ period = 0.5;
+ break;
+ case 0x40:
+ period = 1;
+ break;
+ case 0x80:
+ period = 2;
+ break;
+ default:
+ throw new Error('invalid SROUND value');
+ }
+
+ state.srPeriod = period;
+
+ switch (n & 0x30) {
+ case 0x00:
+ state.srPhase = 0;
+ break;
+ case 0x10:
+ state.srPhase = 0.25 * period;
+ break;
+ case 0x20:
+ state.srPhase = 0.5 * period;
+ break;
+ case 0x30:
+ state.srPhase = 0.75 * period;
+ break;
+ default: throw new Error('invalid SROUND value');
+ }
+
+ n &= 0x0F;
+
+ if (n === 0) { state.srThreshold = 0; }
+ else { state.srThreshold = (n / 8 - 0.5) * period; }
+ }
- stack.push(-n);
-}
+ // S45ROUND[] Super ROUND 45 degrees
+ // 0x77
+ function S45ROUND(state) {
+ var n = state.stack.pop();
+
+ if (exports.DEBUG) { console.log(state.step, 'S45ROUND[]', n); }
+
+ state.round = roundSuper;
+
+ var period;
+
+ switch (n & 0xC0) {
+ case 0x00:
+ period = Math.sqrt(2) / 2;
+ break;
+ case 0x40:
+ period = Math.sqrt(2);
+ break;
+ case 0x80:
+ period = 2 * Math.sqrt(2);
+ break;
+ default:
+ throw new Error('invalid S45ROUND value');
+ }
+
+ state.srPeriod = period;
+
+ switch (n & 0x30) {
+ case 0x00:
+ state.srPhase = 0;
+ break;
+ case 0x10:
+ state.srPhase = 0.25 * period;
+ break;
+ case 0x20:
+ state.srPhase = 0.5 * period;
+ break;
+ case 0x30:
+ state.srPhase = 0.75 * period;
+ break;
+ default:
+ throw new Error('invalid S45ROUND value');
+ }
+
+ n &= 0x0F;
+
+ if (n === 0) { state.srThreshold = 0; }
+ else { state.srThreshold = (n / 8 - 0.5) * period; }
+ }
-// FLOOR[] FLOOR
-// 0x66
-function FLOOR(state) {
- var stack = state.stack;
- var n = stack.pop();
+ // ROFF[] Round Off
+ // 0x7A
+ function ROFF(state) {
+ if (exports.DEBUG) { console.log(state.step, 'ROFF[]'); }
- if (DEBUG) console.log(state.step, 'FLOOR[]', n);
+ state.round = roundOff;
+ }
- stack.push(Math.floor(n / 0x40) * 0x40);
-}
+ // RUTG[] Round Up To Grid
+ // 0x7C
+ function RUTG(state) {
+ if (exports.DEBUG) { console.log(state.step, 'RUTG[]'); }
-// CEILING[] CEILING
-// 0x67
-function CEILING(state) {
- var stack = state.stack;
- var n = stack.pop();
+ state.round = roundUpToGrid;
+ }
- if (DEBUG) console.log(state.step, 'CEILING[]', n);
+ // RDTG[] Round Down To Grid
+ // 0x7D
+ function RDTG(state) {
+ if (exports.DEBUG) { console.log(state.step, 'RDTG[]'); }
- stack.push(Math.ceil(n / 0x40) * 0x40);
-}
+ state.round = roundDownToGrid;
+ }
-// ROUND[ab] ROUND value
-// 0x68-0x6B
-function ROUND(dt, state) {
- var stack = state.stack;
- var n = stack.pop();
+ // SCANCTRL[] SCAN conversion ConTRoL
+ // 0x85
+ function SCANCTRL(state) {
+ var n = state.stack.pop();
- if (DEBUG) console.log(state.step, 'ROUND[]');
+ // ignored by opentype.js
- stack.push(state.round(n / 0x40) * 0x40);
-}
+ if (exports.DEBUG) { console.log(state.step, 'SCANCTRL[]', n); }
+ }
-// WCVTF[] Write Control Value Table in Funits
-// 0x70
-function WCVTF(state) {
- var stack = state.stack;
- var v = stack.pop();
- var l = stack.pop();
+ // SDPVTL[a] Set Dual Projection Vector To Line
+ // 0x86-0x87
+ function SDPVTL(a, state) {
+ var stack = state.stack;
+ var p2i = stack.pop();
+ var p1i = stack.pop();
+ var p2 = state.z2[p2i];
+ var p1 = state.z1[p1i];
+
+ if (exports.DEBUG) { console.log(state.step, 'SDPVTL[' + a + ']', p2i, p1i); }
+
+ var dx;
+ var dy;
+
+ if (!a) {
+ dx = p1.x - p2.x;
+ dy = p1.y - p2.y;
+ } else {
+ dx = p2.y - p1.y;
+ dy = p1.x - p2.x;
+ }
+
+ state.dpv = getUnitVector(dx, dy);
+ }
- if (DEBUG) console.log(state.step, 'WCVTF[]', v, l);
+ // GETINFO[] GET INFOrmation
+ // 0x88
+ function GETINFO(state) {
+ var stack = state.stack;
+ var sel = stack.pop();
+ var r = 0;
- state.cvt[l] = v * state.ppem / state.font.unitsPerEm;
-}
+ if (exports.DEBUG) { console.log(state.step, 'GETINFO[]', sel); }
-// DELTAC1[] DELTA exception C1
-// DELTAC2[] DELTA exception C2
-// DELTAC3[] DELTA exception C3
-// 0x73, 0x74, 0x75
-function DELTAC123(b, state) {
- var stack = state.stack;
- var n = stack.pop();
- var ppem = state.ppem;
- var base = state.deltaBase + (b - 1) * 16;
- var ds = state.deltaShift;
+ // v35 as in no subpixel hinting
+ if (sel & 0x01) { r = 35; }
- if (DEBUG) console.log(state.step, 'DELTAC[' + b + ']', n, stack);
+ // TODO rotation and stretch currently not supported
+ // and thus those GETINFO are always 0.
- for (var i = 0; i < n; i++) {
- var c = stack.pop();
- var arg = stack.pop();
- var appem = base + ((arg & 0xF0) >> 4);
- if (appem !== ppem) continue;
+ // opentype.js is always gray scaling
+ if (sel & 0x20) { r |= 0x1000; }
- var mag = (arg & 0x0F) - 8;
- if (mag >= 0) mag++;
+ stack.push(r);
+ }
- var delta = mag * ds;
+ // ROLL[] ROLL the top three stack elements
+ // 0x8A
+ function ROLL(state) {
+ var stack = state.stack;
+ var a = stack.pop();
+ var b = stack.pop();
+ var c = stack.pop();
- if (DEBUG) console.log(state.step, 'DELTACFIX', c, 'by', delta);
+ if (exports.DEBUG) { console.log(state.step, 'ROLL[]'); }
- state.cvt[c] += delta;
- }
-}
+ stack.push(b);
+ stack.push(a);
+ stack.push(c);
+ }
-// SROUND[] Super ROUND
-// 0x76
-function SROUND(state) {
- var n = state.stack.pop();
+ // MAX[] MAXimum of top two stack elements
+ // 0x8B
+ function MAX(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
- if (DEBUG) console.log(state.step, 'SROUND[]', n);
+ if (exports.DEBUG) { console.log(state.step, 'MAX[]', e2, e1); }
- state.round = roundSuper;
+ stack.push(Math.max(e1, e2));
+ }
- var period;
+ // MIN[] MINimum of top two stack elements
+ // 0x8C
+ function MIN(state) {
+ var stack = state.stack;
+ var e2 = stack.pop();
+ var e1 = stack.pop();
- switch (n & 0xC0) {
- case 0x00:
- period = 0.5;
- break;
- case 0x40:
- period = 1;
- break;
- case 0x80:
- period = 2;
- break;
- default:
- throw new Error('invalid SROUND value');
- }
+ if (exports.DEBUG) { console.log(state.step, 'MIN[]', e2, e1); }
- state.srPeriod = period;
+ stack.push(Math.min(e1, e2));
+ }
- switch (n & 0x30) {
- case 0x00:
- state.srPhase = 0;
- break;
- case 0x10:
- state.srPhase = 0.25 * period;
- break;
- case 0x20:
- state.srPhase = 0.5 * period;
- break;
- case 0x30:
- state.srPhase = 0.75 * period;
- break;
- default: throw new Error('invalid SROUND value');
- }
+ // SCANTYPE[] SCANTYPE
+ // 0x8D
+ function SCANTYPE(state) {
+ var n = state.stack.pop();
+ // ignored by opentype.js
+ if (exports.DEBUG) { console.log(state.step, 'SCANTYPE[]', n); }
+ }
- n &= 0x0F;
+ // INSTCTRL[] INSTCTRL
+ // 0x8D
+ function INSTCTRL(state) {
+ var s = state.stack.pop();
+ var v = state.stack.pop();
- if (n === 0) state.srThreshold = 0;
- else state.srThreshold = (n / 8 - 0.5) * period;
-}
+ if (exports.DEBUG) { console.log(state.step, 'INSTCTRL[]', s, v); }
-// S45ROUND[] Super ROUND 45 degrees
-// 0x77
-function S45ROUND(state) {
- var n = state.stack.pop();
+ switch (s) {
+ case 1 : state.inhibitGridFit = !!v; return;
+ case 2 : state.ignoreCvt = !!v; return;
+ default: throw new Error('invalid INSTCTRL[] selector');
+ }
+ }
- if (DEBUG) console.log(state.step, 'S45ROUND[]', n);
+ // PUSHB[abc] PUSH Bytes
+ // 0xB0-0xB7
+ function PUSHB(n, state) {
+ var stack = state.stack;
+ var prog = state.prog;
+ var ip = state.ip;
- state.round = roundSuper;
+ if (exports.DEBUG) { console.log(state.step, 'PUSHB[' + n + ']'); }
- var period;
+ for (var i = 0; i < n; i++) { stack.push(prog[++ip]); }
- switch (n & 0xC0) {
- case 0x00:
- period = Math.sqrt(2) / 2;
- break;
- case 0x40:
- period = Math.sqrt(2);
- break;
- case 0x80:
- period = 2 * Math.sqrt(2);
- break;
- default:
- throw new Error('invalid S45ROUND value');
- }
+ state.ip = ip;
+ }
- state.srPeriod = period;
+ // PUSHW[abc] PUSH Words
+ // 0xB8-0xBF
+ function PUSHW(n, state) {
+ var ip = state.ip;
+ var prog = state.prog;
+ var stack = state.stack;
- switch (n & 0x30) {
- case 0x00:
- state.srPhase = 0;
- break;
- case 0x10:
- state.srPhase = 0.25 * period;
- break;
- case 0x20:
- state.srPhase = 0.5 * period;
- break;
- case 0x30:
- state.srPhase = 0.75 * period;
- break;
- default:
- throw new Error('invalid S45ROUND value');
- }
+ if (exports.DEBUG) { console.log(state.ip, 'PUSHW[' + n + ']'); }
- n &= 0x0F;
+ for (var i = 0; i < n; i++) {
+ var w = (prog[++ip] << 8) | prog[++ip];
+ if (w & 0x8000) { w = -((w ^ 0xffff) + 1); }
+ stack.push(w);
+ }
- if (n === 0) state.srThreshold = 0;
- else state.srThreshold = (n / 8 - 0.5) * period;
-}
+ state.ip = ip;
+ }
-// ROFF[] Round Off
-// 0x7A
-function ROFF(state) {
- if (DEBUG) console.log(state.step, 'ROFF[]');
+ // MDRP[abcde] Move Direct Relative Point
+ // 0xD0-0xEF
+ // (if indirect is 0)
+ //
+ // and
+ //
+ // MIRP[abcde] Move Indirect Relative Point
+ // 0xE0-0xFF
+ // (if indirect is 1)
+
+ function MDRP_MIRP(indirect, setRp0, keepD, ro, dt, state) {
+ var stack = state.stack;
+ var cvte = indirect && stack.pop();
+ var pi = stack.pop();
+ var rp0i = state.rp0;
+ var rp = state.z0[rp0i];
+ var p = state.z1[pi];
+
+ var md = state.minDis;
+ var fv = state.fv;
+ var pv = state.dpv;
+ var od; // original distance
+ var d; // moving distance
+ var sign; // sign of distance
+ var cv;
+
+ d = od = pv.distance(p, rp, true, true);
+ sign = d >= 0 ? 1 : -1; // Math.sign would be 0 in case of 0
+
+ // TODO consider autoFlip
+ d = Math.abs(d);
+
+ if (indirect) {
+ cv = state.cvt[cvte];
+
+ if (ro && Math.abs(d - cv) < state.cvCutIn) { d = cv; }
+ }
+
+ if (keepD && d < md) { d = md; }
+
+ if (ro) { d = state.round(d); }
+
+ fv.setRelative(p, rp, sign * d, pv);
+ fv.touch(p);
+
+ if (exports.DEBUG) {
+ console.log(
+ state.step,
+ (indirect ? 'MIRP[' : 'MDRP[') +
+ (setRp0 ? 'M' : 'm') +
+ (keepD ? '>' : '_') +
+ (ro ? 'R' : '_') +
+ (dt === 0 ? 'Gr' : (dt === 1 ? 'Bl' : (dt === 2 ? 'Wh' : ''))) +
+ ']',
+ indirect ?
+ cvte + '(' + state.cvt[cvte] + ',' + cv + ')' :
+ '',
+ pi,
+ '(d =', od, '->', sign * d, ')'
+ );
+ }
+
+ state.rp1 = state.rp0;
+ state.rp2 = pi;
+ if (setRp0) { state.rp0 = pi; }
+ }
- state.round = roundOff;
-}
+ /*
+ * The instruction table.
+ */
+ instructionTable = [
+ /* 0x00 */ SVTCA.bind(undefined, yUnitVector),
+ /* 0x01 */ SVTCA.bind(undefined, xUnitVector),
+ /* 0x02 */ SPVTCA.bind(undefined, yUnitVector),
+ /* 0x03 */ SPVTCA.bind(undefined, xUnitVector),
+ /* 0x04 */ SFVTCA.bind(undefined, yUnitVector),
+ /* 0x05 */ SFVTCA.bind(undefined, xUnitVector),
+ /* 0x06 */ SPVTL.bind(undefined, 0),
+ /* 0x07 */ SPVTL.bind(undefined, 1),
+ /* 0x08 */ SFVTL.bind(undefined, 0),
+ /* 0x09 */ SFVTL.bind(undefined, 1),
+ /* 0x0A */ SPVFS,
+ /* 0x0B */ SFVFS,
+ /* 0x0C */ GPV,
+ /* 0x0D */ GFV,
+ /* 0x0E */ SFVTPV,
+ /* 0x0F */ ISECT,
+ /* 0x10 */ SRP0,
+ /* 0x11 */ SRP1,
+ /* 0x12 */ SRP2,
+ /* 0x13 */ SZP0,
+ /* 0x14 */ SZP1,
+ /* 0x15 */ SZP2,
+ /* 0x16 */ SZPS,
+ /* 0x17 */ SLOOP,
+ /* 0x18 */ RTG,
+ /* 0x19 */ RTHG,
+ /* 0x1A */ SMD,
+ /* 0x1B */ ELSE,
+ /* 0x1C */ JMPR,
+ /* 0x1D */ SCVTCI,
+ /* 0x1E */ undefined, // TODO SSWCI
+ /* 0x1F */ undefined, // TODO SSW
+ /* 0x20 */ DUP,
+ /* 0x21 */ POP,
+ /* 0x22 */ CLEAR,
+ /* 0x23 */ SWAP,
+ /* 0x24 */ DEPTH,
+ /* 0x25 */ CINDEX,
+ /* 0x26 */ MINDEX,
+ /* 0x27 */ undefined, // TODO ALIGNPTS
+ /* 0x28 */ undefined,
+ /* 0x29 */ undefined, // TODO UTP
+ /* 0x2A */ LOOPCALL,
+ /* 0x2B */ CALL,
+ /* 0x2C */ FDEF,
+ /* 0x2D */ undefined, // ENDF (eaten by FDEF)
+ /* 0x2E */ MDAP.bind(undefined, 0),
+ /* 0x2F */ MDAP.bind(undefined, 1),
+ /* 0x30 */ IUP.bind(undefined, yUnitVector),
+ /* 0x31 */ IUP.bind(undefined, xUnitVector),
+ /* 0x32 */ SHP.bind(undefined, 0),
+ /* 0x33 */ SHP.bind(undefined, 1),
+ /* 0x34 */ SHC.bind(undefined, 0),
+ /* 0x35 */ SHC.bind(undefined, 1),
+ /* 0x36 */ SHZ.bind(undefined, 0),
+ /* 0x37 */ SHZ.bind(undefined, 1),
+ /* 0x38 */ SHPIX,
+ /* 0x39 */ IP,
+ /* 0x3A */ MSIRP.bind(undefined, 0),
+ /* 0x3B */ MSIRP.bind(undefined, 1),
+ /* 0x3C */ ALIGNRP,
+ /* 0x3D */ RTDG,
+ /* 0x3E */ MIAP.bind(undefined, 0),
+ /* 0x3F */ MIAP.bind(undefined, 1),
+ /* 0x40 */ NPUSHB,
+ /* 0x41 */ NPUSHW,
+ /* 0x42 */ WS,
+ /* 0x43 */ RS,
+ /* 0x44 */ WCVTP,
+ /* 0x45 */ RCVT,
+ /* 0x46 */ GC.bind(undefined, 0),
+ /* 0x47 */ GC.bind(undefined, 1),
+ /* 0x48 */ undefined, // TODO SCFS
+ /* 0x49 */ MD.bind(undefined, 0),
+ /* 0x4A */ MD.bind(undefined, 1),
+ /* 0x4B */ MPPEM,
+ /* 0x4C */ undefined, // TODO MPS
+ /* 0x4D */ FLIPON,
+ /* 0x4E */ undefined, // TODO FLIPOFF
+ /* 0x4F */ undefined, // TODO DEBUG
+ /* 0x50 */ LT,
+ /* 0x51 */ LTEQ,
+ /* 0x52 */ GT,
+ /* 0x53 */ GTEQ,
+ /* 0x54 */ EQ,
+ /* 0x55 */ NEQ,
+ /* 0x56 */ ODD,
+ /* 0x57 */ EVEN,
+ /* 0x58 */ IF,
+ /* 0x59 */ EIF,
+ /* 0x5A */ AND,
+ /* 0x5B */ OR,
+ /* 0x5C */ NOT,
+ /* 0x5D */ DELTAP123.bind(undefined, 1),
+ /* 0x5E */ SDB,
+ /* 0x5F */ SDS,
+ /* 0x60 */ ADD,
+ /* 0x61 */ SUB,
+ /* 0x62 */ DIV,
+ /* 0x63 */ MUL,
+ /* 0x64 */ ABS,
+ /* 0x65 */ NEG,
+ /* 0x66 */ FLOOR,
+ /* 0x67 */ CEILING,
+ /* 0x68 */ ROUND.bind(undefined, 0),
+ /* 0x69 */ ROUND.bind(undefined, 1),
+ /* 0x6A */ ROUND.bind(undefined, 2),
+ /* 0x6B */ ROUND.bind(undefined, 3),
+ /* 0x6C */ undefined, // TODO NROUND[ab]
+ /* 0x6D */ undefined, // TODO NROUND[ab]
+ /* 0x6E */ undefined, // TODO NROUND[ab]
+ /* 0x6F */ undefined, // TODO NROUND[ab]
+ /* 0x70 */ WCVTF,
+ /* 0x71 */ DELTAP123.bind(undefined, 2),
+ /* 0x72 */ DELTAP123.bind(undefined, 3),
+ /* 0x73 */ DELTAC123.bind(undefined, 1),
+ /* 0x74 */ DELTAC123.bind(undefined, 2),
+ /* 0x75 */ DELTAC123.bind(undefined, 3),
+ /* 0x76 */ SROUND,
+ /* 0x77 */ S45ROUND,
+ /* 0x78 */ undefined, // TODO JROT[]
+ /* 0x79 */ undefined, // TODO JROF[]
+ /* 0x7A */ ROFF,
+ /* 0x7B */ undefined,
+ /* 0x7C */ RUTG,
+ /* 0x7D */ RDTG,
+ /* 0x7E */ POP, // actually SANGW, supposed to do only a pop though
+ /* 0x7F */ POP, // actually AA, supposed to do only a pop though
+ /* 0x80 */ undefined, // TODO FLIPPT
+ /* 0x81 */ undefined, // TODO FLIPRGON
+ /* 0x82 */ undefined, // TODO FLIPRGOFF
+ /* 0x83 */ undefined,
+ /* 0x84 */ undefined,
+ /* 0x85 */ SCANCTRL,
+ /* 0x86 */ SDPVTL.bind(undefined, 0),
+ /* 0x87 */ SDPVTL.bind(undefined, 1),
+ /* 0x88 */ GETINFO,
+ /* 0x89 */ undefined, // TODO IDEF
+ /* 0x8A */ ROLL,
+ /* 0x8B */ MAX,
+ /* 0x8C */ MIN,
+ /* 0x8D */ SCANTYPE,
+ /* 0x8E */ INSTCTRL,
+ /* 0x8F */ undefined,
+ /* 0x90 */ undefined,
+ /* 0x91 */ undefined,
+ /* 0x92 */ undefined,
+ /* 0x93 */ undefined,
+ /* 0x94 */ undefined,
+ /* 0x95 */ undefined,
+ /* 0x96 */ undefined,
+ /* 0x97 */ undefined,
+ /* 0x98 */ undefined,
+ /* 0x99 */ undefined,
+ /* 0x9A */ undefined,
+ /* 0x9B */ undefined,
+ /* 0x9C */ undefined,
+ /* 0x9D */ undefined,
+ /* 0x9E */ undefined,
+ /* 0x9F */ undefined,
+ /* 0xA0 */ undefined,
+ /* 0xA1 */ undefined,
+ /* 0xA2 */ undefined,
+ /* 0xA3 */ undefined,
+ /* 0xA4 */ undefined,
+ /* 0xA5 */ undefined,
+ /* 0xA6 */ undefined,
+ /* 0xA7 */ undefined,
+ /* 0xA8 */ undefined,
+ /* 0xA9 */ undefined,
+ /* 0xAA */ undefined,
+ /* 0xAB */ undefined,
+ /* 0xAC */ undefined,
+ /* 0xAD */ undefined,
+ /* 0xAE */ undefined,
+ /* 0xAF */ undefined,
+ /* 0xB0 */ PUSHB.bind(undefined, 1),
+ /* 0xB1 */ PUSHB.bind(undefined, 2),
+ /* 0xB2 */ PUSHB.bind(undefined, 3),
+ /* 0xB3 */ PUSHB.bind(undefined, 4),
+ /* 0xB4 */ PUSHB.bind(undefined, 5),
+ /* 0xB5 */ PUSHB.bind(undefined, 6),
+ /* 0xB6 */ PUSHB.bind(undefined, 7),
+ /* 0xB7 */ PUSHB.bind(undefined, 8),
+ /* 0xB8 */ PUSHW.bind(undefined, 1),
+ /* 0xB9 */ PUSHW.bind(undefined, 2),
+ /* 0xBA */ PUSHW.bind(undefined, 3),
+ /* 0xBB */ PUSHW.bind(undefined, 4),
+ /* 0xBC */ PUSHW.bind(undefined, 5),
+ /* 0xBD */ PUSHW.bind(undefined, 6),
+ /* 0xBE */ PUSHW.bind(undefined, 7),
+ /* 0xBF */ PUSHW.bind(undefined, 8),
+ /* 0xC0 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 0),
+ /* 0xC1 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 1),
+ /* 0xC2 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 2),
+ /* 0xC3 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 3),
+ /* 0xC4 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 0),
+ /* 0xC5 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 1),
+ /* 0xC6 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 2),
+ /* 0xC7 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 3),
+ /* 0xC8 */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 0),
+ /* 0xC9 */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 1),
+ /* 0xCA */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 2),
+ /* 0xCB */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 3),
+ /* 0xCC */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 0),
+ /* 0xCD */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 1),
+ /* 0xCE */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 2),
+ /* 0xCF */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 3),
+ /* 0xD0 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 0),
+ /* 0xD1 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 1),
+ /* 0xD2 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 2),
+ /* 0xD3 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 3),
+ /* 0xD4 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 0),
+ /* 0xD5 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 1),
+ /* 0xD6 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 2),
+ /* 0xD7 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 3),
+ /* 0xD8 */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 0),
+ /* 0xD9 */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 1),
+ /* 0xDA */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 2),
+ /* 0xDB */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 3),
+ /* 0xDC */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 0),
+ /* 0xDD */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 1),
+ /* 0xDE */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 2),
+ /* 0xDF */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 3),
+ /* 0xE0 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 0),
+ /* 0xE1 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 1),
+ /* 0xE2 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 2),
+ /* 0xE3 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 3),
+ /* 0xE4 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 0),
+ /* 0xE5 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 1),
+ /* 0xE6 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 2),
+ /* 0xE7 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 3),
+ /* 0xE8 */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 0),
+ /* 0xE9 */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 1),
+ /* 0xEA */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 2),
+ /* 0xEB */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 3),
+ /* 0xEC */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 0),
+ /* 0xED */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 1),
+ /* 0xEE */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 2),
+ /* 0xEF */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 3),
+ /* 0xF0 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 0),
+ /* 0xF1 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 1),
+ /* 0xF2 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 2),
+ /* 0xF3 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 3),
+ /* 0xF4 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 0),
+ /* 0xF5 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 1),
+ /* 0xF6 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 2),
+ /* 0xF7 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 3),
+ /* 0xF8 */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 0),
+ /* 0xF9 */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 1),
+ /* 0xFA */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 2),
+ /* 0xFB */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 3),
+ /* 0xFC */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 0),
+ /* 0xFD */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 1),
+ /* 0xFE */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 2),
+ /* 0xFF */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 3)
+ ];
+
+ /*****************************
+ Mathematical Considerations
+ ******************************
+
+ fv ... refers to freedom vector
+ pv ... refers to projection vector
+ rp ... refers to reference point
+ p ... refers to to point being operated on
+ d ... refers to distance
+
+ SETRELATIVE:
+ ============
+
+ case freedom vector == x-axis:
+ ------------------------------
+
+ (pv)
+ .-'
+ rpd .-'
+ .-*
+ d .-'90°'
+ .-' '
+ .-' '
+ *-' ' b
+ rp '
+ '
+ '
+ p *----------*-------------- (fv)
+ pm
+
+ rpdx = rpx + d * pv.x
+ rpdy = rpy + d * pv.y
+
+ equation of line b
+
+ y - rpdy = pvns * (x- rpdx)
+
+ y = p.y
+
+ x = rpdx + ( p.y - rpdy ) / pvns
+
+
+ case freedom vector == y-axis:
+ ------------------------------
+
+ * pm
+ |\
+ | \
+ | \
+ | \
+ | \
+ | \
+ | \
+ | \
+ | \
+ | \ b
+ | \
+ | \
+ | \ .-' (pv)
+ | 90° \.-'
+ | .-'* rpd
+ | .-'
+ * *-' d
+ p rp
-// RUTG[] Round Up To Grid
-// 0x7C
-function RUTG(state) {
- if (DEBUG) console.log(state.step, 'RUTG[]');
+ rpdx = rpx + d * pv.x
+ rpdy = rpy + d * pv.y
- state.round = roundUpToGrid;
-}
+ equation of line b:
+ pvns ... normal slope to pv
-// RDTG[] Round Down To Grid
-// 0x7D
-function RDTG(state) {
- if (DEBUG) console.log(state.step, 'RDTG[]');
+ y - rpdy = pvns * (x - rpdx)
- state.round = roundDownToGrid;
-}
+ x = p.x
-// SCANCTRL[] SCAN conversion ConTRoL
-// 0x85
-function SCANCTRL(state) {
- var n = state.stack.pop();
+ y = rpdy + pvns * (p.x - rpdx)
- // ignored by opentype.js
- if (DEBUG) console.log(state.step, 'SCANCTRL[]', n);
-}
-// SDPVTL[a] Set Dual Projection Vector To Line
-// 0x86-0x87
-function SDPVTL(a, state) {
- var stack = state.stack;
- var p2i = stack.pop();
- var p1i = stack.pop();
- var p2 = state.z2[p2i];
- var p1 = state.z1[p1i];
+ generic case:
+ -------------
- if (DEBUG) console.log('SDPVTL[' + a + ']', p2i, p1i);
- var dx;
- var dy;
+ .'(fv)
+ .'
+ .* pm
+ .' !
+ .' .
+ .' !
+ .' . b
+ .' !
+ * .
+ p !
+ 90° . ... (pv)
+ ...-*-'''
+ ...---''' rpd
+ ...---''' d
+ *--'''
+ rp
- if (!a) {
- dx = p1.x - p2.x;
- dy = p1.y - p2.y;
- } else {
- dx = p2.y - p1.y;
- dy = p1.x - p2.x;
- }
+ rpdx = rpx + d * pv.x
+ rpdy = rpy + d * pv.y
- state.dpv = getUnitVector(dx, dy);
-}
+ equation of line b:
+ pvns... normal slope to pv
-// GETINFO[] GET INFOrmation
-// 0x88
-function GETINFO(state) {
- var stack = state.stack;
- var sel = stack.pop();
- var r = 0;
+ y - rpdy = pvns * (x - rpdx)
- if (DEBUG) console.log(state.step, 'GETINFO[]', sel);
+ equation of freedom vector line:
+ fvs ... slope of freedom vector (=fy/fx)
- // v35 as in no subpixel hinting
- if (sel & 0x01) r = 35;
+ y - py = fvs * (x - px)
- // TODO rotation and stretch currently not supported
- // and thus those GETINFO are always 0.
- // opentype.js is always gray scaling
- if (sel & 0x20) r |= 0x1000;
+ on pm both equations are true for same x/y
- stack.push(r);
-}
+ y - rpdy = pvns * (x - rpdx)
-// ROLL[] ROLL the top three stack elements
-// 0x8A
-function ROLL(state) {
- var stack = state.stack;
- var a = stack.pop();
- var b = stack.pop();
- var c = stack.pop();
+ y - py = fvs * (x - px)
- if (DEBUG) console.log(state.step, 'ROLL[]');
+ form to y and set equal:
- stack.push(b);
- stack.push(a);
- stack.push(c);
-}
+ pvns * (x - rpdx) + rpdy = fvs * (x - px) + py
-// MAX[] MAXimum of top two stack elements
-// 0x8B
-function MAX(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ expand:
- if (DEBUG) console.log(state.step, 'MAX[]', e2, e1);
+ pvns * x - pvns * rpdx + rpdy = fvs * x - fvs * px + py
- stack.push(Math.max(e1, e2));
-}
+ switch:
-// MIN[] MINimum of top two stack elements
-// 0x8C
-function MIN(state) {
- var stack = state.stack;
- var e2 = stack.pop();
- var e1 = stack.pop();
+ fvs * x - fvs * px + py = pvns * x - pvns * rpdx + rpdy
- if (DEBUG) console.log(state.step, 'MIN[]', e2, e1);
+ solve for x:
- stack.push(Math.min(e1, e2));
-}
+ fvs * x - pvns * x = fvs * px - pvns * rpdx - py + rpdy
-// SCANTYPE[] SCANTYPE
-// 0x8D
-function SCANTYPE(state) {
- var n = state.stack.pop();
- // ignored by opentype.js
- if (DEBUG) console.log(state.step, 'SCANTYPE[]', n);
-}
-// INSTCTRL[] INSTCTRL
-// 0x8D
-function INSTCTRL(state) {
- var s = state.stack.pop();
- var v = state.stack.pop();
- if (DEBUG) console.log(state.step, 'INSTCTRL[]', s, v);
+ fvs * px - pvns * rpdx + rpdy - py
+ x = -----------------------------------
+ fvs - pvns
- switch (s) {
- case 1 : state.inhibitGridFit = !!v; return;
- case 2 : state.ignoreCvt = !!v; return;
- default: throw new Error('invalid INSTCTRL[] selector');
- }
-}
+ and:
-// PUSHB[abc] PUSH Bytes
-// 0xB0-0xB7
-function PUSHB(n, state) {
- var stack = state.stack;
- var prog = state.prog;
- var ip = state.ip;
+ y = fvs * (x - px) + py
- if (DEBUG) console.log(state.step, 'PUSHB[' + n + ']');
- for (var i = 0; i < n; i++) stack.push(prog[++ip]);
- state.ip = ip;
-}
+ INTERPOLATE:
+ ============
-// PUSHW[abc] PUSH Words
-// 0xB8-0xBF
-function PUSHW(n, state) {
- var ip = state.ip;
- var prog = state.prog;
- var stack = state.stack;
+ Examples of point interpolation.
- if (DEBUG) console.log(state.ip, 'PUSHW[' + n + ']');
+ The weight of the movement of the reference point gets bigger
+ the further the other reference point is away, thus the safest
+ option (that is avoiding 0/0 divisions) is to weight the
+ original distance of the other point by the sum of both distances.
- for (var i = 0; i < n; i++) {
- var w = (prog[++ip] << 8) | prog[++ip];
- if (w & 0x8000) w = -((w ^ 0xffff) + 1);
- stack.push(w);
- }
+ If the sum of both distances is 0, then move the point by the
+ arithmetic average of the movement of both reference points.
- state.ip = ip;
-}
-// MDRP[abcde] Move Direct Relative Point
-// 0xD0-0xEF
-// (if indirect is 0)
-//
-// and
-//
-// MIRP[abcde] Move Indirect Relative Point
-// 0xE0-0xFF
-// (if indirect is 1)
-
-function MDRP_MIRP(indirect, setRp0, keepD, ro, dt, state) {
- var stack = state.stack;
- var cvte = indirect && stack.pop();
- var pi = stack.pop();
- var rp0i = state.rp0;
- var rp = state.z0[rp0i];
- var p = state.z1[pi];
-
- var md = state.minDis;
- var fv = state.fv;
- var pv = state.dpv;
- var od; // original distance
- var d; // moving distance
- var sign; // sign of distance
- var cv;
-
- d = od = pv.distance(p, rp, true, true);
- sign = d >= 0 ? 1 : -1; // Math.sign would be 0 in case of 0
-
- // TODO consider autoFlip
- d = Math.abs(d);
-
- if (indirect) {
- cv = state.cvt[cvte];
-
- if (ro && Math.abs(d - cv) < state.cvCutIn) d = cv;
- }
- if (keepD && d < md) d = md;
-
- if (ro) d = state.round(d);
-
- fv.setRelative(p, rp, sign * d, pv);
- fv.touch(p);
-
- if (DEBUG) {
- console.log(
- state.step,
- (indirect ? 'MIRP[' : 'MDRP[') +
- (setRp0 ? 'M' : 'm') +
- (keepD ? '>' : '_') +
- (ro ? 'R' : '_') +
- (dt === 0 ? 'Gr' : (dt === 1 ? 'Bl' : (dt === 2 ? 'Wh' : ''))) +
- ']',
- indirect ?
- cvte + '(' + state.cvt[cvte] + ',' + cv + ')' :
- '',
- pi,
- '(d =', od, '->', sign * d, ')'
- );
- }
- state.rp1 = state.rp0;
- state.rp2 = pi;
- if (setRp0) state.rp0 = pi;
-}
+ (+6)
+ rp1o *---->*rp1
+ . . (+12)
+ . . rp2o *---------->* rp2
+ . . . .
+ . . . .
+ . 10 20 . .
+ |.........|...................| .
+ . . .
+ . . (+8) .
+ po *------>*p .
+ . . .
+ . 12 . 24 .
+ |...........|.......................|
+ 36
-/*
-* The instruction table.
-*/
-instructionTable = [
- /* 0x00 */ SVTCA.bind(undefined, yUnitVector),
- /* 0x01 */ SVTCA.bind(undefined, xUnitVector),
- /* 0x02 */ SPVTCA.bind(undefined, yUnitVector),
- /* 0x03 */ SPVTCA.bind(undefined, xUnitVector),
- /* 0x04 */ SFVTCA.bind(undefined, yUnitVector),
- /* 0x05 */ SFVTCA.bind(undefined, xUnitVector),
- /* 0x06 */ SPVTL.bind(undefined, 0),
- /* 0x07 */ SPVTL.bind(undefined, 1),
- /* 0x08 */ SFVTL.bind(undefined, 0),
- /* 0x09 */ SFVTL.bind(undefined, 1),
- /* 0x0A */ SPVFS,
- /* 0x0B */ SFVFS,
- /* 0x0C */ GPV,
- /* 0x0D */ GFV,
- /* 0x0E */ SFVTPV,
- /* 0x0F */ ISECT,
- /* 0x10 */ SRP0,
- /* 0x11 */ SRP1,
- /* 0x12 */ SRP2,
- /* 0x13 */ SZP0,
- /* 0x14 */ SZP1,
- /* 0x15 */ SZP2,
- /* 0x16 */ SZPS,
- /* 0x17 */ SLOOP,
- /* 0x18 */ RTG,
- /* 0x19 */ RTHG,
- /* 0x1A */ SMD,
- /* 0x1B */ ELSE,
- /* 0x1C */ JMPR,
- /* 0x1D */ SCVTCI,
- /* 0x1E */ undefined, // TODO SSWCI
- /* 0x1F */ undefined, // TODO SSW
- /* 0x20 */ DUP,
- /* 0x21 */ POP,
- /* 0x22 */ CLEAR,
- /* 0x23 */ SWAP,
- /* 0x24 */ DEPTH,
- /* 0x25 */ CINDEX,
- /* 0x26 */ MINDEX,
- /* 0x27 */ undefined, // TODO ALIGNPTS
- /* 0x28 */ undefined,
- /* 0x29 */ undefined, // TODO UTP
- /* 0x2A */ LOOPCALL,
- /* 0x2B */ CALL,
- /* 0x2C */ FDEF,
- /* 0x2D */ undefined, // ENDF (eaten by FDEF)
- /* 0x2E */ MDAP.bind(undefined, 0),
- /* 0x2F */ MDAP.bind(undefined, 1),
- /* 0x30 */ IUP.bind(undefined, yUnitVector),
- /* 0x31 */ IUP.bind(undefined, xUnitVector),
- /* 0x32 */ SHP.bind(undefined, 0),
- /* 0x33 */ SHP.bind(undefined, 1),
- /* 0x34 */ SHC.bind(undefined, 0),
- /* 0x35 */ SHC.bind(undefined, 1),
- /* 0x36 */ SHZ.bind(undefined, 0),
- /* 0x37 */ SHZ.bind(undefined, 1),
- /* 0x38 */ SHPIX,
- /* 0x39 */ IP,
- /* 0x3A */ MSIRP.bind(undefined, 0),
- /* 0x3B */ MSIRP.bind(undefined, 1),
- /* 0x3C */ ALIGNRP,
- /* 0x3D */ RTDG,
- /* 0x3E */ MIAP.bind(undefined, 0),
- /* 0x3F */ MIAP.bind(undefined, 1),
- /* 0x40 */ NPUSHB,
- /* 0x41 */ NPUSHW,
- /* 0x42 */ WS,
- /* 0x43 */ RS,
- /* 0x44 */ WCVTP,
- /* 0x45 */ RCVT,
- /* 0x46 */ GC.bind(undefined, 0),
- /* 0x47 */ GC.bind(undefined, 1),
- /* 0x48 */ undefined, // TODO SCFS
- /* 0x49 */ MD.bind(undefined, 0),
- /* 0x4A */ MD.bind(undefined, 1),
- /* 0x4B */ MPPEM,
- /* 0x4C */ undefined, // TODO MPS
- /* 0x4D */ FLIPON,
- /* 0x4E */ undefined, // TODO FLIPOFF
- /* 0x4F */ undefined, // TODO DEBUG
- /* 0x50 */ LT,
- /* 0x51 */ LTEQ,
- /* 0x52 */ GT,
- /* 0x53 */ GTEQ,
- /* 0x54 */ EQ,
- /* 0x55 */ NEQ,
- /* 0x56 */ ODD,
- /* 0x57 */ EVEN,
- /* 0x58 */ IF,
- /* 0x59 */ EIF,
- /* 0x5A */ AND,
- /* 0x5B */ OR,
- /* 0x5C */ NOT,
- /* 0x5D */ DELTAP123.bind(undefined, 1),
- /* 0x5E */ SDB,
- /* 0x5F */ SDS,
- /* 0x60 */ ADD,
- /* 0x61 */ SUB,
- /* 0x62 */ DIV,
- /* 0x63 */ MUL,
- /* 0x64 */ ABS,
- /* 0x65 */ NEG,
- /* 0x66 */ FLOOR,
- /* 0x67 */ CEILING,
- /* 0x68 */ ROUND.bind(undefined, 0),
- /* 0x69 */ ROUND.bind(undefined, 1),
- /* 0x6A */ ROUND.bind(undefined, 2),
- /* 0x6B */ ROUND.bind(undefined, 3),
- /* 0x6C */ undefined, // TODO NROUND[ab]
- /* 0x6D */ undefined, // TODO NROUND[ab]
- /* 0x6E */ undefined, // TODO NROUND[ab]
- /* 0x6F */ undefined, // TODO NROUND[ab]
- /* 0x70 */ WCVTF,
- /* 0x71 */ DELTAP123.bind(undefined, 2),
- /* 0x72 */ DELTAP123.bind(undefined, 3),
- /* 0x73 */ DELTAC123.bind(undefined, 1),
- /* 0x74 */ DELTAC123.bind(undefined, 2),
- /* 0x75 */ DELTAC123.bind(undefined, 3),
- /* 0x76 */ SROUND,
- /* 0x77 */ S45ROUND,
- /* 0x78 */ undefined, // TODO JROT[]
- /* 0x79 */ undefined, // TODO JROF[]
- /* 0x7A */ ROFF,
- /* 0x7B */ undefined,
- /* 0x7C */ RUTG,
- /* 0x7D */ RDTG,
- /* 0x7E */ POP, // actually SANGW, supposed to do only a pop though
- /* 0x7F */ POP, // actually AA, upposed to do only a pop though
- /* 0x80 */ undefined, // TODO FLIPPT
- /* 0x81 */ undefined, // TODO FLIPRGON
- /* 0x82 */ undefined, // TODO FLIPRGOFF
- /* 0x83 */ undefined,
- /* 0x84 */ undefined,
- /* 0x85 */ SCANCTRL,
- /* 0x86 */ SDPVTL.bind(undefined, 0),
- /* 0x87 */ SDPVTL.bind(undefined, 1),
- /* 0x88 */ GETINFO,
- /* 0x89 */ undefined, // TODO IDEF
- /* 0x8A */ ROLL,
- /* 0x8B */ MAX,
- /* 0x8C */ MIN,
- /* 0x8D */ SCANTYPE,
- /* 0x8E */ INSTCTRL,
- /* 0x8F */ undefined,
- /* 0x90 */ undefined,
- /* 0x91 */ undefined,
- /* 0x92 */ undefined,
- /* 0x93 */ undefined,
- /* 0x94 */ undefined,
- /* 0x95 */ undefined,
- /* 0x96 */ undefined,
- /* 0x97 */ undefined,
- /* 0x98 */ undefined,
- /* 0x99 */ undefined,
- /* 0x9A */ undefined,
- /* 0x9B */ undefined,
- /* 0x9C */ undefined,
- /* 0x9D */ undefined,
- /* 0x9E */ undefined,
- /* 0x9F */ undefined,
- /* 0xA0 */ undefined,
- /* 0xA1 */ undefined,
- /* 0xA2 */ undefined,
- /* 0xA3 */ undefined,
- /* 0xA4 */ undefined,
- /* 0xA5 */ undefined,
- /* 0xA6 */ undefined,
- /* 0xA7 */ undefined,
- /* 0xA8 */ undefined,
- /* 0xA9 */ undefined,
- /* 0xAA */ undefined,
- /* 0xAB */ undefined,
- /* 0xAC */ undefined,
- /* 0xAD */ undefined,
- /* 0xAE */ undefined,
- /* 0xAF */ undefined,
- /* 0xB0 */ PUSHB.bind(undefined, 1),
- /* 0xB1 */ PUSHB.bind(undefined, 2),
- /* 0xB2 */ PUSHB.bind(undefined, 3),
- /* 0xB3 */ PUSHB.bind(undefined, 4),
- /* 0xB4 */ PUSHB.bind(undefined, 5),
- /* 0xB5 */ PUSHB.bind(undefined, 6),
- /* 0xB6 */ PUSHB.bind(undefined, 7),
- /* 0xB7 */ PUSHB.bind(undefined, 8),
- /* 0xB8 */ PUSHW.bind(undefined, 1),
- /* 0xB9 */ PUSHW.bind(undefined, 2),
- /* 0xBA */ PUSHW.bind(undefined, 3),
- /* 0xBB */ PUSHW.bind(undefined, 4),
- /* 0xBC */ PUSHW.bind(undefined, 5),
- /* 0xBD */ PUSHW.bind(undefined, 6),
- /* 0xBE */ PUSHW.bind(undefined, 7),
- /* 0xBF */ PUSHW.bind(undefined, 8),
- /* 0xC0 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 0),
- /* 0xC1 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 1),
- /* 0xC2 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 2),
- /* 0xC3 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 3),
- /* 0xC4 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 0),
- /* 0xC5 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 1),
- /* 0xC6 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 2),
- /* 0xC7 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 3),
- /* 0xC8 */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 0),
- /* 0xC9 */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 1),
- /* 0xCA */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 2),
- /* 0xCB */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 3),
- /* 0xCC */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 0),
- /* 0xCD */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 1),
- /* 0xCE */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 2),
- /* 0xCF */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 3),
- /* 0xD0 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 0),
- /* 0xD1 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 1),
- /* 0xD2 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 2),
- /* 0xD3 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 3),
- /* 0xD4 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 0),
- /* 0xD5 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 1),
- /* 0xD6 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 2),
- /* 0xD7 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 3),
- /* 0xD8 */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 0),
- /* 0xD9 */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 1),
- /* 0xDA */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 2),
- /* 0xDB */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 3),
- /* 0xDC */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 0),
- /* 0xDD */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 1),
- /* 0xDE */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 2),
- /* 0xDF */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 3),
- /* 0xE0 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 0),
- /* 0xE1 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 1),
- /* 0xE2 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 2),
- /* 0xE3 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 3),
- /* 0xE4 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 0),
- /* 0xE5 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 1),
- /* 0xE6 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 2),
- /* 0xE7 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 3),
- /* 0xE8 */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 0),
- /* 0xE9 */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 1),
- /* 0xEA */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 2),
- /* 0xEB */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 3),
- /* 0xEC */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 0),
- /* 0xED */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 1),
- /* 0xEE */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 2),
- /* 0xEF */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 3),
- /* 0xF0 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 0),
- /* 0xF1 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 1),
- /* 0xF2 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 2),
- /* 0xF3 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 3),
- /* 0xF4 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 0),
- /* 0xF5 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 1),
- /* 0xF6 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 2),
- /* 0xF7 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 3),
- /* 0xF8 */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 0),
- /* 0xF9 */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 1),
- /* 0xFA */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 2),
- /* 0xFB */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 3),
- /* 0xFC */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 0),
- /* 0xFD */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 1),
- /* 0xFE */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 2),
- /* 0xFF */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 3)
-];
-
-module.exports = Hinting;
-
-/*****************************
- Mathematical Considertions
-******************************
-
-fv ... refers to freedom vector
-pv ... refers to projection vector
-rp ... refers to reference point
-p ... refers to to point being operated on
-d ... refers to distance
-
-SETRELATIVE:
-============
-
-case freedom vector == x-axis:
-------------------------------
-
- (pv)
- .-'
- rpd .-'
- .-*
- d .-'90°'
- .-' '
- .-' '
- *-' ' b
- rp '
- '
- '
- p *----------*-------------- (fv)
- pm
-
- rpdx = rpx + d * pv.x
- rpdy = rpy + d * pv.y
-
- equation of line b
-
- y - rpdy = pvns * (x- rpdx)
-
- y = p.y
-
- x = rpdx + ( p.y - rpdy ) / pvns
-
-
-case freedom vector == y-axis:
-------------------------------
-
- * pm
- |\
- | \
- | \
- | \
- | \
- | \
- | \
- | \
- | \
- | \ b
- | \
- | \
- | \ .-' (pv)
- | 90° \.-'
- | .-'* rpd
- | .-'
- * *-' d
- p rp
- rpdx = rpx + d * pv.x
- rpdy = rpy + d * pv.y
+ -------
- equation of line b:
- pvns ... normal slope to pv
- y - rpdy = pvns * (x - rpdx)
- x = p.x
+ (+10)
+ rp1o *-------->*rp1
+ . . (-10)
+ . . rp2 *<---------* rpo2
+ . . . .
+ . . . .
+ . 10 . 30 . .
+ |.........|.............................|
+ . .
+ . (+5) .
+ po *--->* p .
+ . . .
+ . . 20 .
+ |....|..............|
+ 5 15
- y = rpdy + pvns * (p.x - rpdx)
+ -------
-generic case:
--------------
+ (+10)
+ rp1o *-------->*rp1
+ . .
+ . .
+ rp2o *-------->*rp2
- .'(fv)
- .'
- .* pm
- .' !
- .' .
- .' !
- .' . b
- .' !
- * .
- p !
- 90° . ... (pv)
- ...-*-'''
- ...---''' rpd
- ...---''' d
- *--'''
- rp
+ (+10)
+ po *-------->* p
- rpdx = rpx + d * pv.x
- rpdy = rpy + d * pv.y
+ -------
- equation of line b:
- pvns... normal slope to pv
- y - rpdy = pvns * (x - rpdx)
+ (+10)
+ rp1o *-------->*rp1
+ . .
+ . .(+30)
+ rp2o *---------------------------->*rp2
+
+
+ (+25)
+ po *----------------------->* p
+
+
+
+ vim: set ts=4 sw=4 expandtab:
+ *****/
+
+ // The Font object
+
+ // This code is based on Array.from implementation for strings in https://github.com/mathiasbynens/Array.from
+ var arrayFromString = Array.from || (function (s) { return s.match(/[\uD800-\uDBFF][\uDC00-\uDFFF]?|[^\uD800-\uDFFF]|./g) || []; });
+
+ /**
+ * @typedef FontOptions
+ * @type Object
+ * @property {Boolean} empty - whether to create a new empty font
+ * @property {string} familyName
+ * @property {string} styleName
+ * @property {string=} fullName
+ * @property {string=} postScriptName
+ * @property {string=} designer
+ * @property {string=} designerURL
+ * @property {string=} manufacturer
+ * @property {string=} manufacturerURL
+ * @property {string=} license
+ * @property {string=} licenseURL
+ * @property {string=} version
+ * @property {string=} description
+ * @property {string=} copyright
+ * @property {string=} trademark
+ * @property {Number} unitsPerEm
+ * @property {Number} ascender
+ * @property {Number} descender
+ * @property {Number} createdTimestamp
+ * @property {string=} weightClass
+ * @property {string=} widthClass
+ * @property {string=} fsSelection
+ */
+
+ /**
+ * A Font represents a loaded OpenType font file.
+ * It contains a set of glyphs and methods to draw text on a drawing context,
+ * or to get a path representing the text.
+ * @exports opentype.Font
+ * @class
+ * @param {FontOptions}
+ * @constructor
+ */
+ function Font(options) {
+ options = options || {};
+
+ if (!options.empty) {
+ // Check that we've provided the minimum set of names.
+ checkArgument(options.familyName, 'When creating a new Font object, familyName is required.');
+ checkArgument(options.styleName, 'When creating a new Font object, styleName is required.');
+ checkArgument(options.unitsPerEm, 'When creating a new Font object, unitsPerEm is required.');
+ checkArgument(options.ascender, 'When creating a new Font object, ascender is required.');
+ checkArgument(options.descender, 'When creating a new Font object, descender is required.');
+ checkArgument(options.descender < 0, 'Descender should be negative (e.g. -512).');
+
+ // OS X will complain if the names are empty, so we put a single space everywhere by default.
+ this.names = {
+ fontFamily: {en: options.familyName || ' '},
+ fontSubfamily: {en: options.styleName || ' '},
+ fullName: {en: options.fullName || options.familyName + ' ' + options.styleName},
+ // postScriptName may not contain any whitespace
+ postScriptName: {en: options.postScriptName || (options.familyName + options.styleName).replace(/\s/g, '')},
+ designer: {en: options.designer || ' '},
+ designerURL: {en: options.designerURL || ' '},
+ manufacturer: {en: options.manufacturer || ' '},
+ manufacturerURL: {en: options.manufacturerURL || ' '},
+ license: {en: options.license || ' '},
+ licenseURL: {en: options.licenseURL || ' '},
+ version: {en: options.version || 'Version 0.1'},
+ description: {en: options.description || ' '},
+ copyright: {en: options.copyright || ' '},
+ trademark: {en: options.trademark || ' '}
+ };
+ this.unitsPerEm = options.unitsPerEm || 1000;
+ this.ascender = options.ascender;
+ this.descender = options.descender;
+ this.createdTimestamp = options.createdTimestamp;
+ this.tables = { os2: {
+ usWeightClass: options.weightClass || this.usWeightClasses.MEDIUM,
+ usWidthClass: options.widthClass || this.usWidthClasses.MEDIUM,
+ fsSelection: options.fsSelection || this.fsSelectionValues.REGULAR
+ } };
+ }
+
+ this.supported = true; // Deprecated: parseBuffer will throw an error if font is not supported.
+ this.glyphs = new glyphset.GlyphSet(this, options.glyphs || []);
+ this.encoding = new DefaultEncoding(this);
+ this.position = new Position(this);
+ this.substitution = new Substitution(this);
+ this.tables = this.tables || {};
+
+ Object.defineProperty(this, 'hinting', {
+ get: function() {
+ if (this._hinting) { return this._hinting; }
+ if (this.outlinesFormat === 'truetype') {
+ return (this._hinting = new Hinting(this));
+ }
+ }
+ });
+ }
- equation of freedom vector line:
- fvs ... slope of freedom vector (=fy/fx)
+ /**
+ * Check if the font has a glyph for the given character.
+ * @param {string}
+ * @return {Boolean}
+ */
+ Font.prototype.hasChar = function(c) {
+ return this.encoding.charToGlyphIndex(c) !== null;
+ };
+
+ /**
+ * Convert the given character to a single glyph index.
+ * Note that this function assumes that there is a one-to-one mapping between
+ * the given character and a glyph; for complex scripts this might not be the case.
+ * @param {string}
+ * @return {Number}
+ */
+ Font.prototype.charToGlyphIndex = function(s) {
+ return this.encoding.charToGlyphIndex(s);
+ };
+
+ /**
+ * Convert the given character to a single Glyph object.
+ * Note that this function assumes that there is a one-to-one mapping between
+ * the given character and a glyph; for complex scripts this might not be the case.
+ * @param {string}
+ * @return {opentype.Glyph}
+ */
+ Font.prototype.charToGlyph = function(c) {
+ var glyphIndex = this.charToGlyphIndex(c);
+ var glyph = this.glyphs.get(glyphIndex);
+ if (!glyph) {
+ // .notdef
+ glyph = this.glyphs.get(0);
+ }
+
+ return glyph;
+ };
+
+ /**
+ * Convert the given text to a list of Glyph objects.
+ * Note that there is no strict one-to-one mapping between characters and
+ * glyphs, so the list of returned glyphs can be larger or smaller than the
+ * length of the given string.
+ * @param {string}
+ * @param {GlyphRenderOptions} [options]
+ * @return {opentype.Glyph[]}
+ */
+ Font.prototype.stringToGlyphs = function(s, options) {
+ var this$1 = this;
+
+ options = options || this.defaultRenderOptions;
+ // Get glyph indexes
+ var chars = arrayFromString(s);
+ var indexes = [];
+ for (var i = 0; i < chars.length; i += 1) {
+ var c = chars[i];
+ indexes.push(this$1.charToGlyphIndex(c));
+ }
+ var length = indexes.length;
+
+ // Apply substitutions on glyph indexes
+ if (options.features) {
+ var script = options.script || this.substitution.getDefaultScriptName();
+ var manyToOne = [];
+ if (options.features.liga) { manyToOne = manyToOne.concat(this.substitution.getFeature('liga', script, options.language)); }
+ if (options.features.rlig) { manyToOne = manyToOne.concat(this.substitution.getFeature('rlig', script, options.language)); }
+ for (var i$1 = 0; i$1 < length; i$1 += 1) {
+ for (var j = 0; j < manyToOne.length; j++) {
+ var ligature = manyToOne[j];
+ var components = ligature.sub;
+ var compCount = components.length;
+ var k = 0;
+ while (k < compCount && components[k] === indexes[i$1 + k]) { k++; }
+ if (k === compCount) {
+ indexes.splice(i$1, compCount, ligature.by);
+ length = length - compCount + 1;
+ }
+ }
+ }
+ }
+
+ // convert glyph indexes to glyph objects
+ var glyphs = new Array(length);
+ var notdef = this.glyphs.get(0);
+ for (var i$2 = 0; i$2 < length; i$2 += 1) {
+ glyphs[i$2] = this$1.glyphs.get(indexes[i$2]) || notdef;
+ }
+ return glyphs;
+ };
+
+ /**
+ * @param {string}
+ * @return {Number}
+ */
+ Font.prototype.nameToGlyphIndex = function(name) {
+ return this.glyphNames.nameToGlyphIndex(name);
+ };
+
+ /**
+ * @param {string}
+ * @return {opentype.Glyph}
+ */
+ Font.prototype.nameToGlyph = function(name) {
+ var glyphIndex = this.nameToGlyphIndex(name);
+ var glyph = this.glyphs.get(glyphIndex);
+ if (!glyph) {
+ // .notdef
+ glyph = this.glyphs.get(0);
+ }
+
+ return glyph;
+ };
+
+ /**
+ * @param {Number}
+ * @return {String}
+ */
+ Font.prototype.glyphIndexToName = function(gid) {
+ if (!this.glyphNames.glyphIndexToName) {
+ return '';
+ }
+
+ return this.glyphNames.glyphIndexToName(gid);
+ };
+
+ /**
+ * Retrieve the value of the kerning pair between the left glyph (or its index)
+ * and the right glyph (or its index). If no kerning pair is found, return 0.
+ * The kerning value gets added to the advance width when calculating the spacing
+ * between glyphs.
+ * For GPOS kerning, this method uses the default script and language, which covers
+ * most use cases. To have greater control, use font.position.getKerningValue .
+ * @param {opentype.Glyph} leftGlyph
+ * @param {opentype.Glyph} rightGlyph
+ * @return {Number}
+ */
+ Font.prototype.getKerningValue = function(leftGlyph, rightGlyph) {
+ leftGlyph = leftGlyph.index || leftGlyph;
+ rightGlyph = rightGlyph.index || rightGlyph;
+ var gposKerning = this.position.defaultKerningTables;
+ if (gposKerning) {
+ return this.position.getKerningValue(gposKerning, leftGlyph, rightGlyph);
+ }
+ // "kern" table
+ return this.kerningPairs[leftGlyph + ',' + rightGlyph] || 0;
+ };
+
+ /**
+ * @typedef GlyphRenderOptions
+ * @type Object
+ * @property {string} [script] - script used to determine which features to apply. By default, 'DFLT' or 'latn' is used.
+ * See https://www.microsoft.com/typography/otspec/scripttags.htm
+ * @property {string} [language='dflt'] - language system used to determine which features to apply.
+ * See https://www.microsoft.com/typography/developers/opentype/languagetags.aspx
+ * @property {boolean} [kerning=true] - whether to include kerning values
+ * @property {object} [features] - OpenType Layout feature tags. Used to enable or disable the features of the given script/language system.
+ * See https://www.microsoft.com/typography/otspec/featuretags.htm
+ */
+ Font.prototype.defaultRenderOptions = {
+ kerning: true,
+ features: {
+ liga: true,
+ rlig: true
+ }
+ };
+
+ /**
+ * Helper function that invokes the given callback for each glyph in the given text.
+ * The callback gets `(glyph, x, y, fontSize, options)`.* @param {string} text
+ * @param {string} text - The text to apply.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ * @param {Function} callback
+ */
+ Font.prototype.forEachGlyph = function(text, x, y, fontSize, options, callback) {
+ var this$1 = this;
+
+ x = x !== undefined ? x : 0;
+ y = y !== undefined ? y : 0;
+ fontSize = fontSize !== undefined ? fontSize : 72;
+ options = options || this.defaultRenderOptions;
+ var fontScale = 1 / this.unitsPerEm * fontSize;
+ var glyphs = this.stringToGlyphs(text, options);
+ var kerningLookups;
+ if (options.kerning) {
+ var script = options.script || this.position.getDefaultScriptName();
+ kerningLookups = this.position.getKerningTables(script, options.language);
+ }
+ for (var i = 0; i < glyphs.length; i += 1) {
+ var glyph = glyphs[i];
+ callback.call(this$1, glyph, x, y, fontSize, options);
+ if (glyph.advanceWidth) {
+ x += glyph.advanceWidth * fontScale;
+ }
+
+ if (options.kerning && i < glyphs.length - 1) {
+ // We should apply position adjustment lookups in a more generic way.
+ // Here we only use the xAdvance value.
+ var kerningValue = kerningLookups ?
+ this$1.position.getKerningValue(kerningLookups, glyph.index, glyphs[i + 1].index) :
+ this$1.getKerningValue(glyph, glyphs[i + 1]);
+ x += kerningValue * fontScale;
+ }
+
+ if (options.letterSpacing) {
+ x += options.letterSpacing * fontSize;
+ } else if (options.tracking) {
+ x += (options.tracking / 1000) * fontSize;
+ }
+ }
+ return x;
+ };
+
+ /**
+ * Create a Path object that represents the given text.
+ * @param {string} text - The text to create.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ * @return {opentype.Path}
+ */
+ Font.prototype.getPath = function(text, x, y, fontSize, options) {
+ var fullPath = new Path();
+ this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
+ var glyphPath = glyph.getPath(gX, gY, gFontSize, options, this);
+ fullPath.extend(glyphPath);
+ });
+ return fullPath;
+ };
+
+ /**
+ * Create an array of Path objects that represent the glyphs of a given text.
+ * @param {string} text - The text to create.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ * @return {opentype.Path[]}
+ */
+ Font.prototype.getPaths = function(text, x, y, fontSize, options) {
+ var glyphPaths = [];
+ this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
+ var glyphPath = glyph.getPath(gX, gY, gFontSize, options, this);
+ glyphPaths.push(glyphPath);
+ });
+
+ return glyphPaths;
+ };
+
+ /**
+ * Returns the advance width of a text.
+ *
+ * This is something different than Path.getBoundingBox() as for example a
+ * suffixed whitespace increases the advanceWidth but not the bounding box
+ * or an overhanging letter like a calligraphic 'f' might have a quite larger
+ * bounding box than its advance width.
+ *
+ * This corresponds to canvas2dContext.measureText(text).width
+ *
+ * @param {string} text - The text to create.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ * @return advance width
+ */
+ Font.prototype.getAdvanceWidth = function(text, fontSize, options) {
+ return this.forEachGlyph(text, 0, 0, fontSize, options, function() {});
+ };
+
+ /**
+ * Draw the text on the given drawing context.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
+ * @param {string} text - The text to create.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ */
+ Font.prototype.draw = function(ctx, text, x, y, fontSize, options) {
+ this.getPath(text, x, y, fontSize, options).draw(ctx);
+ };
+
+ /**
+ * Draw the points of all glyphs in the text.
+ * On-curve points will be drawn in blue, off-curve points will be drawn in red.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
+ * @param {string} text - The text to create.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ */
+ Font.prototype.drawPoints = function(ctx, text, x, y, fontSize, options) {
+ this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
+ glyph.drawPoints(ctx, gX, gY, gFontSize);
+ });
+ };
+
+ /**
+ * Draw lines indicating important font measurements for all glyphs in the text.
+ * Black lines indicate the origin of the coordinate system (point 0,0).
+ * Blue lines indicate the glyph bounding box.
+ * Green line indicates the advance width of the glyph.
+ * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas.
+ * @param {string} text - The text to create.
+ * @param {number} [x=0] - Horizontal position of the beginning of the text.
+ * @param {number} [y=0] - Vertical position of the *baseline* of the text.
+ * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`.
+ * @param {GlyphRenderOptions=} options
+ */
+ Font.prototype.drawMetrics = function(ctx, text, x, y, fontSize, options) {
+ this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) {
+ glyph.drawMetrics(ctx, gX, gY, gFontSize);
+ });
+ };
+
+ /**
+ * @param {string}
+ * @return {string}
+ */
+ Font.prototype.getEnglishName = function(name) {
+ var translations = this.names[name];
+ if (translations) {
+ return translations.en;
+ }
+ };
+
+ /**
+ * Validate
+ */
+ Font.prototype.validate = function() {
+ var _this = this;
+
+ function assert(predicate, message) {
+ }
+
+ function assertNamePresent(name) {
+ var englishName = _this.getEnglishName(name);
+ assert(englishName && englishName.trim().length > 0,
+ 'No English ' + name + ' specified.');
+ }
+
+ // Identification information
+ assertNamePresent('fontFamily');
+ assertNamePresent('weightName');
+ assertNamePresent('manufacturer');
+ assertNamePresent('copyright');
+ assertNamePresent('version');
+
+ // Dimension information
+ assert(this.unitsPerEm > 0, 'No unitsPerEm specified.');
+ };
+
+ /**
+ * Convert the font object to a SFNT data structure.
+ * This structure contains all the necessary tables and metadata to create a binary OTF file.
+ * @return {opentype.Table}
+ */
+ Font.prototype.toTables = function() {
+ return sfnt.fontToTable(this);
+ };
+ /**
+ * @deprecated Font.toBuffer is deprecated. Use Font.toArrayBuffer instead.
+ */
+ Font.prototype.toBuffer = function() {
+ console.warn('Font.toBuffer is deprecated. Use Font.toArrayBuffer instead.');
+ return this.toArrayBuffer();
+ };
+ /**
+ * Converts a `opentype.Font` into an `ArrayBuffer`
+ * @return {ArrayBuffer}
+ */
+ Font.prototype.toArrayBuffer = function() {
+ var sfntTable = this.toTables();
+ var bytes = sfntTable.encode();
+ var buffer = new ArrayBuffer(bytes.length);
+ var intArray = new Uint8Array(buffer);
+ for (var i = 0; i < bytes.length; i++) {
+ intArray[i] = bytes[i];
+ }
+
+ return buffer;
+ };
+
+ /**
+ * Initiate a download of the OpenType font.
+ */
+ Font.prototype.download = function(fileName) {
+ var familyName = this.getEnglishName('fontFamily');
+ var styleName = this.getEnglishName('fontSubfamily');
+ fileName = fileName || familyName.replace(/\s/g, '') + '-' + styleName + '.otf';
+ var arrayBuffer = this.toArrayBuffer();
+
+ if (isBrowser()) {
+ window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem;
+ window.requestFileSystem(window.TEMPORARY, arrayBuffer.byteLength, function(fs) {
+ fs.root.getFile(fileName, {create: true}, function(fileEntry) {
+ fileEntry.createWriter(function(writer) {
+ var dataView = new DataView(arrayBuffer);
+ var blob = new Blob([dataView], {type: 'font/opentype'});
+ writer.write(blob);
+
+ writer.addEventListener('writeend', function() {
+ // Navigating to the file will download it.
+ location.href = fileEntry.toURL();
+ }, false);
+ });
+ });
+ },
+ function(err) {
+ throw new Error(err.name + ': ' + err.message);
+ });
+ } else {
+ var fs = _dereq_('fs');
+ var buffer = arrayBufferToNodeBuffer(arrayBuffer);
+ fs.writeFileSync(fileName, buffer);
+ }
+ };
+ /**
+ * @private
+ */
+ Font.prototype.fsSelectionValues = {
+ ITALIC: 0x001, //1
+ UNDERSCORE: 0x002, //2
+ NEGATIVE: 0x004, //4
+ OUTLINED: 0x008, //8
+ STRIKEOUT: 0x010, //16
+ BOLD: 0x020, //32
+ REGULAR: 0x040, //64
+ USER_TYPO_METRICS: 0x080, //128
+ WWS: 0x100, //256
+ OBLIQUE: 0x200 //512
+ };
+
+ /**
+ * @private
+ */
+ Font.prototype.usWidthClasses = {
+ ULTRA_CONDENSED: 1,
+ EXTRA_CONDENSED: 2,
+ CONDENSED: 3,
+ SEMI_CONDENSED: 4,
+ MEDIUM: 5,
+ SEMI_EXPANDED: 6,
+ EXPANDED: 7,
+ EXTRA_EXPANDED: 8,
+ ULTRA_EXPANDED: 9
+ };
+
+ /**
+ * @private
+ */
+ Font.prototype.usWeightClasses = {
+ THIN: 100,
+ EXTRA_LIGHT: 200,
+ LIGHT: 300,
+ NORMAL: 400,
+ MEDIUM: 500,
+ SEMI_BOLD: 600,
+ BOLD: 700,
+ EXTRA_BOLD: 800,
+ BLACK: 900
+ };
+
+ // The `fvar` table stores font variation axes and instances.
+
+ function addName(name, names) {
+ var nameString = JSON.stringify(name);
+ var nameID = 256;
+ for (var nameKey in names) {
+ var n = parseInt(nameKey);
+ if (!n || n < 256) {
+ continue;
+ }
+
+ if (JSON.stringify(names[nameKey]) === nameString) {
+ return n;
+ }
+
+ if (nameID <= n) {
+ nameID = n + 1;
+ }
+ }
+
+ names[nameID] = name;
+ return nameID;
+ }
- y - py = fvs * (x - px)
+ function makeFvarAxis(n, axis, names) {
+ var nameID = addName(axis.name, names);
+ return [
+ {name: 'tag_' + n, type: 'TAG', value: axis.tag},
+ {name: 'minValue_' + n, type: 'FIXED', value: axis.minValue << 16},
+ {name: 'defaultValue_' + n, type: 'FIXED', value: axis.defaultValue << 16},
+ {name: 'maxValue_' + n, type: 'FIXED', value: axis.maxValue << 16},
+ {name: 'flags_' + n, type: 'USHORT', value: 0},
+ {name: 'nameID_' + n, type: 'USHORT', value: nameID}
+ ];
+ }
+ function parseFvarAxis(data, start, names) {
+ var axis = {};
+ var p = new parse.Parser(data, start);
+ axis.tag = p.parseTag();
+ axis.minValue = p.parseFixed();
+ axis.defaultValue = p.parseFixed();
+ axis.maxValue = p.parseFixed();
+ p.skip('uShort', 1); // reserved for flags; no values defined
+ axis.name = names[p.parseUShort()] || {};
+ return axis;
+ }
- on pm both equations are true for same x/y
+ function makeFvarInstance(n, inst, axes, names) {
+ var nameID = addName(inst.name, names);
+ var fields = [
+ {name: 'nameID_' + n, type: 'USHORT', value: nameID},
+ {name: 'flags_' + n, type: 'USHORT', value: 0}
+ ];
+
+ for (var i = 0; i < axes.length; ++i) {
+ var axisTag = axes[i].tag;
+ fields.push({
+ name: 'axis_' + n + ' ' + axisTag,
+ type: 'FIXED',
+ value: inst.coordinates[axisTag] << 16
+ });
+ }
+
+ return fields;
+ }
- y - rpdy = pvns * (x - rpdx)
+ function parseFvarInstance(data, start, axes, names) {
+ var inst = {};
+ var p = new parse.Parser(data, start);
+ inst.name = names[p.parseUShort()] || {};
+ p.skip('uShort', 1); // reserved for flags; no values defined
- y - py = fvs * (x - px)
+ inst.coordinates = {};
+ for (var i = 0; i < axes.length; ++i) {
+ inst.coordinates[axes[i].tag] = p.parseFixed();
+ }
- form to y and set equal:
+ return inst;
+ }
- pvns * (x - rpdx) + rpdy = fvs * (x - px) + py
+ function makeFvarTable(fvar, names) {
+ var result = new table.Table('fvar', [
+ {name: 'version', type: 'ULONG', value: 0x10000},
+ {name: 'offsetToData', type: 'USHORT', value: 0},
+ {name: 'countSizePairs', type: 'USHORT', value: 2},
+ {name: 'axisCount', type: 'USHORT', value: fvar.axes.length},
+ {name: 'axisSize', type: 'USHORT', value: 20},
+ {name: 'instanceCount', type: 'USHORT', value: fvar.instances.length},
+ {name: 'instanceSize', type: 'USHORT', value: 4 + fvar.axes.length * 4}
+ ]);
+ result.offsetToData = result.sizeOf();
+
+ for (var i = 0; i < fvar.axes.length; i++) {
+ result.fields = result.fields.concat(makeFvarAxis(i, fvar.axes[i], names));
+ }
+
+ for (var j = 0; j < fvar.instances.length; j++) {
+ result.fields = result.fields.concat(makeFvarInstance(j, fvar.instances[j], fvar.axes, names));
+ }
+
+ return result;
+ }
- expand:
+ function parseFvarTable(data, start, names) {
+ var p = new parse.Parser(data, start);
+ var tableVersion = p.parseULong();
+ check.argument(tableVersion === 0x00010000, 'Unsupported fvar table version.');
+ var offsetToData = p.parseOffset16();
+ // Skip countSizePairs.
+ p.skip('uShort', 1);
+ var axisCount = p.parseUShort();
+ var axisSize = p.parseUShort();
+ var instanceCount = p.parseUShort();
+ var instanceSize = p.parseUShort();
+
+ var axes = [];
+ for (var i = 0; i < axisCount; i++) {
+ axes.push(parseFvarAxis(data, start + offsetToData + i * axisSize, names));
+ }
+
+ var instances = [];
+ var instanceStart = start + offsetToData + axisCount * axisSize;
+ for (var j = 0; j < instanceCount; j++) {
+ instances.push(parseFvarInstance(data, instanceStart + j * instanceSize, axes, names));
+ }
+
+ return {axes: axes, instances: instances};
+ }
- pvns * x - pvns * rpdx + rpdy = fvs * x - fvs * px + py
+ var fvar = { make: makeFvarTable, parse: parseFvarTable };
+
+ // The `GPOS` table contains kerning pairs, among other things.
+
+ var subtableParsers$1 = new Array(10); // subtableParsers[0] is unused
+
+ // https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#lookup-type-1-single-adjustment-positioning-subtable
+ // this = Parser instance
+ subtableParsers$1[1] = function parseLookup1() {
+ var start = this.offset + this.relativeOffset;
+ var posformat = this.parseUShort();
+ if (posformat === 1) {
+ return {
+ posFormat: 1,
+ coverage: this.parsePointer(Parser.coverage),
+ value: this.parseValueRecord()
+ };
+ } else if (posformat === 2) {
+ return {
+ posFormat: 2,
+ coverage: this.parsePointer(Parser.coverage),
+ values: this.parseValueRecordList()
+ };
+ }
+ check.assert(false, '0x' + start.toString(16) + ': GPOS lookup type 1 format must be 1 or 2.');
+ };
+
+ // https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#lookup-type-2-pair-adjustment-positioning-subtable
+ subtableParsers$1[2] = function parseLookup2() {
+ var start = this.offset + this.relativeOffset;
+ var posFormat = this.parseUShort();
+ check.assert(posFormat === 1 || posFormat === 2, '0x' + start.toString(16) + ': GPOS lookup type 2 format must be 1 or 2.');
+ var coverage = this.parsePointer(Parser.coverage);
+ var valueFormat1 = this.parseUShort();
+ var valueFormat2 = this.parseUShort();
+ if (posFormat === 1) {
+ // Adjustments for Glyph Pairs
+ return {
+ posFormat: posFormat,
+ coverage: coverage,
+ valueFormat1: valueFormat1,
+ valueFormat2: valueFormat2,
+ pairSets: this.parseList(Parser.pointer(Parser.list(function() {
+ return { // pairValueRecord
+ secondGlyph: this.parseUShort(),
+ value1: this.parseValueRecord(valueFormat1),
+ value2: this.parseValueRecord(valueFormat2)
+ };
+ })))
+ };
+ } else if (posFormat === 2) {
+ var classDef1 = this.parsePointer(Parser.classDef);
+ var classDef2 = this.parsePointer(Parser.classDef);
+ var class1Count = this.parseUShort();
+ var class2Count = this.parseUShort();
+ return {
+ // Class Pair Adjustment
+ posFormat: posFormat,
+ coverage: coverage,
+ valueFormat1: valueFormat1,
+ valueFormat2: valueFormat2,
+ classDef1: classDef1,
+ classDef2: classDef2,
+ class1Count: class1Count,
+ class2Count: class2Count,
+ classRecords: this.parseList(class1Count, Parser.list(class2Count, function() {
+ return {
+ value1: this.parseValueRecord(valueFormat1),
+ value2: this.parseValueRecord(valueFormat2)
+ };
+ }))
+ };
+ }
+ };
+
+ subtableParsers$1[3] = function parseLookup3() { return { error: 'GPOS Lookup 3 not supported' }; };
+ subtableParsers$1[4] = function parseLookup4() { return { error: 'GPOS Lookup 4 not supported' }; };
+ subtableParsers$1[5] = function parseLookup5() { return { error: 'GPOS Lookup 5 not supported' }; };
+ subtableParsers$1[6] = function parseLookup6() { return { error: 'GPOS Lookup 6 not supported' }; };
+ subtableParsers$1[7] = function parseLookup7() { return { error: 'GPOS Lookup 7 not supported' }; };
+ subtableParsers$1[8] = function parseLookup8() { return { error: 'GPOS Lookup 8 not supported' }; };
+ subtableParsers$1[9] = function parseLookup9() { return { error: 'GPOS Lookup 9 not supported' }; };
+
+ // https://docs.microsoft.com/en-us/typography/opentype/spec/gpos
+ function parseGposTable(data, start) {
+ start = start || 0;
+ var p = new Parser(data, start);
+ var tableVersion = p.parseVersion(1);
+ check.argument(tableVersion === 1 || tableVersion === 1.1, 'Unsupported GPOS table version ' + tableVersion);
+
+ if (tableVersion === 1) {
+ return {
+ version: tableVersion,
+ scripts: p.parseScriptList(),
+ features: p.parseFeatureList(),
+ lookups: p.parseLookupList(subtableParsers$1)
+ };
+ } else {
+ return {
+ version: tableVersion,
+ scripts: p.parseScriptList(),
+ features: p.parseFeatureList(),
+ lookups: p.parseLookupList(subtableParsers$1),
+ variations: p.parseFeatureVariationsList()
+ };
+ }
- switch:
+ }
- fvs * x - fvs * px + py = pvns * x - pvns * rpdx + rpdy
+ // GPOS Writing //////////////////////////////////////////////
+ // NOT SUPPORTED
+ var subtableMakers$1 = new Array(10);
+
+ function makeGposTable(gpos) {
+ return new table.Table('GPOS', [
+ {name: 'version', type: 'ULONG', value: 0x10000},
+ {name: 'scripts', type: 'TABLE', value: new table.ScriptList(gpos.scripts)},
+ {name: 'features', type: 'TABLE', value: new table.FeatureList(gpos.features)},
+ {name: 'lookups', type: 'TABLE', value: new table.LookupList(gpos.lookups, subtableMakers$1)}
+ ]);
+ }
- solve for x:
+ var gpos = { parse: parseGposTable, make: makeGposTable };
+
+ // The `kern` table contains kerning pairs.
+
+ function parseWindowsKernTable(p) {
+ var pairs = {};
+ // Skip nTables.
+ p.skip('uShort');
+ var subtableVersion = p.parseUShort();
+ check.argument(subtableVersion === 0, 'Unsupported kern sub-table version.');
+ // Skip subtableLength, subtableCoverage
+ p.skip('uShort', 2);
+ var nPairs = p.parseUShort();
+ // Skip searchRange, entrySelector, rangeShift.
+ p.skip('uShort', 3);
+ for (var i = 0; i < nPairs; i += 1) {
+ var leftIndex = p.parseUShort();
+ var rightIndex = p.parseUShort();
+ var value = p.parseShort();
+ pairs[leftIndex + ',' + rightIndex] = value;
+ }
+ return pairs;
+ }
- fvs * x - pvns * x = fvs * px - pvns * rpdx - py + rpdy
+ function parseMacKernTable(p) {
+ var pairs = {};
+ // The Mac kern table stores the version as a fixed (32 bits) but we only loaded the first 16 bits.
+ // Skip the rest.
+ p.skip('uShort');
+ var nTables = p.parseULong();
+ //check.argument(nTables === 1, 'Only 1 subtable is supported (got ' + nTables + ').');
+ if (nTables > 1) {
+ console.warn('Only the first kern subtable is supported.');
+ }
+ p.skip('uLong');
+ var coverage = p.parseUShort();
+ var subtableVersion = coverage & 0xFF;
+ p.skip('uShort');
+ if (subtableVersion === 0) {
+ var nPairs = p.parseUShort();
+ // Skip searchRange, entrySelector, rangeShift.
+ p.skip('uShort', 3);
+ for (var i = 0; i < nPairs; i += 1) {
+ var leftIndex = p.parseUShort();
+ var rightIndex = p.parseUShort();
+ var value = p.parseShort();
+ pairs[leftIndex + ',' + rightIndex] = value;
+ }
+ }
+ return pairs;
+ }
+ // Parse the `kern` table which contains kerning pairs.
+ function parseKernTable(data, start) {
+ var p = new parse.Parser(data, start);
+ var tableVersion = p.parseUShort();
+ if (tableVersion === 0) {
+ return parseWindowsKernTable(p);
+ } else if (tableVersion === 1) {
+ return parseMacKernTable(p);
+ } else {
+ throw new Error('Unsupported kern table version (' + tableVersion + ').');
+ }
+ }
+ var kern = { parse: parseKernTable };
+
+ // The `loca` table stores the offsets to the locations of the glyphs in the font.
+
+ // Parse the `loca` table. This table stores the offsets to the locations of the glyphs in the font,
+ // relative to the beginning of the glyphData table.
+ // The number of glyphs stored in the `loca` table is specified in the `maxp` table (under numGlyphs)
+ // The loca table has two versions: a short version where offsets are stored as uShorts, and a long
+ // version where offsets are stored as uLongs. The `head` table specifies which version to use
+ // (under indexToLocFormat).
+ function parseLocaTable(data, start, numGlyphs, shortVersion) {
+ var p = new parse.Parser(data, start);
+ var parseFn = shortVersion ? p.parseUShort : p.parseULong;
+ // There is an extra entry after the last index element to compute the length of the last glyph.
+ // That's why we use numGlyphs + 1.
+ var glyphOffsets = [];
+ for (var i = 0; i < numGlyphs + 1; i += 1) {
+ var glyphOffset = parseFn.call(p);
+ if (shortVersion) {
+ // The short table version stores the actual offset divided by 2.
+ glyphOffset *= 2;
+ }
+
+ glyphOffsets.push(glyphOffset);
+ }
+
+ return glyphOffsets;
+ }
- fvs * px - pvns * rpdx + rpdy - py
- x = -----------------------------------
- fvs - pvns
+ var loca = { parse: parseLocaTable };
+
+ // opentype.js
+
+ /**
+ * The opentype library.
+ * @namespace opentype
+ */
+
+ // File loaders /////////////////////////////////////////////////////////
+ /**
+ * Loads a font from a file. The callback throws an error message as the first parameter if it fails
+ * and the font as an ArrayBuffer in the second parameter if it succeeds.
+ * @param {string} path - The path of the file
+ * @param {Function} callback - The function to call when the font load completes
+ */
+ function loadFromFile(path, callback) {
+ var fs = _dereq_('fs');
+ fs.readFile(path, function(err, buffer) {
+ if (err) {
+ return callback(err.message);
+ }
+
+ callback(null, nodeBufferToArrayBuffer(buffer));
+ });
+ }
+ /**
+ * Loads a font from a URL. The callback throws an error message as the first parameter if it fails
+ * and the font as an ArrayBuffer in the second parameter if it succeeds.
+ * @param {string} url - The URL of the font file.
+ * @param {Function} callback - The function to call when the font load completes
+ */
+ function loadFromUrl(url, callback) {
+ var request = new XMLHttpRequest();
+ request.open('get', url, true);
+ request.responseType = 'arraybuffer';
+ request.onload = function() {
+ if (request.response) {
+ return callback(null, request.response);
+ } else {
+ return callback('Font could not be loaded: ' + request.statusText);
+ }
+ };
+
+ request.onerror = function () {
+ callback('Font could not be loaded');
+ };
+
+ request.send();
+ }
- and:
+ // Table Directory Entries //////////////////////////////////////////////
+ /**
+ * Parses OpenType table entries.
+ * @param {DataView}
+ * @param {Number}
+ * @return {Object[]}
+ */
+ function parseOpenTypeTableEntries(data, numTables) {
+ var tableEntries = [];
+ var p = 12;
+ for (var i = 0; i < numTables; i += 1) {
+ var tag = parse.getTag(data, p);
+ var checksum = parse.getULong(data, p + 4);
+ var offset = parse.getULong(data, p + 8);
+ var length = parse.getULong(data, p + 12);
+ tableEntries.push({tag: tag, checksum: checksum, offset: offset, length: length, compression: false});
+ p += 16;
+ }
+
+ return tableEntries;
+ }
- y = fvs * (x - px) + py
+ /**
+ * Parses WOFF table entries.
+ * @param {DataView}
+ * @param {Number}
+ * @return {Object[]}
+ */
+ function parseWOFFTableEntries(data, numTables) {
+ var tableEntries = [];
+ var p = 44; // offset to the first table directory entry.
+ for (var i = 0; i < numTables; i += 1) {
+ var tag = parse.getTag(data, p);
+ var offset = parse.getULong(data, p + 4);
+ var compLength = parse.getULong(data, p + 8);
+ var origLength = parse.getULong(data, p + 12);
+ var compression = (void 0);
+ if (compLength < origLength) {
+ compression = 'WOFF';
+ } else {
+ compression = false;
+ }
+
+ tableEntries.push({tag: tag, offset: offset, compression: compression,
+ compressedLength: compLength, length: origLength});
+ p += 20;
+ }
+
+ return tableEntries;
+ }
+ /**
+ * @typedef TableData
+ * @type Object
+ * @property {DataView} data - The DataView
+ * @property {number} offset - The data offset.
+ */
+
+ /**
+ * @param {DataView}
+ * @param {Object}
+ * @return {TableData}
+ */
+ function uncompressTable(data, tableEntry) {
+ if (tableEntry.compression === 'WOFF') {
+ var inBuffer = new Uint8Array(data.buffer, tableEntry.offset + 2, tableEntry.compressedLength - 2);
+ var outBuffer = new Uint8Array(tableEntry.length);
+ tinyInflate(inBuffer, outBuffer);
+ if (outBuffer.byteLength !== tableEntry.length) {
+ throw new Error('Decompression error: ' + tableEntry.tag + ' decompressed length doesn\'t match recorded length');
+ }
+
+ var view = new DataView(outBuffer.buffer, 0);
+ return {data: view, offset: 0};
+ } else {
+ return {data: data, offset: tableEntry.offset};
+ }
+ }
+ // Public API ///////////////////////////////////////////////////////////
+
+ /**
+ * Parse the OpenType file data (as an ArrayBuffer) and return a Font object.
+ * Throws an error if the font could not be parsed.
+ * @param {ArrayBuffer}
+ * @return {opentype.Font}
+ */
+ function parseBuffer(buffer) {
+ var indexToLocFormat;
+ var ltagTable;
+
+ // Since the constructor can also be called to create new fonts from scratch, we indicate this
+ // should be an empty font that we'll fill with our own data.
+ var font = new Font({empty: true});
+
+ // OpenType fonts use big endian byte ordering.
+ // We can't rely on typed array view types, because they operate with the endianness of the host computer.
+ // Instead we use DataViews where we can specify endianness.
+ var data = new DataView(buffer, 0);
+ var numTables;
+ var tableEntries = [];
+ var signature = parse.getTag(data, 0);
+ if (signature === String.fromCharCode(0, 1, 0, 0) || signature === 'true' || signature === 'typ1') {
+ font.outlinesFormat = 'truetype';
+ numTables = parse.getUShort(data, 4);
+ tableEntries = parseOpenTypeTableEntries(data, numTables);
+ } else if (signature === 'OTTO') {
+ font.outlinesFormat = 'cff';
+ numTables = parse.getUShort(data, 4);
+ tableEntries = parseOpenTypeTableEntries(data, numTables);
+ } else if (signature === 'wOFF') {
+ var flavor = parse.getTag(data, 4);
+ if (flavor === String.fromCharCode(0, 1, 0, 0)) {
+ font.outlinesFormat = 'truetype';
+ } else if (flavor === 'OTTO') {
+ font.outlinesFormat = 'cff';
+ } else {
+ throw new Error('Unsupported OpenType flavor ' + signature);
+ }
+
+ numTables = parse.getUShort(data, 12);
+ tableEntries = parseWOFFTableEntries(data, numTables);
+ } else {
+ throw new Error('Unsupported OpenType signature ' + signature);
+ }
+
+ var cffTableEntry;
+ var fvarTableEntry;
+ var glyfTableEntry;
+ var gposTableEntry;
+ var gsubTableEntry;
+ var hmtxTableEntry;
+ var kernTableEntry;
+ var locaTableEntry;
+ var nameTableEntry;
+ var metaTableEntry;
+ var p;
+
+ for (var i = 0; i < numTables; i += 1) {
+ var tableEntry = tableEntries[i];
+ var table = (void 0);
+ switch (tableEntry.tag) {
+ case 'cmap':
+ table = uncompressTable(data, tableEntry);
+ font.tables.cmap = cmap.parse(table.data, table.offset);
+ font.encoding = new CmapEncoding(font.tables.cmap);
+ break;
+ case 'cvt ' :
+ table = uncompressTable(data, tableEntry);
+ p = new parse.Parser(table.data, table.offset);
+ font.tables.cvt = p.parseShortList(tableEntry.length / 2);
+ break;
+ case 'fvar':
+ fvarTableEntry = tableEntry;
+ break;
+ case 'fpgm' :
+ table = uncompressTable(data, tableEntry);
+ p = new parse.Parser(table.data, table.offset);
+ font.tables.fpgm = p.parseByteList(tableEntry.length);
+ break;
+ case 'head':
+ table = uncompressTable(data, tableEntry);
+ font.tables.head = head.parse(table.data, table.offset);
+ font.unitsPerEm = font.tables.head.unitsPerEm;
+ indexToLocFormat = font.tables.head.indexToLocFormat;
+ break;
+ case 'hhea':
+ table = uncompressTable(data, tableEntry);
+ font.tables.hhea = hhea.parse(table.data, table.offset);
+ font.ascender = font.tables.hhea.ascender;
+ font.descender = font.tables.hhea.descender;
+ font.numberOfHMetrics = font.tables.hhea.numberOfHMetrics;
+ break;
+ case 'hmtx':
+ hmtxTableEntry = tableEntry;
+ break;
+ case 'ltag':
+ table = uncompressTable(data, tableEntry);
+ ltagTable = ltag.parse(table.data, table.offset);
+ break;
+ case 'maxp':
+ table = uncompressTable(data, tableEntry);
+ font.tables.maxp = maxp.parse(table.data, table.offset);
+ font.numGlyphs = font.tables.maxp.numGlyphs;
+ break;
+ case 'name':
+ nameTableEntry = tableEntry;
+ break;
+ case 'OS/2':
+ table = uncompressTable(data, tableEntry);
+ font.tables.os2 = os2.parse(table.data, table.offset);
+ break;
+ case 'post':
+ table = uncompressTable(data, tableEntry);
+ font.tables.post = post.parse(table.data, table.offset);
+ font.glyphNames = new GlyphNames(font.tables.post);
+ break;
+ case 'prep' :
+ table = uncompressTable(data, tableEntry);
+ p = new parse.Parser(table.data, table.offset);
+ font.tables.prep = p.parseByteList(tableEntry.length);
+ break;
+ case 'glyf':
+ glyfTableEntry = tableEntry;
+ break;
+ case 'loca':
+ locaTableEntry = tableEntry;
+ break;
+ case 'CFF ':
+ cffTableEntry = tableEntry;
+ break;
+ case 'kern':
+ kernTableEntry = tableEntry;
+ break;
+ case 'GPOS':
+ gposTableEntry = tableEntry;
+ break;
+ case 'GSUB':
+ gsubTableEntry = tableEntry;
+ break;
+ case 'meta':
+ metaTableEntry = tableEntry;
+ break;
+ }
+ }
+
+ var nameTable = uncompressTable(data, nameTableEntry);
+ font.tables.name = _name.parse(nameTable.data, nameTable.offset, ltagTable);
+ font.names = font.tables.name;
+
+ if (glyfTableEntry && locaTableEntry) {
+ var shortVersion = indexToLocFormat === 0;
+ var locaTable = uncompressTable(data, locaTableEntry);
+ var locaOffsets = loca.parse(locaTable.data, locaTable.offset, font.numGlyphs, shortVersion);
+ var glyfTable = uncompressTable(data, glyfTableEntry);
+ font.glyphs = glyf.parse(glyfTable.data, glyfTable.offset, locaOffsets, font);
+ } else if (cffTableEntry) {
+ var cffTable = uncompressTable(data, cffTableEntry);
+ cff.parse(cffTable.data, cffTable.offset, font);
+ } else {
+ throw new Error('Font doesn\'t contain TrueType or CFF outlines.');
+ }
+
+ var hmtxTable = uncompressTable(data, hmtxTableEntry);
+ hmtx.parse(hmtxTable.data, hmtxTable.offset, font.numberOfHMetrics, font.numGlyphs, font.glyphs);
+ addGlyphNames(font);
+
+ if (kernTableEntry) {
+ var kernTable = uncompressTable(data, kernTableEntry);
+ font.kerningPairs = kern.parse(kernTable.data, kernTable.offset);
+ } else {
+ font.kerningPairs = {};
+ }
+
+ if (gposTableEntry) {
+ var gposTable = uncompressTable(data, gposTableEntry);
+ font.tables.gpos = gpos.parse(gposTable.data, gposTable.offset);
+ font.position.init();
+ }
+
+ if (gsubTableEntry) {
+ var gsubTable = uncompressTable(data, gsubTableEntry);
+ font.tables.gsub = gsub.parse(gsubTable.data, gsubTable.offset);
+ }
+
+ if (fvarTableEntry) {
+ var fvarTable = uncompressTable(data, fvarTableEntry);
+ font.tables.fvar = fvar.parse(fvarTable.data, fvarTable.offset, font.names);
+ }
+
+ if (metaTableEntry) {
+ var metaTable = uncompressTable(data, metaTableEntry);
+ font.tables.meta = meta.parse(metaTable.data, metaTable.offset);
+ font.metas = font.tables.meta;
+ }
+
+ return font;
+ }
-INTERPOLATE:
-============
+ /**
+ * Asynchronously load the font from a URL or a filesystem. When done, call the callback
+ * with two arguments `(err, font)`. The `err` will be null on success,
+ * the `font` is a Font object.
+ * We use the node.js callback convention so that
+ * opentype.js can integrate with frameworks like async.js.
+ * @alias opentype.load
+ * @param {string} url - The URL of the font to load.
+ * @param {Function} callback - The callback.
+ */
+ function load(url, callback) {
+ var isNode$$1 = typeof window === 'undefined';
+ var loadFn = isNode$$1 ? loadFromFile : loadFromUrl;
+ loadFn(url, function(err, arrayBuffer) {
+ if (err) {
+ return callback(err);
+ }
+ var font;
+ try {
+ font = parseBuffer(arrayBuffer);
+ } catch (e) {
+ return callback(e, null);
+ }
+ return callback(null, font);
+ });
+ }
-Examples of point interpolation.
+ /**
+ * Synchronously load the font from a URL or file.
+ * When done, returns the font object or throws an error.
+ * @alias opentype.loadSync
+ * @param {string} url - The URL of the font to load.
+ * @return {opentype.Font}
+ */
+ function loadSync(url) {
+ var fs = _dereq_('fs');
+ var buffer = fs.readFileSync(url);
+ return parseBuffer(nodeBufferToArrayBuffer(buffer));
+ }
-The weight of the movement of the reference point gets bigger
-the further the other reference point is away, thus the safest
-option (that is avoiding 0/0 divisions) is to weight the
-original distance of the other point by the sum of both distances.
+ exports.Font = Font;
+ exports.Glyph = Glyph;
+ exports.Path = Path;
+ exports.BoundingBox = BoundingBox;
+ exports._parse = parse;
+ exports.parse = parseBuffer;
+ exports.load = load;
+ exports.loadSync = loadSync;
-If the sum of both distances is 0, then move the point by the
-arithmetic average of the movement of both refererence points.
+ Object.defineProperty(exports, '__esModule', { value: true });
+})));
+}).call(this,_dereq_("buffer").Buffer)
+},{"buffer":4,"fs":3}],12:[function(_dereq_,module,exports){
+// shim for using process in browser
+var process = module.exports = {};
- (+6)
- rp1o *---->*rp1
- . . (+12)
- . . rp2o *---------->* rp2
- . . . .
- . . . .
- . 10 20 . .
- |.........|...................| .
- . . .
- . . (+8) .
- po *------>*p .
- . . .
- . 12 . 24 .
- |...........|.......................|
- 36
+// cached from whatever global is present so that test runners that stub it
+// don't break things. But we need to wrap it in a try catch in case it is
+// wrapped in strict mode code which doesn't define any globals. It's inside a
+// function because try/catches deoptimize in certain engines.
+var cachedSetTimeout;
+var cachedClearTimeout;
--------
-
-
-
- (+10)
- rp1o *-------->*rp1
- . . (-10)
- . . rp2 *<---------* rpo2
- . . . .
- . . . .
- . 10 . 30 . .
- |.........|.............................|
- . .
- . (+5) .
- po *--->* p .
- . . .
- . . 20 .
- |....|..............|
- 5 15
-
-
--------
-
-
- (+10)
- rp1o *-------->*rp1
- . .
- . .
- rp2o *-------->*rp2
-
-
- (+10)
- po *-------->* p
-
--------
-
-
- (+10)
- rp1o *-------->*rp1
- . .
- . .(+30)
- rp2o *---------------------------->*rp2
-
-
- (+25)
- po *----------------------->* p
-
-
-
-vim: set ts=4 sw=4 expandtab:
-*****/
-
-},{}],17:[function(_dereq_,module,exports){
-// The Layout object is the prototype of Substition objects, and provides utility methods to manipulate
-// common layout tables (GPOS, GSUB, GDEF...)
-
-'use strict';
-
-var check = _dereq_('./check');
-
-function searchTag(arr, tag) {
- /* jshint bitwise: false */
- var imin = 0;
- var imax = arr.length - 1;
- while (imin <= imax) {
- var imid = (imin + imax) >>> 1;
- var val = arr[imid].tag;
- if (val === tag) {
- return imid;
- } else if (val < tag) {
- imin = imid + 1;
- } else { imax = imid - 1; }
- }
- // Not found: return -1-insertion point
- return -imin - 1;
-}
-
-function binSearch(arr, value) {
- /* jshint bitwise: false */
- var imin = 0;
- var imax = arr.length - 1;
- while (imin <= imax) {
- var imid = (imin + imax) >>> 1;
- var val = arr[imid];
- if (val === value) {
- return imid;
- } else if (val < value) {
- imin = imid + 1;
- } else { imax = imid - 1; }
- }
- // Not found: return -1-insertion point
- return -imin - 1;
+function defaultSetTimout() {
+ throw new Error('setTimeout has not been defined');
}
-
-/**
- * @exports opentype.Layout
- * @class
- */
-function Layout(font, tableName) {
- this.font = font;
- this.tableName = tableName;
+function defaultClearTimeout () {
+ throw new Error('clearTimeout has not been defined');
}
-
-Layout.prototype = {
-
- /**
- * Binary search an object by "tag" property
- * @instance
- * @function searchTag
- * @memberof opentype.Layout
- * @param {Array} arr
- * @param {string} tag
- * @return {number}
- */
- searchTag: searchTag,
-
- /**
- * Binary search in a list of numbers
- * @instance
- * @function binSearch
- * @memberof opentype.Layout
- * @param {Array} arr
- * @param {number} value
- * @return {number}
- */
- binSearch: binSearch,
-
- /**
- * Get or create the Layout table (GSUB, GPOS etc).
- * @param {boolean} create - Whether to create a new one.
- * @return {Object} The GSUB or GPOS table.
- */
- getTable: function(create) {
- var layout = this.font.tables[this.tableName];
- if (!layout && create) {
- layout = this.font.tables[this.tableName] = this.createDefaultTable();
- }
- return layout;
- },
-
- /**
- * Returns all scripts in the substitution table.
- * @instance
- * @return {Array}
- */
- getScriptNames: function() {
- var layout = this.getTable();
- if (!layout) { return []; }
- return layout.scripts.map(function(script) {
- return script.tag;
- });
- },
-
- /**
- * Returns the best bet for a script name.
- * Returns 'DFLT' if it exists.
- * If not, returns 'latn' if it exists.
- * If neither exist, returns undefined.
- */
- getDefaultScriptName: function() {
- var layout = this.getTable();
- if (!layout) { return; }
- var hasLatn = false;
- for (var i = 0; i < layout.scripts.length; i++) {
- var name = layout.scripts[i].tag;
- if (name === 'DFLT') return name;
- if (name === 'latn') hasLatn = true;
- }
- if (hasLatn) return 'latn';
- },
-
- /**
- * Returns all LangSysRecords in the given script.
- * @instance
- * @param {string} [script='DFLT']
- * @param {boolean} create - forces the creation of this script table if it doesn't exist.
- * @return {Object} An object with tag and script properties.
- */
- getScriptTable: function(script, create) {
- var layout = this.getTable(create);
- if (layout) {
- script = script || 'DFLT';
- var scripts = layout.scripts;
- var pos = searchTag(layout.scripts, script);
- if (pos >= 0) {
- return scripts[pos].script;
- } else if (create) {
- var scr = {
- tag: script,
- script: {
- defaultLangSys: { reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: [] },
- langSysRecords: []
- }
- };
- scripts.splice(-1 - pos, 0, scr);
- return scr.script;
- }
- }
- },
-
- /**
- * Returns a language system table
- * @instance
- * @param {string} [script='DFLT']
- * @param {string} [language='dlft']
- * @param {boolean} create - forces the creation of this langSysTable if it doesn't exist.
- * @return {Object}
- */
- getLangSysTable: function(script, language, create) {
- var scriptTable = this.getScriptTable(script, create);
- if (scriptTable) {
- if (!language || language === 'dflt' || language === 'DFLT') {
- return scriptTable.defaultLangSys;
- }
- var pos = searchTag(scriptTable.langSysRecords, language);
- if (pos >= 0) {
- return scriptTable.langSysRecords[pos].langSys;
- } else if (create) {
- var langSysRecord = {
- tag: language,
- langSys: { reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: [] }
- };
- scriptTable.langSysRecords.splice(-1 - pos, 0, langSysRecord);
- return langSysRecord.langSys;
- }
- }
- },
-
- /**
- * Get a specific feature table.
- * @instance
- * @param {string} [script='DFLT']
- * @param {string} [language='dlft']
- * @param {string} feature - One of the codes listed at https://www.microsoft.com/typography/OTSPEC/featurelist.htm
- * @param {boolean} create - forces the creation of the feature table if it doesn't exist.
- * @return {Object}
- */
- getFeatureTable: function(script, language, feature, create) {
- var langSysTable = this.getLangSysTable(script, language, create);
- if (langSysTable) {
- var featureRecord;
- var featIndexes = langSysTable.featureIndexes;
- var allFeatures = this.font.tables[this.tableName].features;
- // The FeatureIndex array of indices is in arbitrary order,
- // even if allFeatures is sorted alphabetically by feature tag.
- for (var i = 0; i < featIndexes.length; i++) {
- featureRecord = allFeatures[featIndexes[i]];
- if (featureRecord.tag === feature) {
- return featureRecord.feature;
- }
- }
- if (create) {
- var index = allFeatures.length;
- // Automatic ordering of features would require to shift feature indexes in the script list.
- check.assert(index === 0 || feature >= allFeatures[index - 1].tag, 'Features must be added in alphabetical order.');
- featureRecord = {
- tag: feature,
- feature: { params: 0, lookupListIndexes: [] }
- };
- allFeatures.push(featureRecord);
- featIndexes.push(index);
- return featureRecord.feature;
- }
- }
- },
-
- /**
- * Get the lookup tables of a given type for a script/language/feature.
- * @instance
- * @param {string} [script='DFLT']
- * @param {string} [language='dlft']
- * @param {string} feature - 4-letter feature code
- * @param {number} lookupType - 1 to 8
- * @param {boolean} create - forces the creation of the lookup table if it doesn't exist, with no subtables.
- * @return {Object[]}
- */
- getLookupTables: function(script, language, feature, lookupType, create) {
- var featureTable = this.getFeatureTable(script, language, feature, create);
- var tables = [];
- if (featureTable) {
- var lookupTable;
- var lookupListIndexes = featureTable.lookupListIndexes;
- var allLookups = this.font.tables[this.tableName].lookups;
- // lookupListIndexes are in no particular order, so use naïve search.
- for (var i = 0; i < lookupListIndexes.length; i++) {
- lookupTable = allLookups[lookupListIndexes[i]];
- if (lookupTable.lookupType === lookupType) {
- tables.push(lookupTable);
- }
- }
- if (tables.length === 0 && create) {
- lookupTable = {
- lookupType: lookupType,
- lookupFlag: 0,
- subtables: [],
- markFilteringSet: undefined
- };
- var index = allLookups.length;
- allLookups.push(lookupTable);
- lookupListIndexes.push(index);
- return [lookupTable];
- }
- }
- return tables;
- },
-
- /**
- * Returns the list of glyph indexes of a coverage table.
- * Format 1: the list is stored raw
- * Format 2: compact list as range records.
- * @instance
- * @param {Object} coverageTable
- * @return {Array}
- */
- expandCoverage: function(coverageTable) {
- if (coverageTable.format === 1) {
- return coverageTable.glyphs;
+(function () {
+ try {
+ if (typeof setTimeout === 'function') {
+ cachedSetTimeout = setTimeout;
} else {
- var glyphs = [];
- var ranges = coverageTable.ranges;
- for (var i = 0; i < ranges.length; i++) {
- var range = ranges[i];
- var start = range.start;
- var end = range.end;
- for (var j = start; j <= end; j++) {
- glyphs.push(j);
- }
- }
- return glyphs;
+ cachedSetTimeout = defaultSetTimout;
}
+ } catch (e) {
+ cachedSetTimeout = defaultSetTimout;
}
-
-};
-
-module.exports = Layout;
-
-},{"./check":10}],18:[function(_dereq_,module,exports){
-// opentype.js
-// https://github.com/nodebox/opentype.js
-// (c) 2015 Frederik De Bleser
-// opentype.js may be freely distributed under the MIT license.
-
-/* global DataView, Uint8Array, XMLHttpRequest */
-
-'use strict';
-
-var inflate = _dereq_('tiny-inflate');
-
-var encoding = _dereq_('./encoding');
-var _font = _dereq_('./font');
-var glyph = _dereq_('./glyph');
-var parse = _dereq_('./parse');
-var bbox = _dereq_('./bbox');
-var path = _dereq_('./path');
-var util = _dereq_('./util');
-
-var cmap = _dereq_('./tables/cmap');
-var cff = _dereq_('./tables/cff');
-var fvar = _dereq_('./tables/fvar');
-var glyf = _dereq_('./tables/glyf');
-var gpos = _dereq_('./tables/gpos');
-var gsub = _dereq_('./tables/gsub');
-var head = _dereq_('./tables/head');
-var hhea = _dereq_('./tables/hhea');
-var hmtx = _dereq_('./tables/hmtx');
-var kern = _dereq_('./tables/kern');
-var ltag = _dereq_('./tables/ltag');
-var loca = _dereq_('./tables/loca');
-var maxp = _dereq_('./tables/maxp');
-var _name = _dereq_('./tables/name');
-var os2 = _dereq_('./tables/os2');
-var post = _dereq_('./tables/post');
-var meta = _dereq_('./tables/meta');
-
-/**
- * The opentype library.
- * @namespace opentype
- */
-
-// File loaders /////////////////////////////////////////////////////////
-/**
- * Loads a font from a file. The callback throws an error message as the first parameter if it fails
- * and the font as an ArrayBuffer in the second parameter if it succeeds.
- * @param {string} path - The path of the file
- * @param {Function} callback - The function to call when the font load completes
- */
-function loadFromFile(path, callback) {
- var fs = _dereq_('fs');
- fs.readFile(path, function(err, buffer) {
- if (err) {
- return callback(err.message);
+ try {
+ if (typeof clearTimeout === 'function') {
+ cachedClearTimeout = clearTimeout;
+ } else {
+ cachedClearTimeout = defaultClearTimeout;
}
-
- callback(null, util.nodeBufferToArrayBuffer(buffer));
- });
-}
-/**
- * Loads a font from a URL. The callback throws an error message as the first parameter if it fails
- * and the font as an ArrayBuffer in the second parameter if it succeeds.
- * @param {string} url - The URL of the font file.
- * @param {Function} callback - The function to call when the font load completes
- */
-function loadFromUrl(url, callback) {
- var request = new XMLHttpRequest();
- request.open('get', url, true);
- request.responseType = 'arraybuffer';
- request.onload = function() {
- if (request.status !== 200) {
- return callback('Font could not be loaded: ' + request.statusText);
+ } catch (e) {
+ cachedClearTimeout = defaultClearTimeout;
+ }
+} ())
+function runTimeout(fun) {
+ if (cachedSetTimeout === setTimeout) {
+ //normal enviroments in sane situations
+ return setTimeout(fun, 0);
+ }
+ // if setTimeout wasn't available but was latter defined
+ if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) {
+ cachedSetTimeout = setTimeout;
+ return setTimeout(fun, 0);
+ }
+ try {
+ // when when somebody has screwed with setTimeout but no I.E. maddness
+ return cachedSetTimeout(fun, 0);
+ } catch(e){
+ try {
+ // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally
+ return cachedSetTimeout.call(null, fun, 0);
+ } catch(e){
+ // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error
+ return cachedSetTimeout.call(this, fun, 0);
}
+ }
- return callback(null, request.response);
- };
-
- request.onerror = function () {
- callback('Font could not be loaded');
- };
- request.send();
}
-
-// Table Directory Entries //////////////////////////////////////////////
-/**
- * Parses OpenType table entries.
- * @param {DataView}
- * @param {Number}
- * @return {Object[]}
- */
-function parseOpenTypeTableEntries(data, numTables) {
- var tableEntries = [];
- var p = 12;
- for (var i = 0; i < numTables; i += 1) {
- var tag = parse.getTag(data, p);
- var checksum = parse.getULong(data, p + 4);
- var offset = parse.getULong(data, p + 8);
- var length = parse.getULong(data, p + 12);
- tableEntries.push({tag: tag, checksum: checksum, offset: offset, length: length, compression: false});
- p += 16;
+function runClearTimeout(marker) {
+ if (cachedClearTimeout === clearTimeout) {
+ //normal enviroments in sane situations
+ return clearTimeout(marker);
}
-
- return tableEntries;
-}
-
-/**
- * Parses WOFF table entries.
- * @param {DataView}
- * @param {Number}
- * @return {Object[]}
- */
-function parseWOFFTableEntries(data, numTables) {
- var tableEntries = [];
- var p = 44; // offset to the first table directory entry.
- for (var i = 0; i < numTables; i += 1) {
- var tag = parse.getTag(data, p);
- var offset = parse.getULong(data, p + 4);
- var compLength = parse.getULong(data, p + 8);
- var origLength = parse.getULong(data, p + 12);
- var compression;
- if (compLength < origLength) {
- compression = 'WOFF';
- } else {
- compression = false;
- }
-
- tableEntries.push({tag: tag, offset: offset, compression: compression,
- compressedLength: compLength, originalLength: origLength});
- p += 20;
+ // if clearTimeout wasn't available but was latter defined
+ if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) {
+ cachedClearTimeout = clearTimeout;
+ return clearTimeout(marker);
}
-
- return tableEntries;
-}
-
-/**
- * @typedef TableData
- * @type Object
- * @property {DataView} data - The DataView
- * @property {number} offset - The data offset.
- */
-
-/**
- * @param {DataView}
- * @param {Object}
- * @return {TableData}
- */
-function uncompressTable(data, tableEntry) {
- if (tableEntry.compression === 'WOFF') {
- var inBuffer = new Uint8Array(data.buffer, tableEntry.offset + 2, tableEntry.compressedLength - 2);
- var outBuffer = new Uint8Array(tableEntry.originalLength);
- inflate(inBuffer, outBuffer);
- if (outBuffer.byteLength !== tableEntry.originalLength) {
- throw new Error('Decompression error: ' + tableEntry.tag + ' decompressed length doesn\'t match recorded length');
+ try {
+ // when when somebody has screwed with setTimeout but no I.E. maddness
+ return cachedClearTimeout(marker);
+ } catch (e){
+ try {
+ // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally
+ return cachedClearTimeout.call(null, marker);
+ } catch (e){
+ // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error.
+ // Some versions of I.E. have different rules for clearTimeout vs setTimeout
+ return cachedClearTimeout.call(this, marker);
}
-
- var view = new DataView(outBuffer.buffer, 0);
- return {data: view, offset: 0};
- } else {
- return {data: data, offset: tableEntry.offset};
}
-}
-// Public API ///////////////////////////////////////////////////////////
-
-/**
- * Parse the OpenType file data (as an ArrayBuffer) and return a Font object.
- * Throws an error if the font could not be parsed.
- * @param {ArrayBuffer}
- * @return {opentype.Font}
- */
-function parseBuffer(buffer) {
- var indexToLocFormat;
- var ltagTable;
-
- // Since the constructor can also be called to create new fonts from scratch, we indicate this
- // should be an empty font that we'll fill with our own data.
- var font = new _font.Font({empty: true});
-
- // OpenType fonts use big endian byte ordering.
- // We can't rely on typed array view types, because they operate with the endianness of the host computer.
- // Instead we use DataViews where we can specify endianness.
- var data = new DataView(buffer, 0);
- var numTables;
- var tableEntries = [];
- var signature = parse.getTag(data, 0);
- if (signature === String.fromCharCode(0, 1, 0, 0) || signature === 'true' || signature === 'typ1') {
- font.outlinesFormat = 'truetype';
- numTables = parse.getUShort(data, 4);
- tableEntries = parseOpenTypeTableEntries(data, numTables);
- } else if (signature === 'OTTO') {
- font.outlinesFormat = 'cff';
- numTables = parse.getUShort(data, 4);
- tableEntries = parseOpenTypeTableEntries(data, numTables);
- } else if (signature === 'wOFF') {
- var flavor = parse.getTag(data, 4);
- if (flavor === String.fromCharCode(0, 1, 0, 0)) {
- font.outlinesFormat = 'truetype';
- } else if (flavor === 'OTTO') {
- font.outlinesFormat = 'cff';
- } else {
- throw new Error('Unsupported OpenType flavor ' + signature);
- }
- numTables = parse.getUShort(data, 12);
- tableEntries = parseWOFFTableEntries(data, numTables);
- } else {
- throw new Error('Unsupported OpenType signature ' + signature);
- }
- var cffTableEntry;
- var fvarTableEntry;
- var glyfTableEntry;
- var gposTableEntry;
- var gsubTableEntry;
- var hmtxTableEntry;
- var kernTableEntry;
- var locaTableEntry;
- var nameTableEntry;
- var metaTableEntry;
- var p;
-
- for (var i = 0; i < numTables; i += 1) {
- var tableEntry = tableEntries[i];
- var table;
- switch (tableEntry.tag) {
- case 'cmap':
- table = uncompressTable(data, tableEntry);
- font.tables.cmap = cmap.parse(table.data, table.offset);
- font.encoding = new encoding.CmapEncoding(font.tables.cmap);
- break;
- case 'cvt ' :
- table = uncompressTable(data, tableEntry);
- p = new parse.Parser(table.data, table.offset);
- font.tables.cvt = p.parseShortList(tableEntry.length / 2);
- break;
- case 'fvar':
- fvarTableEntry = tableEntry;
- break;
- case 'fpgm' :
- table = uncompressTable(data, tableEntry);
- p = new parse.Parser(table.data, table.offset);
- font.tables.fpgm = p.parseByteList(tableEntry.length);
- break;
- case 'head':
- table = uncompressTable(data, tableEntry);
- font.tables.head = head.parse(table.data, table.offset);
- font.unitsPerEm = font.tables.head.unitsPerEm;
- indexToLocFormat = font.tables.head.indexToLocFormat;
- break;
- case 'hhea':
- table = uncompressTable(data, tableEntry);
- font.tables.hhea = hhea.parse(table.data, table.offset);
- font.ascender = font.tables.hhea.ascender;
- font.descender = font.tables.hhea.descender;
- font.numberOfHMetrics = font.tables.hhea.numberOfHMetrics;
- break;
- case 'hmtx':
- hmtxTableEntry = tableEntry;
- break;
- case 'ltag':
- table = uncompressTable(data, tableEntry);
- ltagTable = ltag.parse(table.data, table.offset);
- break;
- case 'maxp':
- table = uncompressTable(data, tableEntry);
- font.tables.maxp = maxp.parse(table.data, table.offset);
- font.numGlyphs = font.tables.maxp.numGlyphs;
- break;
- case 'name':
- nameTableEntry = tableEntry;
- break;
- case 'OS/2':
- table = uncompressTable(data, tableEntry);
- font.tables.os2 = os2.parse(table.data, table.offset);
- break;
- case 'post':
- table = uncompressTable(data, tableEntry);
- font.tables.post = post.parse(table.data, table.offset);
- font.glyphNames = new encoding.GlyphNames(font.tables.post);
- break;
- case 'prep' :
- table = uncompressTable(data, tableEntry);
- p = new parse.Parser(table.data, table.offset);
- font.tables.prep = p.parseByteList(tableEntry.length);
- break;
- case 'glyf':
- glyfTableEntry = tableEntry;
- break;
- case 'loca':
- locaTableEntry = tableEntry;
- break;
- case 'CFF ':
- cffTableEntry = tableEntry;
- break;
- case 'kern':
- kernTableEntry = tableEntry;
- break;
- case 'GPOS':
- gposTableEntry = tableEntry;
- break;
- case 'GSUB':
- gsubTableEntry = tableEntry;
- break;
- case 'meta':
- metaTableEntry = tableEntry;
- break;
- }
- }
+}
+var queue = [];
+var draining = false;
+var currentQueue;
+var queueIndex = -1;
- var nameTable = uncompressTable(data, nameTableEntry);
- font.tables.name = _name.parse(nameTable.data, nameTable.offset, ltagTable);
- font.names = font.tables.name;
-
- if (glyfTableEntry && locaTableEntry) {
- var shortVersion = indexToLocFormat === 0;
- var locaTable = uncompressTable(data, locaTableEntry);
- var locaOffsets = loca.parse(locaTable.data, locaTable.offset, font.numGlyphs, shortVersion);
- var glyfTable = uncompressTable(data, glyfTableEntry);
- font.glyphs = glyf.parse(glyfTable.data, glyfTable.offset, locaOffsets, font);
- } else if (cffTableEntry) {
- var cffTable = uncompressTable(data, cffTableEntry);
- cff.parse(cffTable.data, cffTable.offset, font);
- } else {
- throw new Error('Font doesn\'t contain TrueType or CFF outlines.');
+function cleanUpNextTick() {
+ if (!draining || !currentQueue) {
+ return;
}
-
- var hmtxTable = uncompressTable(data, hmtxTableEntry);
- hmtx.parse(hmtxTable.data, hmtxTable.offset, font.numberOfHMetrics, font.numGlyphs, font.glyphs);
- encoding.addGlyphNames(font);
-
- if (kernTableEntry) {
- var kernTable = uncompressTable(data, kernTableEntry);
- font.kerningPairs = kern.parse(kernTable.data, kernTable.offset);
+ draining = false;
+ if (currentQueue.length) {
+ queue = currentQueue.concat(queue);
} else {
- font.kerningPairs = {};
- }
-
- if (gposTableEntry) {
- var gposTable = uncompressTable(data, gposTableEntry);
- gpos.parse(gposTable.data, gposTable.offset, font);
+ queueIndex = -1;
}
-
- if (gsubTableEntry) {
- var gsubTable = uncompressTable(data, gsubTableEntry);
- font.tables.gsub = gsub.parse(gsubTable.data, gsubTable.offset);
+ if (queue.length) {
+ drainQueue();
}
+}
- if (fvarTableEntry) {
- var fvarTable = uncompressTable(data, fvarTableEntry);
- font.tables.fvar = fvar.parse(fvarTable.data, fvarTable.offset, font.names);
+function drainQueue() {
+ if (draining) {
+ return;
}
+ var timeout = runTimeout(cleanUpNextTick);
+ draining = true;
- if (metaTableEntry) {
- var metaTable = uncompressTable(data, metaTableEntry);
- font.tables.meta = meta.parse(metaTable.data, metaTable.offset);
- font.metas = font.tables.meta;
+ var len = queue.length;
+ while(len) {
+ currentQueue = queue;
+ queue = [];
+ while (++queueIndex < len) {
+ if (currentQueue) {
+ currentQueue[queueIndex].run();
+ }
+ }
+ queueIndex = -1;
+ len = queue.length;
}
-
- return font;
+ currentQueue = null;
+ draining = false;
+ runClearTimeout(timeout);
}
-/**
- * Asynchronously load the font from a URL or a filesystem. When done, call the callback
- * with two arguments `(err, font)`. The `err` will be null on success,
- * the `font` is a Font object.
- * We use the node.js callback convention so that
- * opentype.js can integrate with frameworks like async.js.
- * @alias opentype.load
- * @param {string} url - The URL of the font to load.
- * @param {Function} callback - The callback.
- */
-function load(url, callback) {
- var isNode = typeof window === 'undefined';
- var loadFn = isNode ? loadFromFile : loadFromUrl;
- loadFn(url, function(err, arrayBuffer) {
- if (err) {
- return callback(err);
- }
- var font;
- try {
- font = parseBuffer(arrayBuffer);
- } catch (e) {
- return callback(e, null);
+process.nextTick = function (fun) {
+ var args = new Array(arguments.length - 1);
+ if (arguments.length > 1) {
+ for (var i = 1; i < arguments.length; i++) {
+ args[i - 1] = arguments[i];
}
- return callback(null, font);
- });
-}
+ }
+ queue.push(new Item(fun, args));
+ if (queue.length === 1 && !draining) {
+ runTimeout(drainQueue);
+ }
+};
-/**
- * Synchronously load the font from a URL or file.
- * When done, returns the font object or throws an error.
- * @alias opentype.loadSync
- * @param {string} url - The URL of the font to load.
- * @return {opentype.Font}
- */
-function loadSync(url) {
- var fs = _dereq_('fs');
- var buffer = fs.readFileSync(url);
- return parseBuffer(util.nodeBufferToArrayBuffer(buffer));
+// v8 likes predictible objects
+function Item(fun, array) {
+ this.fun = fun;
+ this.array = array;
}
-
-exports._parse = parse;
-exports.Font = _font.Font;
-exports.Glyph = glyph.Glyph;
-exports.Path = path.Path;
-exports.BoundingBox = bbox.BoundingBox;
-exports.parse = parseBuffer;
-exports.load = load;
-exports.loadSync = loadSync;
-
-},{"./bbox":9,"./encoding":12,"./font":13,"./glyph":14,"./parse":19,"./path":20,"./tables/cff":23,"./tables/cmap":24,"./tables/fvar":25,"./tables/glyf":26,"./tables/gpos":27,"./tables/gsub":28,"./tables/head":29,"./tables/hhea":30,"./tables/hmtx":31,"./tables/kern":32,"./tables/loca":33,"./tables/ltag":34,"./tables/maxp":35,"./tables/meta":36,"./tables/name":37,"./tables/os2":38,"./tables/post":39,"./util":42,"fs":3,"tiny-inflate":44}],19:[function(_dereq_,module,exports){
-// Parsing utility functions
-
-'use strict';
-
-var check = _dereq_('./check');
-
-// Retrieve an unsigned byte from the DataView.
-exports.getByte = function getByte(dataView, offset) {
- return dataView.getUint8(offset);
+Item.prototype.run = function () {
+ this.fun.apply(null, this.array);
};
+process.title = 'browser';
+process.browser = true;
+process.env = {};
+process.argv = [];
+process.version = ''; // empty string to avoid regexp issues
+process.versions = {};
-exports.getCard8 = exports.getByte;
-
-// Retrieve an unsigned 16-bit short from the DataView.
-// The value is stored in big endian.
-function getUShort(dataView, offset) {
- return dataView.getUint16(offset, false);
-}
+function noop() {}
-exports.getUShort = exports.getCard16 = getUShort;
+process.on = noop;
+process.addListener = noop;
+process.once = noop;
+process.off = noop;
+process.removeListener = noop;
+process.removeAllListeners = noop;
+process.emit = noop;
+process.prependListener = noop;
+process.prependOnceListener = noop;
-// Retrieve a signed 16-bit short from the DataView.
-// The value is stored in big endian.
-exports.getShort = function(dataView, offset) {
- return dataView.getInt16(offset, false);
-};
+process.listeners = function (name) { return [] }
-// Retrieve an unsigned 32-bit long from the DataView.
-// The value is stored in big endian.
-exports.getULong = function(dataView, offset) {
- return dataView.getUint32(offset, false);
+process.binding = function (name) {
+ throw new Error('process.binding is not supported');
};
-// Retrieve a 32-bit signed fixed-point number (16.16) from the DataView.
-// The value is stored in big endian.
-exports.getFixed = function(dataView, offset) {
- var decimal = dataView.getInt16(offset, false);
- var fraction = dataView.getUint16(offset + 2, false);
- return decimal + fraction / 65535;
+process.cwd = function () { return '/' };
+process.chdir = function (dir) {
+ throw new Error('process.chdir is not supported');
};
+process.umask = function() { return 0; };
-// Retrieve a 4-character tag from the DataView.
-// Tags are used to identify tables.
-exports.getTag = function(dataView, offset) {
- var tag = '';
- for (var i = offset; i < offset + 4; i += 1) {
- tag += String.fromCharCode(dataView.getInt8(i));
- }
+},{}],13:[function(_dereq_,module,exports){
+(function(self) {
+ 'use strict';
- return tag;
-};
+ if (self.fetch) {
+ return
+ }
-// Retrieve an offset from the DataView.
-// Offsets are 1 to 4 bytes in length, depending on the offSize argument.
-exports.getOffset = function(dataView, offset, offSize) {
- var v = 0;
- for (var i = 0; i < offSize; i += 1) {
- v <<= 8;
- v += dataView.getUint8(offset + i);
- }
+ var support = {
+ searchParams: 'URLSearchParams' in self,
+ iterable: 'Symbol' in self && 'iterator' in Symbol,
+ blob: 'FileReader' in self && 'Blob' in self && (function() {
+ try {
+ new Blob()
+ return true
+ } catch(e) {
+ return false
+ }
+ })(),
+ formData: 'FormData' in self,
+ arrayBuffer: 'ArrayBuffer' in self
+ }
- return v;
-};
+ if (support.arrayBuffer) {
+ var viewClasses = [
+ '[object Int8Array]',
+ '[object Uint8Array]',
+ '[object Uint8ClampedArray]',
+ '[object Int16Array]',
+ '[object Uint16Array]',
+ '[object Int32Array]',
+ '[object Uint32Array]',
+ '[object Float32Array]',
+ '[object Float64Array]'
+ ]
-// Retrieve a number of bytes from start offset to the end offset from the DataView.
-exports.getBytes = function(dataView, startOffset, endOffset) {
- var bytes = [];
- for (var i = startOffset; i < endOffset; i += 1) {
- bytes.push(dataView.getUint8(i));
+ var isDataView = function(obj) {
+ return obj && DataView.prototype.isPrototypeOf(obj)
}
- return bytes;
-};
-
-// Convert the list of bytes to a string.
-exports.bytesToString = function(bytes) {
- var s = '';
- for (var i = 0; i < bytes.length; i += 1) {
- s += String.fromCharCode(bytes[i]);
+ var isArrayBufferView = ArrayBuffer.isView || function(obj) {
+ return obj && viewClasses.indexOf(Object.prototype.toString.call(obj)) > -1
}
+ }
- return s;
-};
-
-var typeOffsets = {
- byte: 1,
- uShort: 2,
- short: 2,
- uLong: 4,
- fixed: 4,
- longDateTime: 8,
- tag: 4
-};
-
-// A stateful parser that changes the offset whenever a value is retrieved.
-// The data is a DataView.
-function Parser(data, offset) {
- this.data = data;
- this.offset = offset;
- this.relativeOffset = 0;
-}
-
-Parser.prototype.parseByte = function() {
- var v = this.data.getUint8(this.offset + this.relativeOffset);
- this.relativeOffset += 1;
- return v;
-};
-
-Parser.prototype.parseChar = function() {
- var v = this.data.getInt8(this.offset + this.relativeOffset);
- this.relativeOffset += 1;
- return v;
-};
-
-Parser.prototype.parseCard8 = Parser.prototype.parseByte;
-
-Parser.prototype.parseUShort = function() {
- var v = this.data.getUint16(this.offset + this.relativeOffset);
- this.relativeOffset += 2;
- return v;
-};
+ function normalizeName(name) {
+ if (typeof name !== 'string') {
+ name = String(name)
+ }
+ if (/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(name)) {
+ throw new TypeError('Invalid character in header field name')
+ }
+ return name.toLowerCase()
+ }
-Parser.prototype.parseCard16 = Parser.prototype.parseUShort;
-Parser.prototype.parseSID = Parser.prototype.parseUShort;
-Parser.prototype.parseOffset16 = Parser.prototype.parseUShort;
+ function normalizeValue(value) {
+ if (typeof value !== 'string') {
+ value = String(value)
+ }
+ return value
+ }
-Parser.prototype.parseShort = function() {
- var v = this.data.getInt16(this.offset + this.relativeOffset);
- this.relativeOffset += 2;
- return v;
-};
+ // Build a destructive iterator for the value list
+ function iteratorFor(items) {
+ var iterator = {
+ next: function() {
+ var value = items.shift()
+ return {done: value === undefined, value: value}
+ }
+ }
-Parser.prototype.parseF2Dot14 = function() {
- var v = this.data.getInt16(this.offset + this.relativeOffset) / 16384;
- this.relativeOffset += 2;
- return v;
-};
+ if (support.iterable) {
+ iterator[Symbol.iterator] = function() {
+ return iterator
+ }
+ }
-Parser.prototype.parseULong = function() {
- var v = exports.getULong(this.data, this.offset + this.relativeOffset);
- this.relativeOffset += 4;
- return v;
-};
+ return iterator
+ }
-Parser.prototype.parseFixed = function() {
- var v = exports.getFixed(this.data, this.offset + this.relativeOffset);
- this.relativeOffset += 4;
- return v;
-};
+ function Headers(headers) {
+ this.map = {}
-Parser.prototype.parseString = function(length) {
- var dataView = this.data;
- var offset = this.offset + this.relativeOffset;
- var string = '';
- this.relativeOffset += length;
- for (var i = 0; i < length; i++) {
- string += String.fromCharCode(dataView.getUint8(offset + i));
+ if (headers instanceof Headers) {
+ headers.forEach(function(value, name) {
+ this.append(name, value)
+ }, this)
+ } else if (Array.isArray(headers)) {
+ headers.forEach(function(header) {
+ this.append(header[0], header[1])
+ }, this)
+ } else if (headers) {
+ Object.getOwnPropertyNames(headers).forEach(function(name) {
+ this.append(name, headers[name])
+ }, this)
}
+ }
- return string;
-};
+ Headers.prototype.append = function(name, value) {
+ name = normalizeName(name)
+ value = normalizeValue(value)
+ var oldValue = this.map[name]
+ this.map[name] = oldValue ? oldValue+','+value : value
+ }
-Parser.prototype.parseTag = function() {
- return this.parseString(4);
-};
+ Headers.prototype['delete'] = function(name) {
+ delete this.map[normalizeName(name)]
+ }
-// LONGDATETIME is a 64-bit integer.
-// JavaScript and unix timestamps traditionally use 32 bits, so we
-// only take the last 32 bits.
-// + Since until 2038 those bits will be filled by zeros we can ignore them.
-Parser.prototype.parseLongDateTime = function() {
- var v = exports.getULong(this.data, this.offset + this.relativeOffset + 4);
- // Subtract seconds between 01/01/1904 and 01/01/1970
- // to convert Apple Mac timstamp to Standard Unix timestamp
- v -= 2082844800;
- this.relativeOffset += 8;
- return v;
-};
+ Headers.prototype.get = function(name) {
+ name = normalizeName(name)
+ return this.has(name) ? this.map[name] : null
+ }
-Parser.prototype.parseVersion = function() {
- var major = getUShort(this.data, this.offset + this.relativeOffset);
+ Headers.prototype.has = function(name) {
+ return this.map.hasOwnProperty(normalizeName(name))
+ }
- // How to interpret the minor version is very vague in the spec. 0x5000 is 5, 0x1000 is 1
- // This returns the correct number if minor = 0xN000 where N is 0-9
- var minor = getUShort(this.data, this.offset + this.relativeOffset + 2);
- this.relativeOffset += 4;
- return major + minor / 0x1000 / 10;
-};
+ Headers.prototype.set = function(name, value) {
+ this.map[normalizeName(name)] = normalizeValue(value)
+ }
-Parser.prototype.skip = function(type, amount) {
- if (amount === undefined) {
- amount = 1;
+ Headers.prototype.forEach = function(callback, thisArg) {
+ for (var name in this.map) {
+ if (this.map.hasOwnProperty(name)) {
+ callback.call(thisArg, this.map[name], name, this)
+ }
}
+ }
- this.relativeOffset += typeOffsets[type] * amount;
-};
+ Headers.prototype.keys = function() {
+ var items = []
+ this.forEach(function(value, name) { items.push(name) })
+ return iteratorFor(items)
+ }
-///// Parsing lists and records ///////////////////////////////
+ Headers.prototype.values = function() {
+ var items = []
+ this.forEach(function(value) { items.push(value) })
+ return iteratorFor(items)
+ }
-// Parse a list of 16 bit unsigned integers. The length of the list can be read on the stream
-// or provided as an argument.
-Parser.prototype.parseOffset16List =
-Parser.prototype.parseUShortList = function(count) {
- if (count === undefined) { count = this.parseUShort(); }
- var offsets = new Array(count);
- var dataView = this.data;
- var offset = this.offset + this.relativeOffset;
- for (var i = 0; i < count; i++) {
- offsets[i] = dataView.getUint16(offset);
- offset += 2;
- }
+ Headers.prototype.entries = function() {
+ var items = []
+ this.forEach(function(value, name) { items.push([name, value]) })
+ return iteratorFor(items)
+ }
- this.relativeOffset += count * 2;
- return offsets;
-};
+ if (support.iterable) {
+ Headers.prototype[Symbol.iterator] = Headers.prototype.entries
+ }
-// Parses a list of 16 bit signed integers.
-Parser.prototype.parseShortList = function(count) {
- var list = new Array(count);
- var dataView = this.data;
- var offset = this.offset + this.relativeOffset;
- for (var i = 0; i < count; i++) {
- list[i] = dataView.getInt16(offset);
- offset += 2;
+ function consumed(body) {
+ if (body.bodyUsed) {
+ return Promise.reject(new TypeError('Already read'))
}
+ body.bodyUsed = true
+ }
- this.relativeOffset += count * 2;
- return list;
-};
+ function fileReaderReady(reader) {
+ return new Promise(function(resolve, reject) {
+ reader.onload = function() {
+ resolve(reader.result)
+ }
+ reader.onerror = function() {
+ reject(reader.error)
+ }
+ })
+ }
-// Parses a list of bytes.
-Parser.prototype.parseByteList = function(count) {
- var list = new Array(count);
- var dataView = this.data;
- var offset = this.offset + this.relativeOffset;
- for (var i = 0; i < count; i++) {
- list[i] = dataView.getUint8(offset++);
- }
+ function readBlobAsArrayBuffer(blob) {
+ var reader = new FileReader()
+ var promise = fileReaderReady(reader)
+ reader.readAsArrayBuffer(blob)
+ return promise
+ }
- this.relativeOffset += count;
- return list;
-};
+ function readBlobAsText(blob) {
+ var reader = new FileReader()
+ var promise = fileReaderReady(reader)
+ reader.readAsText(blob)
+ return promise
+ }
-/**
- * Parse a list of items.
- * Record count is optional, if omitted it is read from the stream.
- * itemCallback is one of the Parser methods.
- */
-Parser.prototype.parseList = function(count, itemCallback) {
- if (!itemCallback) {
- itemCallback = count;
- count = this.parseUShort();
- }
- var list = new Array(count);
- for (var i = 0; i < count; i++) {
- list[i] = itemCallback.call(this);
- }
- return list;
-};
+ function readArrayBufferAsText(buf) {
+ var view = new Uint8Array(buf)
+ var chars = new Array(view.length)
-/**
- * Parse a list of records.
- * Record count is optional, if omitted it is read from the stream.
- * Example of recordDescription: { sequenceIndex: Parser.uShort, lookupListIndex: Parser.uShort }
- */
-Parser.prototype.parseRecordList = function(count, recordDescription) {
- // If the count argument is absent, read it in the stream.
- if (!recordDescription) {
- recordDescription = count;
- count = this.parseUShort();
- }
- var records = new Array(count);
- var fields = Object.keys(recordDescription);
- for (var i = 0; i < count; i++) {
- var rec = {};
- for (var j = 0; j < fields.length; j++) {
- var fieldName = fields[j];
- var fieldType = recordDescription[fieldName];
- rec[fieldName] = fieldType.call(this);
- }
- records[i] = rec;
+ for (var i = 0; i < view.length; i++) {
+ chars[i] = String.fromCharCode(view[i])
}
- return records;
-};
+ return chars.join('')
+ }
-// Parse a data structure into an object
-// Example of description: { sequenceIndex: Parser.uShort, lookupListIndex: Parser.uShort }
-Parser.prototype.parseStruct = function(description) {
- if (typeof description === 'function') {
- return description.call(this);
+ function bufferClone(buf) {
+ if (buf.slice) {
+ return buf.slice(0)
} else {
- var fields = Object.keys(description);
- var struct = {};
- for (var j = 0; j < fields.length; j++) {
- var fieldName = fields[j];
- var fieldType = description[fieldName];
- struct[fieldName] = fieldType.call(this);
- }
- return struct;
- }
-};
-
-Parser.prototype.parsePointer = function(description) {
- var structOffset = this.parseOffset16();
- if (structOffset > 0) { // NULL offset => return indefined
- return new Parser(this.data, this.offset + structOffset).parseStruct(description);
- }
-};
-
-/**
- * Parse a list of offsets to lists of 16-bit integers,
- * or a list of offsets to lists of offsets to any kind of items.
- * If itemCallback is not provided, a list of list of UShort is assumed.
- * If provided, itemCallback is called on each item and must parse the item.
- * See examples in tables/gsub.js
- */
-Parser.prototype.parseListOfLists = function(itemCallback) {
- var offsets = this.parseOffset16List();
- var count = offsets.length;
- var relativeOffset = this.relativeOffset;
- var list = new Array(count);
- for (var i = 0; i < count; i++) {
- var start = offsets[i];
- if (start === 0) { // NULL offset
- list[i] = undefined; // Add i as owned property to list. Convenient with assert.
- continue;
- }
- this.relativeOffset = start;
- if (itemCallback) {
- var subOffsets = this.parseOffset16List();
- var subList = new Array(subOffsets.length);
- for (var j = 0; j < subOffsets.length; j++) {
- this.relativeOffset = start + subOffsets[j];
- subList[j] = itemCallback.call(this);
- }
- list[i] = subList;
- } else {
- list[i] = this.parseUShortList();
- }
+ var view = new Uint8Array(buf.byteLength)
+ view.set(new Uint8Array(buf))
+ return view.buffer
}
- this.relativeOffset = relativeOffset;
- return list;
-};
+ }
-///// Complex tables parsing //////////////////////////////////
+ function Body() {
+ this.bodyUsed = false
-// Parse a coverage table in a GSUB, GPOS or GDEF table.
-// https://www.microsoft.com/typography/OTSPEC/chapter2.htm
-// parser.offset must point to the start of the table containing the coverage.
-Parser.prototype.parseCoverage = function() {
- var startOffset = this.offset + this.relativeOffset;
- var format = this.parseUShort();
- var count = this.parseUShort();
- if (format === 1) {
- return {
- format: 1,
- glyphs: this.parseUShortList(count)
- };
- } else if (format === 2) {
- var ranges = new Array(count);
- for (var i = 0; i < count; i++) {
- ranges[i] = {
- start: this.parseUShort(),
- end: this.parseUShort(),
- index: this.parseUShort()
- };
- }
- return {
- format: 2,
- ranges: ranges
- };
+ this._initBody = function(body) {
+ this._bodyInit = body
+ if (!body) {
+ this._bodyText = ''
+ } else if (typeof body === 'string') {
+ this._bodyText = body
+ } else if (support.blob && Blob.prototype.isPrototypeOf(body)) {
+ this._bodyBlob = body
+ } else if (support.formData && FormData.prototype.isPrototypeOf(body)) {
+ this._bodyFormData = body
+ } else if (support.searchParams && URLSearchParams.prototype.isPrototypeOf(body)) {
+ this._bodyText = body.toString()
+ } else if (support.arrayBuffer && support.blob && isDataView(body)) {
+ this._bodyArrayBuffer = bufferClone(body.buffer)
+ // IE 10-11 can't handle a DataView body.
+ this._bodyInit = new Blob([this._bodyArrayBuffer])
+ } else if (support.arrayBuffer && (ArrayBuffer.prototype.isPrototypeOf(body) || isArrayBufferView(body))) {
+ this._bodyArrayBuffer = bufferClone(body)
+ } else {
+ throw new Error('unsupported BodyInit type')
+ }
+
+ if (!this.headers.get('content-type')) {
+ if (typeof body === 'string') {
+ this.headers.set('content-type', 'text/plain;charset=UTF-8')
+ } else if (this._bodyBlob && this._bodyBlob.type) {
+ this.headers.set('content-type', this._bodyBlob.type)
+ } else if (support.searchParams && URLSearchParams.prototype.isPrototypeOf(body)) {
+ this.headers.set('content-type', 'application/x-www-form-urlencoded;charset=UTF-8')
+ }
+ }
}
- check.assert(false, '0x' + startOffset.toString(16) + ': Coverage format must be 1 or 2.');
-};
-// Parse a Class Definition Table in a GSUB, GPOS or GDEF table.
-// https://www.microsoft.com/typography/OTSPEC/chapter2.htm
-Parser.prototype.parseClassDef = function() {
- var startOffset = this.offset + this.relativeOffset;
- var format = this.parseUShort();
- if (format === 1) {
- return {
- format: 1,
- startGlyph: this.parseUShort(),
- classes: this.parseUShortList()
- };
- } else if (format === 2) {
- return {
- format: 2,
- ranges: this.parseRecordList({
- start: Parser.uShort,
- end: Parser.uShort,
- classId: Parser.uShort
- })
- };
+ if (support.blob) {
+ this.blob = function() {
+ var rejected = consumed(this)
+ if (rejected) {
+ return rejected
+ }
+
+ if (this._bodyBlob) {
+ return Promise.resolve(this._bodyBlob)
+ } else if (this._bodyArrayBuffer) {
+ return Promise.resolve(new Blob([this._bodyArrayBuffer]))
+ } else if (this._bodyFormData) {
+ throw new Error('could not read FormData body as blob')
+ } else {
+ return Promise.resolve(new Blob([this._bodyText]))
+ }
+ }
+
+ this.arrayBuffer = function() {
+ if (this._bodyArrayBuffer) {
+ return consumed(this) || Promise.resolve(this._bodyArrayBuffer)
+ } else {
+ return this.blob().then(readBlobAsArrayBuffer)
+ }
+ }
}
- check.assert(false, '0x' + startOffset.toString(16) + ': ClassDef format must be 1 or 2.');
-};
-///// Static methods ///////////////////////////////////
-// These convenience methods can be used as callbacks and should be called with "this" context set to a Parser instance.
+ this.text = function() {
+ var rejected = consumed(this)
+ if (rejected) {
+ return rejected
+ }
-Parser.list = function(count, itemCallback) {
- return function() {
- return this.parseList(count, itemCallback);
- };
-};
+ if (this._bodyBlob) {
+ return readBlobAsText(this._bodyBlob)
+ } else if (this._bodyArrayBuffer) {
+ return Promise.resolve(readArrayBufferAsText(this._bodyArrayBuffer))
+ } else if (this._bodyFormData) {
+ throw new Error('could not read FormData body as text')
+ } else {
+ return Promise.resolve(this._bodyText)
+ }
+ }
-Parser.recordList = function(count, recordDescription) {
- return function() {
- return this.parseRecordList(count, recordDescription);
- };
-};
+ if (support.formData) {
+ this.formData = function() {
+ return this.text().then(decode)
+ }
+ }
-Parser.pointer = function(description) {
- return function() {
- return this.parsePointer(description);
- };
-};
+ this.json = function() {
+ return this.text().then(JSON.parse)
+ }
-Parser.tag = Parser.prototype.parseTag;
-Parser.byte = Parser.prototype.parseByte;
-Parser.uShort = Parser.offset16 = Parser.prototype.parseUShort;
-Parser.uShortList = Parser.prototype.parseUShortList;
-Parser.struct = Parser.prototype.parseStruct;
-Parser.coverage = Parser.prototype.parseCoverage;
-Parser.classDef = Parser.prototype.parseClassDef;
-
-///// Script, Feature, Lookup lists ///////////////////////////////////////////////
-// https://www.microsoft.com/typography/OTSPEC/chapter2.htm
-
-var langSysTable = {
- reserved: Parser.uShort,
- reqFeatureIndex: Parser.uShort,
- featureIndexes: Parser.uShortList
-};
-
-Parser.prototype.parseScriptList = function() {
- return this.parsePointer(Parser.recordList({
- tag: Parser.tag,
- script: Parser.pointer({
- defaultLangSys: Parser.pointer(langSysTable),
- langSysRecords: Parser.recordList({
- tag: Parser.tag,
- langSys: Parser.pointer(langSysTable)
- })
- })
- }));
-};
+ return this
+ }
-Parser.prototype.parseFeatureList = function() {
- return this.parsePointer(Parser.recordList({
- tag: Parser.tag,
- feature: Parser.pointer({
- featureParams: Parser.offset16,
- lookupListIndexes: Parser.uShortList
- })
- }));
-};
+ // HTTP methods whose capitalization should be normalized
+ var methods = ['DELETE', 'GET', 'HEAD', 'OPTIONS', 'POST', 'PUT']
-Parser.prototype.parseLookupList = function(lookupTableParsers) {
- return this.parsePointer(Parser.list(Parser.pointer(function() {
- var lookupType = this.parseUShort();
- check.argument(1 <= lookupType && lookupType <= 8, 'GSUB lookup type ' + lookupType + ' unknown.');
- var lookupFlag = this.parseUShort();
- var useMarkFilteringSet = lookupFlag & 0x10;
- return {
- lookupType: lookupType,
- lookupFlag: lookupFlag,
- subtables: this.parseList(Parser.pointer(lookupTableParsers[lookupType])),
- markFilteringSet: useMarkFilteringSet ? this.parseUShort() : undefined
- };
- })));
-};
+ function normalizeMethod(method) {
+ var upcased = method.toUpperCase()
+ return (methods.indexOf(upcased) > -1) ? upcased : method
+ }
-exports.Parser = Parser;
+ function Request(input, options) {
+ options = options || {}
+ var body = options.body
-},{"./check":10}],20:[function(_dereq_,module,exports){
-// Geometric objects
+ if (input instanceof Request) {
+ if (input.bodyUsed) {
+ throw new TypeError('Already read')
+ }
+ this.url = input.url
+ this.credentials = input.credentials
+ if (!options.headers) {
+ this.headers = new Headers(input.headers)
+ }
+ this.method = input.method
+ this.mode = input.mode
+ if (!body && input._bodyInit != null) {
+ body = input._bodyInit
+ input.bodyUsed = true
+ }
+ } else {
+ this.url = String(input)
+ }
-'use strict';
+ this.credentials = options.credentials || this.credentials || 'omit'
+ if (options.headers || !this.headers) {
+ this.headers = new Headers(options.headers)
+ }
+ this.method = normalizeMethod(options.method || this.method || 'GET')
+ this.mode = options.mode || this.mode || null
+ this.referrer = null
-var bbox = _dereq_('./bbox');
+ if ((this.method === 'GET' || this.method === 'HEAD') && body) {
+ throw new TypeError('Body not allowed for GET or HEAD requests')
+ }
+ this._initBody(body)
+ }
-/**
- * A bézier path containing a set of path commands similar to a SVG path.
- * Paths can be drawn on a context using `draw`.
- * @exports opentype.Path
- * @class
- * @constructor
- */
-function Path() {
- this.commands = [];
- this.fill = 'black';
- this.stroke = null;
- this.strokeWidth = 1;
-}
+ Request.prototype.clone = function() {
+ return new Request(this, { body: this._bodyInit })
+ }
-/**
- * @param {number} x
- * @param {number} y
- */
-Path.prototype.moveTo = function(x, y) {
- this.commands.push({
- type: 'M',
- x: x,
- y: y
- });
-};
+ function decode(body) {
+ var form = new FormData()
+ body.trim().split('&').forEach(function(bytes) {
+ if (bytes) {
+ var split = bytes.split('=')
+ var name = split.shift().replace(/\+/g, ' ')
+ var value = split.join('=').replace(/\+/g, ' ')
+ form.append(decodeURIComponent(name), decodeURIComponent(value))
+ }
+ })
+ return form
+ }
-/**
- * @param {number} x
- * @param {number} y
- */
-Path.prototype.lineTo = function(x, y) {
- this.commands.push({
- type: 'L',
- x: x,
- y: y
- });
-};
+ function parseHeaders(rawHeaders) {
+ var headers = new Headers()
+ rawHeaders.split(/\r?\n/).forEach(function(line) {
+ var parts = line.split(':')
+ var key = parts.shift().trim()
+ if (key) {
+ var value = parts.join(':').trim()
+ headers.append(key, value)
+ }
+ })
+ return headers
+ }
-/**
- * Draws cubic curve
- * @function
- * curveTo
- * @memberof opentype.Path.prototype
- * @param {number} x1 - x of control 1
- * @param {number} y1 - y of control 1
- * @param {number} x2 - x of control 2
- * @param {number} y2 - y of control 2
- * @param {number} x - x of path point
- * @param {number} y - y of path point
- */
-
-/**
- * Draws cubic curve
- * @function
- * bezierCurveTo
- * @memberof opentype.Path.prototype
- * @param {number} x1 - x of control 1
- * @param {number} y1 - y of control 1
- * @param {number} x2 - x of control 2
- * @param {number} y2 - y of control 2
- * @param {number} x - x of path point
- * @param {number} y - y of path point
- * @see curveTo
- */
-Path.prototype.curveTo = Path.prototype.bezierCurveTo = function(x1, y1, x2, y2, x, y) {
- this.commands.push({
- type: 'C',
- x1: x1,
- y1: y1,
- x2: x2,
- y2: y2,
- x: x,
- y: y
- });
-};
+ Body.call(Request.prototype)
-/**
- * Draws quadratic curve
- * @function
- * quadraticCurveTo
- * @memberof opentype.Path.prototype
- * @param {number} x1 - x of control
- * @param {number} y1 - y of control
- * @param {number} x - x of path point
- * @param {number} y - y of path point
- */
+ function Response(bodyInit, options) {
+ if (!options) {
+ options = {}
+ }
-/**
- * Draws quadratic curve
- * @function
- * quadTo
- * @memberof opentype.Path.prototype
- * @param {number} x1 - x of control
- * @param {number} y1 - y of control
- * @param {number} x - x of path point
- * @param {number} y - y of path point
- */
-Path.prototype.quadTo = Path.prototype.quadraticCurveTo = function(x1, y1, x, y) {
- this.commands.push({
- type: 'Q',
- x1: x1,
- y1: y1,
- x: x,
- y: y
- });
-};
+ this.type = 'default'
+ this.status = 'status' in options ? options.status : 200
+ this.ok = this.status >= 200 && this.status < 300
+ this.statusText = 'statusText' in options ? options.statusText : 'OK'
+ this.headers = new Headers(options.headers)
+ this.url = options.url || ''
+ this._initBody(bodyInit)
+ }
-/**
- * Closes the path
- * @function closePath
- * @memberof opentype.Path.prototype
- */
+ Body.call(Response.prototype)
-/**
- * Close the path
- * @function close
- * @memberof opentype.Path.prototype
- */
-Path.prototype.close = Path.prototype.closePath = function() {
- this.commands.push({
- type: 'Z'
- });
-};
+ Response.prototype.clone = function() {
+ return new Response(this._bodyInit, {
+ status: this.status,
+ statusText: this.statusText,
+ headers: new Headers(this.headers),
+ url: this.url
+ })
+ }
-/**
- * Add the given path or list of commands to the commands of this path.
- * @param {Array} pathOrCommands - another opentype.Path, an opentype.BoundingBox, or an array of commands.
- */
-Path.prototype.extend = function(pathOrCommands) {
- if (pathOrCommands.commands) {
- pathOrCommands = pathOrCommands.commands;
- } else if (pathOrCommands instanceof bbox.BoundingBox) {
- var box = pathOrCommands;
- this.moveTo(box.x1, box.y1);
- this.lineTo(box.x2, box.y1);
- this.lineTo(box.x2, box.y2);
- this.lineTo(box.x1, box.y2);
- this.close();
- return;
- }
+ Response.error = function() {
+ var response = new Response(null, {status: 0, statusText: ''})
+ response.type = 'error'
+ return response
+ }
- Array.prototype.push.apply(this.commands, pathOrCommands);
-};
-
-/**
- * Calculate the bounding box of the path.
- * @returns {opentype.BoundingBox}
- */
-Path.prototype.getBoundingBox = function() {
- var box = new bbox.BoundingBox();
-
- var startX = 0;
- var startY = 0;
- var prevX = 0;
- var prevY = 0;
- for (var i = 0; i < this.commands.length; i++) {
- var cmd = this.commands[i];
- switch (cmd.type) {
- case 'M':
- box.addPoint(cmd.x, cmd.y);
- startX = prevX = cmd.x;
- startY = prevY = cmd.y;
- break;
- case 'L':
- box.addPoint(cmd.x, cmd.y);
- prevX = cmd.x;
- prevY = cmd.y;
- break;
- case 'Q':
- box.addQuad(prevX, prevY, cmd.x1, cmd.y1, cmd.x, cmd.y);
- prevX = cmd.x;
- prevY = cmd.y;
- break;
- case 'C':
- box.addBezier(prevX, prevY, cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
- prevX = cmd.x;
- prevY = cmd.y;
- break;
- case 'Z':
- prevX = startX;
- prevY = startY;
- break;
- default:
- throw new Error('Unexpected path commmand ' + cmd.type);
- }
- }
- if (box.isEmpty()) {
- box.addPoint(0, 0);
- }
- return box;
-};
+ var redirectStatuses = [301, 302, 303, 307, 308]
-/**
- * Draw the path to a 2D context.
- * @param {CanvasRenderingContext2D} ctx - A 2D drawing context.
- */
-Path.prototype.draw = function(ctx) {
- ctx.beginPath();
- for (var i = 0; i < this.commands.length; i += 1) {
- var cmd = this.commands[i];
- if (cmd.type === 'M') {
- ctx.moveTo(cmd.x, cmd.y);
- } else if (cmd.type === 'L') {
- ctx.lineTo(cmd.x, cmd.y);
- } else if (cmd.type === 'C') {
- ctx.bezierCurveTo(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
- } else if (cmd.type === 'Q') {
- ctx.quadraticCurveTo(cmd.x1, cmd.y1, cmd.x, cmd.y);
- } else if (cmd.type === 'Z') {
- ctx.closePath();
- }
+ Response.redirect = function(url, status) {
+ if (redirectStatuses.indexOf(status) === -1) {
+ throw new RangeError('Invalid status code')
}
- if (this.fill) {
- ctx.fillStyle = this.fill;
- ctx.fill();
- }
+ return new Response(null, {status: status, headers: {location: url}})
+ }
- if (this.stroke) {
- ctx.strokeStyle = this.stroke;
- ctx.lineWidth = this.strokeWidth;
- ctx.stroke();
- }
-};
+ self.Headers = Headers
+ self.Request = Request
+ self.Response = Response
-/**
- * Convert the Path to a string of path data instructions
- * See http://www.w3.org/TR/SVG/paths.html#PathData
- * @param {number} [decimalPlaces=2] - The amount of decimal places for floating-point values
- * @return {string}
- */
-Path.prototype.toPathData = function(decimalPlaces) {
- decimalPlaces = decimalPlaces !== undefined ? decimalPlaces : 2;
+ self.fetch = function(input, init) {
+ return new Promise(function(resolve, reject) {
+ var request = new Request(input, init)
+ var xhr = new XMLHttpRequest()
- function floatToString(v) {
- if (Math.round(v) === v) {
- return '' + Math.round(v);
- } else {
- return v.toFixed(decimalPlaces);
+ xhr.onload = function() {
+ var options = {
+ status: xhr.status,
+ statusText: xhr.statusText,
+ headers: parseHeaders(xhr.getAllResponseHeaders() || '')
}
- }
+ options.url = 'responseURL' in xhr ? xhr.responseURL : options.headers.get('X-Request-URL')
+ var body = 'response' in xhr ? xhr.response : xhr.responseText
+ resolve(new Response(body, options))
+ }
- function packValues() {
- var s = '';
- for (var i = 0; i < arguments.length; i += 1) {
- var v = arguments[i];
- if (v >= 0 && i > 0) {
- s += ' ';
- }
+ xhr.onerror = function() {
+ reject(new TypeError('Network request failed'))
+ }
- s += floatToString(v);
- }
+ xhr.ontimeout = function() {
+ reject(new TypeError('Network request failed'))
+ }
- return s;
- }
+ xhr.open(request.method, request.url, true)
- var d = '';
- for (var i = 0; i < this.commands.length; i += 1) {
- var cmd = this.commands[i];
- if (cmd.type === 'M') {
- d += 'M' + packValues(cmd.x, cmd.y);
- } else if (cmd.type === 'L') {
- d += 'L' + packValues(cmd.x, cmd.y);
- } else if (cmd.type === 'C') {
- d += 'C' + packValues(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
- } else if (cmd.type === 'Q') {
- d += 'Q' + packValues(cmd.x1, cmd.y1, cmd.x, cmd.y);
- } else if (cmd.type === 'Z') {
- d += 'Z';
- }
- }
+ if (request.credentials === 'include') {
+ xhr.withCredentials = true
+ }
- return d;
-};
+ if ('responseType' in xhr && support.blob) {
+ xhr.responseType = 'blob'
+ }
-/**
- * Convert the path to an SVG element, as a string.
- * @param {number} [decimalPlaces=2] - The amount of decimal places for floating-point values
- * @return {string}
- */
-Path.prototype.toSVG = function(decimalPlaces) {
- var svg = '.
+ *
+ * In these functions, hue is always in the range [0, 1], just like all other
+ * components are in the range [0, 1]. 'Brightness' and 'value' are used
+ * interchangeably.
*/
-Substitution.prototype.addSingle = function(feature, substitution, script, language) {
- var lookupTable = this.getLookupTables(script, language, feature, 1, true)[0];
- var subtable = getSubstFormat(lookupTable, 2, { // lookup type 1 subtable, format 2, coverage format 1
- substFormat: 2,
- coverage: { format: 1, glyphs: [] },
- substitute: []
- });
- check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format);
- var coverageGlyph = substitution.sub;
- var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph);
- if (pos < 0) {
- pos = -1 - pos;
- subtable.coverage.glyphs.splice(pos, 0, coverageGlyph);
- subtable.substitute.splice(pos, 0, 0);
- }
- subtable.substitute[pos] = substitution.by;
-};
-/**
- * Add or modify an alternate substitution (lookup type 1)
- * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...)
- * @param {Object} substitution - { sub: id, by: [ids] }
- * @param {string} [script='DFLT']
- * @param {string} [language='dflt']
- */
-Substitution.prototype.addAlternate = function(feature, substitution, script, language) {
- var lookupTable = this.getLookupTables(script, language, feature, 3, true)[0];
- var subtable = getSubstFormat(lookupTable, 1, { // lookup type 3 subtable, format 1, coverage format 1
- substFormat: 1,
- coverage: { format: 1, glyphs: [] },
- alternateSets: []
- });
- check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format);
- var coverageGlyph = substitution.sub;
- var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph);
- if (pos < 0) {
- pos = -1 - pos;
- subtable.coverage.glyphs.splice(pos, 0, coverageGlyph);
- subtable.alternateSets.splice(pos, 0, 0);
- }
- subtable.alternateSets[pos] = substitution.by;
-};
+var p5 = _dereq_('../core/main');
+p5.ColorConversion = {};
/**
- * Add a ligature (lookup type 4)
- * Ligatures with more components must be stored ahead of those with fewer components in order to be found
- * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...)
- * @param {Object} ligature - { sub: [ids], by: id }
- * @param {string} [script='DFLT']
- * @param {string} [language='dflt']
+ * Convert an HSBA array to HSLA.
*/
-Substitution.prototype.addLigature = function(feature, ligature, script, language) {
- var lookupTable = this.getLookupTables(script, language, feature, 4, true)[0];
- var subtable = lookupTable.subtables[0];
- if (!subtable) {
- subtable = { // lookup type 4 subtable, format 1, coverage format 1
- substFormat: 1,
- coverage: { format: 1, glyphs: [] },
- ligatureSets: []
- };
- lookupTable.subtables[0] = subtable;
- }
- check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format);
- var coverageGlyph = ligature.sub[0];
- var ligComponents = ligature.sub.slice(1);
- var ligatureTable = {
- ligGlyph: ligature.by,
- components: ligComponents
- };
- var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph);
- if (pos >= 0) {
- // ligatureSet already exists
- var ligatureSet = subtable.ligatureSets[pos];
- for (var i = 0; i < ligatureSet.length; i++) {
- // If ligature already exists, return.
- if (arraysEqual(ligatureSet[i].components, ligComponents)) {
- return;
- }
- }
- // ligature does not exist: add it.
- ligatureSet.push(ligatureTable);
+p5.ColorConversion._hsbaToHSLA = function(hsba) {
+ var hue = hsba[0];
+ var sat = hsba[1];
+ var val = hsba[2];
+
+ // Calculate lightness.
+ var li = (2 - sat) * val / 2;
+
+ // Convert saturation.
+ if (li !== 0) {
+ if (li === 1) {
+ sat = 0;
+ } else if (li < 0.5) {
+ sat = sat / (2 - sat);
} else {
- // Create a new ligatureSet and add coverage for the first glyph.
- pos = -1 - pos;
- subtable.coverage.glyphs.splice(pos, 0, coverageGlyph);
- subtable.ligatureSets.splice(pos, 0, [ligatureTable]);
+ sat = sat * val / (2 - li * 2);
}
-};
+ }
-/**
- * List all feature data for a given script and language.
- * @param {string} feature - 4-letter feature name
- * @param {string} [script='DFLT']
- * @param {string} [language='dflt']
- * @return {Array} substitutions - The list of substitutions.
- */
-Substitution.prototype.getFeature = function(feature, script, language) {
- if (/ss\d\d/.test(feature)) { // ss01 - ss20
- return this.getSingle(feature, script, language);
- }
- switch (feature) {
- case 'aalt':
- case 'salt':
- return this.getSingle(feature, script, language)
- .concat(this.getAlternates(feature, script, language));
- case 'dlig':
- case 'liga':
- case 'rlig': return this.getLigatures(feature, script, language);
- }
+ // Hue and alpha stay the same.
+ return [hue, sat, li, hsba[3]];
};
/**
- * Add a substitution to a feature for a given script and language.
- * @param {string} feature - 4-letter feature name
- * @param {Object} sub - the substitution to add (an object like { sub: id or [ids], by: id or [ids] })
- * @param {string} [script='DFLT']
- * @param {string} [language='dflt']
+ * Convert an HSBA array to RGBA.
*/
-Substitution.prototype.add = function(feature, sub, script, language) {
- if (/ss\d\d/.test(feature)) { // ss01 - ss20
- return this.addSingle(feature, sub, script, language);
- }
- switch (feature) {
- case 'aalt':
- case 'salt':
- if (typeof sub.by === 'number') {
- return this.addSingle(feature, sub, script, language);
- }
- return this.addAlternate(feature, sub, script, language);
- case 'dlig':
- case 'liga':
- case 'rlig':
- return this.addLigature(feature, sub, script, language);
- }
-};
+p5.ColorConversion._hsbaToRGBA = function(hsba) {
+ var hue = hsba[0] * 6; // We will split hue into 6 sectors.
+ var sat = hsba[1];
+ var val = hsba[2];
-module.exports = Substitution;
+ var RGBA = [];
-},{"./check":10,"./layout":17}],22:[function(_dereq_,module,exports){
-// Table metadata
+ if (sat === 0) {
+ RGBA = [val, val, val, hsba[3]]; // Return early if grayscale.
+ } else {
+ var sector = Math.floor(hue);
+ var tint1 = val * (1 - sat);
+ var tint2 = val * (1 - sat * (hue - sector));
+ var tint3 = val * (1 - sat * (1 + sector - hue));
+ var red, green, blue;
+ if (sector === 1) {
+ // Yellow to green.
+ red = tint2;
+ green = val;
+ blue = tint1;
+ } else if (sector === 2) {
+ // Green to cyan.
+ red = tint1;
+ green = val;
+ blue = tint3;
+ } else if (sector === 3) {
+ // Cyan to blue.
+ red = tint1;
+ green = tint2;
+ blue = val;
+ } else if (sector === 4) {
+ // Blue to magenta.
+ red = tint3;
+ green = tint1;
+ blue = val;
+ } else if (sector === 5) {
+ // Magenta to red.
+ red = val;
+ green = tint1;
+ blue = tint2;
+ } else {
+ // Red to yellow (sector could be 0 or 6).
+ red = val;
+ green = tint3;
+ blue = tint1;
+ }
+ RGBA = [red, green, blue, hsba[3]];
+ }
-'use strict';
+ return RGBA;
+};
-var check = _dereq_('./check');
-var encode = _dereq_('./types').encode;
-var sizeOf = _dereq_('./types').sizeOf;
/**
- * @exports opentype.Table
- * @class
- * @param {string} tableName
- * @param {Array} fields
- * @param {Object} options
- * @constructor
+ * Convert an HSLA array to HSBA.
*/
-function Table(tableName, fields, options) {
- var i;
- for (i = 0; i < fields.length; i += 1) {
- var field = fields[i];
- this[field.name] = field.value;
- }
+p5.ColorConversion._hslaToHSBA = function(hsla) {
+ var hue = hsla[0];
+ var sat = hsla[1];
+ var li = hsla[2];
- this.tableName = tableName;
- this.fields = fields;
- if (options) {
- var optionKeys = Object.keys(options);
- for (i = 0; i < optionKeys.length; i += 1) {
- var k = optionKeys[i];
- var v = options[k];
- if (this[k] !== undefined) {
- this[k] = v;
- }
- }
- }
-}
+ // Calculate brightness.
+ var val;
+ if (li < 0.5) {
+ val = (1 + sat) * li;
+ } else {
+ val = li + sat - li * sat;
+ }
-/**
- * Encodes the table and returns an array of bytes
- * @return {Array}
- */
-Table.prototype.encode = function() {
- return encode.TABLE(this);
-};
+ // Convert saturation.
+ sat = 2 * (val - li) / val;
-/**
- * Get the size of the table.
- * @return {number}
- */
-Table.prototype.sizeOf = function() {
- return sizeOf.TABLE(this);
+ // Hue and alpha stay the same.
+ return [hue, sat, val, hsla[3]];
};
/**
- * @private
+ * Convert an HSLA array to RGBA.
+ *
+ * We need to change basis from HSLA to something that can be more easily be
+ * projected onto RGBA. We will choose hue and brightness as our first two
+ * components, and pick a convenient third one ('zest') so that we don't need
+ * to calculate formal HSBA saturation.
*/
-function ushortList(itemName, list, count) {
- if (count === undefined) {
- count = list.length;
- }
- var fields = new Array(list.length + 1);
- fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count};
- for (var i = 0; i < list.length; i++) {
- fields[i + 1] = {name: itemName + i, type: 'USHORT', value: list[i]};
- }
- return fields;
-}
+p5.ColorConversion._hslaToRGBA = function(hsla) {
+ var hue = hsla[0] * 6; // We will split hue into 6 sectors.
+ var sat = hsla[1];
+ var li = hsla[2];
-/**
- * @private
- */
-function tableList(itemName, records, itemCallback) {
- var count = records.length;
- var fields = new Array(count + 1);
- fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count};
- for (var i = 0; i < count; i++) {
- fields[i + 1] = {name: itemName + i, type: 'TABLE', value: itemCallback(records[i], i)};
- }
- return fields;
-}
-
-/**
- * @private
- */
-function recordList(itemName, records, itemCallback) {
- var count = records.length;
- var fields = [];
- fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count};
- for (var i = 0; i < count; i++) {
- fields = fields.concat(itemCallback(records[i], i));
- }
- return fields;
-}
-
-// Common Layout Tables
+ var RGBA = [];
-/**
- * @exports opentype.Coverage
- * @class
- * @param {opentype.Table}
- * @constructor
- * @extends opentype.Table
- */
-function Coverage(coverageTable) {
- if (coverageTable.format === 1) {
- Table.call(this, 'coverageTable',
- [{name: 'coverageFormat', type: 'USHORT', value: 1}]
- .concat(ushortList('glyph', coverageTable.glyphs))
- );
+ if (sat === 0) {
+ RGBA = [li, li, li, hsla[3]]; // Return early if grayscale.
+ } else {
+ // Calculate brightness.
+ var val;
+ if (li < 0.5) {
+ val = (1 + sat) * li;
} else {
- check.assert(false, 'Can\'t create coverage table format 2 yet.');
+ val = li + sat - li * sat;
}
-}
-Coverage.prototype = Object.create(Table.prototype);
-Coverage.prototype.constructor = Coverage;
-
-function ScriptList(scriptListTable) {
- Table.call(this, 'scriptListTable',
- recordList('scriptRecord', scriptListTable, function(scriptRecord, i) {
- var script = scriptRecord.script;
- var defaultLangSys = script.defaultLangSys;
- check.assert(!!defaultLangSys, 'Unable to write GSUB: script ' + scriptRecord.tag + ' has no default language system.');
- return [
- {name: 'scriptTag' + i, type: 'TAG', value: scriptRecord.tag},
- {name: 'script' + i, type: 'TABLE', value: new Table('scriptTable', [
- {name: 'defaultLangSys', type: 'TABLE', value: new Table('defaultLangSys', [
- {name: 'lookupOrder', type: 'USHORT', value: 0},
- {name: 'reqFeatureIndex', type: 'USHORT', value: defaultLangSys.reqFeatureIndex}]
- .concat(ushortList('featureIndex', defaultLangSys.featureIndexes)))}
- ].concat(recordList('langSys', script.langSysRecords, function(langSysRecord, i) {
- var langSys = langSysRecord.langSys;
- return [
- {name: 'langSysTag' + i, type: 'TAG', value: langSysRecord.tag},
- {name: 'langSys' + i, type: 'TABLE', value: new Table('langSys', [
- {name: 'lookupOrder', type: 'USHORT', value: 0},
- {name: 'reqFeatureIndex', type: 'USHORT', value: langSys.reqFeatureIndex}
- ].concat(ushortList('featureIndex', langSys.featureIndexes)))}
- ];
- })))}
- ];
- })
- );
-}
-ScriptList.prototype = Object.create(Table.prototype);
-ScriptList.prototype.constructor = ScriptList;
-/**
- * @exports opentype.FeatureList
- * @class
- * @param {opentype.Table}
- * @constructor
- * @extends opentype.Table
- */
-function FeatureList(featureListTable) {
- Table.call(this, 'featureListTable',
- recordList('featureRecord', featureListTable, function(featureRecord, i) {
- var feature = featureRecord.feature;
- return [
- {name: 'featureTag' + i, type: 'TAG', value: featureRecord.tag},
- {name: 'feature' + i, type: 'TABLE', value: new Table('featureTable', [
- {name: 'featureParams', type: 'USHORT', value: feature.featureParams},
- ].concat(ushortList('lookupListIndex', feature.lookupListIndexes)))}
- ];
- })
- );
-}
-FeatureList.prototype = Object.create(Table.prototype);
-FeatureList.prototype.constructor = FeatureList;
+ // Define zest.
+ var zest = 2 * li - val;
-/**
- * @exports opentype.LookupList
- * @class
- * @param {opentype.Table}
- * @param {Object}
- * @constructor
- * @extends opentype.Table
- */
-function LookupList(lookupListTable, subtableMakers) {
- Table.call(this, 'lookupListTable', tableList('lookup', lookupListTable, function(lookupTable) {
- var subtableCallback = subtableMakers[lookupTable.lookupType];
- check.assert(!!subtableCallback, 'Unable to write GSUB lookup type ' + lookupTable.lookupType + ' tables.');
- return new Table('lookupTable', [
- {name: 'lookupType', type: 'USHORT', value: lookupTable.lookupType},
- {name: 'lookupFlag', type: 'USHORT', value: lookupTable.lookupFlag}
- ].concat(tableList('subtable', lookupTable.subtables, subtableCallback)));
- }));
-}
-LookupList.prototype = Object.create(Table.prototype);
-LookupList.prototype.constructor = LookupList;
-
-// Record = same as Table, but inlined (a Table has an offset and its data is further in the stream)
-// Don't use offsets inside Records (probable bug), only in Tables.
-exports.Record = exports.Table = Table;
-exports.Coverage = Coverage;
-exports.ScriptList = ScriptList;
-exports.FeatureList = FeatureList;
-exports.LookupList = LookupList;
-
-exports.ushortList = ushortList;
-exports.tableList = tableList;
-exports.recordList = recordList;
-
-},{"./check":10,"./types":41}],23:[function(_dereq_,module,exports){
-// The `CFF` table contains the glyph outlines in PostScript format.
-// https://www.microsoft.com/typography/OTSPEC/cff.htm
-// http://download.microsoft.com/download/8/0/1/801a191c-029d-4af3-9642-555f6fe514ee/cff.pdf
-// http://download.microsoft.com/download/8/0/1/801a191c-029d-4af3-9642-555f6fe514ee/type2.pdf
+ // Implement projection (project onto green by default).
+ var hzvToRGB = function(hue, zest, val) {
+ if (hue < 0) {
+ // Hue must wrap to allow projection onto red and blue.
+ hue += 6;
+ } else if (hue >= 6) {
+ hue -= 6;
+ }
+ if (hue < 1) {
+ // Red to yellow (increasing green).
+ return zest + (val - zest) * hue;
+ } else if (hue < 3) {
+ // Yellow to cyan (greatest green).
+ return val;
+ } else if (hue < 4) {
+ // Cyan to blue (decreasing green).
+ return zest + (val - zest) * (4 - hue);
+ } else {
+ // Blue to red (least green).
+ return zest;
+ }
+ };
-'use strict';
+ // Perform projections, offsetting hue as necessary.
+ RGBA = [
+ hzvToRGB(hue + 2, zest, val),
+ hzvToRGB(hue, zest, val),
+ hzvToRGB(hue - 2, zest, val),
+ hsla[3]
+ ];
+ }
-var encoding = _dereq_('../encoding');
-var glyphset = _dereq_('../glyphset');
-var parse = _dereq_('../parse');
-var path = _dereq_('../path');
-var table = _dereq_('../table');
+ return RGBA;
+};
-// Custom equals function that can also check lists.
-function equals(a, b) {
- if (a === b) {
- return true;
- } else if (Array.isArray(a) && Array.isArray(b)) {
- if (a.length !== b.length) {
- return false;
- }
+/**
+ * Convert an RGBA array to HSBA.
+ */
+p5.ColorConversion._rgbaToHSBA = function(rgba) {
+ var red = rgba[0];
+ var green = rgba[1];
+ var blue = rgba[2];
- for (var i = 0; i < a.length; i += 1) {
- if (!equals(a[i], b[i])) {
- return false;
- }
- }
+ var val = Math.max(red, green, blue);
+ var chroma = val - Math.min(red, green, blue);
- return true;
- } else {
- return false;
+ var hue, sat;
+ if (chroma === 0) {
+ // Return early if grayscale.
+ hue = 0;
+ sat = 0;
+ } else {
+ sat = chroma / val;
+ if (red === val) {
+ // Magenta to yellow.
+ hue = (green - blue) / chroma;
+ } else if (green === val) {
+ // Yellow to cyan.
+ hue = 2 + (blue - red) / chroma;
+ } else if (blue === val) {
+ // Cyan to magenta.
+ hue = 4 + (red - green) / chroma;
}
-}
-
-// Subroutines are encoded using the negative half of the number space.
-// See type 2 chapter 4.7 "Subroutine operators".
-function calcCFFSubroutineBias(subrs) {
- var bias;
- if (subrs.length < 1240) {
- bias = 107;
- } else if (subrs.length < 33900) {
- bias = 1131;
- } else {
- bias = 32768;
+ if (hue < 0) {
+ // Confine hue to the interval [0, 1).
+ hue += 6;
+ } else if (hue >= 6) {
+ hue -= 6;
}
+ }
- return bias;
-}
+ return [hue / 6, sat, val, rgba[3]];
+};
-// Parse a `CFF` INDEX array.
-// An index array consists of a list of offsets, then a list of objects at those offsets.
-function parseCFFIndex(data, start, conversionFn) {
- //var i, objectOffset, endOffset;
- var offsets = [];
- var objects = [];
- var count = parse.getCard16(data, start);
- var i;
- var objectOffset;
- var endOffset;
- if (count !== 0) {
- var offsetSize = parse.getByte(data, start + 2);
- objectOffset = start + ((count + 1) * offsetSize) + 2;
- var pos = start + 3;
- for (i = 0; i < count + 1; i += 1) {
- offsets.push(parse.getOffset(data, pos, offsetSize));
- pos += offsetSize;
- }
+/**
+ * Convert an RGBA array to HSLA.
+ */
+p5.ColorConversion._rgbaToHSLA = function(rgba) {
+ var red = rgba[0];
+ var green = rgba[1];
+ var blue = rgba[2];
+
+ var val = Math.max(red, green, blue);
+ var min = Math.min(red, green, blue);
+ var li = val + min; // We will halve this later.
+ var chroma = val - min;
- // The total size of the index array is 4 header bytes + the value of the last offset.
- endOffset = objectOffset + offsets[count];
+ var hue, sat;
+ if (chroma === 0) {
+ // Return early if grayscale.
+ hue = 0;
+ sat = 0;
+ } else {
+ if (li < 1) {
+ sat = chroma / li;
} else {
- endOffset = start + 2;
+ sat = chroma / (2 - li);
}
-
- for (i = 0; i < offsets.length - 1; i += 1) {
- var value = parse.getBytes(data, objectOffset + offsets[i], objectOffset + offsets[i + 1]);
- if (conversionFn) {
- value = conversionFn(value);
- }
-
- objects.push(value);
+ if (red === val) {
+ // Magenta to yellow.
+ hue = (green - blue) / chroma;
+ } else if (green === val) {
+ // Yellow to cyan.
+ hue = 2 + (blue - red) / chroma;
+ } else if (blue === val) {
+ // Cyan to magenta.
+ hue = 4 + (red - green) / chroma;
+ }
+ if (hue < 0) {
+ // Confine hue to the interval [0, 1).
+ hue += 6;
+ } else if (hue >= 6) {
+ hue -= 6;
}
+ }
- return {objects: objects, startOffset: start, endOffset: endOffset};
-}
+ return [hue / 6, sat, li / 2, rgba[3]];
+};
-// Parse a `CFF` DICT real value.
-function parseFloatOperand(parser) {
- var s = '';
- var eof = 15;
- var lookup = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '.', 'E', 'E-', null, '-'];
- while (true) {
- var b = parser.parseByte();
- var n1 = b >> 4;
- var n2 = b & 15;
-
- if (n1 === eof) {
- break;
- }
+module.exports = p5.ColorConversion;
- s += lookup[n1];
+},{"../core/main":25}],16:[function(_dereq_,module,exports){
+/**
+ * @module Color
+ * @submodule Creating & Reading
+ * @for p5
+ * @requires core
+ * @requires constants
+ */
- if (n2 === eof) {
- break;
- }
+'use strict';
- s += lookup[n2];
- }
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
+_dereq_('./p5.Color');
+_dereq_('../core/error_helpers');
- return parseFloat(s);
-}
+/**
+ * Extracts the alpha value from a color or pixel array.
+ *
+ * @method alpha
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the alpha value
+ * @example
+ *
+ *
+ * noStroke();
+ * var c = color(0, 126, 255, 102);
+ * fill(c);
+ * rect(15, 15, 35, 70);
+ * var value = alpha(c); // Sets 'value' to 102
+ * fill(value);
+ * rect(50, 15, 35, 70);
+ *
+ *
+ *
+ * @alt
+ * Left half of canvas light blue and right half light charcoal grey.
+ * Left half of canvas light purple and right half a royal blue.
+ * Left half of canvas salmon pink and the right half white.
+ * Yellow rect in middle right of canvas, with 55 pixel width and height.
+ * Yellow ellipse in top left canvas, black ellipse in bottom right,both 80x80.
+ * Bright fuschia rect in middle of canvas, 60 pixel width and height.
+ * Two bright green rects on opposite sides of the canvas, both 45x80.
+ * Four blue rects in each corner of the canvas, each are 35x35.
+ * Bright sea green rect on left and darker rect on right of canvas, both 45x80.
+ * Dark green rect on left and light green rect on right of canvas, both 45x80.
+ * Dark blue rect on left and light teal rect on right of canvas, both 45x80.
+ * blue rect on left and green on right, both with black outlines & 35x60.
+ * salmon pink rect on left and black on right, both 35x60.
+ * 4 rects, tan, brown, brownish purple and purple, with white outlines & 20x60.
+ * light pastel green rect on left and dark grey rect on right, both 35x60.
+ * yellow rect on left and red rect on right, both with black outlines & 35x60.
+ * grey canvas
+ * deep pink rect on left and grey rect on right, both 35x60.
+ */
+p5.prototype.alpha = function(c) {
+ p5._validateParameters('alpha', arguments);
+ return this.color(c)._getAlpha();
+};
-// Parse a `CFF` DICT operand.
-function parseOperand(parser, b0) {
- var b1;
- var b2;
- var b3;
- var b4;
- if (b0 === 28) {
- b1 = parser.parseByte();
- b2 = parser.parseByte();
- return b1 << 8 | b2;
- }
+/**
+ * Extracts the blue value from a color or pixel array.
+ *
+ * @method blue
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the blue value
+ * @example
+ *
+ *
+ * var c = color(175, 100, 220); // Define color 'c'
+ * fill(c); // Use color variable 'c' as fill color
+ * rect(15, 20, 35, 60); // Draw left rectangle
+ *
+ * var blueValue = blue(c); // Get blue in 'c'
+ * print(blueValue); // Prints "220.0"
+ * fill(0, 0, blueValue); // Use 'blueValue' in new fill
+ * rect(50, 20, 35, 60); // Draw right rectangle
+ *
+ *
+ *
+ * @alt
+ * Left half of canvas light purple and right half a royal blue.
+ *
+ */
+p5.prototype.blue = function(c) {
+ p5._validateParameters('blue', arguments);
+ return this.color(c)._getBlue();
+};
- if (b0 === 29) {
- b1 = parser.parseByte();
- b2 = parser.parseByte();
- b3 = parser.parseByte();
- b4 = parser.parseByte();
- return b1 << 24 | b2 << 16 | b3 << 8 | b4;
- }
+/**
+ * Extracts the HSB brightness value from a color or pixel array.
+ *
+ * @method brightness
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the brightness value
+ * @example
+ *
+ *
+ * noStroke();
+ * colorMode(HSB, 255);
+ * var c = color(0, 126, 255);
+ * fill(c);
+ * rect(15, 20, 35, 60);
+ * var value = brightness(c); // Sets 'value' to 255
+ * fill(value);
+ * rect(50, 20, 35, 60);
+ *
+ *
+ *
+ * @alt
+ * Left half of canvas salmon pink and the right half white.
+ *
+ */
+p5.prototype.brightness = function(c) {
+ p5._validateParameters('brightness', arguments);
+ return this.color(c)._getBrightness();
+};
- if (b0 === 30) {
- return parseFloatOperand(parser);
- }
+/**
+ * Creates colors for storing in variables of the color datatype. The
+ * parameters are interpreted as RGB or HSB values depending on the
+ * current colorMode(). The default mode is RGB values from 0 to 255
+ * and, therefore, the function call color(255, 204, 0) will return a
+ * bright yellow color.
+ *
+ * Note that if only one value is provided to color(), it will be interpreted
+ * as a grayscale value. Add a second value, and it will be used for alpha
+ * transparency. When three values are specified, they are interpreted as
+ * either RGB or HSB values. Adding a fourth value applies alpha
+ * transparency.
+ *
+ * If a single string argument is provided, RGB, RGBA and Hex CSS color
+ * strings and all named color strings are supported. In this case, an alpha
+ * number value as a second argument is not supported, the RGBA form should be
+ * used.
+ *
+ * @method color
+ * @param {Number} gray number specifying value between white
+ * and black.
+ * @param {Number} [alpha] alpha value relative to current color range
+ * (default is 0-255)
+ * @return {p5.Color} resulting color
+ *
+ * @example
+ *
+ *
+ * var c = color(255, 204, 0); // Define color 'c'
+ * fill(c); // Use color variable 'c' as fill color
+ * noStroke(); // Don't draw a stroke around shapes
+ * rect(30, 20, 55, 55); // Draw rectangle
+ *
+ *
+ *
+ *
+ *
+ * var c = color(255, 204, 0); // Define color 'c'
+ * fill(c); // Use color variable 'c' as fill color
+ * noStroke(); // Don't draw a stroke around shapes
+ * ellipse(25, 25, 80, 80); // Draw left circle
+ *
+ * // Using only one value with color()
+ * // generates a grayscale value.
+ * c = color(65); // Update 'c' with grayscale value
+ * fill(c); // Use updated 'c' as fill color
+ * ellipse(75, 75, 80, 80); // Draw right circle
+ *
+ *
+ *
+ *
+ *
+ * // Named SVG & CSS colors may be used,
+ * var c = color('magenta');
+ * fill(c); // Use 'c' as fill color
+ * noStroke(); // Don't draw a stroke around shapes
+ * rect(20, 20, 60, 60); // Draw rectangle
+ *
+ *
+ *
+ *
+ *
+ * // as can hex color codes:
+ * noStroke(); // Don't draw a stroke around shapes
+ * var c = color('#0f0');
+ * fill(c); // Use 'c' as fill color
+ * rect(0, 10, 45, 80); // Draw rectangle
+ *
+ * c = color('#00ff00');
+ * fill(c); // Use updated 'c' as fill color
+ * rect(55, 10, 45, 80); // Draw rectangle
+ *
+ *
+ *
+ *
+ *
+ * // RGB and RGBA color strings are also supported:
+ * // these all set to the same color (solid blue)
+ * var c;
+ * noStroke(); // Don't draw a stroke around shapes
+ * c = color('rgb(0,0,255)');
+ * fill(c); // Use 'c' as fill color
+ * rect(10, 10, 35, 35); // Draw rectangle
+ *
+ * c = color('rgb(0%, 0%, 100%)');
+ * fill(c); // Use updated 'c' as fill color
+ * rect(55, 10, 35, 35); // Draw rectangle
+ *
+ * c = color('rgba(0, 0, 255, 1)');
+ * fill(c); // Use updated 'c' as fill color
+ * rect(10, 55, 35, 35); // Draw rectangle
+ *
+ * c = color('rgba(0%, 0%, 100%, 1)');
+ * fill(c); // Use updated 'c' as fill color
+ * rect(55, 55, 35, 35); // Draw rectangle
+ *
+ *
+ *
+ *
+ *
+ * // HSL color is also supported and can be specified
+ * // by value
+ * var c;
+ * noStroke(); // Don't draw a stroke around shapes
+ * c = color('hsl(160, 100%, 50%)');
+ * fill(c); // Use 'c' as fill color
+ * rect(0, 10, 45, 80); // Draw rectangle
+ *
+ * c = color('hsla(160, 100%, 50%, 0.5)');
+ * fill(c); // Use updated 'c' as fill color
+ * rect(55, 10, 45, 80); // Draw rectangle
+ *
+ *
+ *
+ *
+ *
+ * // HSB color is also supported and can be specified
+ * // by value
+ * var c;
+ * noStroke(); // Don't draw a stroke around shapes
+ * c = color('hsb(160, 100%, 50%)');
+ * fill(c); // Use 'c' as fill color
+ * rect(0, 10, 45, 80); // Draw rectangle
+ *
+ * c = color('hsba(160, 100%, 50%, 0.5)');
+ * fill(c); // Use updated 'c' as fill color
+ * rect(55, 10, 45, 80); // Draw rectangle
+ *
+ *
+ *
+ *
+ *
+ * var c; // Declare color 'c'
+ * noStroke(); // Don't draw a stroke around shapes
+ *
+ * // If no colorMode is specified, then the
+ * // default of RGB with scale of 0-255 is used.
+ * c = color(50, 55, 100); // Create a color for 'c'
+ * fill(c); // Use color variable 'c' as fill color
+ * rect(0, 10, 45, 80); // Draw left rect
+ *
+ * colorMode(HSB, 100); // Use HSB with scale of 0-100
+ * c = color(50, 55, 100); // Update 'c' with new color
+ * fill(c); // Use updated 'c' as fill color
+ * rect(55, 10, 45, 80); // Draw right rect
+ *
+ *
+ *
+ * @alt
+ * Yellow rect in middle right of canvas, with 55 pixel width and height.
+ * Yellow ellipse in top left of canvas, black ellipse in bottom right,both 80x80.
+ * Bright fuschia rect in middle of canvas, 60 pixel width and height.
+ * Two bright green rects on opposite sides of the canvas, both 45x80.
+ * Four blue rects in each corner of the canvas, each are 35x35.
+ * Bright sea green rect on left and darker rect on right of canvas, both 45x80.
+ * Dark green rect on left and lighter green rect on right of canvas, both 45x80.
+ * Dark blue rect on left and light teal rect on right of canvas, both 45x80.
+ *
+ */
+/**
+ * @method color
+ * @param {Number} v1 red or hue value relative to
+ * the current color range
+ * @param {Number} v2 green or saturation value
+ * relative to the current color range
+ * @param {Number} v3 blue or brightness value
+ * relative to the current color range
+ * @param {Number} [alpha]
+ * @return {p5.Color}
+ */
- if (b0 >= 32 && b0 <= 246) {
- return b0 - 139;
- }
+/**
+ * @method color
+ * @param {String} value a color string
+ * @return {p5.Color}
+ */
+/**
+ * @method color
+ * @param {Number[]} values an array containing the red,green,blue &
+ * and alpha components of the color
+ * @return {p5.Color}
+ */
+/**
+ * @method color
+ * @param {p5.Color} color
+ * @return {p5.Color}
+ */
- if (b0 >= 247 && b0 <= 250) {
- b1 = parser.parseByte();
- return (b0 - 247) * 256 + b1 + 108;
- }
+p5.prototype.color = function() {
+ p5._validateParameters('color', arguments);
+ if (arguments[0] instanceof p5.Color) {
+ return arguments[0]; // Do nothing if argument is already a color object.
+ }
- if (b0 >= 251 && b0 <= 254) {
- b1 = parser.parseByte();
- return -(b0 - 251) * 256 - b1 - 108;
- }
+ var args = arguments[0] instanceof Array ? arguments[0] : arguments;
+ return new p5.Color(this, args);
+};
- throw new Error('Invalid b0 ' + b0);
-}
+/**
+ * Extracts the green value from a color or pixel array.
+ *
+ * @method green
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the green value
+ * @example
+ *
+ *
+ * var c = color(20, 75, 200); // Define color 'c'
+ * fill(c); // Use color variable 'c' as fill color
+ * rect(15, 20, 35, 60); // Draw left rectangle
+ *
+ * var greenValue = green(c); // Get green in 'c'
+ * print(greenValue); // Print "75.0"
+ * fill(0, greenValue, 0); // Use 'greenValue' in new fill
+ * rect(50, 20, 35, 60); // Draw right rectangle
+ *
+ *
+ *
+ * @alt
+ * blue rect on left and green on right, both with black outlines & 35x60.
+ *
+ */
-// Convert the entries returned by `parseDict` to a proper dictionary.
-// If a value is a list of one, it is unpacked.
-function entriesToObject(entries) {
- var o = {};
- for (var i = 0; i < entries.length; i += 1) {
- var key = entries[i][0];
- var values = entries[i][1];
- var value;
- if (values.length === 1) {
- value = values[0];
- } else {
- value = values;
- }
+p5.prototype.green = function(c) {
+ p5._validateParameters('green', arguments);
+ return this.color(c)._getGreen();
+};
- if (o.hasOwnProperty(key)) {
- throw new Error('Object ' + o + ' already has key ' + key);
- }
+/**
+ * Extracts the hue value from a color or pixel array.
+ *
+ * Hue exists in both HSB and HSL. This function will return the
+ * HSB-normalized hue when supplied with an HSB color object (or when supplied
+ * with a pixel array while the color mode is HSB), but will default to the
+ * HSL-normalized hue otherwise. (The values will only be different if the
+ * maximum hue setting for each system is different.)
+ *
+ * @method hue
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the hue
+ * @example
+ *
+ *
+ * noStroke();
+ * colorMode(HSB, 255);
+ * var c = color(0, 126, 255);
+ * fill(c);
+ * rect(15, 20, 35, 60);
+ * var value = hue(c); // Sets 'value' to "0"
+ * fill(value);
+ * rect(50, 20, 35, 60);
+ *
+ *
+ *
+ * @alt
+ * salmon pink rect on left and black on right, both 35x60.
+ *
+ */
- o[key] = value;
- }
+p5.prototype.hue = function(c) {
+ p5._validateParameters('hue', arguments);
+ return this.color(c)._getHue();
+};
- return o;
-}
+/**
+ * Blends two colors to find a third color somewhere between them. The amt
+ * parameter is the amount to interpolate between the two values where 0.0
+ * equal to the first color, 0.1 is very near the first color, 0.5 is halfway
+ * in between, etc. An amount below 0 will be treated as 0. Likewise, amounts
+ * above 1 will be capped at 1. This is different from the behavior of lerp(),
+ * but necessary because otherwise numbers outside the range will produce
+ * strange and unexpected colors.
+ *
+ * The way that colours are interpolated depends on the current color mode.
+ *
+ * @method lerpColor
+ * @param {p5.Color} c1 interpolate from this color
+ * @param {p5.Color} c2 interpolate to this color
+ * @param {Number} amt number between 0 and 1
+ * @return {p5.Color} interpolated color
+ * @example
+ *
+ *
+ * colorMode(RGB);
+ * stroke(255);
+ * background(51);
+ * var from = color(218, 165, 32);
+ * var to = color(72, 61, 139);
+ * colorMode(RGB); // Try changing to HSB.
+ * var interA = lerpColor(from, to, 0.33);
+ * var interB = lerpColor(from, to, 0.66);
+ * fill(from);
+ * rect(10, 20, 20, 60);
+ * fill(interA);
+ * rect(30, 20, 20, 60);
+ * fill(interB);
+ * rect(50, 20, 20, 60);
+ * fill(to);
+ * rect(70, 20, 20, 60);
+ *
+ *
+ *
+ * @alt
+ * 4 rects one tan, brown, brownish purple, purple, with white outlines & 20x60
+ *
+ */
-// Parse a `CFF` DICT object.
-// A dictionary contains key-value pairs in a compact tokenized format.
-function parseCFFDict(data, start, size) {
- start = start !== undefined ? start : 0;
- var parser = new parse.Parser(data, start);
- var entries = [];
- var operands = [];
- size = size !== undefined ? size : data.length;
-
- while (parser.relativeOffset < size) {
- var op = parser.parseByte();
-
- // The first byte for each dict item distinguishes between operator (key) and operand (value).
- // Values <= 21 are operators.
- if (op <= 21) {
- // Two-byte operators have an initial escape byte of 12.
- if (op === 12) {
- op = 1200 + parser.parseByte();
- }
+p5.prototype.lerpColor = function(c1, c2, amt) {
+ p5._validateParameters('lerpColor', arguments);
+ var mode = this._colorMode;
+ var maxes = this._colorMaxes;
+ var l0, l1, l2, l3;
+ var fromArray, toArray;
- entries.push([op, operands]);
- operands = [];
- } else {
- // Since the operands (values) come before the operators (keys), we store all operands in a list
- // until we encounter an operator.
- operands.push(parseOperand(parser, op));
- }
- }
+ if (mode === constants.RGB) {
+ fromArray = c1.levels.map(function(level) {
+ return level / 255;
+ });
+ toArray = c2.levels.map(function(level) {
+ return level / 255;
+ });
+ } else if (mode === constants.HSB) {
+ c1._getBrightness(); // Cache hsba so it definitely exists.
+ c2._getBrightness();
+ fromArray = c1.hsba;
+ toArray = c2.hsba;
+ } else if (mode === constants.HSL) {
+ c1._getLightness(); // Cache hsla so it definitely exists.
+ c2._getLightness();
+ fromArray = c1.hsla;
+ toArray = c2.hsla;
+ } else {
+ throw new Error(mode + 'cannot be used for interpolation.');
+ }
- return entriesToObject(entries);
-}
+ // Prevent extrapolation.
+ amt = Math.max(Math.min(amt, 1), 0);
-// Given a String Index (SID), return the value of the string.
-// Strings below index 392 are standard CFF strings and are not encoded in the font.
-function getCFFString(strings, index) {
- if (index <= 390) {
- index = encoding.cffStandardStrings[index];
- } else {
- index = strings[index - 391];
- }
+ // Define lerp here itself if user isn't using math module.
+ // Maintains the definition as found in math/calculation.js
+ if (typeof this.lerp === 'undefined') {
+ this.lerp = function(start, stop, amt) {
+ return amt * (stop - start) + start;
+ };
+ }
- return index;
-}
+ // Perform interpolation.
+ l0 = this.lerp(fromArray[0], toArray[0], amt);
+ l1 = this.lerp(fromArray[1], toArray[1], amt);
+ l2 = this.lerp(fromArray[2], toArray[2], amt);
+ l3 = this.lerp(fromArray[3], toArray[3], amt);
-// Interpret a dictionary and return a new dictionary with readable keys and values for missing entries.
-// This function takes `meta` which is a list of objects containing `operand`, `name` and `default`.
-function interpretDict(dict, meta, strings) {
- var newDict = {};
- var value;
-
- // Because we also want to include missing values, we start out from the meta list
- // and lookup values in the dict.
- for (var i = 0; i < meta.length; i += 1) {
- var m = meta[i];
-
- if (Array.isArray(m.type)) {
- var values = [];
- values.length = m.type.length;
- for (var j = 0; j < m.type.length; j++) {
- value = dict[m.op] !== undefined ? dict[m.op][j] : undefined;
- if (value === undefined) {
- value = m.value !== undefined && m.value[j] !== undefined ? m.value[j] : null;
- }
- if (m.type[j] === 'SID') {
- value = getCFFString(strings, value);
- }
- values[j] = value;
- }
- newDict[m.name] = values;
- } else {
- value = dict[m.op];
- if (value === undefined) {
- value = m.value !== undefined ? m.value : null;
- }
-
- if (m.type === 'SID') {
- value = getCFFString(strings, value);
- }
- newDict[m.name] = value;
- }
- }
-
- return newDict;
-}
+ // Scale components.
+ l0 *= maxes[mode][0];
+ l1 *= maxes[mode][1];
+ l2 *= maxes[mode][2];
+ l3 *= maxes[mode][3];
-// Parse the CFF header.
-function parseCFFHeader(data, start) {
- var header = {};
- header.formatMajor = parse.getCard8(data, start);
- header.formatMinor = parse.getCard8(data, start + 1);
- header.size = parse.getCard8(data, start + 2);
- header.offsetSize = parse.getCard8(data, start + 3);
- header.startOffset = start;
- header.endOffset = start + 4;
- return header;
-}
+ return this.color(l0, l1, l2, l3);
+};
-var TOP_DICT_META = [
- {name: 'version', op: 0, type: 'SID'},
- {name: 'notice', op: 1, type: 'SID'},
- {name: 'copyright', op: 1200, type: 'SID'},
- {name: 'fullName', op: 2, type: 'SID'},
- {name: 'familyName', op: 3, type: 'SID'},
- {name: 'weight', op: 4, type: 'SID'},
- {name: 'isFixedPitch', op: 1201, type: 'number', value: 0},
- {name: 'italicAngle', op: 1202, type: 'number', value: 0},
- {name: 'underlinePosition', op: 1203, type: 'number', value: -100},
- {name: 'underlineThickness', op: 1204, type: 'number', value: 50},
- {name: 'paintType', op: 1205, type: 'number', value: 0},
- {name: 'charstringType', op: 1206, type: 'number', value: 2},
- {name: 'fontMatrix', op: 1207, type: ['real', 'real', 'real', 'real', 'real', 'real'], value: [0.001, 0, 0, 0.001, 0, 0]},
- {name: 'uniqueId', op: 13, type: 'number'},
- {name: 'fontBBox', op: 5, type: ['number', 'number', 'number', 'number'], value: [0, 0, 0, 0]},
- {name: 'strokeWidth', op: 1208, type: 'number', value: 0},
- {name: 'xuid', op: 14, type: [], value: null},
- {name: 'charset', op: 15, type: 'offset', value: 0},
- {name: 'encoding', op: 16, type: 'offset', value: 0},
- {name: 'charStrings', op: 17, type: 'offset', value: 0},
- {name: 'private', op: 18, type: ['number', 'offset'], value: [0, 0]},
- {name: 'ros', op: 1230, type: ['SID', 'SID', 'number']},
- {name: 'cidFontVersion', op: 1231, type: 'number', value: 0},
- {name: 'cidFontRevision', op: 1232, type: 'number', value: 0},
- {name: 'cidFontType', op: 1233, type: 'number', value: 0},
- {name: 'cidCount', op: 1234, type: 'number', value: 8720},
- {name: 'uidBase', op: 1235, type: 'number'},
- {name: 'fdArray', op: 1236, type: 'offset'},
- {name: 'fdSelect', op: 1237, type: 'offset'},
- {name: 'fontName', op: 1238, type: 'SID'}
-];
-
-var PRIVATE_DICT_META = [
- {name: 'subrs', op: 19, type: 'offset', value: 0},
- {name: 'defaultWidthX', op: 20, type: 'number', value: 0},
- {name: 'nominalWidthX', op: 21, type: 'number', value: 0}
-];
-
-// Parse the CFF top dictionary. A CFF table can contain multiple fonts, each with their own top dictionary.
-// The top dictionary contains the essential metadata for the font, together with the private dictionary.
-function parseCFFTopDict(data, strings) {
- var dict = parseCFFDict(data, 0, data.byteLength);
- return interpretDict(dict, TOP_DICT_META, strings);
-}
+/**
+ * Extracts the HSL lightness value from a color or pixel array.
+ *
+ * @method lightness
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the lightness
+ * @example
+ *
+ *
+ * noStroke();
+ * colorMode(HSL);
+ * var c = color(156, 100, 50, 1);
+ * fill(c);
+ * rect(15, 20, 35, 60);
+ * var value = lightness(c); // Sets 'value' to 50
+ * fill(value);
+ * rect(50, 20, 35, 60);
+ *
+ *
+ *
+ * @alt
+ * light pastel green rect on left and dark grey rect on right, both 35x60.
+ *
+ */
+p5.prototype.lightness = function(c) {
+ p5._validateParameters('lightness', arguments);
+ return this.color(c)._getLightness();
+};
-// Parse the CFF private dictionary. We don't fully parse out all the values, only the ones we need.
-function parseCFFPrivateDict(data, start, size, strings) {
- var dict = parseCFFDict(data, start, size);
- return interpretDict(dict, PRIVATE_DICT_META, strings);
-}
+/**
+ * Extracts the red value from a color or pixel array.
+ *
+ * @method red
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the red value
+ * @example
+ *
+ *
+ * var c = color(255, 204, 0); // Define color 'c'
+ * fill(c); // Use color variable 'c' as fill color
+ * rect(15, 20, 35, 60); // Draw left rectangle
+ *
+ * var redValue = red(c); // Get red in 'c'
+ * print(redValue); // Print "255.0"
+ * fill(redValue, 0, 0); // Use 'redValue' in new fill
+ * rect(50, 20, 35, 60); // Draw right rectangle
+ *
+ *
+ *
+ *
+ *
+ * colorMode(RGB, 255);
+ * var c = color(127, 255, 0);
+ * colorMode(RGB, 1);
+ * var myColor = red(c);
+ * print(myColor);
+ *
+ *
+ *
+ * @alt
+ * yellow rect on left and red rect on right, both with black outlines and 35x60.
+ * grey canvas
+ */
+p5.prototype.red = function(c) {
+ p5._validateParameters('red', arguments);
+ return this.color(c)._getRed();
+};
-// Returns a list of "Top DICT"s found using an INDEX list.
-// Used to read both the usual high-level Top DICTs and also the FDArray
-// discovered inside CID-keyed fonts. When a Top DICT has a reference to
-// a Private DICT that is read and saved into the Top DICT.
-//
-// In addition to the expected/optional values as outlined in TOP_DICT_META
-// the following values might be saved into the Top DICT.
-//
-// _subrs [] array of local CFF subroutines from Private DICT
-// _subrsBias bias value computed from number of subroutines
-// (see calcCFFSubroutineBias() and parseCFFCharstring())
-// _defaultWidthX default widths for CFF characters
-// _nominalWidthX bias added to width embedded within glyph description
-//
-// _privateDict saved copy of parsed Private DICT from Top DICT
-function gatherCFFTopDicts(data, start, cffIndex, strings) {
- var topDictArray = [];
- for (var iTopDict = 0; iTopDict < cffIndex.length; iTopDict += 1) {
- var topDictData = new DataView(new Uint8Array(cffIndex[iTopDict]).buffer);
- var topDict = parseCFFTopDict(topDictData, strings);
- topDict._subrs = [];
- topDict._subrsBias = 0;
- var privateSize = topDict.private[0];
- var privateOffset = topDict.private[1];
- if (privateSize !== 0 && privateOffset !== 0) {
- var privateDict = parseCFFPrivateDict(data, privateOffset + start, privateSize, strings);
- topDict._defaultWidthX = privateDict.defaultWidthX;
- topDict._nominalWidthX = privateDict.nominalWidthX;
- if (privateDict.subrs !== 0) {
- var subrOffset = privateOffset + privateDict.subrs;
- var subrIndex = parseCFFIndex(data, subrOffset + start);
- topDict._subrs = subrIndex.objects;
- topDict._subrsBias = calcCFFSubroutineBias(topDict._subrs);
- }
- topDict._privateDict = privateDict;
- }
- topDictArray.push(topDict);
- }
- return topDictArray;
-}
+/**
+ * Extracts the saturation value from a color or pixel array.
+ *
+ * Saturation is scaled differently in HSB and HSL. This function will return
+ * the HSB saturation when supplied with an HSB color object (or when supplied
+ * with a pixel array while the color mode is HSB), but will default to the
+ * HSL saturation otherwise.
+ *
+ * @method saturation
+ * @param {p5.Color|Number[]|String} color p5.Color object, color components,
+ * or CSS color
+ * @return {Number} the saturation value
+ * @example
+ *
+ *
+ * noStroke();
+ * colorMode(HSB, 255);
+ * var c = color(0, 126, 255);
+ * fill(c);
+ * rect(15, 20, 35, 60);
+ * var value = saturation(c); // Sets 'value' to 126
+ * fill(value);
+ * rect(50, 20, 35, 60);
+ *
+ *
+ *
+ * @alt
+ *deep pink rect on left and grey rect on right, both 35x60.
+ *
+ */
-// Parse the CFF charset table, which contains internal names for all the glyphs.
-// This function will return a list of glyph names.
-// See Adobe TN #5176 chapter 13, "Charsets".
-function parseCFFCharset(data, start, nGlyphs, strings) {
- var i;
- var sid;
- var count;
- var parser = new parse.Parser(data, start);
-
- // The .notdef glyph is not included, so subtract 1.
- nGlyphs -= 1;
- var charset = ['.notdef'];
-
- var format = parser.parseCard8();
- if (format === 0) {
- for (i = 0; i < nGlyphs; i += 1) {
- sid = parser.parseSID();
- charset.push(getCFFString(strings, sid));
- }
- } else if (format === 1) {
- while (charset.length <= nGlyphs) {
- sid = parser.parseSID();
- count = parser.parseCard8();
- for (i = 0; i <= count; i += 1) {
- charset.push(getCFFString(strings, sid));
- sid += 1;
- }
- }
- } else if (format === 2) {
- while (charset.length <= nGlyphs) {
- sid = parser.parseSID();
- count = parser.parseCard16();
- for (i = 0; i <= count; i += 1) {
- charset.push(getCFFString(strings, sid));
- sid += 1;
- }
- }
- } else {
- throw new Error('Unknown charset format ' + format);
- }
+p5.prototype.saturation = function(c) {
+ p5._validateParameters('saturation', arguments);
+ return this.color(c)._getSaturation();
+};
- return charset;
-}
+module.exports = p5;
-// Parse the CFF encoding data. Only one encoding can be specified per font.
-// See Adobe TN #5176 chapter 12, "Encodings".
-function parseCFFEncoding(data, start, charset) {
- var i;
- var code;
- var enc = {};
- var parser = new parse.Parser(data, start);
- var format = parser.parseCard8();
- if (format === 0) {
- var nCodes = parser.parseCard8();
- for (i = 0; i < nCodes; i += 1) {
- code = parser.parseCard8();
- enc[code] = i;
- }
- } else if (format === 1) {
- var nRanges = parser.parseCard8();
- code = 1;
- for (i = 0; i < nRanges; i += 1) {
- var first = parser.parseCard8();
- var nLeft = parser.parseCard8();
- for (var j = first; j <= first + nLeft; j += 1) {
- enc[j] = code;
- code += 1;
- }
- }
- } else {
- throw new Error('Unknown encoding format ' + format);
- }
+},{"../core/constants":19,"../core/error_helpers":21,"../core/main":25,"./p5.Color":17}],17:[function(_dereq_,module,exports){
+/**
+ * @module Color
+ * @submodule Creating & Reading
+ * @for p5
+ * @requires core
+ * @requires constants
+ * @requires color_conversion
+ */
- return new encoding.CffEncoding(enc, charset);
-}
+'use strict';
-// Take in charstring code and return a Glyph object.
-// The encoding is described in the Type 2 Charstring Format
-// https://www.microsoft.com/typography/OTSPEC/charstr2.htm
-function parseCFFCharstring(font, glyph, code) {
- var c1x;
- var c1y;
- var c2x;
- var c2y;
- var p = new path.Path();
- var stack = [];
- var nStems = 0;
- var haveWidth = false;
- var open = false;
- var x = 0;
- var y = 0;
- var subrs;
- var subrsBias;
- var defaultWidthX;
- var nominalWidthX;
- if (font.isCIDFont) {
- var fdIndex = font.tables.cff.topDict._fdSelect[glyph.index];
- var fdDict = font.tables.cff.topDict._fdArray[fdIndex];
- subrs = fdDict._subrs;
- subrsBias = fdDict._subrsBias;
- defaultWidthX = fdDict._defaultWidthX;
- nominalWidthX = fdDict._nominalWidthX;
- } else {
- subrs = font.tables.cff.topDict._subrs;
- subrsBias = font.tables.cff.topDict._subrsBias;
- defaultWidthX = font.tables.cff.topDict._defaultWidthX;
- nominalWidthX = font.tables.cff.topDict._nominalWidthX;
- }
- var width = defaultWidthX;
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
+var color_conversion = _dereq_('./color_conversion');
- function newContour(x, y) {
- if (open) {
- p.closePath();
- }
+/**
+ * Each color stores the color mode and level maxes that applied at the
+ * time of its construction. These are used to interpret the input arguments
+ * (at construction and later for that instance of color) and to format the
+ * output e.g. when saturation() is requested.
+ *
+ * Internally we store an array representing the ideal RGBA values in floating
+ * point form, normalized from 0 to 1. From this we calculate the closest
+ * screen color (RGBA levels from 0 to 255) and expose this to the renderer.
+ *
+ * We also cache normalized, floating point components of the color in various
+ * representations as they are calculated. This is done to prevent repeating a
+ * conversion that has already been performed.
+ *
+ * @class p5.Color
+ */
+p5.Color = function(pInst, vals) {
+ // Record color mode and maxes at time of construction.
+ this._storeModeAndMaxes(pInst._colorMode, pInst._colorMaxes);
- p.moveTo(x, y);
- open = true;
- }
+ // Calculate normalized RGBA values.
+ if (
+ this.mode !== constants.RGB &&
+ this.mode !== constants.HSL &&
+ this.mode !== constants.HSB
+ ) {
+ throw new Error(this.mode + ' is an invalid colorMode.');
+ } else {
+ this._array = p5.Color._parseInputs.apply(this, vals);
+ }
- function parseStems() {
- var hasWidthArg;
+ // Expose closest screen color.
+ this._calculateLevels();
+ return this;
+};
- // The number of stem operators on the stack is always even.
- // If the value is uneven, that means a width is specified.
- hasWidthArg = stack.length % 2 !== 0;
- if (hasWidthArg && !haveWidth) {
- width = stack.shift() + nominalWidthX;
- }
+/**
+ * This function returns the color formatted as a string. This can be useful
+ * for debugging, or for using p5.js with other libraries.
+ * @method toString
+ * @param {String} [format] How the color string will be formatted.
+ * Leaving this empty formats the string as rgba(r, g, b, a).
+ * '#rgb' '#rgba' '#rrggbb' and '#rrggbbaa' format as hexadecimal color codes.
+ * 'rgb' 'hsb' and 'hsl' return the color formatted in the specified color mode.
+ * 'rgba' 'hsba' and 'hsla' are the same as above but with alpha channels.
+ * 'rgb%' 'hsb%' 'hsl%' 'rgba%' 'hsba%' and 'hsla%' format as percentages.
+ * @return {String} the formatted string
+ * @example
+ *
+ *
+ * var myColor;
+ * function setup() {
+ * createCanvas(200, 200);
+ * stroke(255);
+ * myColor = color(100, 100, 250);
+ * fill(myColor);
+ * }
+ *
+ * function draw() {
+ * rotate(HALF_PI);
+ * text(myColor.toString(), 0, -5);
+ * text(myColor.toString('#rrggbb'), 0, -30);
+ * text(myColor.toString('rgba%'), 0, -55);
+ * }
+ *
+ *
+ *
+ * @alt
+ * canvas with text representation of color
+ */
+p5.Color.prototype.toString = function(format) {
+ if (!this.hsba) this.hsba = color_conversion._rgbaToHSBA(this._array);
+ if (!this.hsla) this.hsla = color_conversion._rgbaToHSLA(this._array);
- nStems += stack.length >> 1;
- stack.length = 0;
- haveWidth = true;
- }
+ var a = this.levels;
+ var f = this._array;
+ var alpha = f[3]; // String representation uses normalized alpha
+
+ switch (format) {
+ case '#rrggbb':
+ return '#'.concat(
+ a[0] < 16 ? '0'.concat(a[0].toString(16)) : a[0].toString(16),
+ a[1] < 16 ? '0'.concat(a[1].toString(16)) : a[1].toString(16),
+ a[2] < 16 ? '0'.concat(a[2].toString(16)) : a[2].toString(16)
+ );
+
+ case '#rrggbbaa':
+ return '#'.concat(
+ a[0] < 16 ? '0'.concat(a[0].toString(16)) : a[0].toString(16),
+ a[1] < 16 ? '0'.concat(a[1].toString(16)) : a[1].toString(16),
+ a[2] < 16 ? '0'.concat(a[2].toString(16)) : a[2].toString(16),
+ a[3] < 16 ? '0'.concat(a[2].toString(16)) : a[3].toString(16)
+ );
+
+ case '#rgb':
+ return '#'.concat(
+ Math.round(f[0] * 15).toString(16),
+ Math.round(f[1] * 15).toString(16),
+ Math.round(f[2] * 15).toString(16)
+ );
+
+ case '#rgba':
+ return '#'.concat(
+ Math.round(f[0] * 15).toString(16),
+ Math.round(f[1] * 15).toString(16),
+ Math.round(f[2] * 15).toString(16),
+ Math.round(f[3] * 15).toString(16)
+ );
+
+ case 'rgb':
+ return 'rgb('.concat(a[0], ', ', a[1], ', ', a[2], ')');
+
+ case 'rgb%':
+ return 'rgb('.concat(
+ (100 * f[0]).toPrecision(3),
+ '%, ',
+ (100 * f[1]).toPrecision(3),
+ '%, ',
+ (100 * f[2]).toPrecision(3),
+ '%)'
+ );
+
+ case 'rgba%':
+ return 'rgba('.concat(
+ (100 * f[0]).toPrecision(3),
+ '%, ',
+ (100 * f[1]).toPrecision(3),
+ '%, ',
+ (100 * f[2]).toPrecision(3),
+ '%, ',
+ (100 * f[3]).toPrecision(3),
+ '%)'
+ );
+
+ case 'hsb':
+ case 'hsv':
+ return 'hsb('.concat(
+ this.hsba[0] * this.maxes[constants.HSB][0],
+ ', ',
+ this.hsba[1] * this.maxes[constants.HSB][1],
+ ', ',
+ this.hsba[2] * this.maxes[constants.HSB][2],
+ ')'
+ );
+
+ case 'hsb%':
+ case 'hsv%':
+ return 'hsb('.concat(
+ (100 * this.hsba[0]).toPrecision(3),
+ '%, ',
+ (100 * this.hsba[1]).toPrecision(3),
+ '%, ',
+ (100 * this.hsba[2]).toPrecision(3),
+ '%)'
+ );
+
+ case 'hsba':
+ case 'hsva':
+ return 'hsba('.concat(
+ this.hsba[0] * this.maxes[constants.HSB][0],
+ ', ',
+ this.hsba[1] * this.maxes[constants.HSB][1],
+ ', ',
+ this.hsba[2] * this.maxes[constants.HSB][2],
+ ', ',
+ alpha,
+ ')'
+ );
+
+ case 'hsba%':
+ case 'hsva%':
+ return 'hsba('.concat(
+ (100 * this.hsba[0]).toPrecision(3),
+ '%, ',
+ (100 * this.hsba[1]).toPrecision(3),
+ '%, ',
+ (100 * this.hsba[2]).toPrecision(3),
+ '%, ',
+ (100 * alpha).toPrecision(3),
+ '%)'
+ );
+
+ case 'hsl':
+ return 'hsl('.concat(
+ this.hsla[0] * this.maxes[constants.HSL][0],
+ ', ',
+ this.hsla[1] * this.maxes[constants.HSL][1],
+ ', ',
+ this.hsla[2] * this.maxes[constants.HSL][2],
+ ')'
+ );
+
+ case 'hsl%':
+ return 'hsl('.concat(
+ (100 * this.hsla[0]).toPrecision(3),
+ '%, ',
+ (100 * this.hsla[1]).toPrecision(3),
+ '%, ',
+ (100 * this.hsla[2]).toPrecision(3),
+ '%)'
+ );
+
+ case 'hsla':
+ return 'hsla('.concat(
+ this.hsla[0] * this.maxes[constants.HSL][0],
+ ', ',
+ this.hsla[1] * this.maxes[constants.HSL][1],
+ ', ',
+ this.hsla[2] * this.maxes[constants.HSL][2],
+ ', ',
+ alpha,
+ ')'
+ );
+
+ case 'hsla%':
+ return 'hsl('.concat(
+ (100 * this.hsla[0]).toPrecision(3),
+ '%, ',
+ (100 * this.hsla[1]).toPrecision(3),
+ '%, ',
+ (100 * this.hsla[2]).toPrecision(3),
+ '%, ',
+ (100 * alpha).toPrecision(3),
+ '%)'
+ );
+
+ case 'rgba':
+ default:
+ return 'rgba(' + a[0] + ',' + a[1] + ',' + a[2] + ',' + alpha + ')';
+ }
+};
- function parse(code) {
- var b1;
- var b2;
- var b3;
- var b4;
- var codeIndex;
- var subrCode;
- var jpx;
- var jpy;
- var c3x;
- var c3y;
- var c4x;
- var c4y;
-
- var i = 0;
- while (i < code.length) {
- var v = code[i];
- i += 1;
- switch (v) {
- case 1: // hstem
- parseStems();
- break;
- case 3: // vstem
- parseStems();
- break;
- case 4: // vmoveto
- if (stack.length > 1 && !haveWidth) {
- width = stack.shift() + nominalWidthX;
- haveWidth = true;
- }
+/**
+ * @method setRed
+ * @param {Number} red the new red value
+ * @example
+ *
+ *
+ * var backgroundColor;
+ *
+ * function setup() {
+ * backgroundColor = color(100, 50, 150);
+ * }
+ *
+ * function draw() {
+ * backgroundColor.setRed(128 + 128 * sin(millis() / 1000));
+ * background(backgroundColor);
+ * }
+ *
+ *
+ *
+ * @alt
+ * canvas with gradually changing background color
+ */
+p5.Color.prototype.setRed = function(new_red) {
+ this._array[0] = new_red / this.maxes[constants.RGB][0];
+ this._calculateLevels();
+};
- y += stack.pop();
- newContour(x, y);
- break;
- case 5: // rlineto
- while (stack.length > 0) {
- x += stack.shift();
- y += stack.shift();
- p.lineTo(x, y);
- }
+/**
+ * @method setGreen
+ * @param {Number} green the new green value
+ * @example
+ *
+ *
+ * var backgroundColor;
+ *
+ * function setup() {
+ * backgroundColor = color(100, 50, 150);
+ * }
+ *
+ * function draw() {
+ * backgroundColor.setGreen(128 + 128 * sin(millis() / 1000));
+ * background(backgroundColor);
+ * }
+ *
+ *
+ *
+ * @alt
+ * canvas with gradually changing background color
+ **/
+p5.Color.prototype.setGreen = function(new_green) {
+ this._array[1] = new_green / this.maxes[constants.RGB][1];
+ this._calculateLevels();
+};
- break;
- case 6: // hlineto
- while (stack.length > 0) {
- x += stack.shift();
- p.lineTo(x, y);
- if (stack.length === 0) {
- break;
- }
+/**
+ * @method setBlue
+ * @param {Number} blue the new blue value
+ * @example
+ *
+ *
+ * var backgroundColor;
+ *
+ * function setup() {
+ * backgroundColor = color(100, 50, 150);
+ * }
+ *
+ * function draw() {
+ * backgroundColor.setBlue(128 + 128 * sin(millis() / 1000));
+ * background(backgroundColor);
+ * }
+ *
+ *
+ *
+ * @alt
+ * canvas with gradually changing background color
+ **/
+p5.Color.prototype.setBlue = function(new_blue) {
+ this._array[2] = new_blue / this.maxes[constants.RGB][2];
+ this._calculateLevels();
+};
- y += stack.shift();
- p.lineTo(x, y);
- }
+/**
+ * @method setAlpha
+ * @param {Number} alpha the new alpha value
+ * @example
+ *
+ *
+ * var squareColor;
+ *
+ * function setup() {
+ * ellipseMode(CORNERS);
+ * strokeWeight(4);
+ * squareColor = color(100, 50, 150);
+ * }
+ *
+ * function draw() {
+ * background(255);
+ *
+ * noFill();
+ * stroke(0);
+ * ellipse(10, 10, width - 10, height - 10);
+ *
+ * squareColor.setAlpha(128 + 128 * sin(millis() / 1000));
+ * fill(squareColor);
+ * noStroke();
+ * rect(13, 13, width - 26, height - 26);
+ * }
+ *
+ *
+ *
+ * @alt
+ * circle behind a square with gradually changing opacity
+ **/
+p5.Color.prototype.setAlpha = function(new_alpha) {
+ this._array[3] = new_alpha / this.maxes[this.mode][3];
+ this._calculateLevels();
+};
- break;
- case 7: // vlineto
- while (stack.length > 0) {
- y += stack.shift();
- p.lineTo(x, y);
- if (stack.length === 0) {
- break;
- }
+// calculates and stores the closest screen levels
+p5.Color.prototype._calculateLevels = function() {
+ var array = this._array;
+ // (loop backwards for performance)
+ var levels = (this.levels = new Array(array.length));
+ for (var i = array.length - 1; i >= 0; --i) {
+ levels[i] = Math.round(array[i] * 255);
+ }
+};
- x += stack.shift();
- p.lineTo(x, y);
- }
+p5.Color.prototype._getAlpha = function() {
+ return this._array[3] * this.maxes[this.mode][3];
+};
- break;
- case 8: // rrcurveto
- while (stack.length > 0) {
- c1x = x + stack.shift();
- c1y = y + stack.shift();
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x + stack.shift();
- y = c2y + stack.shift();
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- }
+// stores the color mode and maxes in this instance of Color
+// for later use (by _parseInputs())
+p5.Color.prototype._storeModeAndMaxes = function(new_mode, new_maxes) {
+ this.mode = new_mode;
+ this.maxes = new_maxes;
+};
- break;
- case 10: // callsubr
- codeIndex = stack.pop() + subrsBias;
- subrCode = subrs[codeIndex];
- if (subrCode) {
- parse(subrCode);
- }
+p5.Color.prototype._getMode = function() {
+ return this.mode;
+};
- break;
- case 11: // return
- return;
- case 12: // flex operators
- v = code[i];
- i += 1;
- switch (v) {
- case 35: // flex
- // |- dx1 dy1 dx2 dy2 dx3 dy3 dx4 dy4 dx5 dy5 dx6 dy6 fd flex (12 35) |-
- c1x = x + stack.shift(); // dx1
- c1y = y + stack.shift(); // dy1
- c2x = c1x + stack.shift(); // dx2
- c2y = c1y + stack.shift(); // dy2
- jpx = c2x + stack.shift(); // dx3
- jpy = c2y + stack.shift(); // dy3
- c3x = jpx + stack.shift(); // dx4
- c3y = jpy + stack.shift(); // dy4
- c4x = c3x + stack.shift(); // dx5
- c4y = c3y + stack.shift(); // dy5
- x = c4x + stack.shift(); // dx6
- y = c4y + stack.shift(); // dy6
- stack.shift(); // flex depth
- p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
- p.curveTo(c3x, c3y, c4x, c4y, x, y);
- break;
- case 34: // hflex
- // |- dx1 dx2 dy2 dx3 dx4 dx5 dx6 hflex (12 34) |-
- c1x = x + stack.shift(); // dx1
- c1y = y; // dy1
- c2x = c1x + stack.shift(); // dx2
- c2y = c1y + stack.shift(); // dy2
- jpx = c2x + stack.shift(); // dx3
- jpy = c2y; // dy3
- c3x = jpx + stack.shift(); // dx4
- c3y = c2y; // dy4
- c4x = c3x + stack.shift(); // dx5
- c4y = y; // dy5
- x = c4x + stack.shift(); // dx6
- p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
- p.curveTo(c3x, c3y, c4x, c4y, x, y);
- break;
- case 36: // hflex1
- // |- dx1 dy1 dx2 dy2 dx3 dx4 dx5 dy5 dx6 hflex1 (12 36) |-
- c1x = x + stack.shift(); // dx1
- c1y = y + stack.shift(); // dy1
- c2x = c1x + stack.shift(); // dx2
- c2y = c1y + stack.shift(); // dy2
- jpx = c2x + stack.shift(); // dx3
- jpy = c2y; // dy3
- c3x = jpx + stack.shift(); // dx4
- c3y = c2y; // dy4
- c4x = c3x + stack.shift(); // dx5
- c4y = c3y + stack.shift(); // dy5
- x = c4x + stack.shift(); // dx6
- p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
- p.curveTo(c3x, c3y, c4x, c4y, x, y);
- break;
- case 37: // flex1
- // |- dx1 dy1 dx2 dy2 dx3 dy3 dx4 dy4 dx5 dy5 d6 flex1 (12 37) |-
- c1x = x + stack.shift(); // dx1
- c1y = y + stack.shift(); // dy1
- c2x = c1x + stack.shift(); // dx2
- c2y = c1y + stack.shift(); // dy2
- jpx = c2x + stack.shift(); // dx3
- jpy = c2y + stack.shift(); // dy3
- c3x = jpx + stack.shift(); // dx4
- c3y = jpy + stack.shift(); // dy4
- c4x = c3x + stack.shift(); // dx5
- c4y = c3y + stack.shift(); // dy5
- if (Math.abs(c4x - x) > Math.abs(c4y - y)) {
- x = c4x + stack.shift();
- } else {
- y = c4y + stack.shift();
- }
-
- p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy);
- p.curveTo(c3x, c3y, c4x, c4y, x, y);
- break;
- default:
- console.log('Glyph ' + glyph.index + ': unknown operator ' + 1200 + v);
- stack.length = 0;
- }
- break;
- case 14: // endchar
- if (stack.length > 0 && !haveWidth) {
- width = stack.shift() + nominalWidthX;
- haveWidth = true;
- }
+p5.Color.prototype._getMaxes = function() {
+ return this.maxes;
+};
- if (open) {
- p.closePath();
- open = false;
- }
+p5.Color.prototype._getBlue = function() {
+ return this._array[2] * this.maxes[constants.RGB][2];
+};
- break;
- case 18: // hstemhm
- parseStems();
- break;
- case 19: // hintmask
- case 20: // cntrmask
- parseStems();
- i += (nStems + 7) >> 3;
- break;
- case 21: // rmoveto
- if (stack.length > 2 && !haveWidth) {
- width = stack.shift() + nominalWidthX;
- haveWidth = true;
- }
+p5.Color.prototype._getBrightness = function() {
+ if (!this.hsba) {
+ this.hsba = color_conversion._rgbaToHSBA(this._array);
+ }
+ return this.hsba[2] * this.maxes[constants.HSB][2];
+};
- y += stack.pop();
- x += stack.pop();
- newContour(x, y);
- break;
- case 22: // hmoveto
- if (stack.length > 1 && !haveWidth) {
- width = stack.shift() + nominalWidthX;
- haveWidth = true;
- }
+p5.Color.prototype._getGreen = function() {
+ return this._array[1] * this.maxes[constants.RGB][1];
+};
- x += stack.pop();
- newContour(x, y);
- break;
- case 23: // vstemhm
- parseStems();
- break;
- case 24: // rcurveline
- while (stack.length > 2) {
- c1x = x + stack.shift();
- c1y = y + stack.shift();
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x + stack.shift();
- y = c2y + stack.shift();
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- }
+/**
+ * Hue is the same in HSB and HSL, but the maximum value may be different.
+ * This function will return the HSB-normalized saturation when supplied with
+ * an HSB color object, but will default to the HSL-normalized saturation
+ * otherwise.
+ */
+p5.Color.prototype._getHue = function() {
+ if (this.mode === constants.HSB) {
+ if (!this.hsba) {
+ this.hsba = color_conversion._rgbaToHSBA(this._array);
+ }
+ return this.hsba[0] * this.maxes[constants.HSB][0];
+ } else {
+ if (!this.hsla) {
+ this.hsla = color_conversion._rgbaToHSLA(this._array);
+ }
+ return this.hsla[0] * this.maxes[constants.HSL][0];
+ }
+};
- x += stack.shift();
- y += stack.shift();
- p.lineTo(x, y);
- break;
- case 25: // rlinecurve
- while (stack.length > 6) {
- x += stack.shift();
- y += stack.shift();
- p.lineTo(x, y);
- }
+p5.Color.prototype._getLightness = function() {
+ if (!this.hsla) {
+ this.hsla = color_conversion._rgbaToHSLA(this._array);
+ }
+ return this.hsla[2] * this.maxes[constants.HSL][2];
+};
- c1x = x + stack.shift();
- c1y = y + stack.shift();
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x + stack.shift();
- y = c2y + stack.shift();
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- break;
- case 26: // vvcurveto
- if (stack.length % 2) {
- x += stack.shift();
- }
+p5.Color.prototype._getRed = function() {
+ return this._array[0] * this.maxes[constants.RGB][0];
+};
- while (stack.length > 0) {
- c1x = x;
- c1y = y + stack.shift();
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x;
- y = c2y + stack.shift();
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- }
+/**
+ * Saturation is scaled differently in HSB and HSL. This function will return
+ * the HSB saturation when supplied with an HSB color object, but will default
+ * to the HSL saturation otherwise.
+ */
+p5.Color.prototype._getSaturation = function() {
+ if (this.mode === constants.HSB) {
+ if (!this.hsba) {
+ this.hsba = color_conversion._rgbaToHSBA(this._array);
+ }
+ return this.hsba[1] * this.maxes[constants.HSB][1];
+ } else {
+ if (!this.hsla) {
+ this.hsla = color_conversion._rgbaToHSLA(this._array);
+ }
+ return this.hsla[1] * this.maxes[constants.HSL][1];
+ }
+};
- break;
- case 27: // hhcurveto
- if (stack.length % 2) {
- y += stack.shift();
- }
+/**
+ * CSS named colors.
+ */
+var namedColors = {
+ aliceblue: '#f0f8ff',
+ antiquewhite: '#faebd7',
+ aqua: '#00ffff',
+ aquamarine: '#7fffd4',
+ azure: '#f0ffff',
+ beige: '#f5f5dc',
+ bisque: '#ffe4c4',
+ black: '#000000',
+ blanchedalmond: '#ffebcd',
+ blue: '#0000ff',
+ blueviolet: '#8a2be2',
+ brown: '#a52a2a',
+ burlywood: '#deb887',
+ cadetblue: '#5f9ea0',
+ chartreuse: '#7fff00',
+ chocolate: '#d2691e',
+ coral: '#ff7f50',
+ cornflowerblue: '#6495ed',
+ cornsilk: '#fff8dc',
+ crimson: '#dc143c',
+ cyan: '#00ffff',
+ darkblue: '#00008b',
+ darkcyan: '#008b8b',
+ darkgoldenrod: '#b8860b',
+ darkgray: '#a9a9a9',
+ darkgreen: '#006400',
+ darkgrey: '#a9a9a9',
+ darkkhaki: '#bdb76b',
+ darkmagenta: '#8b008b',
+ darkolivegreen: '#556b2f',
+ darkorange: '#ff8c00',
+ darkorchid: '#9932cc',
+ darkred: '#8b0000',
+ darksalmon: '#e9967a',
+ darkseagreen: '#8fbc8f',
+ darkslateblue: '#483d8b',
+ darkslategray: '#2f4f4f',
+ darkslategrey: '#2f4f4f',
+ darkturquoise: '#00ced1',
+ darkviolet: '#9400d3',
+ deeppink: '#ff1493',
+ deepskyblue: '#00bfff',
+ dimgray: '#696969',
+ dimgrey: '#696969',
+ dodgerblue: '#1e90ff',
+ firebrick: '#b22222',
+ floralwhite: '#fffaf0',
+ forestgreen: '#228b22',
+ fuchsia: '#ff00ff',
+ gainsboro: '#dcdcdc',
+ ghostwhite: '#f8f8ff',
+ gold: '#ffd700',
+ goldenrod: '#daa520',
+ gray: '#808080',
+ green: '#008000',
+ greenyellow: '#adff2f',
+ grey: '#808080',
+ honeydew: '#f0fff0',
+ hotpink: '#ff69b4',
+ indianred: '#cd5c5c',
+ indigo: '#4b0082',
+ ivory: '#fffff0',
+ khaki: '#f0e68c',
+ lavender: '#e6e6fa',
+ lavenderblush: '#fff0f5',
+ lawngreen: '#7cfc00',
+ lemonchiffon: '#fffacd',
+ lightblue: '#add8e6',
+ lightcoral: '#f08080',
+ lightcyan: '#e0ffff',
+ lightgoldenrodyellow: '#fafad2',
+ lightgray: '#d3d3d3',
+ lightgreen: '#90ee90',
+ lightgrey: '#d3d3d3',
+ lightpink: '#ffb6c1',
+ lightsalmon: '#ffa07a',
+ lightseagreen: '#20b2aa',
+ lightskyblue: '#87cefa',
+ lightslategray: '#778899',
+ lightslategrey: '#778899',
+ lightsteelblue: '#b0c4de',
+ lightyellow: '#ffffe0',
+ lime: '#00ff00',
+ limegreen: '#32cd32',
+ linen: '#faf0e6',
+ magenta: '#ff00ff',
+ maroon: '#800000',
+ mediumaquamarine: '#66cdaa',
+ mediumblue: '#0000cd',
+ mediumorchid: '#ba55d3',
+ mediumpurple: '#9370db',
+ mediumseagreen: '#3cb371',
+ mediumslateblue: '#7b68ee',
+ mediumspringgreen: '#00fa9a',
+ mediumturquoise: '#48d1cc',
+ mediumvioletred: '#c71585',
+ midnightblue: '#191970',
+ mintcream: '#f5fffa',
+ mistyrose: '#ffe4e1',
+ moccasin: '#ffe4b5',
+ navajowhite: '#ffdead',
+ navy: '#000080',
+ oldlace: '#fdf5e6',
+ olive: '#808000',
+ olivedrab: '#6b8e23',
+ orange: '#ffa500',
+ orangered: '#ff4500',
+ orchid: '#da70d6',
+ palegoldenrod: '#eee8aa',
+ palegreen: '#98fb98',
+ paleturquoise: '#afeeee',
+ palevioletred: '#db7093',
+ papayawhip: '#ffefd5',
+ peachpuff: '#ffdab9',
+ peru: '#cd853f',
+ pink: '#ffc0cb',
+ plum: '#dda0dd',
+ powderblue: '#b0e0e6',
+ purple: '#800080',
+ red: '#ff0000',
+ rosybrown: '#bc8f8f',
+ royalblue: '#4169e1',
+ saddlebrown: '#8b4513',
+ salmon: '#fa8072',
+ sandybrown: '#f4a460',
+ seagreen: '#2e8b57',
+ seashell: '#fff5ee',
+ sienna: '#a0522d',
+ silver: '#c0c0c0',
+ skyblue: '#87ceeb',
+ slateblue: '#6a5acd',
+ slategray: '#708090',
+ slategrey: '#708090',
+ snow: '#fffafa',
+ springgreen: '#00ff7f',
+ steelblue: '#4682b4',
+ tan: '#d2b48c',
+ teal: '#008080',
+ thistle: '#d8bfd8',
+ tomato: '#ff6347',
+ turquoise: '#40e0d0',
+ violet: '#ee82ee',
+ wheat: '#f5deb3',
+ white: '#ffffff',
+ whitesmoke: '#f5f5f5',
+ yellow: '#ffff00',
+ yellowgreen: '#9acd32'
+};
- while (stack.length > 0) {
- c1x = x + stack.shift();
- c1y = y;
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x + stack.shift();
- y = c2y;
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- }
+/**
+ * These regular expressions are used to build up the patterns for matching
+ * viable CSS color strings: fragmenting the regexes in this way increases the
+ * legibility and comprehensibility of the code.
+ *
+ * Note that RGB values of .9 are not parsed by IE, but are supported here for
+ * color string consistency.
+ */
+var WHITESPACE = /\s*/; // Match zero or more whitespace characters.
+var INTEGER = /(\d{1,3})/; // Match integers: 79, 255, etc.
+var DECIMAL = /((?:\d+(?:\.\d+)?)|(?:\.\d+))/; // Match 129.6, 79, .9, etc.
+var PERCENT = new RegExp(DECIMAL.source + '%'); // Match 12.9%, 79%, .9%, etc.
- break;
- case 28: // shortint
- b1 = code[i];
- b2 = code[i + 1];
- stack.push(((b1 << 24) | (b2 << 16)) >> 16);
- i += 2;
- break;
- case 29: // callgsubr
- codeIndex = stack.pop() + font.gsubrsBias;
- subrCode = font.gsubrs[codeIndex];
- if (subrCode) {
- parse(subrCode);
- }
+/**
+ * Full color string patterns. The capture groups are necessary.
+ */
+var colorPatterns = {
+ // Match colors in format #XXX, e.g. #416.
+ HEX3: /^#([a-f0-9])([a-f0-9])([a-f0-9])$/i,
- break;
- case 30: // vhcurveto
- while (stack.length > 0) {
- c1x = x;
- c1y = y + stack.shift();
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x + stack.shift();
- y = c2y + (stack.length === 1 ? stack.shift() : 0);
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- if (stack.length === 0) {
- break;
- }
+ // Match colors in format #XXXX, e.g. #5123.
+ HEX4: /^#([a-f0-9])([a-f0-9])([a-f0-9])([a-f0-9])$/i,
- c1x = x + stack.shift();
- c1y = y;
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- y = c2y + stack.shift();
- x = c2x + (stack.length === 1 ? stack.shift() : 0);
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- }
+ // Match colors in format #XXXXXX, e.g. #b4d455.
+ HEX6: /^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i,
- break;
- case 31: // hvcurveto
- while (stack.length > 0) {
- c1x = x + stack.shift();
- c1y = y;
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- y = c2y + stack.shift();
- x = c2x + (stack.length === 1 ? stack.shift() : 0);
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- if (stack.length === 0) {
- break;
- }
+ // Match colors in format #XXXXXXXX, e.g. #b4d45535.
+ HEX8: /^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i,
- c1x = x;
- c1y = y + stack.shift();
- c2x = c1x + stack.shift();
- c2y = c1y + stack.shift();
- x = c2x + stack.shift();
- y = c2y + (stack.length === 1 ? stack.shift() : 0);
- p.curveTo(c1x, c1y, c2x, c2y, x, y);
- }
+ // Match colors in format rgb(R, G, B), e.g. rgb(255, 0, 128).
+ RGB: new RegExp(
+ [
+ '^rgb\\(',
+ INTEGER.source,
+ ',',
+ INTEGER.source,
+ ',',
+ INTEGER.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
- break;
- default:
- if (v < 32) {
- console.log('Glyph ' + glyph.index + ': unknown operator ' + v);
- } else if (v < 247) {
- stack.push(v - 139);
- } else if (v < 251) {
- b1 = code[i];
- i += 1;
- stack.push((v - 247) * 256 + b1 + 108);
- } else if (v < 255) {
- b1 = code[i];
- i += 1;
- stack.push(-(v - 251) * 256 - b1 - 108);
- } else {
- b1 = code[i];
- b2 = code[i + 1];
- b3 = code[i + 2];
- b4 = code[i + 3];
- i += 4;
- stack.push(((b1 << 24) | (b2 << 16) | (b3 << 8) | b4) / 65536);
- }
- }
- }
- }
+ // Match colors in format rgb(R%, G%, B%), e.g. rgb(100%, 0%, 28.9%).
+ RGB_PERCENT: new RegExp(
+ [
+ '^rgb\\(',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
- parse(code);
+ // Match colors in format rgb(R, G, B, A), e.g. rgb(255, 0, 128, 0.25).
+ RGBA: new RegExp(
+ [
+ '^rgba\\(',
+ INTEGER.source,
+ ',',
+ INTEGER.source,
+ ',',
+ INTEGER.source,
+ ',',
+ DECIMAL.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
- glyph.advanceWidth = width;
- return p;
-}
+ // Match colors in format rgb(R%, G%, B%, A), e.g. rgb(100%, 0%, 28.9%, 0.5).
+ RGBA_PERCENT: new RegExp(
+ [
+ '^rgba\\(',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ ',',
+ DECIMAL.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
-function parseCFFFDSelect(data, start, nGlyphs, fdArrayCount) {
- var fdSelect = [];
- var fdIndex;
- var parser = new parse.Parser(data, start);
- var format = parser.parseCard8();
- if (format === 0) {
- // Simple list of nGlyphs elements
- for (var iGid = 0; iGid < nGlyphs; iGid++) {
- fdIndex = parser.parseCard8();
- if (fdIndex >= fdArrayCount) {
- throw new Error('CFF table CID Font FDSelect has bad FD index value ' + fdIndex + ' (FD count ' + fdArrayCount + ')');
- }
- fdSelect.push(fdIndex);
- }
- } else if (format === 3) {
- // Ranges
- var nRanges = parser.parseCard16();
- var first = parser.parseCard16();
- if (first !== 0) {
- throw new Error('CFF Table CID Font FDSelect format 3 range has bad initial GID ' + first);
- }
- var next;
- for (var iRange = 0; iRange < nRanges; iRange++) {
- fdIndex = parser.parseCard8();
- next = parser.parseCard16();
- if (fdIndex >= fdArrayCount) {
- throw new Error('CFF table CID Font FDSelect has bad FD index value ' + fdIndex + ' (FD count ' + fdArrayCount + ')');
- }
- if (next > nGlyphs) {
- throw new Error('CFF Table CID Font FDSelect format 3 range has bad GID ' + next);
- }
- for (; first < next; first++) {
- fdSelect.push(fdIndex);
- }
- first = next;
- }
- if (next !== nGlyphs) {
- throw new Error('CFF Table CID Font FDSelect format 3 range has bad final GID ' + next);
- }
- } else {
- throw new Error('CFF Table CID Font FDSelect table has unsupported format ' + format);
- }
- return fdSelect;
-}
+ // Match colors in format hsla(H, S%, L%), e.g. hsl(100, 40%, 28.9%).
+ HSL: new RegExp(
+ [
+ '^hsl\\(',
+ INTEGER.source,
+ ',',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
-// Parse the `CFF` table, which contains the glyph outlines in PostScript format.
-function parseCFFTable(data, start, font) {
- font.tables.cff = {};
- var header = parseCFFHeader(data, start);
- var nameIndex = parseCFFIndex(data, header.endOffset, parse.bytesToString);
- var topDictIndex = parseCFFIndex(data, nameIndex.endOffset);
- var stringIndex = parseCFFIndex(data, topDictIndex.endOffset, parse.bytesToString);
- var globalSubrIndex = parseCFFIndex(data, stringIndex.endOffset);
- font.gsubrs = globalSubrIndex.objects;
- font.gsubrsBias = calcCFFSubroutineBias(font.gsubrs);
-
- var topDictArray = gatherCFFTopDicts(data, start, topDictIndex.objects, stringIndex.objects);
- if (topDictArray.length !== 1) {
- throw new Error('CFF table has too many fonts in \'FontSet\' - ' + 'count of fonts NameIndex.length = ' + topDictArray.length);
- }
+ // Match colors in format hsla(H, S%, L%, A), e.g. hsla(100, 40%, 28.9%, 0.5).
+ HSLA: new RegExp(
+ [
+ '^hsla\\(',
+ INTEGER.source,
+ ',',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ ',',
+ DECIMAL.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
- var topDict = topDictArray[0];
- font.tables.cff.topDict = topDict;
+ // Match colors in format hsb(H, S%, B%), e.g. hsb(100, 40%, 28.9%).
+ HSB: new RegExp(
+ [
+ '^hsb\\(',
+ INTEGER.source,
+ ',',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ ),
- if (topDict._privateDict) {
- font.defaultWidthX = topDict._privateDict.defaultWidthX;
- font.nominalWidthX = topDict._privateDict.nominalWidthX;
- }
+ // Match colors in format hsba(H, S%, B%, A), e.g. hsba(100, 40%, 28.9%, 0.5).
+ HSBA: new RegExp(
+ [
+ '^hsba\\(',
+ INTEGER.source,
+ ',',
+ PERCENT.source,
+ ',',
+ PERCENT.source,
+ ',',
+ DECIMAL.source,
+ '\\)$'
+ ].join(WHITESPACE.source),
+ 'i'
+ )
+};
- if (topDict.ros[0] !== undefined && topDict.ros[1] !== undefined) {
- font.isCIDFont = true;
- }
+/**
+ * For a number of different inputs, returns a color formatted as [r, g, b, a]
+ * arrays, with each component normalized between 0 and 1.
+ *
+ * @private
+ * @param {Array} [...args] An 'array-like' object that represents a list of
+ * arguments
+ * @return {Number[]} a color formatted as [r, g, b, a]
+ * Example:
+ * input ==> output
+ * g ==> [g, g, g, 255]
+ * g,a ==> [g, g, g, a]
+ * r, g, b ==> [r, g, b, 255]
+ * r, g, b, a ==> [r, g, b, a]
+ * [g] ==> [g, g, g, 255]
+ * [g, a] ==> [g, g, g, a]
+ * [r, g, b] ==> [r, g, b, 255]
+ * [r, g, b, a] ==> [r, g, b, a]
+ * @example
+ *
+ *
+ * // todo
+ *
+ *
+ *
+ * @alt
+ * //todo
+ *
+ */
+p5.Color._parseInputs = function(r, g, b, a) {
+ var numArgs = arguments.length;
+ var mode = this.mode;
+ var maxes = this.maxes[mode];
+ var results = [];
+ var i;
- if (font.isCIDFont) {
- var fdArrayOffset = topDict.fdArray;
- var fdSelectOffset = topDict.fdSelect;
- if (fdArrayOffset === 0 || fdSelectOffset === 0) {
- throw new Error('Font is marked as a CID font, but FDArray and/or FDSelect information is missing');
- }
- fdArrayOffset += start;
- var fdArrayIndex = parseCFFIndex(data, fdArrayOffset);
- var fdArray = gatherCFFTopDicts(data, start, fdArrayIndex.objects, stringIndex.objects);
- topDict._fdArray = fdArray;
- fdSelectOffset += start;
- topDict._fdSelect = parseCFFFDSelect(data, fdSelectOffset, font.numGlyphs, fdArray.length);
- }
+ if (numArgs >= 3) {
+ // Argument is a list of component values.
- var privateDictOffset = start + topDict['private'][1];
- var privateDict = parseCFFPrivateDict(data, privateDictOffset, topDict['private'][0], stringIndex.objects);
- font.defaultWidthX = privateDict.defaultWidthX;
- font.nominalWidthX = privateDict.nominalWidthX;
+ results[0] = r / maxes[0];
+ results[1] = g / maxes[1];
+ results[2] = b / maxes[2];
- if (privateDict.subrs !== 0) {
- var subrOffset = privateDictOffset + privateDict.subrs;
- var subrIndex = parseCFFIndex(data, subrOffset);
- font.subrs = subrIndex.objects;
- font.subrsBias = calcCFFSubroutineBias(font.subrs);
+ // Alpha may be undefined, so default it to 100%.
+ if (typeof a === 'number') {
+ results[3] = a / maxes[3];
} else {
- font.subrs = [];
- font.subrsBias = 0;
+ results[3] = 1;
}
- // Offsets in the top dict are relative to the beginning of the CFF data, so add the CFF start offset.
- var charStringsIndex = parseCFFIndex(data, start + topDict.charStrings);
- font.nGlyphs = charStringsIndex.objects.length;
+ // Constrain components to the range [0,1].
+ // (loop backwards for performance)
+ for (i = results.length - 1; i >= 0; --i) {
+ var result = results[i];
+ if (result < 0) {
+ results[i] = 0;
+ } else if (result > 1) {
+ results[i] = 1;
+ }
+ }
- var charset = parseCFFCharset(data, start + topDict.charset, font.nGlyphs, stringIndex.objects);
- if (topDict.encoding === 0) { // Standard encoding
- font.cffEncoding = new encoding.CffEncoding(encoding.cffStandardEncoding, charset);
- } else if (topDict.encoding === 1) { // Expert encoding
- font.cffEncoding = new encoding.CffEncoding(encoding.cffExpertEncoding, charset);
+ // Convert to RGBA and return.
+ if (mode === constants.HSL) {
+ return color_conversion._hslaToRGBA(results);
+ } else if (mode === constants.HSB) {
+ return color_conversion._hsbaToRGBA(results);
} else {
- font.cffEncoding = parseCFFEncoding(data, start + topDict.encoding, charset);
+ return results;
}
+ } else if (numArgs === 1 && typeof r === 'string') {
+ var str = r.trim().toLowerCase();
- // Prefer the CMAP encoding to the CFF encoding.
- font.encoding = font.encoding || font.cffEncoding;
-
- font.glyphs = new glyphset.GlyphSet(font);
- for (var i = 0; i < font.nGlyphs; i += 1) {
- var charString = charStringsIndex.objects[i];
- font.glyphs.push(i, glyphset.cffGlyphLoader(font, i, parseCFFCharstring, charString));
+ // Return if string is a named colour.
+ if (namedColors[str]) {
+ return p5.Color._parseInputs.call(this, namedColors[str]);
}
-}
-// Convert a string to a String ID (SID).
-// The list of strings is modified in place.
-function encodeString(s, strings) {
- var sid;
-
- // Is the string in the CFF standard strings?
- var i = encoding.cffStandardStrings.indexOf(s);
- if (i >= 0) {
- sid = i;
+ // Try RGBA pattern matching.
+ if (colorPatterns.HEX3.test(str)) {
+ // #rgb
+ results = colorPatterns.HEX3.exec(str)
+ .slice(1)
+ .map(function(color) {
+ return parseInt(color + color, 16) / 255;
+ });
+ results[3] = 1;
+ return results;
+ } else if (colorPatterns.HEX6.test(str)) {
+ // #rrggbb
+ results = colorPatterns.HEX6.exec(str)
+ .slice(1)
+ .map(function(color) {
+ return parseInt(color, 16) / 255;
+ });
+ results[3] = 1;
+ return results;
+ } else if (colorPatterns.HEX4.test(str)) {
+ // #rgba
+ results = colorPatterns.HEX4.exec(str)
+ .slice(1)
+ .map(function(color) {
+ return parseInt(color + color, 16) / 255;
+ });
+ return results;
+ } else if (colorPatterns.HEX8.test(str)) {
+ // #rrggbbaa
+ results = colorPatterns.HEX8.exec(str)
+ .slice(1)
+ .map(function(color) {
+ return parseInt(color, 16) / 255;
+ });
+ return results;
+ } else if (colorPatterns.RGB.test(str)) {
+ // rgb(R,G,B)
+ results = colorPatterns.RGB.exec(str)
+ .slice(1)
+ .map(function(color) {
+ return color / 255;
+ });
+ results[3] = 1;
+ return results;
+ } else if (colorPatterns.RGB_PERCENT.test(str)) {
+ // rgb(R%,G%,B%)
+ results = colorPatterns.RGB_PERCENT.exec(str)
+ .slice(1)
+ .map(function(color) {
+ return parseFloat(color) / 100;
+ });
+ results[3] = 1;
+ return results;
+ } else if (colorPatterns.RGBA.test(str)) {
+ // rgba(R,G,B,A)
+ results = colorPatterns.RGBA.exec(str)
+ .slice(1)
+ .map(function(color, idx) {
+ if (idx === 3) {
+ return parseFloat(color);
+ }
+ return color / 255;
+ });
+ return results;
+ } else if (colorPatterns.RGBA_PERCENT.test(str)) {
+ // rgba(R%,G%,B%,A%)
+ results = colorPatterns.RGBA_PERCENT.exec(str)
+ .slice(1)
+ .map(function(color, idx) {
+ if (idx === 3) {
+ return parseFloat(color);
+ }
+ return parseFloat(color) / 100;
+ });
+ return results;
}
- // Is the string already in the string index?
- i = strings.indexOf(s);
- if (i >= 0) {
- sid = i + encoding.cffStandardStrings.length;
- } else {
- sid = encoding.cffStandardStrings.length + strings.length;
- strings.push(s);
- }
-
- return sid;
-}
-
-function makeHeader() {
- return new table.Record('Header', [
- {name: 'major', type: 'Card8', value: 1},
- {name: 'minor', type: 'Card8', value: 0},
- {name: 'hdrSize', type: 'Card8', value: 4},
- {name: 'major', type: 'Card8', value: 1}
- ]);
-}
-
-function makeNameIndex(fontNames) {
- var t = new table.Record('Name INDEX', [
- {name: 'names', type: 'INDEX', value: []}
- ]);
- t.names = [];
- for (var i = 0; i < fontNames.length; i += 1) {
- t.names.push({name: 'name_' + i, type: 'NAME', value: fontNames[i]});
- }
-
- return t;
-}
-
-// Given a dictionary's metadata, create a DICT structure.
-function makeDict(meta, attrs, strings) {
- var m = {};
- for (var i = 0; i < meta.length; i += 1) {
- var entry = meta[i];
- var value = attrs[entry.name];
- if (value !== undefined && !equals(value, entry.value)) {
- if (entry.type === 'SID') {
- value = encodeString(value, strings);
- }
-
- m[entry.op] = {name: entry.name, type: entry.type, value: value};
- }
- }
-
- return m;
-}
-
-// The Top DICT houses the global font attributes.
-function makeTopDict(attrs, strings) {
- var t = new table.Record('Top DICT', [
- {name: 'dict', type: 'DICT', value: {}}
- ]);
- t.dict = makeDict(TOP_DICT_META, attrs, strings);
- return t;
-}
-
-function makeTopDictIndex(topDict) {
- var t = new table.Record('Top DICT INDEX', [
- {name: 'topDicts', type: 'INDEX', value: []}
- ]);
- t.topDicts = [{name: 'topDict_0', type: 'TABLE', value: topDict}];
- return t;
-}
-
-function makeStringIndex(strings) {
- var t = new table.Record('String INDEX', [
- {name: 'strings', type: 'INDEX', value: []}
- ]);
- t.strings = [];
- for (var i = 0; i < strings.length; i += 1) {
- t.strings.push({name: 'string_' + i, type: 'STRING', value: strings[i]});
- }
-
- return t;
-}
-
-function makeGlobalSubrIndex() {
- // Currently we don't use subroutines.
- return new table.Record('Global Subr INDEX', [
- {name: 'subrs', type: 'INDEX', value: []}
- ]);
-}
-
-function makeCharsets(glyphNames, strings) {
- var t = new table.Record('Charsets', [
- {name: 'format', type: 'Card8', value: 0}
- ]);
- for (var i = 0; i < glyphNames.length; i += 1) {
- var glyphName = glyphNames[i];
- var glyphSID = encodeString(glyphName, strings);
- t.fields.push({name: 'glyph_' + i, type: 'SID', value: glyphSID});
- }
-
- return t;
-}
-
-function glyphToOps(glyph) {
- var ops = [];
- var path = glyph.path;
- ops.push({name: 'width', type: 'NUMBER', value: glyph.advanceWidth});
- var x = 0;
- var y = 0;
- for (var i = 0; i < path.commands.length; i += 1) {
- var dx;
- var dy;
- var cmd = path.commands[i];
- if (cmd.type === 'Q') {
- // CFF only supports bézier curves, so convert the quad to a bézier.
- var _13 = 1 / 3;
- var _23 = 2 / 3;
-
- // We're going to create a new command so we don't change the original path.
- cmd = {
- type: 'C',
- x: cmd.x,
- y: cmd.y,
- x1: _13 * x + _23 * cmd.x1,
- y1: _13 * y + _23 * cmd.y1,
- x2: _13 * cmd.x + _23 * cmd.x1,
- y2: _13 * cmd.y + _23 * cmd.y1
- };
- }
-
- if (cmd.type === 'M') {
- dx = Math.round(cmd.x - x);
- dy = Math.round(cmd.y - y);
- ops.push({name: 'dx', type: 'NUMBER', value: dx});
- ops.push({name: 'dy', type: 'NUMBER', value: dy});
- ops.push({name: 'rmoveto', type: 'OP', value: 21});
- x = Math.round(cmd.x);
- y = Math.round(cmd.y);
- } else if (cmd.type === 'L') {
- dx = Math.round(cmd.x - x);
- dy = Math.round(cmd.y - y);
- ops.push({name: 'dx', type: 'NUMBER', value: dx});
- ops.push({name: 'dy', type: 'NUMBER', value: dy});
- ops.push({name: 'rlineto', type: 'OP', value: 5});
- x = Math.round(cmd.x);
- y = Math.round(cmd.y);
- } else if (cmd.type === 'C') {
- var dx1 = Math.round(cmd.x1 - x);
- var dy1 = Math.round(cmd.y1 - y);
- var dx2 = Math.round(cmd.x2 - cmd.x1);
- var dy2 = Math.round(cmd.y2 - cmd.y1);
- dx = Math.round(cmd.x - cmd.x2);
- dy = Math.round(cmd.y - cmd.y2);
- ops.push({name: 'dx1', type: 'NUMBER', value: dx1});
- ops.push({name: 'dy1', type: 'NUMBER', value: dy1});
- ops.push({name: 'dx2', type: 'NUMBER', value: dx2});
- ops.push({name: 'dy2', type: 'NUMBER', value: dy2});
- ops.push({name: 'dx', type: 'NUMBER', value: dx});
- ops.push({name: 'dy', type: 'NUMBER', value: dy});
- ops.push({name: 'rrcurveto', type: 'OP', value: 8});
- x = Math.round(cmd.x);
- y = Math.round(cmd.y);
- }
-
- // Contours are closed automatically.
-
- }
-
- ops.push({name: 'endchar', type: 'OP', value: 14});
- return ops;
-}
-
-function makeCharStringsIndex(glyphs) {
- var t = new table.Record('CharStrings INDEX', [
- {name: 'charStrings', type: 'INDEX', value: []}
- ]);
-
- for (var i = 0; i < glyphs.length; i += 1) {
- var glyph = glyphs.get(i);
- var ops = glyphToOps(glyph);
- t.charStrings.push({name: glyph.name, type: 'CHARSTRING', value: ops});
+ // Try HSLA pattern matching.
+ if (colorPatterns.HSL.test(str)) {
+ // hsl(H,S,L)
+ results = colorPatterns.HSL.exec(str)
+ .slice(1)
+ .map(function(color, idx) {
+ if (idx === 0) {
+ return parseInt(color, 10) / 360;
+ }
+ return parseInt(color, 10) / 100;
+ });
+ results[3] = 1;
+ } else if (colorPatterns.HSLA.test(str)) {
+ // hsla(H,S,L,A)
+ results = colorPatterns.HSLA.exec(str)
+ .slice(1)
+ .map(function(color, idx) {
+ if (idx === 0) {
+ return parseInt(color, 10) / 360;
+ } else if (idx === 3) {
+ return parseFloat(color);
+ }
+ return parseInt(color, 10) / 100;
+ });
}
-
- return t;
-}
-
-function makePrivateDict(attrs, strings) {
- var t = new table.Record('Private DICT', [
- {name: 'dict', type: 'DICT', value: {}}
- ]);
- t.dict = makeDict(PRIVATE_DICT_META, attrs, strings);
- return t;
-}
-
-function makeCFFTable(glyphs, options) {
- var t = new table.Table('CFF ', [
- {name: 'header', type: 'RECORD'},
- {name: 'nameIndex', type: 'RECORD'},
- {name: 'topDictIndex', type: 'RECORD'},
- {name: 'stringIndex', type: 'RECORD'},
- {name: 'globalSubrIndex', type: 'RECORD'},
- {name: 'charsets', type: 'RECORD'},
- {name: 'charStringsIndex', type: 'RECORD'},
- {name: 'privateDict', type: 'RECORD'}
- ]);
-
- var fontScale = 1 / options.unitsPerEm;
- // We use non-zero values for the offsets so that the DICT encodes them.
- // This is important because the size of the Top DICT plays a role in offset calculation,
- // and the size shouldn't change after we've written correct offsets.
- var attrs = {
- version: options.version,
- fullName: options.fullName,
- familyName: options.familyName,
- weight: options.weightName,
- fontBBox: options.fontBBox || [0, 0, 0, 0],
- fontMatrix: [fontScale, 0, 0, fontScale, 0, 0],
- charset: 999,
- encoding: 0,
- charStrings: 999,
- private: [0, 999]
- };
-
- var privateAttrs = {};
-
- var glyphNames = [];
- var glyph;
-
- // Skip first glyph (.notdef)
- for (var i = 1; i < glyphs.length; i += 1) {
- glyph = glyphs.get(i);
- glyphNames.push(glyph.name);
+ results = results.map(function(value) {
+ return Math.max(Math.min(value, 1), 0);
+ });
+ if (results.length) {
+ return color_conversion._hslaToRGBA(results);
}
- var strings = [];
-
- t.header = makeHeader();
- t.nameIndex = makeNameIndex([options.postScriptName]);
- var topDict = makeTopDict(attrs, strings);
- t.topDictIndex = makeTopDictIndex(topDict);
- t.globalSubrIndex = makeGlobalSubrIndex();
- t.charsets = makeCharsets(glyphNames, strings);
- t.charStringsIndex = makeCharStringsIndex(glyphs);
- t.privateDict = makePrivateDict(privateAttrs, strings);
-
- // Needs to come at the end, to encode all custom strings used in the font.
- t.stringIndex = makeStringIndex(strings);
-
- var startOffset = t.header.sizeOf() +
- t.nameIndex.sizeOf() +
- t.topDictIndex.sizeOf() +
- t.stringIndex.sizeOf() +
- t.globalSubrIndex.sizeOf();
- attrs.charset = startOffset;
-
- // We use the CFF standard encoding; proper encoding will be handled in cmap.
- attrs.encoding = 0;
- attrs.charStrings = attrs.charset + t.charsets.sizeOf();
- attrs.private[1] = attrs.charStrings + t.charStringsIndex.sizeOf();
-
- // Recreate the Top DICT INDEX with the correct offsets.
- topDict = makeTopDict(attrs, strings);
- t.topDictIndex = makeTopDictIndex(topDict);
-
- return t;
-}
-
-exports.parse = parseCFFTable;
-exports.make = makeCFFTable;
-
-},{"../encoding":12,"../glyphset":15,"../parse":19,"../path":20,"../table":22}],24:[function(_dereq_,module,exports){
-// The `cmap` table stores the mappings from characters to glyphs.
-// https://www.microsoft.com/typography/OTSPEC/cmap.htm
-
-'use strict';
-
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-function parseCmapTableFormat12(cmap, p) {
- var i;
-
- //Skip reserved.
- p.parseUShort();
-
- // Length in bytes of the sub-tables.
- cmap.length = p.parseULong();
- cmap.language = p.parseULong();
-
- var groupCount;
- cmap.groupCount = groupCount = p.parseULong();
- cmap.glyphIndexMap = {};
-
- for (i = 0; i < groupCount; i += 1) {
- var startCharCode = p.parseULong();
- var endCharCode = p.parseULong();
- var startGlyphId = p.parseULong();
-
- for (var c = startCharCode; c <= endCharCode; c += 1) {
- cmap.glyphIndexMap[c] = startGlyphId;
- startGlyphId++;
- }
+ // Try HSBA pattern matching.
+ if (colorPatterns.HSB.test(str)) {
+ // hsb(H,S,B)
+ results = colorPatterns.HSB.exec(str)
+ .slice(1)
+ .map(function(color, idx) {
+ if (idx === 0) {
+ return parseInt(color, 10) / 360;
+ }
+ return parseInt(color, 10) / 100;
+ });
+ results[3] = 1;
+ } else if (colorPatterns.HSBA.test(str)) {
+ // hsba(H,S,B,A)
+ results = colorPatterns.HSBA.exec(str)
+ .slice(1)
+ .map(function(color, idx) {
+ if (idx === 0) {
+ return parseInt(color, 10) / 360;
+ } else if (idx === 3) {
+ return parseFloat(color);
+ }
+ return parseInt(color, 10) / 100;
+ });
}
-}
-
-function parseCmapTableFormat4(cmap, p, data, start, offset) {
- var i;
-
- // Length in bytes of the sub-tables.
- cmap.length = p.parseUShort();
- cmap.language = p.parseUShort();
-
- // segCount is stored x 2.
- var segCount;
- cmap.segCount = segCount = p.parseUShort() >> 1;
-
- // Skip searchRange, entrySelector, rangeShift.
- p.skip('uShort', 3);
-
- // The "unrolled" mapping from character codes to glyph indices.
- cmap.glyphIndexMap = {};
- var endCountParser = new parse.Parser(data, start + offset + 14);
- var startCountParser = new parse.Parser(data, start + offset + 16 + segCount * 2);
- var idDeltaParser = new parse.Parser(data, start + offset + 16 + segCount * 4);
- var idRangeOffsetParser = new parse.Parser(data, start + offset + 16 + segCount * 6);
- var glyphIndexOffset = start + offset + 16 + segCount * 8;
- for (i = 0; i < segCount - 1; i += 1) {
- var glyphIndex;
- var endCount = endCountParser.parseUShort();
- var startCount = startCountParser.parseUShort();
- var idDelta = idDeltaParser.parseShort();
- var idRangeOffset = idRangeOffsetParser.parseUShort();
- for (var c = startCount; c <= endCount; c += 1) {
- if (idRangeOffset !== 0) {
- // The idRangeOffset is relative to the current position in the idRangeOffset array.
- // Take the current offset in the idRangeOffset array.
- glyphIndexOffset = (idRangeOffsetParser.offset + idRangeOffsetParser.relativeOffset - 2);
-
- // Add the value of the idRangeOffset, which will move us into the glyphIndex array.
- glyphIndexOffset += idRangeOffset;
-
- // Then add the character index of the current segment, multiplied by 2 for USHORTs.
- glyphIndexOffset += (c - startCount) * 2;
- glyphIndex = parse.getUShort(data, glyphIndexOffset);
- if (glyphIndex !== 0) {
- glyphIndex = (glyphIndex + idDelta) & 0xFFFF;
- }
- } else {
- glyphIndex = (c + idDelta) & 0xFFFF;
- }
- cmap.glyphIndexMap[c] = glyphIndex;
- }
- }
-}
+ if (results.length) {
+ // (loop backwards for performance)
+ for (i = results.length - 1; i >= 0; --i) {
+ results[i] = Math.max(Math.min(results[i], 1), 0);
+ }
-// Parse the `cmap` table. This table stores the mappings from characters to glyphs.
-// There are many available formats, but we only support the Windows format 4 and 12.
-// This function returns a `CmapEncoding` object or null if no supported format could be found.
-function parseCmapTable(data, start) {
- var i;
- var cmap = {};
- cmap.version = parse.getUShort(data, start);
- check.argument(cmap.version === 0, 'cmap table version should be 0.');
-
- // The cmap table can contain many sub-tables, each with their own format.
- // We're only interested in a "platform 3" table. This is a Windows format.
- cmap.numTables = parse.getUShort(data, start + 2);
- var offset = -1;
- for (i = cmap.numTables - 1; i >= 0; i -= 1) {
- var platformId = parse.getUShort(data, start + 4 + (i * 8));
- var encodingId = parse.getUShort(data, start + 4 + (i * 8) + 2);
- if (platformId === 3 && (encodingId === 0 || encodingId === 1 || encodingId === 10)) {
- offset = parse.getULong(data, start + 4 + (i * 8) + 4);
- break;
- }
+ return color_conversion._hsbaToRGBA(results);
}
- if (offset === -1) {
- // There is no cmap table in the font that we support.
- throw new Error('No valid cmap sub-tables found.');
- }
+ // Input did not match any CSS color pattern: default to white.
+ results = [1, 1, 1, 1];
+ } else if ((numArgs === 1 || numArgs === 2) && typeof r === 'number') {
+ // 'Grayscale' mode.
- var p = new parse.Parser(data, start + offset);
- cmap.format = p.parseUShort();
+ /**
+ * For HSB and HSL, interpret the gray level as a brightness/lightness
+ * value (they are equivalent when chroma is zero). For RGB, normalize the
+ * gray level according to the blue maximum.
+ */
+ results[0] = r / maxes[2];
+ results[1] = r / maxes[2];
+ results[2] = r / maxes[2];
- if (cmap.format === 12) {
- parseCmapTableFormat12(cmap, p);
- } else if (cmap.format === 4) {
- parseCmapTableFormat4(cmap, p, data, start, offset);
+ // Alpha may be undefined, so default it to 100%.
+ if (typeof g === 'number') {
+ results[3] = g / maxes[3];
} else {
- throw new Error('Only format 4 and 12 cmap tables are supported (found format ' + cmap.format + ').');
+ results[3] = 1;
}
- return cmap;
-}
-
-function addSegment(t, code, glyphIndex) {
- t.segments.push({
- end: code,
- start: code,
- delta: -(code - glyphIndex),
- offset: 0
- });
-}
-
-function addTerminatorSegment(t) {
- t.segments.push({
- end: 0xFFFF,
- start: 0xFFFF,
- delta: 1,
- offset: 0
+ // Constrain components to the range [0,1].
+ results = results.map(function(value) {
+ return Math.max(Math.min(value, 1), 0);
});
-}
-
-function makeCmapTable(glyphs) {
- var i;
- var t = new table.Table('cmap', [
- {name: 'version', type: 'USHORT', value: 0},
- {name: 'numTables', type: 'USHORT', value: 1},
- {name: 'platformID', type: 'USHORT', value: 3},
- {name: 'encodingID', type: 'USHORT', value: 1},
- {name: 'offset', type: 'ULONG', value: 12},
- {name: 'format', type: 'USHORT', value: 4},
- {name: 'length', type: 'USHORT', value: 0},
- {name: 'language', type: 'USHORT', value: 0},
- {name: 'segCountX2', type: 'USHORT', value: 0},
- {name: 'searchRange', type: 'USHORT', value: 0},
- {name: 'entrySelector', type: 'USHORT', value: 0},
- {name: 'rangeShift', type: 'USHORT', value: 0}
- ]);
-
- t.segments = [];
- for (i = 0; i < glyphs.length; i += 1) {
- var glyph = glyphs.get(i);
- for (var j = 0; j < glyph.unicodes.length; j += 1) {
- addSegment(t, glyph.unicodes[j], i);
- }
-
- t.segments = t.segments.sort(function(a, b) {
- return a.start - b.start;
- });
- }
-
- addTerminatorSegment(t);
-
- var segCount;
- segCount = t.segments.length;
- t.segCountX2 = segCount * 2;
- t.searchRange = Math.pow(2, Math.floor(Math.log(segCount) / Math.log(2))) * 2;
- t.entrySelector = Math.log(t.searchRange / 2) / Math.log(2);
- t.rangeShift = t.segCountX2 - t.searchRange;
-
- // Set up parallel segment arrays.
- var endCounts = [];
- var startCounts = [];
- var idDeltas = [];
- var idRangeOffsets = [];
- var glyphIds = [];
-
- for (i = 0; i < segCount; i += 1) {
- var segment = t.segments[i];
- endCounts = endCounts.concat({name: 'end_' + i, type: 'USHORT', value: segment.end});
- startCounts = startCounts.concat({name: 'start_' + i, type: 'USHORT', value: segment.start});
- idDeltas = idDeltas.concat({name: 'idDelta_' + i, type: 'SHORT', value: segment.delta});
- idRangeOffsets = idRangeOffsets.concat({name: 'idRangeOffset_' + i, type: 'USHORT', value: segment.offset});
- if (segment.glyphId !== undefined) {
- glyphIds = glyphIds.concat({name: 'glyph_' + i, type: 'USHORT', value: segment.glyphId});
- }
- }
+ } else {
+ throw new Error(arguments + 'is not a valid color representation.');
+ }
- t.fields = t.fields.concat(endCounts);
- t.fields.push({name: 'reservedPad', type: 'USHORT', value: 0});
- t.fields = t.fields.concat(startCounts);
- t.fields = t.fields.concat(idDeltas);
- t.fields = t.fields.concat(idRangeOffsets);
- t.fields = t.fields.concat(glyphIds);
-
- t.length = 14 + // Subtable header
- endCounts.length * 2 +
- 2 + // reservedPad
- startCounts.length * 2 +
- idDeltas.length * 2 +
- idRangeOffsets.length * 2 +
- glyphIds.length * 2;
-
- return t;
-}
+ return results;
+};
-exports.parse = parseCmapTable;
-exports.make = makeCmapTable;
+module.exports = p5.Color;
-},{"../check":10,"../parse":19,"../table":22}],25:[function(_dereq_,module,exports){
-// The `fvar` table stores font variation axes and instances.
-// https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6fvar.html
+},{"../core/constants":19,"../core/main":25,"./color_conversion":15}],18:[function(_dereq_,module,exports){
+/**
+ * @module Color
+ * @submodule Setting
+ * @for p5
+ * @requires core
+ * @requires constants
+ */
'use strict';
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-function addName(name, names) {
- var nameString = JSON.stringify(name);
- var nameID = 256;
- for (var nameKey in names) {
- var n = parseInt(nameKey);
- if (!n || n < 256) {
- continue;
- }
-
- if (JSON.stringify(names[nameKey]) === nameString) {
- return n;
- }
-
- if (nameID <= n) {
- nameID = n + 1;
- }
- }
-
- names[nameID] = name;
- return nameID;
-}
-
-function makeFvarAxis(n, axis, names) {
- var nameID = addName(axis.name, names);
- return [
- {name: 'tag_' + n, type: 'TAG', value: axis.tag},
- {name: 'minValue_' + n, type: 'FIXED', value: axis.minValue << 16},
- {name: 'defaultValue_' + n, type: 'FIXED', value: axis.defaultValue << 16},
- {name: 'maxValue_' + n, type: 'FIXED', value: axis.maxValue << 16},
- {name: 'flags_' + n, type: 'USHORT', value: 0},
- {name: 'nameID_' + n, type: 'USHORT', value: nameID}
- ];
-}
-
-function parseFvarAxis(data, start, names) {
- var axis = {};
- var p = new parse.Parser(data, start);
- axis.tag = p.parseTag();
- axis.minValue = p.parseFixed();
- axis.defaultValue = p.parseFixed();
- axis.maxValue = p.parseFixed();
- p.skip('uShort', 1); // reserved for flags; no values defined
- axis.name = names[p.parseUShort()] || {};
- return axis;
-}
-
-function makeFvarInstance(n, inst, axes, names) {
- var nameID = addName(inst.name, names);
- var fields = [
- {name: 'nameID_' + n, type: 'USHORT', value: nameID},
- {name: 'flags_' + n, type: 'USHORT', value: 0}
- ];
-
- for (var i = 0; i < axes.length; ++i) {
- var axisTag = axes[i].tag;
- fields.push({
- name: 'axis_' + n + ' ' + axisTag,
- type: 'FIXED',
- value: inst.coordinates[axisTag] << 16
- });
- }
-
- return fields;
-}
-
-function parseFvarInstance(data, start, axes, names) {
- var inst = {};
- var p = new parse.Parser(data, start);
- inst.name = names[p.parseUShort()] || {};
- p.skip('uShort', 1); // reserved for flags; no values defined
-
- inst.coordinates = {};
- for (var i = 0; i < axes.length; ++i) {
- inst.coordinates[axes[i].tag] = p.parseFixed();
- }
-
- return inst;
-}
-
-function makeFvarTable(fvar, names) {
- var result = new table.Table('fvar', [
- {name: 'version', type: 'ULONG', value: 0x10000},
- {name: 'offsetToData', type: 'USHORT', value: 0},
- {name: 'countSizePairs', type: 'USHORT', value: 2},
- {name: 'axisCount', type: 'USHORT', value: fvar.axes.length},
- {name: 'axisSize', type: 'USHORT', value: 20},
- {name: 'instanceCount', type: 'USHORT', value: fvar.instances.length},
- {name: 'instanceSize', type: 'USHORT', value: 4 + fvar.axes.length * 4}
- ]);
- result.offsetToData = result.sizeOf();
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
+_dereq_('./p5.Color');
- for (var i = 0; i < fvar.axes.length; i++) {
- result.fields = result.fields.concat(makeFvarAxis(i, fvar.axes[i], names));
- }
+/**
+ * The background() function sets the color used for the background of the
+ * p5.js canvas. The default background is light gray. This function is
+ * typically used within draw() to clear the display window at the beginning
+ * of each frame, but it can be used inside setup() to set the background on
+ * the first frame of animation or if the background need only be set once.
+ *
+ * The color is either specified in terms of the RGB, HSB, or HSL color
+ * depending on the current colorMode. (The default color space is RGB, with
+ * each value in the range from 0 to 255). The alpha range by default is also 0 to 255.
+ *
+ * If a single string argument is provided, RGB, RGBA and Hex CSS color strings
+ * and all named color strings are supported. In this case, an alpha number
+ * value as a second argument is not supported, the RGBA form should be used.
+ *
+ * A p5.Color object can also be provided to set the background color.
+ *
+ * A p5.Image can also be provided to set the background image.
+ *
+ * @method background
+ * @param {p5.Color} color any value created by the color() function
+ * @chainable
+ *
+ * @example
+ *
+ *
+ * // Grayscale integer value
+ * background(51);
+ *
+ *
+ *
+ *
+ *
+ * // R, G & B integer values
+ * background(255, 204, 0);
+ *
+ *
+ *
+ *
+ *
+ * // H, S & B integer values
+ * colorMode(HSB);
+ * background(255, 204, 100);
+ *
+ *
+ *
+ *
+ *
+ * // Named SVG/CSS color string
+ * background('red');
+ *
+ *
+ *
+ *
+ *
+ * // three-digit hexadecimal RGB notation
+ * background('#fae');
+ *
+ *
+ *
+ *
+ *
+ * // six-digit hexadecimal RGB notation
+ * background('#222222');
+ *
+ *
+ *
+ *
+ *
+ * // integer RGB notation
+ * background('rgb(0,255,0)');
+ *
+ *
+ *
+ *
+ *
+ * // integer RGBA notation
+ * background('rgba(0,255,0, 0.25)');
+ *
+ *
+ *
+ *
+ *
+ * // percentage RGB notation
+ * background('rgb(100%,0%,10%)');
+ *
+ *
+ *
+ *
+ *
+ * // percentage RGBA notation
+ * background('rgba(100%,0%,100%,0.5)');
+ *
+ *
+ *
+ *
+ *
+ * // p5 Color object
+ * background(color(0, 0, 255));
+ *
+ *
+ *
+ * @alt
+ * canvas with darkest charcoal grey background.
+ * canvas with yellow background.
+ * canvas with royal blue background.
+ * canvas with red background.
+ * canvas with pink background.
+ * canvas with black background.
+ * canvas with bright green background.
+ * canvas with soft green background.
+ * canvas with red background.
+ * canvas with light purple background.
+ * canvas with blue background.
+ */
- for (var j = 0; j < fvar.instances.length; j++) {
- result.fields = result.fields.concat(makeFvarInstance(j, fvar.instances[j], fvar.axes, names));
- }
+/**
+ * @method background
+ * @param {String} colorstring color string, possible formats include: integer
+ * rgb() or rgba(), percentage rgb() or rgba(),
+ * 3-digit hex, 6-digit hex
+ * @param {Number} [a] opacity of the background relative to current
+ * color range (default is 0-255)
+ * @chainable
+ */
- return result;
-}
+/**
+ * @method background
+ * @param {Number} gray specifies a value between white and black
+ * @param {Number} [a]
+ * @chainable
+ */
-function parseFvarTable(data, start, names) {
- var p = new parse.Parser(data, start);
- var tableVersion = p.parseULong();
- check.argument(tableVersion === 0x00010000, 'Unsupported fvar table version.');
- var offsetToData = p.parseOffset16();
- // Skip countSizePairs.
- p.skip('uShort', 1);
- var axisCount = p.parseUShort();
- var axisSize = p.parseUShort();
- var instanceCount = p.parseUShort();
- var instanceSize = p.parseUShort();
-
- var axes = [];
- for (var i = 0; i < axisCount; i++) {
- axes.push(parseFvarAxis(data, start + offsetToData + i * axisSize, names));
- }
+/**
+ * @method background
+ * @param {Number} v1 red or hue value (depending on the current color
+ * mode)
+ * @param {Number} v2 green or saturation value (depending on the current
+ * color mode)
+ * @param {Number} v3 blue or brightness value (depending on the current
+ * color mode)
+ * @param {Number} [a]
+ * @chainable
+ */
- var instances = [];
- var instanceStart = start + offsetToData + axisCount * axisSize;
- for (var j = 0; j < instanceCount; j++) {
- instances.push(parseFvarInstance(data, instanceStart + j * instanceSize, axes, names));
- }
+/**
+ * @method background
+ * @param {Number[]} values an array containing the red,green,blue &
+ * and alpha components of the color
+ * @chainable
+ */
- return {axes: axes, instances: instances};
-}
+/**
+ * @method background
+ * @param {p5.Image} image image created with loadImage() or createImage(),
+ * to set as background
+ * (must be same size as the sketch window)
+ * @param {Number} [a]
+ * @chainable
+ */
-exports.make = makeFvarTable;
-exports.parse = parseFvarTable;
+p5.prototype.background = function() {
+ if (arguments[0] instanceof p5.Image) {
+ this.image(arguments[0], 0, 0, this.width, this.height);
+ } else {
+ this._renderer.background.apply(this._renderer, arguments);
+ }
+ return this;
+};
-},{"../check":10,"../parse":19,"../table":22}],26:[function(_dereq_,module,exports){
-// The `glyf` table describes the glyphs in TrueType outline format.
-// http://www.microsoft.com/typography/otspec/glyf.htm
+/**
+ * Clears the pixels within a buffer. This function only works on p5.Canvas
+ * objects created with the createCanvas() function; it won't work with the
+ * main display window. Unlike the main graphics context, pixels in
+ * additional graphics areas created with createGraphics() can be entirely
+ * or partially transparent. This function clears everything to make all of
+ * the pixels 100% transparent.
+ *
+ * @method clear
+ * @chainable
+ * @example
+ *
+ *
+ * // Clear the screen on mouse press.
+ * function setup() {
+ * createCanvas(100, 100);
+ * }
+ *
+ * function draw() {
+ * ellipse(mouseX, mouseY, 20, 20);
+ * }
+ *
+ * function mousePressed() {
+ * clear();
+ * }
+ *
+ *
+ *
+ * @alt
+ * 20x20 white ellipses are continually drawn at mouse x and y coordinates.
+ *
+ */
-'use strict';
+p5.prototype.clear = function() {
+ this._renderer.clear();
+ return this;
+};
-var check = _dereq_('../check');
-var glyphset = _dereq_('../glyphset');
-var parse = _dereq_('../parse');
-var path = _dereq_('../path');
-
-// Parse the coordinate data for a glyph.
-function parseGlyphCoordinate(p, flag, previousValue, shortVectorBitMask, sameBitMask) {
- var v;
- if ((flag & shortVectorBitMask) > 0) {
- // The coordinate is 1 byte long.
- v = p.parseByte();
- // The `same` bit is re-used for short values to signify the sign of the value.
- if ((flag & sameBitMask) === 0) {
- v = -v;
- }
+/**
+ * colorMode() changes the way p5.js interprets color data. By default, the
+ * parameters for fill(), stroke(), background(), and color() are defined by
+ * values between 0 and 255 using the RGB color model. This is equivalent to
+ * setting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB
+ * system instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You
+ * can also use HSL.
+ *
+ * Note: existing color objects remember the mode that they were created in,
+ * so you can change modes as you like without affecting their appearance.
+ *
+ *
+ * @method colorMode
+ * @param {Constant} mode either RGB, HSB or HSL, corresponding to
+ * Red/Green/Blue and Hue/Saturation/Brightness
+ * (or Lightness)
+ * @param {Number} [max] range for all values
+ * @chainable
+ *
+ * @example
+ *
+ *
+ * noStroke();
+ * colorMode(RGB, 100);
+ * for (var i = 0; i < 100; i++) {
+ * for (var j = 0; j < 100; j++) {
+ * stroke(i, j, 0);
+ * point(i, j);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ * noStroke();
+ * colorMode(HSB, 100);
+ * for (var i = 0; i < 100; i++) {
+ * for (var j = 0; j < 100; j++) {
+ * stroke(i, j, 100);
+ * point(i, j);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ * colorMode(RGB, 255);
+ * var c = color(127, 255, 0);
+ *
+ * colorMode(RGB, 1);
+ * var myColor = c._getRed();
+ * text(myColor, 10, 10, 80, 80);
+ *
+ *
+ *
+ *
+ *
+ * noFill();
+ * colorMode(RGB, 255, 255, 255, 1);
+ * background(255);
+ *
+ * strokeWeight(4);
+ * stroke(255, 0, 10, 0.3);
+ * ellipse(40, 40, 50, 50);
+ * ellipse(50, 50, 40, 40);
+ *
+ *
+ *
+ * @alt
+ *Green to red gradient from bottom L to top R. shading originates from top left.
+ *Rainbow gradient from left to right. Brightness increasing to white at top.
+ *unknown image.
+ *50x50 ellipse at middle L & 40x40 ellipse at center. Transluscent pink outlines.
+ *
+ */
+/**
+ * @method colorMode
+ * @param {Constant} mode
+ * @param {Number} max1 range for the red or hue depending on the
+ * current color mode
+ * @param {Number} max2 range for the green or saturation depending
+ * on the current color mode
+ * @param {Number} max3 range for the blue or brightness/lighntess
+ * depending on the current color mode
+ * @param {Number} [maxA] range for the alpha
+ * @chainable
+ */
+p5.prototype.colorMode = function(mode, max1, max2, max3, maxA) {
+ p5._validateParameters('colorMode', arguments);
+ if (
+ mode === constants.RGB ||
+ mode === constants.HSB ||
+ mode === constants.HSL
+ ) {
+ // Set color mode.
+ this._colorMode = mode;
- v = previousValue + v;
- } else {
- // The coordinate is 2 bytes long.
- // If the `same` bit is set, the coordinate is the same as the previous coordinate.
- if ((flag & sameBitMask) > 0) {
- v = previousValue;
- } else {
- // Parse the coordinate as a signed 16-bit delta value.
- v = previousValue + p.parseShort();
- }
+ // Set color maxes.
+ var maxes = this._colorMaxes[mode];
+ if (arguments.length === 2) {
+ maxes[0] = max1; // Red
+ maxes[1] = max1; // Green
+ maxes[2] = max1; // Blue
+ maxes[3] = max1; // Alpha
+ } else if (arguments.length === 4) {
+ maxes[0] = max1; // Red
+ maxes[1] = max2; // Green
+ maxes[2] = max3; // Blue
+ } else if (arguments.length === 5) {
+ maxes[0] = max1; // Red
+ maxes[1] = max2; // Green
+ maxes[2] = max3; // Blue
+ maxes[3] = maxA; // Alpha
}
+ }
- return v;
-}
-
-// Parse a TrueType glyph.
-function parseGlyph(glyph, data, start) {
- var p = new parse.Parser(data, start);
- glyph.numberOfContours = p.parseShort();
- glyph._xMin = p.parseShort();
- glyph._yMin = p.parseShort();
- glyph._xMax = p.parseShort();
- glyph._yMax = p.parseShort();
- var flags;
- var flag;
- var i;
-
- if (glyph.numberOfContours > 0) {
- // This glyph is not a composite.
- var endPointIndices = glyph.endPointIndices = [];
- for (i = 0; i < glyph.numberOfContours; i += 1) {
- endPointIndices.push(p.parseUShort());
- }
-
- glyph.instructionLength = p.parseUShort();
- glyph.instructions = [];
- for (i = 0; i < glyph.instructionLength; i += 1) {
- glyph.instructions.push(p.parseByte());
- }
-
- var numberOfCoordinates = endPointIndices[endPointIndices.length - 1] + 1;
- flags = [];
- for (i = 0; i < numberOfCoordinates; i += 1) {
- flag = p.parseByte();
- flags.push(flag);
- // If bit 3 is set, we repeat this flag n times, where n is the next byte.
- if ((flag & 8) > 0) {
- var repeatCount = p.parseByte();
- for (var j = 0; j < repeatCount; j += 1) {
- flags.push(flag);
- i += 1;
- }
- }
- }
-
- check.argument(flags.length === numberOfCoordinates, 'Bad flags.');
-
- if (endPointIndices.length > 0) {
- var points = [];
- var point;
- // X/Y coordinates are relative to the previous point, except for the first point which is relative to 0,0.
- if (numberOfCoordinates > 0) {
- for (i = 0; i < numberOfCoordinates; i += 1) {
- flag = flags[i];
- point = {};
- point.onCurve = !!(flag & 1);
- point.lastPointOfContour = endPointIndices.indexOf(i) >= 0;
- points.push(point);
- }
-
- var px = 0;
- for (i = 0; i < numberOfCoordinates; i += 1) {
- flag = flags[i];
- point = points[i];
- point.x = parseGlyphCoordinate(p, flag, px, 2, 16);
- px = point.x;
- }
-
- var py = 0;
- for (i = 0; i < numberOfCoordinates; i += 1) {
- flag = flags[i];
- point = points[i];
- point.y = parseGlyphCoordinate(p, flag, py, 4, 32);
- py = point.y;
- }
- }
-
- glyph.points = points;
- } else {
- glyph.points = [];
- }
- } else if (glyph.numberOfContours === 0) {
- glyph.points = [];
- } else {
- glyph.isComposite = true;
- glyph.points = [];
- glyph.components = [];
- var moreComponents = true;
- while (moreComponents) {
- flags = p.parseUShort();
- var component = {
- glyphIndex: p.parseUShort(),
- xScale: 1,
- scale01: 0,
- scale10: 0,
- yScale: 1,
- dx: 0,
- dy: 0
- };
- if ((flags & 1) > 0) {
- // The arguments are words
- if ((flags & 2) > 0) {
- // values are offset
- component.dx = p.parseShort();
- component.dy = p.parseShort();
- } else {
- // values are matched points
- component.matchedPoints = [p.parseUShort(), p.parseUShort()];
- }
-
- } else {
- // The arguments are bytes
- if ((flags & 2) > 0) {
- // values are offset
- component.dx = p.parseChar();
- component.dy = p.parseChar();
- } else {
- // values are matched points
- component.matchedPoints = [p.parseByte(), p.parseByte()];
- }
- }
+ return this;
+};
- if ((flags & 8) > 0) {
- // We have a scale
- component.xScale = component.yScale = p.parseF2Dot14();
- } else if ((flags & 64) > 0) {
- // We have an X / Y scale
- component.xScale = p.parseF2Dot14();
- component.yScale = p.parseF2Dot14();
- } else if ((flags & 128) > 0) {
- // We have a 2x2 transformation
- component.xScale = p.parseF2Dot14();
- component.scale01 = p.parseF2Dot14();
- component.scale10 = p.parseF2Dot14();
- component.yScale = p.parseF2Dot14();
- }
-
- glyph.components.push(component);
- moreComponents = !!(flags & 32);
- }
- if (flags & 0x100) {
- // We have instructions
- glyph.instructionLength = p.parseUShort();
- glyph.instructions = [];
- for (i = 0; i < glyph.instructionLength; i += 1) {
- glyph.instructions.push(p.parseByte());
- }
- }
- }
-}
-
-// Transform an array of points and return a new array.
-function transformPoints(points, transform) {
- var newPoints = [];
- for (var i = 0; i < points.length; i += 1) {
- var pt = points[i];
- var newPt = {
- x: transform.xScale * pt.x + transform.scale01 * pt.y + transform.dx,
- y: transform.scale10 * pt.x + transform.yScale * pt.y + transform.dy,
- onCurve: pt.onCurve,
- lastPointOfContour: pt.lastPointOfContour
- };
- newPoints.push(newPt);
- }
-
- return newPoints;
-}
-
-function getContours(points) {
- var contours = [];
- var currentContour = [];
- for (var i = 0; i < points.length; i += 1) {
- var pt = points[i];
- currentContour.push(pt);
- if (pt.lastPointOfContour) {
- contours.push(currentContour);
- currentContour = [];
- }
- }
-
- check.argument(currentContour.length === 0, 'There are still points left in the current contour.');
- return contours;
-}
-
-// Convert the TrueType glyph outline to a Path.
-function getPath(points) {
- var p = new path.Path();
- if (!points) {
- return p;
- }
-
- var contours = getContours(points);
-
- for (var contourIndex = 0; contourIndex < contours.length; ++contourIndex) {
- var contour = contours[contourIndex];
-
- var prev = null;
- var curr = contour[contour.length - 1];
- var next = contour[0];
-
- if (curr.onCurve) {
- p.moveTo(curr.x, curr.y);
- } else {
- if (next.onCurve) {
- p.moveTo(next.x, next.y);
- } else {
- // If both first and last points are off-curve, start at their middle.
- var start = { x: (curr.x + next.x) * 0.5, y: (curr.y + next.y) * 0.5 };
- p.moveTo(start.x, start.y);
- }
- }
-
- for (var i = 0; i < contour.length; ++i) {
- prev = curr;
- curr = next;
- next = contour[(i + 1) % contour.length];
-
- if (curr.onCurve) {
- // This is a straight line.
- p.lineTo(curr.x, curr.y);
- } else {
- var prev2 = prev;
- var next2 = next;
-
- if (!prev.onCurve) {
- prev2 = { x: (curr.x + prev.x) * 0.5, y: (curr.y + prev.y) * 0.5 };
- p.lineTo(prev2.x, prev2.y);
- }
-
- if (!next.onCurve) {
- next2 = { x: (curr.x + next.x) * 0.5, y: (curr.y + next.y) * 0.5 };
- }
-
- p.lineTo(prev2.x, prev2.y);
- p.quadraticCurveTo(curr.x, curr.y, next2.x, next2.y);
- }
- }
- }
-
- p.closePath();
- return p;
-}
-
-function buildPath(glyphs, glyph) {
- if (glyph.isComposite) {
- for (var j = 0; j < glyph.components.length; j += 1) {
- var component = glyph.components[j];
- var componentGlyph = glyphs.get(component.glyphIndex);
- // Force the ttfGlyphLoader to parse the glyph.
- componentGlyph.getPath();
- if (componentGlyph.points) {
- var transformedPoints;
- if (component.matchedPoints === undefined) {
- // component positioned by offset
- transformedPoints = transformPoints(componentGlyph.points, component);
- } else {
- // component positioned by matched points
- if ((component.matchedPoints[0] > glyph.points.length - 1) ||
- (component.matchedPoints[1] > componentGlyph.points.length - 1)) {
- throw Error('Matched points out of range in ' + glyph.name);
- }
- var firstPt = glyph.points[component.matchedPoints[0]];
- var secondPt = componentGlyph.points[component.matchedPoints[1]];
- var transform = {
- xScale: component.xScale, scale01: component.scale01,
- scale10: component.scale10, yScale: component.yScale,
- dx: 0, dy: 0
- };
- secondPt = transformPoints([secondPt], transform)[0];
- transform.dx = firstPt.x - secondPt.x;
- transform.dy = firstPt.y - secondPt.y;
- transformedPoints = transformPoints(componentGlyph.points, transform);
- }
- glyph.points = glyph.points.concat(transformedPoints);
- }
- }
- }
-
- return getPath(glyph.points);
-}
-
-// Parse all the glyphs according to the offsets from the `loca` table.
-function parseGlyfTable(data, start, loca, font) {
- var glyphs = new glyphset.GlyphSet(font);
- var i;
-
- // The last element of the loca table is invalid.
- for (i = 0; i < loca.length - 1; i += 1) {
- var offset = loca[i];
- var nextOffset = loca[i + 1];
- if (offset !== nextOffset) {
- glyphs.push(i, glyphset.ttfGlyphLoader(font, i, parseGlyph, data, start + offset, buildPath));
- } else {
- glyphs.push(i, glyphset.glyphLoader(font, i));
- }
- }
-
- return glyphs;
-}
-
-exports.getPath = getPath;
-
-exports.parse = parseGlyfTable;
-
-},{"../check":10,"../glyphset":15,"../parse":19,"../path":20}],27:[function(_dereq_,module,exports){
-// The `GPOS` table contains kerning pairs, among other things.
-// https://www.microsoft.com/typography/OTSPEC/gpos.htm
-
-'use strict';
-
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-
-// Parse ScriptList and FeatureList tables of GPOS, GSUB, GDEF, BASE, JSTF tables.
-// These lists are unused by now, this function is just the basis for a real parsing.
-function parseTaggedListTable(data, start) {
- var p = new parse.Parser(data, start);
- var n = p.parseUShort();
- var list = [];
- for (var i = 0; i < n; i++) {
- list[p.parseTag()] = { offset: p.parseUShort() };
- }
-
- return list;
-}
-
-// Parse a coverage table in a GSUB, GPOS or GDEF table.
-// Format 1 is a simple list of glyph ids,
-// Format 2 is a list of ranges. It is expanded in a list of glyphs, maybe not the best idea.
-function parseCoverageTable(data, start) {
- var p = new parse.Parser(data, start);
- var format = p.parseUShort();
- var count = p.parseUShort();
- if (format === 1) {
- return p.parseUShortList(count);
- } else if (format === 2) {
- var coverage = [];
- for (; count--;) {
- var begin = p.parseUShort();
- var end = p.parseUShort();
- var index = p.parseUShort();
- for (var i = begin; i <= end; i++) {
- coverage[index++] = i;
- }
- }
-
- return coverage;
- }
-}
-
-// Parse a Class Definition Table in a GSUB, GPOS or GDEF table.
-// Returns a function that gets a class value from a glyph ID.
-function parseClassDefTable(data, start) {
- var p = new parse.Parser(data, start);
- var format = p.parseUShort();
- if (format === 1) {
- // Format 1 specifies a range of consecutive glyph indices, one class per glyph ID.
- var startGlyph = p.parseUShort();
- var glyphCount = p.parseUShort();
- var classes = p.parseUShortList(glyphCount);
- return function(glyphID) {
- return classes[glyphID - startGlyph] || 0;
- };
- } else if (format === 2) {
- // Format 2 defines multiple groups of glyph indices that belong to the same class.
- var rangeCount = p.parseUShort();
- var startGlyphs = [];
- var endGlyphs = [];
- var classValues = [];
- for (var i = 0; i < rangeCount; i++) {
- startGlyphs[i] = p.parseUShort();
- endGlyphs[i] = p.parseUShort();
- classValues[i] = p.parseUShort();
- }
-
- return function(glyphID) {
- var l = 0;
- var r = startGlyphs.length - 1;
- while (l < r) {
- var c = (l + r + 1) >> 1;
- if (glyphID < startGlyphs[c]) {
- r = c - 1;
- } else {
- l = c;
- }
- }
-
- if (startGlyphs[l] <= glyphID && glyphID <= endGlyphs[l]) {
- return classValues[l] || 0;
- }
-
- return 0;
- };
- }
-}
-
-// Parse a pair adjustment positioning subtable, format 1 or format 2
-// The subtable is returned in the form of a lookup function.
-function parsePairPosSubTable(data, start) {
- var p = new parse.Parser(data, start);
- // This part is common to format 1 and format 2 subtables
- var format = p.parseUShort();
- var coverageOffset = p.parseUShort();
- var coverage = parseCoverageTable(data, start + coverageOffset);
- // valueFormat 4: XAdvance only, 1: XPlacement only, 0: no ValueRecord for second glyph
- // Only valueFormat1=4 and valueFormat2=0 is supported.
- var valueFormat1 = p.parseUShort();
- var valueFormat2 = p.parseUShort();
- var value1;
- var value2;
- if (valueFormat1 !== 4 || valueFormat2 !== 0) return;
- var sharedPairSets = {};
- if (format === 1) {
- // Pair Positioning Adjustment: Format 1
- var pairSetCount = p.parseUShort();
- var pairSet = [];
- // Array of offsets to PairSet tables-from beginning of PairPos subtable-ordered by Coverage Index
- var pairSetOffsets = p.parseOffset16List(pairSetCount);
- for (var firstGlyph = 0; firstGlyph < pairSetCount; firstGlyph++) {
- var pairSetOffset = pairSetOffsets[firstGlyph];
- var sharedPairSet = sharedPairSets[pairSetOffset];
- if (!sharedPairSet) {
- // Parse a pairset table in a pair adjustment subtable format 1
- sharedPairSet = {};
- p.relativeOffset = pairSetOffset;
- var pairValueCount = p.parseUShort();
- for (; pairValueCount--;) {
- var secondGlyph = p.parseUShort();
- if (valueFormat1) value1 = p.parseShort();
- if (valueFormat2) value2 = p.parseShort();
- // We only support valueFormat1 = 4 and valueFormat2 = 0,
- // so value1 is the XAdvance and value2 is empty.
- sharedPairSet[secondGlyph] = value1;
- }
- }
-
- pairSet[coverage[firstGlyph]] = sharedPairSet;
- }
-
- return function(leftGlyph, rightGlyph) {
- var pairs = pairSet[leftGlyph];
- if (pairs) return pairs[rightGlyph];
- };
- } else if (format === 2) {
- // Pair Positioning Adjustment: Format 2
- var classDef1Offset = p.parseUShort();
- var classDef2Offset = p.parseUShort();
- var class1Count = p.parseUShort();
- var class2Count = p.parseUShort();
- var getClass1 = parseClassDefTable(data, start + classDef1Offset);
- var getClass2 = parseClassDefTable(data, start + classDef2Offset);
-
- // Parse kerning values by class pair.
- var kerningMatrix = [];
- for (var i = 0; i < class1Count; i++) {
- var kerningRow = kerningMatrix[i] = [];
- for (var j = 0; j < class2Count; j++) {
- if (valueFormat1) value1 = p.parseShort();
- if (valueFormat2) value2 = p.parseShort();
- // We only support valueFormat1 = 4 and valueFormat2 = 0,
- // so value1 is the XAdvance and value2 is empty.
- kerningRow[j] = value1;
- }
- }
-
- // Convert coverage list to a hash
- var covered = {};
- for (i = 0; i < coverage.length; i++) covered[coverage[i]] = 1;
-
- // Get the kerning value for a specific glyph pair.
- return function(leftGlyph, rightGlyph) {
- if (!covered[leftGlyph]) return;
- var class1 = getClass1(leftGlyph);
- var class2 = getClass2(rightGlyph);
- var kerningRow = kerningMatrix[class1];
-
- if (kerningRow) {
- return kerningRow[class2];
- }
- };
- }
-}
-
-// Parse a LookupTable (present in of GPOS, GSUB, GDEF, BASE, JSTF tables).
-function parseLookupTable(data, start) {
- var p = new parse.Parser(data, start);
- var lookupType = p.parseUShort();
- var lookupFlag = p.parseUShort();
- var useMarkFilteringSet = lookupFlag & 0x10;
- var subTableCount = p.parseUShort();
- var subTableOffsets = p.parseOffset16List(subTableCount);
- var table = {
- lookupType: lookupType,
- lookupFlag: lookupFlag,
- markFilteringSet: useMarkFilteringSet ? p.parseUShort() : -1
- };
- // LookupType 2, Pair adjustment
- if (lookupType === 2) {
- var subtables = [];
- for (var i = 0; i < subTableCount; i++) {
- var pairPosSubTable = parsePairPosSubTable(data, start + subTableOffsets[i]);
- if (pairPosSubTable) subtables.push(pairPosSubTable);
- }
- // Return a function which finds the kerning values in the subtables.
- table.getKerningValue = function(leftGlyph, rightGlyph) {
- for (var i = subtables.length; i--;) {
- var value = subtables[i](leftGlyph, rightGlyph);
- if (value !== undefined) return value;
- }
-
- return 0;
- };
- }
-
- return table;
-}
-
-// Parse the `GPOS` table which contains, among other things, kerning pairs.
-// https://www.microsoft.com/typography/OTSPEC/gpos.htm
-function parseGposTable(data, start, font) {
- var p = new parse.Parser(data, start);
- var tableVersion = p.parseFixed();
- check.argument(tableVersion === 1, 'Unsupported GPOS table version.');
-
- // ScriptList and FeatureList - ignored for now
- parseTaggedListTable(data, start + p.parseUShort());
- // 'kern' is the feature we are looking for.
- parseTaggedListTable(data, start + p.parseUShort());
-
- // LookupList
- var lookupListOffset = p.parseUShort();
- p.relativeOffset = lookupListOffset;
- var lookupCount = p.parseUShort();
- var lookupTableOffsets = p.parseOffset16List(lookupCount);
- var lookupListAbsoluteOffset = start + lookupListOffset;
- for (var i = 0; i < lookupCount; i++) {
- var table = parseLookupTable(data, lookupListAbsoluteOffset + lookupTableOffsets[i]);
- if (table.lookupType === 2 && !font.getGposKerningValue) font.getGposKerningValue = table.getKerningValue;
- }
-}
-
-exports.parse = parseGposTable;
-
-},{"../check":10,"../parse":19}],28:[function(_dereq_,module,exports){
-// The `GSUB` table contains ligatures, among other things.
-// https://www.microsoft.com/typography/OTSPEC/gsub.htm
-
-'use strict';
-
-var check = _dereq_('../check');
-var Parser = _dereq_('../parse').Parser;
-var subtableParsers = new Array(9); // subtableParsers[0] is unused
-var table = _dereq_('../table');
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#SS
-subtableParsers[1] = function parseLookup1() {
- var start = this.offset + this.relativeOffset;
- var substFormat = this.parseUShort();
- if (substFormat === 1) {
- return {
- substFormat: 1,
- coverage: this.parsePointer(Parser.coverage),
- deltaGlyphId: this.parseUShort()
- };
- } else if (substFormat === 2) {
- return {
- substFormat: 2,
- coverage: this.parsePointer(Parser.coverage),
- substitute: this.parseOffset16List()
- };
- }
- check.assert(false, '0x' + start.toString(16) + ': lookup type 1 format must be 1 or 2.');
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#MS
-subtableParsers[2] = function parseLookup2() {
- var substFormat = this.parseUShort();
- check.argument(substFormat === 1, 'GSUB Multiple Substitution Subtable identifier-format must be 1');
- return {
- substFormat: substFormat,
- coverage: this.parsePointer(Parser.coverage),
- sequences: this.parseListOfLists()
- };
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#AS
-subtableParsers[3] = function parseLookup3() {
- var substFormat = this.parseUShort();
- check.argument(substFormat === 1, 'GSUB Alternate Substitution Subtable identifier-format must be 1');
- return {
- substFormat: substFormat,
- coverage: this.parsePointer(Parser.coverage),
- alternateSets: this.parseListOfLists()
- };
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#LS
-subtableParsers[4] = function parseLookup4() {
- var substFormat = this.parseUShort();
- check.argument(substFormat === 1, 'GSUB ligature table identifier-format must be 1');
- return {
- substFormat: substFormat,
- coverage: this.parsePointer(Parser.coverage),
- ligatureSets: this.parseListOfLists(function() {
- return {
- ligGlyph: this.parseUShort(),
- components: this.parseUShortList(this.parseUShort() - 1)
- };
- })
- };
-};
-
-var lookupRecordDesc = {
- sequenceIndex: Parser.uShort,
- lookupListIndex: Parser.uShort
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#CSF
-subtableParsers[5] = function parseLookup5() {
- var start = this.offset + this.relativeOffset;
- var substFormat = this.parseUShort();
-
- if (substFormat === 1) {
- return {
- substFormat: substFormat,
- coverage: this.parsePointer(Parser.coverage),
- ruleSets: this.parseListOfLists(function() {
- var glyphCount = this.parseUShort();
- var substCount = this.parseUShort();
- return {
- input: this.parseUShortList(glyphCount - 1),
- lookupRecords: this.parseRecordList(substCount, lookupRecordDesc)
- };
- })
- };
- } else if (substFormat === 2) {
- return {
- substFormat: substFormat,
- coverage: this.parsePointer(Parser.coverage),
- classDef: this.parsePointer(Parser.classDef),
- classSets: this.parseListOfLists(function() {
- var glyphCount = this.parseUShort();
- var substCount = this.parseUShort();
- return {
- classes: this.parseUShortList(glyphCount - 1),
- lookupRecords: this.parseRecordList(substCount, lookupRecordDesc)
- };
- })
- };
- } else if (substFormat === 3) {
- var glyphCount = this.parseUShort();
- var substCount = this.parseUShort();
- return {
- substFormat: substFormat,
- coverages: this.parseList(glyphCount, Parser.pointer(Parser.coverage)),
- lookupRecords: this.parseRecordList(substCount, lookupRecordDesc)
- };
- }
- check.assert(false, '0x' + start.toString(16) + ': lookup type 5 format must be 1, 2 or 3.');
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#CC
-subtableParsers[6] = function parseLookup6() {
- var start = this.offset + this.relativeOffset;
- var substFormat = this.parseUShort();
- if (substFormat === 1) {
- return {
- substFormat: 1,
- coverage: this.parsePointer(Parser.coverage),
- chainRuleSets: this.parseListOfLists(function() {
- return {
- backtrack: this.parseUShortList(),
- input: this.parseUShortList(this.parseShort() - 1),
- lookahead: this.parseUShortList(),
- lookupRecords: this.parseRecordList(lookupRecordDesc)
- };
- })
- };
- } else if (substFormat === 2) {
- return {
- substFormat: 2,
- coverage: this.parsePointer(Parser.coverage),
- backtrackClassDef: this.parsePointer(Parser.classDef),
- inputClassDef: this.parsePointer(Parser.classDef),
- lookaheadClassDef: this.parsePointer(Parser.classDef),
- chainClassSet: this.parseListOfLists(function() {
- return {
- backtrack: this.parseUShortList(),
- input: this.parseUShortList(this.parseShort() - 1),
- lookahead: this.parseUShortList(),
- lookupRecords: this.parseRecordList(lookupRecordDesc)
- };
- })
- };
- } else if (substFormat === 3) {
- return {
- substFormat: 3,
- backtrackCoverage: this.parseList(Parser.pointer(Parser.coverage)),
- inputCoverage: this.parseList(Parser.pointer(Parser.coverage)),
- lookaheadCoverage: this.parseList(Parser.pointer(Parser.coverage)),
- lookupRecords: this.parseRecordList(lookupRecordDesc)
- };
- }
- check.assert(false, '0x' + start.toString(16) + ': lookup type 6 format must be 1, 2 or 3.');
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#ES
-subtableParsers[7] = function parseLookup7() {
- // Extension Substitution subtable
- var substFormat = this.parseUShort();
- check.argument(substFormat === 1, 'GSUB Extension Substitution subtable identifier-format must be 1');
- var extensionLookupType = this.parseUShort();
- var extensionParser = new Parser(this.data, this.offset + this.parseULong());
- return {
- substFormat: 1,
- lookupType: extensionLookupType,
- extension: subtableParsers[extensionLookupType].call(extensionParser)
- };
-};
-
-// https://www.microsoft.com/typography/OTSPEC/GSUB.htm#RCCS
-subtableParsers[8] = function parseLookup8() {
- var substFormat = this.parseUShort();
- check.argument(substFormat === 1, 'GSUB Reverse Chaining Contextual Single Substitution Subtable identifier-format must be 1');
- return {
- substFormat: substFormat,
- coverage: this.parsePointer(Parser.coverage),
- backtrackCoverage: this.parseList(Parser.pointer(Parser.coverage)),
- lookaheadCoverage: this.parseList(Parser.pointer(Parser.coverage)),
- substitutes: this.parseUShortList()
- };
-};
-
-// https://www.microsoft.com/typography/OTSPEC/gsub.htm
-function parseGsubTable(data, start) {
- start = start || 0;
- var p = new Parser(data, start);
- var tableVersion = p.parseVersion();
- check.argument(tableVersion === 1, 'Unsupported GSUB table version.');
- return {
- version: tableVersion,
- scripts: p.parseScriptList(),
- features: p.parseFeatureList(),
- lookups: p.parseLookupList(subtableParsers)
- };
-}
-
-// GSUB Writing //////////////////////////////////////////////
-var subtableMakers = new Array(9);
-
-subtableMakers[1] = function makeLookup1(subtable) {
- if (subtable.substFormat === 1) {
- return new table.Table('substitutionTable', [
- {name: 'substFormat', type: 'USHORT', value: 1},
- {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)},
- {name: 'deltaGlyphID', type: 'USHORT', value: subtable.deltaGlyphId}
- ]);
- } else {
- return new table.Table('substitutionTable', [
- {name: 'substFormat', type: 'USHORT', value: 2},
- {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}
- ].concat(table.ushortList('substitute', subtable.substitute)));
- }
- check.fail('Lookup type 1 substFormat must be 1 or 2.');
-};
-
-subtableMakers[3] = function makeLookup3(subtable) {
- check.assert(subtable.substFormat === 1, 'Lookup type 3 substFormat must be 1.');
- return new table.Table('substitutionTable', [
- {name: 'substFormat', type: 'USHORT', value: 1},
- {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}
- ].concat(table.tableList('altSet', subtable.alternateSets, function(alternateSet) {
- return new table.Table('alternateSetTable', table.ushortList('alternate', alternateSet));
- })));
-};
-
-subtableMakers[4] = function makeLookup4(subtable) {
- check.assert(subtable.substFormat === 1, 'Lookup type 4 substFormat must be 1.');
- return new table.Table('substitutionTable', [
- {name: 'substFormat', type: 'USHORT', value: 1},
- {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}
- ].concat(table.tableList('ligSet', subtable.ligatureSets, function(ligatureSet) {
- return new table.Table('ligatureSetTable', table.tableList('ligature', ligatureSet, function(ligature) {
- return new table.Table('ligatureTable',
- [{name: 'ligGlyph', type: 'USHORT', value: ligature.ligGlyph}]
- .concat(table.ushortList('component', ligature.components, ligature.components.length + 1))
- );
- }));
- })));
-};
-
-function makeGsubTable(gsub) {
- return new table.Table('GSUB', [
- {name: 'version', type: 'ULONG', value: 0x10000},
- {name: 'scripts', type: 'TABLE', value: new table.ScriptList(gsub.scripts)},
- {name: 'features', type: 'TABLE', value: new table.FeatureList(gsub.features)},
- {name: 'lookups', type: 'TABLE', value: new table.LookupList(gsub.lookups, subtableMakers)}
- ]);
-}
-
-exports.parse = parseGsubTable;
-exports.make = makeGsubTable;
-
-},{"../check":10,"../parse":19,"../table":22}],29:[function(_dereq_,module,exports){
-// The `head` table contains global information about the font.
-// https://www.microsoft.com/typography/OTSPEC/head.htm
-
-'use strict';
-
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// Parse the header `head` table
-function parseHeadTable(data, start) {
- var head = {};
- var p = new parse.Parser(data, start);
- head.version = p.parseVersion();
- head.fontRevision = Math.round(p.parseFixed() * 1000) / 1000;
- head.checkSumAdjustment = p.parseULong();
- head.magicNumber = p.parseULong();
- check.argument(head.magicNumber === 0x5F0F3CF5, 'Font header has wrong magic number.');
- head.flags = p.parseUShort();
- head.unitsPerEm = p.parseUShort();
- head.created = p.parseLongDateTime();
- head.modified = p.parseLongDateTime();
- head.xMin = p.parseShort();
- head.yMin = p.parseShort();
- head.xMax = p.parseShort();
- head.yMax = p.parseShort();
- head.macStyle = p.parseUShort();
- head.lowestRecPPEM = p.parseUShort();
- head.fontDirectionHint = p.parseShort();
- head.indexToLocFormat = p.parseShort();
- head.glyphDataFormat = p.parseShort();
- return head;
-}
-
-function makeHeadTable(options) {
- // Apple Mac timestamp epoch is 01/01/1904 not 01/01/1970
- var timestamp = Math.round(new Date().getTime() / 1000) + 2082844800;
- var createdTimestamp = timestamp;
-
- if (options.createdTimestamp) {
- createdTimestamp = options.createdTimestamp + 2082844800;
- }
-
- return new table.Table('head', [
- {name: 'version', type: 'FIXED', value: 0x00010000},
- {name: 'fontRevision', type: 'FIXED', value: 0x00010000},
- {name: 'checkSumAdjustment', type: 'ULONG', value: 0},
- {name: 'magicNumber', type: 'ULONG', value: 0x5F0F3CF5},
- {name: 'flags', type: 'USHORT', value: 0},
- {name: 'unitsPerEm', type: 'USHORT', value: 1000},
- {name: 'created', type: 'LONGDATETIME', value: createdTimestamp},
- {name: 'modified', type: 'LONGDATETIME', value: timestamp},
- {name: 'xMin', type: 'SHORT', value: 0},
- {name: 'yMin', type: 'SHORT', value: 0},
- {name: 'xMax', type: 'SHORT', value: 0},
- {name: 'yMax', type: 'SHORT', value: 0},
- {name: 'macStyle', type: 'USHORT', value: 0},
- {name: 'lowestRecPPEM', type: 'USHORT', value: 0},
- {name: 'fontDirectionHint', type: 'SHORT', value: 2},
- {name: 'indexToLocFormat', type: 'SHORT', value: 0},
- {name: 'glyphDataFormat', type: 'SHORT', value: 0}
- ], options);
-}
-
-exports.parse = parseHeadTable;
-exports.make = makeHeadTable;
-
-},{"../check":10,"../parse":19,"../table":22}],30:[function(_dereq_,module,exports){
-// The `hhea` table contains information for horizontal layout.
-// https://www.microsoft.com/typography/OTSPEC/hhea.htm
-
-'use strict';
-
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// Parse the horizontal header `hhea` table
-function parseHheaTable(data, start) {
- var hhea = {};
- var p = new parse.Parser(data, start);
- hhea.version = p.parseVersion();
- hhea.ascender = p.parseShort();
- hhea.descender = p.parseShort();
- hhea.lineGap = p.parseShort();
- hhea.advanceWidthMax = p.parseUShort();
- hhea.minLeftSideBearing = p.parseShort();
- hhea.minRightSideBearing = p.parseShort();
- hhea.xMaxExtent = p.parseShort();
- hhea.caretSlopeRise = p.parseShort();
- hhea.caretSlopeRun = p.parseShort();
- hhea.caretOffset = p.parseShort();
- p.relativeOffset += 8;
- hhea.metricDataFormat = p.parseShort();
- hhea.numberOfHMetrics = p.parseUShort();
- return hhea;
-}
-
-function makeHheaTable(options) {
- return new table.Table('hhea', [
- {name: 'version', type: 'FIXED', value: 0x00010000},
- {name: 'ascender', type: 'FWORD', value: 0},
- {name: 'descender', type: 'FWORD', value: 0},
- {name: 'lineGap', type: 'FWORD', value: 0},
- {name: 'advanceWidthMax', type: 'UFWORD', value: 0},
- {name: 'minLeftSideBearing', type: 'FWORD', value: 0},
- {name: 'minRightSideBearing', type: 'FWORD', value: 0},
- {name: 'xMaxExtent', type: 'FWORD', value: 0},
- {name: 'caretSlopeRise', type: 'SHORT', value: 1},
- {name: 'caretSlopeRun', type: 'SHORT', value: 0},
- {name: 'caretOffset', type: 'SHORT', value: 0},
- {name: 'reserved1', type: 'SHORT', value: 0},
- {name: 'reserved2', type: 'SHORT', value: 0},
- {name: 'reserved3', type: 'SHORT', value: 0},
- {name: 'reserved4', type: 'SHORT', value: 0},
- {name: 'metricDataFormat', type: 'SHORT', value: 0},
- {name: 'numberOfHMetrics', type: 'USHORT', value: 0}
- ], options);
-}
-
-exports.parse = parseHheaTable;
-exports.make = makeHheaTable;
-
-},{"../parse":19,"../table":22}],31:[function(_dereq_,module,exports){
-// The `hmtx` table contains the horizontal metrics for all glyphs.
-// https://www.microsoft.com/typography/OTSPEC/hmtx.htm
-
-'use strict';
-
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// Parse the `hmtx` table, which contains the horizontal metrics for all glyphs.
-// This function augments the glyph array, adding the advanceWidth and leftSideBearing to each glyph.
-function parseHmtxTable(data, start, numMetrics, numGlyphs, glyphs) {
- var advanceWidth;
- var leftSideBearing;
- var p = new parse.Parser(data, start);
- for (var i = 0; i < numGlyphs; i += 1) {
- // If the font is monospaced, only one entry is needed. This last entry applies to all subsequent glyphs.
- if (i < numMetrics) {
- advanceWidth = p.parseUShort();
- leftSideBearing = p.parseShort();
- }
-
- var glyph = glyphs.get(i);
- glyph.advanceWidth = advanceWidth;
- glyph.leftSideBearing = leftSideBearing;
- }
-}
-
-function makeHmtxTable(glyphs) {
- var t = new table.Table('hmtx', []);
- for (var i = 0; i < glyphs.length; i += 1) {
- var glyph = glyphs.get(i);
- var advanceWidth = glyph.advanceWidth || 0;
- var leftSideBearing = glyph.leftSideBearing || 0;
- t.fields.push({name: 'advanceWidth_' + i, type: 'USHORT', value: advanceWidth});
- t.fields.push({name: 'leftSideBearing_' + i, type: 'SHORT', value: leftSideBearing});
- }
-
- return t;
-}
-
-exports.parse = parseHmtxTable;
-exports.make = makeHmtxTable;
-
-},{"../parse":19,"../table":22}],32:[function(_dereq_,module,exports){
-// The `kern` table contains kerning pairs.
-// Note that some fonts use the GPOS OpenType layout table to specify kerning.
-// https://www.microsoft.com/typography/OTSPEC/kern.htm
-
-'use strict';
-
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-
-function parseWindowsKernTable(p) {
- var pairs = {};
- // Skip nTables.
- p.skip('uShort');
- var subtableVersion = p.parseUShort();
- check.argument(subtableVersion === 0, 'Unsupported kern sub-table version.');
- // Skip subtableLength, subtableCoverage
- p.skip('uShort', 2);
- var nPairs = p.parseUShort();
- // Skip searchRange, entrySelector, rangeShift.
- p.skip('uShort', 3);
- for (var i = 0; i < nPairs; i += 1) {
- var leftIndex = p.parseUShort();
- var rightIndex = p.parseUShort();
- var value = p.parseShort();
- pairs[leftIndex + ',' + rightIndex] = value;
- }
- return pairs;
-}
-
-function parseMacKernTable(p) {
- var pairs = {};
- // The Mac kern table stores the version as a fixed (32 bits) but we only loaded the first 16 bits.
- // Skip the rest.
- p.skip('uShort');
- var nTables = p.parseULong();
- //check.argument(nTables === 1, 'Only 1 subtable is supported (got ' + nTables + ').');
- if (nTables > 1) {
- console.warn('Only the first kern subtable is supported.');
- }
- p.skip('uLong');
- var coverage = p.parseUShort();
- var subtableVersion = coverage & 0xFF;
- p.skip('uShort');
- if (subtableVersion === 0) {
- var nPairs = p.parseUShort();
- // Skip searchRange, entrySelector, rangeShift.
- p.skip('uShort', 3);
- for (var i = 0; i < nPairs; i += 1) {
- var leftIndex = p.parseUShort();
- var rightIndex = p.parseUShort();
- var value = p.parseShort();
- pairs[leftIndex + ',' + rightIndex] = value;
- }
- }
- return pairs;
-}
-
-// Parse the `kern` table which contains kerning pairs.
-function parseKernTable(data, start) {
- var p = new parse.Parser(data, start);
- var tableVersion = p.parseUShort();
- if (tableVersion === 0) {
- return parseWindowsKernTable(p);
- } else if (tableVersion === 1) {
- return parseMacKernTable(p);
- } else {
- throw new Error('Unsupported kern table version (' + tableVersion + ').');
- }
-}
-
-exports.parse = parseKernTable;
-
-},{"../check":10,"../parse":19}],33:[function(_dereq_,module,exports){
-// The `loca` table stores the offsets to the locations of the glyphs in the font.
-// https://www.microsoft.com/typography/OTSPEC/loca.htm
-
-'use strict';
-
-var parse = _dereq_('../parse');
-
-// Parse the `loca` table. This table stores the offsets to the locations of the glyphs in the font,
-// relative to the beginning of the glyphData table.
-// The number of glyphs stored in the `loca` table is specified in the `maxp` table (under numGlyphs)
-// The loca table has two versions: a short version where offsets are stored as uShorts, and a long
-// version where offsets are stored as uLongs. The `head` table specifies which version to use
-// (under indexToLocFormat).
-function parseLocaTable(data, start, numGlyphs, shortVersion) {
- var p = new parse.Parser(data, start);
- var parseFn = shortVersion ? p.parseUShort : p.parseULong;
- // There is an extra entry after the last index element to compute the length of the last glyph.
- // That's why we use numGlyphs + 1.
- var glyphOffsets = [];
- for (var i = 0; i < numGlyphs + 1; i += 1) {
- var glyphOffset = parseFn.call(p);
- if (shortVersion) {
- // The short table version stores the actual offset divided by 2.
- glyphOffset *= 2;
- }
-
- glyphOffsets.push(glyphOffset);
- }
-
- return glyphOffsets;
-}
-
-exports.parse = parseLocaTable;
-
-},{"../parse":19}],34:[function(_dereq_,module,exports){
-// The `ltag` table stores IETF BCP-47 language tags. It allows supporting
-// languages for which TrueType does not assign a numeric code.
-// https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6ltag.html
-// http://www.w3.org/International/articles/language-tags/
-// http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
-
-'use strict';
-
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-function makeLtagTable(tags) {
- var result = new table.Table('ltag', [
- {name: 'version', type: 'ULONG', value: 1},
- {name: 'flags', type: 'ULONG', value: 0},
- {name: 'numTags', type: 'ULONG', value: tags.length}
- ]);
-
- var stringPool = '';
- var stringPoolOffset = 12 + tags.length * 4;
- for (var i = 0; i < tags.length; ++i) {
- var pos = stringPool.indexOf(tags[i]);
- if (pos < 0) {
- pos = stringPool.length;
- stringPool += tags[i];
- }
-
- result.fields.push({name: 'offset ' + i, type: 'USHORT', value: stringPoolOffset + pos});
- result.fields.push({name: 'length ' + i, type: 'USHORT', value: tags[i].length});
- }
-
- result.fields.push({name: 'stringPool', type: 'CHARARRAY', value: stringPool});
- return result;
-}
-
-function parseLtagTable(data, start) {
- var p = new parse.Parser(data, start);
- var tableVersion = p.parseULong();
- check.argument(tableVersion === 1, 'Unsupported ltag table version.');
- // The 'ltag' specification does not define any flags; skip the field.
- p.skip('uLong', 1);
- var numTags = p.parseULong();
-
- var tags = [];
- for (var i = 0; i < numTags; i++) {
- var tag = '';
- var offset = start + p.parseUShort();
- var length = p.parseUShort();
- for (var j = offset; j < offset + length; ++j) {
- tag += String.fromCharCode(data.getInt8(j));
- }
-
- tags.push(tag);
- }
-
- return tags;
-}
-
-exports.make = makeLtagTable;
-exports.parse = parseLtagTable;
-
-},{"../check":10,"../parse":19,"../table":22}],35:[function(_dereq_,module,exports){
-// The `maxp` table establishes the memory requirements for the font.
-// We need it just to get the number of glyphs in the font.
-// https://www.microsoft.com/typography/OTSPEC/maxp.htm
-
-'use strict';
-
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// Parse the maximum profile `maxp` table.
-function parseMaxpTable(data, start) {
- var maxp = {};
- var p = new parse.Parser(data, start);
- maxp.version = p.parseVersion();
- maxp.numGlyphs = p.parseUShort();
- if (maxp.version === 1.0) {
- maxp.maxPoints = p.parseUShort();
- maxp.maxContours = p.parseUShort();
- maxp.maxCompositePoints = p.parseUShort();
- maxp.maxCompositeContours = p.parseUShort();
- maxp.maxZones = p.parseUShort();
- maxp.maxTwilightPoints = p.parseUShort();
- maxp.maxStorage = p.parseUShort();
- maxp.maxFunctionDefs = p.parseUShort();
- maxp.maxInstructionDefs = p.parseUShort();
- maxp.maxStackElements = p.parseUShort();
- maxp.maxSizeOfInstructions = p.parseUShort();
- maxp.maxComponentElements = p.parseUShort();
- maxp.maxComponentDepth = p.parseUShort();
- }
-
- return maxp;
-}
-
-function makeMaxpTable(numGlyphs) {
- return new table.Table('maxp', [
- {name: 'version', type: 'FIXED', value: 0x00005000},
- {name: 'numGlyphs', type: 'USHORT', value: numGlyphs}
- ]);
-}
-
-exports.parse = parseMaxpTable;
-exports.make = makeMaxpTable;
-
-},{"../parse":19,"../table":22}],36:[function(_dereq_,module,exports){
-// The `GPOS` table contains kerning pairs, among other things.
-// https://www.microsoft.com/typography/OTSPEC/gpos.htm
-
-'use strict';
-
-var types = _dereq_('../types');
-var decode = types.decode;
-var check = _dereq_('../check');
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// Parse the metadata `meta` table.
-// https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6meta.html
-function parseMetaTable(data, start) {
- var p = new parse.Parser(data, start);
- var tableVersion = p.parseULong();
- check.argument(tableVersion === 1, 'Unsupported META table version.');
- p.parseULong(); // flags - currently unused and set to 0
- p.parseULong(); // tableOffset
- var numDataMaps = p.parseULong();
-
- var tags = {};
- for (var i = 0; i < numDataMaps; i++) {
- var tag = p.parseTag();
- var dataOffset = p.parseULong();
- var dataLength = p.parseULong();
- var text = decode.UTF8(data, start + dataOffset, dataLength);
-
- tags[tag] = text;
- }
- return tags;
-}
-
-function makeMetaTable(tags) {
- var numTags = Object.keys(tags).length;
- var stringPool = '';
- var stringPoolOffset = 16 + numTags * 12;
-
- var result = new table.Table('meta', [
- {name: 'version', type: 'ULONG', value: 1},
- {name: 'flags', type: 'ULONG', value: 0},
- {name: 'offset', type: 'ULONG', value: stringPoolOffset},
- {name: 'numTags', type: 'ULONG', value: numTags}
- ]);
-
- for (var tag in tags) {
- var pos = stringPool.length;
- stringPool += tags[tag];
-
- result.fields.push({name: 'tag ' + tag, type: 'TAG', value: tag});
- result.fields.push({name: 'offset ' + tag, type: 'ULONG', value: stringPoolOffset + pos});
- result.fields.push({name: 'length ' + tag, type: 'ULONG', value: tags[tag].length});
- }
-
- result.fields.push({name: 'stringPool', type: 'CHARARRAY', value: stringPool});
-
- return result;
-}
-
-exports.parse = parseMetaTable;
-exports.make = makeMetaTable;
-
-},{"../check":10,"../parse":19,"../table":22,"../types":41}],37:[function(_dereq_,module,exports){
-// The `name` naming table.
-// https://www.microsoft.com/typography/OTSPEC/name.htm
-
-'use strict';
-
-var types = _dereq_('../types');
-var decode = types.decode;
-var encode = types.encode;
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// NameIDs for the name table.
-var nameTableNames = [
- 'copyright', // 0
- 'fontFamily', // 1
- 'fontSubfamily', // 2
- 'uniqueID', // 3
- 'fullName', // 4
- 'version', // 5
- 'postScriptName', // 6
- 'trademark', // 7
- 'manufacturer', // 8
- 'designer', // 9
- 'description', // 10
- 'manufacturerURL', // 11
- 'designerURL', // 12
- 'license', // 13
- 'licenseURL', // 14
- 'reserved', // 15
- 'preferredFamily', // 16
- 'preferredSubfamily', // 17
- 'compatibleFullName', // 18
- 'sampleText', // 19
- 'postScriptFindFontName', // 20
- 'wwsFamily', // 21
- 'wwsSubfamily' // 22
-];
-
-var macLanguages = {
- 0: 'en',
- 1: 'fr',
- 2: 'de',
- 3: 'it',
- 4: 'nl',
- 5: 'sv',
- 6: 'es',
- 7: 'da',
- 8: 'pt',
- 9: 'no',
- 10: 'he',
- 11: 'ja',
- 12: 'ar',
- 13: 'fi',
- 14: 'el',
- 15: 'is',
- 16: 'mt',
- 17: 'tr',
- 18: 'hr',
- 19: 'zh-Hant',
- 20: 'ur',
- 21: 'hi',
- 22: 'th',
- 23: 'ko',
- 24: 'lt',
- 25: 'pl',
- 26: 'hu',
- 27: 'es',
- 28: 'lv',
- 29: 'se',
- 30: 'fo',
- 31: 'fa',
- 32: 'ru',
- 33: 'zh',
- 34: 'nl-BE',
- 35: 'ga',
- 36: 'sq',
- 37: 'ro',
- 38: 'cz',
- 39: 'sk',
- 40: 'si',
- 41: 'yi',
- 42: 'sr',
- 43: 'mk',
- 44: 'bg',
- 45: 'uk',
- 46: 'be',
- 47: 'uz',
- 48: 'kk',
- 49: 'az-Cyrl',
- 50: 'az-Arab',
- 51: 'hy',
- 52: 'ka',
- 53: 'mo',
- 54: 'ky',
- 55: 'tg',
- 56: 'tk',
- 57: 'mn-CN',
- 58: 'mn',
- 59: 'ps',
- 60: 'ks',
- 61: 'ku',
- 62: 'sd',
- 63: 'bo',
- 64: 'ne',
- 65: 'sa',
- 66: 'mr',
- 67: 'bn',
- 68: 'as',
- 69: 'gu',
- 70: 'pa',
- 71: 'or',
- 72: 'ml',
- 73: 'kn',
- 74: 'ta',
- 75: 'te',
- 76: 'si',
- 77: 'my',
- 78: 'km',
- 79: 'lo',
- 80: 'vi',
- 81: 'id',
- 82: 'tl',
- 83: 'ms',
- 84: 'ms-Arab',
- 85: 'am',
- 86: 'ti',
- 87: 'om',
- 88: 'so',
- 89: 'sw',
- 90: 'rw',
- 91: 'rn',
- 92: 'ny',
- 93: 'mg',
- 94: 'eo',
- 128: 'cy',
- 129: 'eu',
- 130: 'ca',
- 131: 'la',
- 132: 'qu',
- 133: 'gn',
- 134: 'ay',
- 135: 'tt',
- 136: 'ug',
- 137: 'dz',
- 138: 'jv',
- 139: 'su',
- 140: 'gl',
- 141: 'af',
- 142: 'br',
- 143: 'iu',
- 144: 'gd',
- 145: 'gv',
- 146: 'ga',
- 147: 'to',
- 148: 'el-polyton',
- 149: 'kl',
- 150: 'az',
- 151: 'nn'
-};
-
-// MacOS language ID → MacOS script ID
-//
-// Note that the script ID is not sufficient to determine what encoding
-// to use in TrueType files. For some languages, MacOS used a modification
-// of a mainstream script. For example, an Icelandic name would be stored
-// with smRoman in the TrueType naming table, but the actual encoding
-// is a special Icelandic version of the normal Macintosh Roman encoding.
-// As another example, Inuktitut uses an 8-bit encoding for Canadian Aboriginal
-// Syllables but MacOS had run out of available script codes, so this was
-// done as a (pretty radical) "modification" of Ethiopic.
-//
-// http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/Readme.txt
-var macLanguageToScript = {
- 0: 0, // langEnglish → smRoman
- 1: 0, // langFrench → smRoman
- 2: 0, // langGerman → smRoman
- 3: 0, // langItalian → smRoman
- 4: 0, // langDutch → smRoman
- 5: 0, // langSwedish → smRoman
- 6: 0, // langSpanish → smRoman
- 7: 0, // langDanish → smRoman
- 8: 0, // langPortuguese → smRoman
- 9: 0, // langNorwegian → smRoman
- 10: 5, // langHebrew → smHebrew
- 11: 1, // langJapanese → smJapanese
- 12: 4, // langArabic → smArabic
- 13: 0, // langFinnish → smRoman
- 14: 6, // langGreek → smGreek
- 15: 0, // langIcelandic → smRoman (modified)
- 16: 0, // langMaltese → smRoman
- 17: 0, // langTurkish → smRoman (modified)
- 18: 0, // langCroatian → smRoman (modified)
- 19: 2, // langTradChinese → smTradChinese
- 20: 4, // langUrdu → smArabic
- 21: 9, // langHindi → smDevanagari
- 22: 21, // langThai → smThai
- 23: 3, // langKorean → smKorean
- 24: 29, // langLithuanian → smCentralEuroRoman
- 25: 29, // langPolish → smCentralEuroRoman
- 26: 29, // langHungarian → smCentralEuroRoman
- 27: 29, // langEstonian → smCentralEuroRoman
- 28: 29, // langLatvian → smCentralEuroRoman
- 29: 0, // langSami → smRoman
- 30: 0, // langFaroese → smRoman (modified)
- 31: 4, // langFarsi → smArabic (modified)
- 32: 7, // langRussian → smCyrillic
- 33: 25, // langSimpChinese → smSimpChinese
- 34: 0, // langFlemish → smRoman
- 35: 0, // langIrishGaelic → smRoman (modified)
- 36: 0, // langAlbanian → smRoman
- 37: 0, // langRomanian → smRoman (modified)
- 38: 29, // langCzech → smCentralEuroRoman
- 39: 29, // langSlovak → smCentralEuroRoman
- 40: 0, // langSlovenian → smRoman (modified)
- 41: 5, // langYiddish → smHebrew
- 42: 7, // langSerbian → smCyrillic
- 43: 7, // langMacedonian → smCyrillic
- 44: 7, // langBulgarian → smCyrillic
- 45: 7, // langUkrainian → smCyrillic (modified)
- 46: 7, // langByelorussian → smCyrillic
- 47: 7, // langUzbek → smCyrillic
- 48: 7, // langKazakh → smCyrillic
- 49: 7, // langAzerbaijani → smCyrillic
- 50: 4, // langAzerbaijanAr → smArabic
- 51: 24, // langArmenian → smArmenian
- 52: 23, // langGeorgian → smGeorgian
- 53: 7, // langMoldavian → smCyrillic
- 54: 7, // langKirghiz → smCyrillic
- 55: 7, // langTajiki → smCyrillic
- 56: 7, // langTurkmen → smCyrillic
- 57: 27, // langMongolian → smMongolian
- 58: 7, // langMongolianCyr → smCyrillic
- 59: 4, // langPashto → smArabic
- 60: 4, // langKurdish → smArabic
- 61: 4, // langKashmiri → smArabic
- 62: 4, // langSindhi → smArabic
- 63: 26, // langTibetan → smTibetan
- 64: 9, // langNepali → smDevanagari
- 65: 9, // langSanskrit → smDevanagari
- 66: 9, // langMarathi → smDevanagari
- 67: 13, // langBengali → smBengali
- 68: 13, // langAssamese → smBengali
- 69: 11, // langGujarati → smGujarati
- 70: 10, // langPunjabi → smGurmukhi
- 71: 12, // langOriya → smOriya
- 72: 17, // langMalayalam → smMalayalam
- 73: 16, // langKannada → smKannada
- 74: 14, // langTamil → smTamil
- 75: 15, // langTelugu → smTelugu
- 76: 18, // langSinhalese → smSinhalese
- 77: 19, // langBurmese → smBurmese
- 78: 20, // langKhmer → smKhmer
- 79: 22, // langLao → smLao
- 80: 30, // langVietnamese → smVietnamese
- 81: 0, // langIndonesian → smRoman
- 82: 0, // langTagalog → smRoman
- 83: 0, // langMalayRoman → smRoman
- 84: 4, // langMalayArabic → smArabic
- 85: 28, // langAmharic → smEthiopic
- 86: 28, // langTigrinya → smEthiopic
- 87: 28, // langOromo → smEthiopic
- 88: 0, // langSomali → smRoman
- 89: 0, // langSwahili → smRoman
- 90: 0, // langKinyarwanda → smRoman
- 91: 0, // langRundi → smRoman
- 92: 0, // langNyanja → smRoman
- 93: 0, // langMalagasy → smRoman
- 94: 0, // langEsperanto → smRoman
- 128: 0, // langWelsh → smRoman (modified)
- 129: 0, // langBasque → smRoman
- 130: 0, // langCatalan → smRoman
- 131: 0, // langLatin → smRoman
- 132: 0, // langQuechua → smRoman
- 133: 0, // langGuarani → smRoman
- 134: 0, // langAymara → smRoman
- 135: 7, // langTatar → smCyrillic
- 136: 4, // langUighur → smArabic
- 137: 26, // langDzongkha → smTibetan
- 138: 0, // langJavaneseRom → smRoman
- 139: 0, // langSundaneseRom → smRoman
- 140: 0, // langGalician → smRoman
- 141: 0, // langAfrikaans → smRoman
- 142: 0, // langBreton → smRoman (modified)
- 143: 28, // langInuktitut → smEthiopic (modified)
- 144: 0, // langScottishGaelic → smRoman (modified)
- 145: 0, // langManxGaelic → smRoman (modified)
- 146: 0, // langIrishGaelicScript → smRoman (modified)
- 147: 0, // langTongan → smRoman
- 148: 6, // langGreekAncient → smRoman
- 149: 0, // langGreenlandic → smRoman
- 150: 0, // langAzerbaijanRoman → smRoman
- 151: 0 // langNynorsk → smRoman
-};
-
-// While Microsoft indicates a region/country for all its language
-// IDs, we omit the region code if it's equal to the "most likely
-// region subtag" according to Unicode CLDR. For scripts, we omit
-// the subtag if it is equal to the Suppress-Script entry in the
-// IANA language subtag registry for IETF BCP 47.
-//
-// For example, Microsoft states that its language code 0x041A is
-// Croatian in Croatia. We transform this to the BCP 47 language code 'hr'
-// and not 'hr-HR' because Croatia is the default country for Croatian,
-// according to Unicode CLDR. As another example, Microsoft states
-// that 0x101A is Croatian (Latin) in Bosnia-Herzegovina. We transform
-// this to 'hr-BA' and not 'hr-Latn-BA' because Latin is the default script
-// for the Croatian language, according to IANA.
-//
-// http://www.unicode.org/cldr/charts/latest/supplemental/likely_subtags.html
-// http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
-var windowsLanguages = {
- 0x0436: 'af',
- 0x041C: 'sq',
- 0x0484: 'gsw',
- 0x045E: 'am',
- 0x1401: 'ar-DZ',
- 0x3C01: 'ar-BH',
- 0x0C01: 'ar',
- 0x0801: 'ar-IQ',
- 0x2C01: 'ar-JO',
- 0x3401: 'ar-KW',
- 0x3001: 'ar-LB',
- 0x1001: 'ar-LY',
- 0x1801: 'ary',
- 0x2001: 'ar-OM',
- 0x4001: 'ar-QA',
- 0x0401: 'ar-SA',
- 0x2801: 'ar-SY',
- 0x1C01: 'aeb',
- 0x3801: 'ar-AE',
- 0x2401: 'ar-YE',
- 0x042B: 'hy',
- 0x044D: 'as',
- 0x082C: 'az-Cyrl',
- 0x042C: 'az',
- 0x046D: 'ba',
- 0x042D: 'eu',
- 0x0423: 'be',
- 0x0845: 'bn',
- 0x0445: 'bn-IN',
- 0x201A: 'bs-Cyrl',
- 0x141A: 'bs',
- 0x047E: 'br',
- 0x0402: 'bg',
- 0x0403: 'ca',
- 0x0C04: 'zh-HK',
- 0x1404: 'zh-MO',
- 0x0804: 'zh',
- 0x1004: 'zh-SG',
- 0x0404: 'zh-TW',
- 0x0483: 'co',
- 0x041A: 'hr',
- 0x101A: 'hr-BA',
- 0x0405: 'cs',
- 0x0406: 'da',
- 0x048C: 'prs',
- 0x0465: 'dv',
- 0x0813: 'nl-BE',
- 0x0413: 'nl',
- 0x0C09: 'en-AU',
- 0x2809: 'en-BZ',
- 0x1009: 'en-CA',
- 0x2409: 'en-029',
- 0x4009: 'en-IN',
- 0x1809: 'en-IE',
- 0x2009: 'en-JM',
- 0x4409: 'en-MY',
- 0x1409: 'en-NZ',
- 0x3409: 'en-PH',
- 0x4809: 'en-SG',
- 0x1C09: 'en-ZA',
- 0x2C09: 'en-TT',
- 0x0809: 'en-GB',
- 0x0409: 'en',
- 0x3009: 'en-ZW',
- 0x0425: 'et',
- 0x0438: 'fo',
- 0x0464: 'fil',
- 0x040B: 'fi',
- 0x080C: 'fr-BE',
- 0x0C0C: 'fr-CA',
- 0x040C: 'fr',
- 0x140C: 'fr-LU',
- 0x180C: 'fr-MC',
- 0x100C: 'fr-CH',
- 0x0462: 'fy',
- 0x0456: 'gl',
- 0x0437: 'ka',
- 0x0C07: 'de-AT',
- 0x0407: 'de',
- 0x1407: 'de-LI',
- 0x1007: 'de-LU',
- 0x0807: 'de-CH',
- 0x0408: 'el',
- 0x046F: 'kl',
- 0x0447: 'gu',
- 0x0468: 'ha',
- 0x040D: 'he',
- 0x0439: 'hi',
- 0x040E: 'hu',
- 0x040F: 'is',
- 0x0470: 'ig',
- 0x0421: 'id',
- 0x045D: 'iu',
- 0x085D: 'iu-Latn',
- 0x083C: 'ga',
- 0x0434: 'xh',
- 0x0435: 'zu',
- 0x0410: 'it',
- 0x0810: 'it-CH',
- 0x0411: 'ja',
- 0x044B: 'kn',
- 0x043F: 'kk',
- 0x0453: 'km',
- 0x0486: 'quc',
- 0x0487: 'rw',
- 0x0441: 'sw',
- 0x0457: 'kok',
- 0x0412: 'ko',
- 0x0440: 'ky',
- 0x0454: 'lo',
- 0x0426: 'lv',
- 0x0427: 'lt',
- 0x082E: 'dsb',
- 0x046E: 'lb',
- 0x042F: 'mk',
- 0x083E: 'ms-BN',
- 0x043E: 'ms',
- 0x044C: 'ml',
- 0x043A: 'mt',
- 0x0481: 'mi',
- 0x047A: 'arn',
- 0x044E: 'mr',
- 0x047C: 'moh',
- 0x0450: 'mn',
- 0x0850: 'mn-CN',
- 0x0461: 'ne',
- 0x0414: 'nb',
- 0x0814: 'nn',
- 0x0482: 'oc',
- 0x0448: 'or',
- 0x0463: 'ps',
- 0x0415: 'pl',
- 0x0416: 'pt',
- 0x0816: 'pt-PT',
- 0x0446: 'pa',
- 0x046B: 'qu-BO',
- 0x086B: 'qu-EC',
- 0x0C6B: 'qu',
- 0x0418: 'ro',
- 0x0417: 'rm',
- 0x0419: 'ru',
- 0x243B: 'smn',
- 0x103B: 'smj-NO',
- 0x143B: 'smj',
- 0x0C3B: 'se-FI',
- 0x043B: 'se',
- 0x083B: 'se-SE',
- 0x203B: 'sms',
- 0x183B: 'sma-NO',
- 0x1C3B: 'sms',
- 0x044F: 'sa',
- 0x1C1A: 'sr-Cyrl-BA',
- 0x0C1A: 'sr',
- 0x181A: 'sr-Latn-BA',
- 0x081A: 'sr-Latn',
- 0x046C: 'nso',
- 0x0432: 'tn',
- 0x045B: 'si',
- 0x041B: 'sk',
- 0x0424: 'sl',
- 0x2C0A: 'es-AR',
- 0x400A: 'es-BO',
- 0x340A: 'es-CL',
- 0x240A: 'es-CO',
- 0x140A: 'es-CR',
- 0x1C0A: 'es-DO',
- 0x300A: 'es-EC',
- 0x440A: 'es-SV',
- 0x100A: 'es-GT',
- 0x480A: 'es-HN',
- 0x080A: 'es-MX',
- 0x4C0A: 'es-NI',
- 0x180A: 'es-PA',
- 0x3C0A: 'es-PY',
- 0x280A: 'es-PE',
- 0x500A: 'es-PR',
-
- // Microsoft has defined two different language codes for
- // “Spanish with modern sorting” and “Spanish with traditional
- // sorting”. This makes sense for collation APIs, and it would be
- // possible to express this in BCP 47 language tags via Unicode
- // extensions (eg., es-u-co-trad is Spanish with traditional
- // sorting). However, for storing names in fonts, the distinction
- // does not make sense, so we give “es” in both cases.
- 0x0C0A: 'es',
- 0x040A: 'es',
-
- 0x540A: 'es-US',
- 0x380A: 'es-UY',
- 0x200A: 'es-VE',
- 0x081D: 'sv-FI',
- 0x041D: 'sv',
- 0x045A: 'syr',
- 0x0428: 'tg',
- 0x085F: 'tzm',
- 0x0449: 'ta',
- 0x0444: 'tt',
- 0x044A: 'te',
- 0x041E: 'th',
- 0x0451: 'bo',
- 0x041F: 'tr',
- 0x0442: 'tk',
- 0x0480: 'ug',
- 0x0422: 'uk',
- 0x042E: 'hsb',
- 0x0420: 'ur',
- 0x0843: 'uz-Cyrl',
- 0x0443: 'uz',
- 0x042A: 'vi',
- 0x0452: 'cy',
- 0x0488: 'wo',
- 0x0485: 'sah',
- 0x0478: 'ii',
- 0x046A: 'yo'
-};
-
-// Returns a IETF BCP 47 language code, for example 'zh-Hant'
-// for 'Chinese in the traditional script'.
-function getLanguageCode(platformID, languageID, ltag) {
- switch (platformID) {
- case 0: // Unicode
- if (languageID === 0xFFFF) {
- return 'und';
- } else if (ltag) {
- return ltag[languageID];
- }
-
- break;
-
- case 1: // Macintosh
- return macLanguages[languageID];
-
- case 3: // Windows
- return windowsLanguages[languageID];
- }
-
- return undefined;
-}
-
-var utf16 = 'utf-16';
-
-// MacOS script ID → encoding. This table stores the default case,
-// which can be overridden by macLanguageEncodings.
-var macScriptEncodings = {
- 0: 'macintosh', // smRoman
- 1: 'x-mac-japanese', // smJapanese
- 2: 'x-mac-chinesetrad', // smTradChinese
- 3: 'x-mac-korean', // smKorean
- 6: 'x-mac-greek', // smGreek
- 7: 'x-mac-cyrillic', // smCyrillic
- 9: 'x-mac-devanagai', // smDevanagari
- 10: 'x-mac-gurmukhi', // smGurmukhi
- 11: 'x-mac-gujarati', // smGujarati
- 12: 'x-mac-oriya', // smOriya
- 13: 'x-mac-bengali', // smBengali
- 14: 'x-mac-tamil', // smTamil
- 15: 'x-mac-telugu', // smTelugu
- 16: 'x-mac-kannada', // smKannada
- 17: 'x-mac-malayalam', // smMalayalam
- 18: 'x-mac-sinhalese', // smSinhalese
- 19: 'x-mac-burmese', // smBurmese
- 20: 'x-mac-khmer', // smKhmer
- 21: 'x-mac-thai', // smThai
- 22: 'x-mac-lao', // smLao
- 23: 'x-mac-georgian', // smGeorgian
- 24: 'x-mac-armenian', // smArmenian
- 25: 'x-mac-chinesesimp', // smSimpChinese
- 26: 'x-mac-tibetan', // smTibetan
- 27: 'x-mac-mongolian', // smMongolian
- 28: 'x-mac-ethiopic', // smEthiopic
- 29: 'x-mac-ce', // smCentralEuroRoman
- 30: 'x-mac-vietnamese', // smVietnamese
- 31: 'x-mac-extarabic' // smExtArabic
-};
-
-// MacOS language ID → encoding. This table stores the exceptional
-// cases, which override macScriptEncodings. For writing MacOS naming
-// tables, we need to emit a MacOS script ID. Therefore, we cannot
-// merge macScriptEncodings into macLanguageEncodings.
-//
-// http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/Readme.txt
-var macLanguageEncodings = {
- 15: 'x-mac-icelandic', // langIcelandic
- 17: 'x-mac-turkish', // langTurkish
- 18: 'x-mac-croatian', // langCroatian
- 24: 'x-mac-ce', // langLithuanian
- 25: 'x-mac-ce', // langPolish
- 26: 'x-mac-ce', // langHungarian
- 27: 'x-mac-ce', // langEstonian
- 28: 'x-mac-ce', // langLatvian
- 30: 'x-mac-icelandic', // langFaroese
- 37: 'x-mac-romanian', // langRomanian
- 38: 'x-mac-ce', // langCzech
- 39: 'x-mac-ce', // langSlovak
- 40: 'x-mac-ce', // langSlovenian
- 143: 'x-mac-inuit', // langInuktitut
- 146: 'x-mac-gaelic' // langIrishGaelicScript
-};
-
-function getEncoding(platformID, encodingID, languageID) {
- switch (platformID) {
- case 0: // Unicode
- return utf16;
-
- case 1: // Apple Macintosh
- return macLanguageEncodings[languageID] || macScriptEncodings[encodingID];
-
- case 3: // Microsoft Windows
- if (encodingID === 1 || encodingID === 10) {
- return utf16;
- }
-
- break;
- }
-
- return undefined;
-}
-
-// Parse the naming `name` table.
-// FIXME: Format 1 additional fields are not supported yet.
-// ltag is the content of the `ltag' table, such as ['en', 'zh-Hans', 'de-CH-1904'].
-function parseNameTable(data, start, ltag) {
- var name = {};
- var p = new parse.Parser(data, start);
- var format = p.parseUShort();
- var count = p.parseUShort();
- var stringOffset = p.offset + p.parseUShort();
- for (var i = 0; i < count; i++) {
- var platformID = p.parseUShort();
- var encodingID = p.parseUShort();
- var languageID = p.parseUShort();
- var nameID = p.parseUShort();
- var property = nameTableNames[nameID] || nameID;
- var byteLength = p.parseUShort();
- var offset = p.parseUShort();
- var language = getLanguageCode(platformID, languageID, ltag);
- var encoding = getEncoding(platformID, encodingID, languageID);
- if (encoding !== undefined && language !== undefined) {
- var text;
- if (encoding === utf16) {
- text = decode.UTF16(data, stringOffset + offset, byteLength);
- } else {
- text = decode.MACSTRING(data, stringOffset + offset, byteLength, encoding);
- }
-
- if (text) {
- var translations = name[property];
- if (translations === undefined) {
- translations = name[property] = {};
- }
-
- translations[language] = text;
- }
- }
- }
-
- var langTagCount = 0;
- if (format === 1) {
- // FIXME: Also handle Microsoft's 'name' table 1.
- langTagCount = p.parseUShort();
- }
-
- return name;
-}
-
-// {23: 'foo'} → {'foo': 23}
-// ['bar', 'baz'] → {'bar': 0, 'baz': 1}
-function reverseDict(dict) {
- var result = {};
- for (var key in dict) {
- result[dict[key]] = parseInt(key);
- }
-
- return result;
-}
-
-function makeNameRecord(platformID, encodingID, languageID, nameID, length, offset) {
- return new table.Record('NameRecord', [
- {name: 'platformID', type: 'USHORT', value: platformID},
- {name: 'encodingID', type: 'USHORT', value: encodingID},
- {name: 'languageID', type: 'USHORT', value: languageID},
- {name: 'nameID', type: 'USHORT', value: nameID},
- {name: 'length', type: 'USHORT', value: length},
- {name: 'offset', type: 'USHORT', value: offset}
- ]);
-}
-
-// Finds the position of needle in haystack, or -1 if not there.
-// Like String.indexOf(), but for arrays.
-function findSubArray(needle, haystack) {
- var needleLength = needle.length;
- var limit = haystack.length - needleLength + 1;
-
- loop:
- for (var pos = 0; pos < limit; pos++) {
- for (; pos < limit; pos++) {
- for (var k = 0; k < needleLength; k++) {
- if (haystack[pos + k] !== needle[k]) {
- continue loop;
- }
- }
-
- return pos;
- }
- }
-
- return -1;
-}
-
-function addStringToPool(s, pool) {
- var offset = findSubArray(s, pool);
- if (offset < 0) {
- offset = pool.length;
- for (var i = 0, len = s.length; i < len; ++i) {
- pool.push(s[i]);
- }
-
- }
-
- return offset;
-}
-
-function makeNameTable(names, ltag) {
- var nameID;
- var nameIDs = [];
-
- var namesWithNumericKeys = {};
- var nameTableIds = reverseDict(nameTableNames);
- for (var key in names) {
- var id = nameTableIds[key];
- if (id === undefined) {
- id = key;
- }
-
- nameID = parseInt(id);
-
- if (isNaN(nameID)) {
- throw new Error('Name table entry "' + key + '" does not exist, see nameTableNames for complete list.');
- }
-
- namesWithNumericKeys[nameID] = names[key];
- nameIDs.push(nameID);
- }
-
- var macLanguageIds = reverseDict(macLanguages);
- var windowsLanguageIds = reverseDict(windowsLanguages);
-
- var nameRecords = [];
- var stringPool = [];
-
- for (var i = 0; i < nameIDs.length; i++) {
- nameID = nameIDs[i];
- var translations = namesWithNumericKeys[nameID];
- for (var lang in translations) {
- var text = translations[lang];
-
- // For MacOS, we try to emit the name in the form that was introduced
- // in the initial version of the TrueType spec (in the late 1980s).
- // However, this can fail for various reasons: the requested BCP 47
- // language code might not have an old-style Mac equivalent;
- // we might not have a codec for the needed character encoding;
- // or the name might contain characters that cannot be expressed
- // in the old-style Macintosh encoding. In case of failure, we emit
- // the name in a more modern fashion (Unicode encoding with BCP 47
- // language tags) that is recognized by MacOS 10.5, released in 2009.
- // If fonts were only read by operating systems, we could simply
- // emit all names in the modern form; this would be much easier.
- // However, there are many applications and libraries that read
- // 'name' tables directly, and these will usually only recognize
- // the ancient form (silently skipping the unrecognized names).
- var macPlatform = 1; // Macintosh
- var macLanguage = macLanguageIds[lang];
- var macScript = macLanguageToScript[macLanguage];
- var macEncoding = getEncoding(macPlatform, macScript, macLanguage);
- var macName = encode.MACSTRING(text, macEncoding);
- if (macName === undefined) {
- macPlatform = 0; // Unicode
- macLanguage = ltag.indexOf(lang);
- if (macLanguage < 0) {
- macLanguage = ltag.length;
- ltag.push(lang);
- }
-
- macScript = 4; // Unicode 2.0 and later
- macName = encode.UTF16(text);
- }
-
- var macNameOffset = addStringToPool(macName, stringPool);
- nameRecords.push(makeNameRecord(macPlatform, macScript, macLanguage,
- nameID, macName.length, macNameOffset));
-
- var winLanguage = windowsLanguageIds[lang];
- if (winLanguage !== undefined) {
- var winName = encode.UTF16(text);
- var winNameOffset = addStringToPool(winName, stringPool);
- nameRecords.push(makeNameRecord(3, 1, winLanguage,
- nameID, winName.length, winNameOffset));
- }
- }
- }
-
- nameRecords.sort(function(a, b) {
- return ((a.platformID - b.platformID) ||
- (a.encodingID - b.encodingID) ||
- (a.languageID - b.languageID) ||
- (a.nameID - b.nameID));
- });
-
- var t = new table.Table('name', [
- {name: 'format', type: 'USHORT', value: 0},
- {name: 'count', type: 'USHORT', value: nameRecords.length},
- {name: 'stringOffset', type: 'USHORT', value: 6 + nameRecords.length * 12}
- ]);
-
- for (var r = 0; r < nameRecords.length; r++) {
- t.fields.push({name: 'record_' + r, type: 'RECORD', value: nameRecords[r]});
- }
-
- t.fields.push({name: 'strings', type: 'LITERAL', value: stringPool});
- return t;
-}
-
-exports.parse = parseNameTable;
-exports.make = makeNameTable;
-
-},{"../parse":19,"../table":22,"../types":41}],38:[function(_dereq_,module,exports){
-// The `OS/2` table contains metrics required in OpenType fonts.
-// https://www.microsoft.com/typography/OTSPEC/os2.htm
-
-'use strict';
-
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-var unicodeRanges = [
- {begin: 0x0000, end: 0x007F}, // Basic Latin
- {begin: 0x0080, end: 0x00FF}, // Latin-1 Supplement
- {begin: 0x0100, end: 0x017F}, // Latin Extended-A
- {begin: 0x0180, end: 0x024F}, // Latin Extended-B
- {begin: 0x0250, end: 0x02AF}, // IPA Extensions
- {begin: 0x02B0, end: 0x02FF}, // Spacing Modifier Letters
- {begin: 0x0300, end: 0x036F}, // Combining Diacritical Marks
- {begin: 0x0370, end: 0x03FF}, // Greek and Coptic
- {begin: 0x2C80, end: 0x2CFF}, // Coptic
- {begin: 0x0400, end: 0x04FF}, // Cyrillic
- {begin: 0x0530, end: 0x058F}, // Armenian
- {begin: 0x0590, end: 0x05FF}, // Hebrew
- {begin: 0xA500, end: 0xA63F}, // Vai
- {begin: 0x0600, end: 0x06FF}, // Arabic
- {begin: 0x07C0, end: 0x07FF}, // NKo
- {begin: 0x0900, end: 0x097F}, // Devanagari
- {begin: 0x0980, end: 0x09FF}, // Bengali
- {begin: 0x0A00, end: 0x0A7F}, // Gurmukhi
- {begin: 0x0A80, end: 0x0AFF}, // Gujarati
- {begin: 0x0B00, end: 0x0B7F}, // Oriya
- {begin: 0x0B80, end: 0x0BFF}, // Tamil
- {begin: 0x0C00, end: 0x0C7F}, // Telugu
- {begin: 0x0C80, end: 0x0CFF}, // Kannada
- {begin: 0x0D00, end: 0x0D7F}, // Malayalam
- {begin: 0x0E00, end: 0x0E7F}, // Thai
- {begin: 0x0E80, end: 0x0EFF}, // Lao
- {begin: 0x10A0, end: 0x10FF}, // Georgian
- {begin: 0x1B00, end: 0x1B7F}, // Balinese
- {begin: 0x1100, end: 0x11FF}, // Hangul Jamo
- {begin: 0x1E00, end: 0x1EFF}, // Latin Extended Additional
- {begin: 0x1F00, end: 0x1FFF}, // Greek Extended
- {begin: 0x2000, end: 0x206F}, // General Punctuation
- {begin: 0x2070, end: 0x209F}, // Superscripts And Subscripts
- {begin: 0x20A0, end: 0x20CF}, // Currency Symbol
- {begin: 0x20D0, end: 0x20FF}, // Combining Diacritical Marks For Symbols
- {begin: 0x2100, end: 0x214F}, // Letterlike Symbols
- {begin: 0x2150, end: 0x218F}, // Number Forms
- {begin: 0x2190, end: 0x21FF}, // Arrows
- {begin: 0x2200, end: 0x22FF}, // Mathematical Operators
- {begin: 0x2300, end: 0x23FF}, // Miscellaneous Technical
- {begin: 0x2400, end: 0x243F}, // Control Pictures
- {begin: 0x2440, end: 0x245F}, // Optical Character Recognition
- {begin: 0x2460, end: 0x24FF}, // Enclosed Alphanumerics
- {begin: 0x2500, end: 0x257F}, // Box Drawing
- {begin: 0x2580, end: 0x259F}, // Block Elements
- {begin: 0x25A0, end: 0x25FF}, // Geometric Shapes
- {begin: 0x2600, end: 0x26FF}, // Miscellaneous Symbols
- {begin: 0x2700, end: 0x27BF}, // Dingbats
- {begin: 0x3000, end: 0x303F}, // CJK Symbols And Punctuation
- {begin: 0x3040, end: 0x309F}, // Hiragana
- {begin: 0x30A0, end: 0x30FF}, // Katakana
- {begin: 0x3100, end: 0x312F}, // Bopomofo
- {begin: 0x3130, end: 0x318F}, // Hangul Compatibility Jamo
- {begin: 0xA840, end: 0xA87F}, // Phags-pa
- {begin: 0x3200, end: 0x32FF}, // Enclosed CJK Letters And Months
- {begin: 0x3300, end: 0x33FF}, // CJK Compatibility
- {begin: 0xAC00, end: 0xD7AF}, // Hangul Syllables
- {begin: 0xD800, end: 0xDFFF}, // Non-Plane 0 *
- {begin: 0x10900, end: 0x1091F}, // Phoenicia
- {begin: 0x4E00, end: 0x9FFF}, // CJK Unified Ideographs
- {begin: 0xE000, end: 0xF8FF}, // Private Use Area (plane 0)
- {begin: 0x31C0, end: 0x31EF}, // CJK Strokes
- {begin: 0xFB00, end: 0xFB4F}, // Alphabetic Presentation Forms
- {begin: 0xFB50, end: 0xFDFF}, // Arabic Presentation Forms-A
- {begin: 0xFE20, end: 0xFE2F}, // Combining Half Marks
- {begin: 0xFE10, end: 0xFE1F}, // Vertical Forms
- {begin: 0xFE50, end: 0xFE6F}, // Small Form Variants
- {begin: 0xFE70, end: 0xFEFF}, // Arabic Presentation Forms-B
- {begin: 0xFF00, end: 0xFFEF}, // Halfwidth And Fullwidth Forms
- {begin: 0xFFF0, end: 0xFFFF}, // Specials
- {begin: 0x0F00, end: 0x0FFF}, // Tibetan
- {begin: 0x0700, end: 0x074F}, // Syriac
- {begin: 0x0780, end: 0x07BF}, // Thaana
- {begin: 0x0D80, end: 0x0DFF}, // Sinhala
- {begin: 0x1000, end: 0x109F}, // Myanmar
- {begin: 0x1200, end: 0x137F}, // Ethiopic
- {begin: 0x13A0, end: 0x13FF}, // Cherokee
- {begin: 0x1400, end: 0x167F}, // Unified Canadian Aboriginal Syllabics
- {begin: 0x1680, end: 0x169F}, // Ogham
- {begin: 0x16A0, end: 0x16FF}, // Runic
- {begin: 0x1780, end: 0x17FF}, // Khmer
- {begin: 0x1800, end: 0x18AF}, // Mongolian
- {begin: 0x2800, end: 0x28FF}, // Braille Patterns
- {begin: 0xA000, end: 0xA48F}, // Yi Syllables
- {begin: 0x1700, end: 0x171F}, // Tagalog
- {begin: 0x10300, end: 0x1032F}, // Old Italic
- {begin: 0x10330, end: 0x1034F}, // Gothic
- {begin: 0x10400, end: 0x1044F}, // Deseret
- {begin: 0x1D000, end: 0x1D0FF}, // Byzantine Musical Symbols
- {begin: 0x1D400, end: 0x1D7FF}, // Mathematical Alphanumeric Symbols
- {begin: 0xFF000, end: 0xFFFFD}, // Private Use (plane 15)
- {begin: 0xFE00, end: 0xFE0F}, // Variation Selectors
- {begin: 0xE0000, end: 0xE007F}, // Tags
- {begin: 0x1900, end: 0x194F}, // Limbu
- {begin: 0x1950, end: 0x197F}, // Tai Le
- {begin: 0x1980, end: 0x19DF}, // New Tai Lue
- {begin: 0x1A00, end: 0x1A1F}, // Buginese
- {begin: 0x2C00, end: 0x2C5F}, // Glagolitic
- {begin: 0x2D30, end: 0x2D7F}, // Tifinagh
- {begin: 0x4DC0, end: 0x4DFF}, // Yijing Hexagram Symbols
- {begin: 0xA800, end: 0xA82F}, // Syloti Nagri
- {begin: 0x10000, end: 0x1007F}, // Linear B Syllabary
- {begin: 0x10140, end: 0x1018F}, // Ancient Greek Numbers
- {begin: 0x10380, end: 0x1039F}, // Ugaritic
- {begin: 0x103A0, end: 0x103DF}, // Old Persian
- {begin: 0x10450, end: 0x1047F}, // Shavian
- {begin: 0x10480, end: 0x104AF}, // Osmanya
- {begin: 0x10800, end: 0x1083F}, // Cypriot Syllabary
- {begin: 0x10A00, end: 0x10A5F}, // Kharoshthi
- {begin: 0x1D300, end: 0x1D35F}, // Tai Xuan Jing Symbols
- {begin: 0x12000, end: 0x123FF}, // Cuneiform
- {begin: 0x1D360, end: 0x1D37F}, // Counting Rod Numerals
- {begin: 0x1B80, end: 0x1BBF}, // Sundanese
- {begin: 0x1C00, end: 0x1C4F}, // Lepcha
- {begin: 0x1C50, end: 0x1C7F}, // Ol Chiki
- {begin: 0xA880, end: 0xA8DF}, // Saurashtra
- {begin: 0xA900, end: 0xA92F}, // Kayah Li
- {begin: 0xA930, end: 0xA95F}, // Rejang
- {begin: 0xAA00, end: 0xAA5F}, // Cham
- {begin: 0x10190, end: 0x101CF}, // Ancient Symbols
- {begin: 0x101D0, end: 0x101FF}, // Phaistos Disc
- {begin: 0x102A0, end: 0x102DF}, // Carian
- {begin: 0x1F030, end: 0x1F09F} // Domino Tiles
-];
-
-function getUnicodeRange(unicode) {
- for (var i = 0; i < unicodeRanges.length; i += 1) {
- var range = unicodeRanges[i];
- if (unicode >= range.begin && unicode < range.end) {
- return i;
- }
- }
-
- return -1;
-}
-
-// Parse the OS/2 and Windows metrics `OS/2` table
-function parseOS2Table(data, start) {
- var os2 = {};
- var p = new parse.Parser(data, start);
- os2.version = p.parseUShort();
- os2.xAvgCharWidth = p.parseShort();
- os2.usWeightClass = p.parseUShort();
- os2.usWidthClass = p.parseUShort();
- os2.fsType = p.parseUShort();
- os2.ySubscriptXSize = p.parseShort();
- os2.ySubscriptYSize = p.parseShort();
- os2.ySubscriptXOffset = p.parseShort();
- os2.ySubscriptYOffset = p.parseShort();
- os2.ySuperscriptXSize = p.parseShort();
- os2.ySuperscriptYSize = p.parseShort();
- os2.ySuperscriptXOffset = p.parseShort();
- os2.ySuperscriptYOffset = p.parseShort();
- os2.yStrikeoutSize = p.parseShort();
- os2.yStrikeoutPosition = p.parseShort();
- os2.sFamilyClass = p.parseShort();
- os2.panose = [];
- for (var i = 0; i < 10; i++) {
- os2.panose[i] = p.parseByte();
- }
-
- os2.ulUnicodeRange1 = p.parseULong();
- os2.ulUnicodeRange2 = p.parseULong();
- os2.ulUnicodeRange3 = p.parseULong();
- os2.ulUnicodeRange4 = p.parseULong();
- os2.achVendID = String.fromCharCode(p.parseByte(), p.parseByte(), p.parseByte(), p.parseByte());
- os2.fsSelection = p.parseUShort();
- os2.usFirstCharIndex = p.parseUShort();
- os2.usLastCharIndex = p.parseUShort();
- os2.sTypoAscender = p.parseShort();
- os2.sTypoDescender = p.parseShort();
- os2.sTypoLineGap = p.parseShort();
- os2.usWinAscent = p.parseUShort();
- os2.usWinDescent = p.parseUShort();
- if (os2.version >= 1) {
- os2.ulCodePageRange1 = p.parseULong();
- os2.ulCodePageRange2 = p.parseULong();
- }
-
- if (os2.version >= 2) {
- os2.sxHeight = p.parseShort();
- os2.sCapHeight = p.parseShort();
- os2.usDefaultChar = p.parseUShort();
- os2.usBreakChar = p.parseUShort();
- os2.usMaxContent = p.parseUShort();
- }
-
- return os2;
-}
-
-function makeOS2Table(options) {
- return new table.Table('OS/2', [
- {name: 'version', type: 'USHORT', value: 0x0003},
- {name: 'xAvgCharWidth', type: 'SHORT', value: 0},
- {name: 'usWeightClass', type: 'USHORT', value: 0},
- {name: 'usWidthClass', type: 'USHORT', value: 0},
- {name: 'fsType', type: 'USHORT', value: 0},
- {name: 'ySubscriptXSize', type: 'SHORT', value: 650},
- {name: 'ySubscriptYSize', type: 'SHORT', value: 699},
- {name: 'ySubscriptXOffset', type: 'SHORT', value: 0},
- {name: 'ySubscriptYOffset', type: 'SHORT', value: 140},
- {name: 'ySuperscriptXSize', type: 'SHORT', value: 650},
- {name: 'ySuperscriptYSize', type: 'SHORT', value: 699},
- {name: 'ySuperscriptXOffset', type: 'SHORT', value: 0},
- {name: 'ySuperscriptYOffset', type: 'SHORT', value: 479},
- {name: 'yStrikeoutSize', type: 'SHORT', value: 49},
- {name: 'yStrikeoutPosition', type: 'SHORT', value: 258},
- {name: 'sFamilyClass', type: 'SHORT', value: 0},
- {name: 'bFamilyType', type: 'BYTE', value: 0},
- {name: 'bSerifStyle', type: 'BYTE', value: 0},
- {name: 'bWeight', type: 'BYTE', value: 0},
- {name: 'bProportion', type: 'BYTE', value: 0},
- {name: 'bContrast', type: 'BYTE', value: 0},
- {name: 'bStrokeVariation', type: 'BYTE', value: 0},
- {name: 'bArmStyle', type: 'BYTE', value: 0},
- {name: 'bLetterform', type: 'BYTE', value: 0},
- {name: 'bMidline', type: 'BYTE', value: 0},
- {name: 'bXHeight', type: 'BYTE', value: 0},
- {name: 'ulUnicodeRange1', type: 'ULONG', value: 0},
- {name: 'ulUnicodeRange2', type: 'ULONG', value: 0},
- {name: 'ulUnicodeRange3', type: 'ULONG', value: 0},
- {name: 'ulUnicodeRange4', type: 'ULONG', value: 0},
- {name: 'achVendID', type: 'CHARARRAY', value: 'XXXX'},
- {name: 'fsSelection', type: 'USHORT', value: 0},
- {name: 'usFirstCharIndex', type: 'USHORT', value: 0},
- {name: 'usLastCharIndex', type: 'USHORT', value: 0},
- {name: 'sTypoAscender', type: 'SHORT', value: 0},
- {name: 'sTypoDescender', type: 'SHORT', value: 0},
- {name: 'sTypoLineGap', type: 'SHORT', value: 0},
- {name: 'usWinAscent', type: 'USHORT', value: 0},
- {name: 'usWinDescent', type: 'USHORT', value: 0},
- {name: 'ulCodePageRange1', type: 'ULONG', value: 0},
- {name: 'ulCodePageRange2', type: 'ULONG', value: 0},
- {name: 'sxHeight', type: 'SHORT', value: 0},
- {name: 'sCapHeight', type: 'SHORT', value: 0},
- {name: 'usDefaultChar', type: 'USHORT', value: 0},
- {name: 'usBreakChar', type: 'USHORT', value: 0},
- {name: 'usMaxContext', type: 'USHORT', value: 0}
- ], options);
-}
-
-exports.unicodeRanges = unicodeRanges;
-exports.getUnicodeRange = getUnicodeRange;
-exports.parse = parseOS2Table;
-exports.make = makeOS2Table;
-
-},{"../parse":19,"../table":22}],39:[function(_dereq_,module,exports){
-// The `post` table stores additional PostScript information, such as glyph names.
-// https://www.microsoft.com/typography/OTSPEC/post.htm
-
-'use strict';
-
-var encoding = _dereq_('../encoding');
-var parse = _dereq_('../parse');
-var table = _dereq_('../table');
-
-// Parse the PostScript `post` table
-function parsePostTable(data, start) {
- var post = {};
- var p = new parse.Parser(data, start);
- var i;
- post.version = p.parseVersion();
- post.italicAngle = p.parseFixed();
- post.underlinePosition = p.parseShort();
- post.underlineThickness = p.parseShort();
- post.isFixedPitch = p.parseULong();
- post.minMemType42 = p.parseULong();
- post.maxMemType42 = p.parseULong();
- post.minMemType1 = p.parseULong();
- post.maxMemType1 = p.parseULong();
- switch (post.version) {
- case 1:
- post.names = encoding.standardNames.slice();
- break;
- case 2:
- post.numberOfGlyphs = p.parseUShort();
- post.glyphNameIndex = new Array(post.numberOfGlyphs);
- for (i = 0; i < post.numberOfGlyphs; i++) {
- post.glyphNameIndex[i] = p.parseUShort();
- }
-
- post.names = [];
- for (i = 0; i < post.numberOfGlyphs; i++) {
- if (post.glyphNameIndex[i] >= encoding.standardNames.length) {
- var nameLength = p.parseChar();
- post.names.push(p.parseString(nameLength));
- }
- }
-
- break;
- case 2.5:
- post.numberOfGlyphs = p.parseUShort();
- post.offset = new Array(post.numberOfGlyphs);
- for (i = 0; i < post.numberOfGlyphs; i++) {
- post.offset[i] = p.parseChar();
- }
-
- break;
- }
- return post;
-}
-
-function makePostTable() {
- return new table.Table('post', [
- {name: 'version', type: 'FIXED', value: 0x00030000},
- {name: 'italicAngle', type: 'FIXED', value: 0},
- {name: 'underlinePosition', type: 'FWORD', value: 0},
- {name: 'underlineThickness', type: 'FWORD', value: 0},
- {name: 'isFixedPitch', type: 'ULONG', value: 0},
- {name: 'minMemType42', type: 'ULONG', value: 0},
- {name: 'maxMemType42', type: 'ULONG', value: 0},
- {name: 'minMemType1', type: 'ULONG', value: 0},
- {name: 'maxMemType1', type: 'ULONG', value: 0}
- ]);
-}
-
-exports.parse = parsePostTable;
-exports.make = makePostTable;
-
-},{"../encoding":12,"../parse":19,"../table":22}],40:[function(_dereq_,module,exports){
-// The `sfnt` wrapper provides organization for the tables in the font.
-// It is the top-level data structure in a font.
-// https://www.microsoft.com/typography/OTSPEC/otff.htm
-// Recommendations for creating OpenType Fonts:
-// http://www.microsoft.com/typography/otspec140/recom.htm
-
-'use strict';
-
-var check = _dereq_('../check');
-var table = _dereq_('../table');
-
-var cmap = _dereq_('./cmap');
-var cff = _dereq_('./cff');
-var head = _dereq_('./head');
-var hhea = _dereq_('./hhea');
-var hmtx = _dereq_('./hmtx');
-var ltag = _dereq_('./ltag');
-var maxp = _dereq_('./maxp');
-var _name = _dereq_('./name');
-var os2 = _dereq_('./os2');
-var post = _dereq_('./post');
-var gsub = _dereq_('./gsub');
-var meta = _dereq_('./meta');
-
-function log2(v) {
- return Math.log(v) / Math.log(2) | 0;
-}
-
-function computeCheckSum(bytes) {
- while (bytes.length % 4 !== 0) {
- bytes.push(0);
- }
-
- var sum = 0;
- for (var i = 0; i < bytes.length; i += 4) {
- sum += (bytes[i] << 24) +
- (bytes[i + 1] << 16) +
- (bytes[i + 2] << 8) +
- (bytes[i + 3]);
- }
-
- sum %= Math.pow(2, 32);
- return sum;
-}
-
-function makeTableRecord(tag, checkSum, offset, length) {
- return new table.Record('Table Record', [
- {name: 'tag', type: 'TAG', value: tag !== undefined ? tag : ''},
- {name: 'checkSum', type: 'ULONG', value: checkSum !== undefined ? checkSum : 0},
- {name: 'offset', type: 'ULONG', value: offset !== undefined ? offset : 0},
- {name: 'length', type: 'ULONG', value: length !== undefined ? length : 0}
- ]);
-}
-
-function makeSfntTable(tables) {
- var sfnt = new table.Table('sfnt', [
- {name: 'version', type: 'TAG', value: 'OTTO'},
- {name: 'numTables', type: 'USHORT', value: 0},
- {name: 'searchRange', type: 'USHORT', value: 0},
- {name: 'entrySelector', type: 'USHORT', value: 0},
- {name: 'rangeShift', type: 'USHORT', value: 0}
- ]);
- sfnt.tables = tables;
- sfnt.numTables = tables.length;
- var highestPowerOf2 = Math.pow(2, log2(sfnt.numTables));
- sfnt.searchRange = 16 * highestPowerOf2;
- sfnt.entrySelector = log2(highestPowerOf2);
- sfnt.rangeShift = sfnt.numTables * 16 - sfnt.searchRange;
-
- var recordFields = [];
- var tableFields = [];
-
- var offset = sfnt.sizeOf() + (makeTableRecord().sizeOf() * sfnt.numTables);
- while (offset % 4 !== 0) {
- offset += 1;
- tableFields.push({name: 'padding', type: 'BYTE', value: 0});
- }
-
- for (var i = 0; i < tables.length; i += 1) {
- var t = tables[i];
- check.argument(t.tableName.length === 4, 'Table name' + t.tableName + ' is invalid.');
- var tableLength = t.sizeOf();
- var tableRecord = makeTableRecord(t.tableName, computeCheckSum(t.encode()), offset, tableLength);
- recordFields.push({name: tableRecord.tag + ' Table Record', type: 'RECORD', value: tableRecord});
- tableFields.push({name: t.tableName + ' table', type: 'RECORD', value: t});
- offset += tableLength;
- check.argument(!isNaN(offset), 'Something went wrong calculating the offset.');
- while (offset % 4 !== 0) {
- offset += 1;
- tableFields.push({name: 'padding', type: 'BYTE', value: 0});
- }
- }
-
- // Table records need to be sorted alphabetically.
- recordFields.sort(function(r1, r2) {
- if (r1.value.tag > r2.value.tag) {
- return 1;
- } else {
- return -1;
- }
- });
-
- sfnt.fields = sfnt.fields.concat(recordFields);
- sfnt.fields = sfnt.fields.concat(tableFields);
- return sfnt;
-}
-
-// Get the metrics for a character. If the string has more than one character
-// this function returns metrics for the first available character.
-// You can provide optional fallback metrics if no characters are available.
-function metricsForChar(font, chars, notFoundMetrics) {
- for (var i = 0; i < chars.length; i += 1) {
- var glyphIndex = font.charToGlyphIndex(chars[i]);
- if (glyphIndex > 0) {
- var glyph = font.glyphs.get(glyphIndex);
- return glyph.getMetrics();
- }
- }
-
- return notFoundMetrics;
-}
-
-function average(vs) {
- var sum = 0;
- for (var i = 0; i < vs.length; i += 1) {
- sum += vs[i];
- }
-
- return sum / vs.length;
-}
-
-// Convert the font object to a SFNT data structure.
-// This structure contains all the necessary tables and metadata to create a binary OTF file.
-function fontToSfntTable(font) {
- var xMins = [];
- var yMins = [];
- var xMaxs = [];
- var yMaxs = [];
- var advanceWidths = [];
- var leftSideBearings = [];
- var rightSideBearings = [];
- var firstCharIndex;
- var lastCharIndex = 0;
- var ulUnicodeRange1 = 0;
- var ulUnicodeRange2 = 0;
- var ulUnicodeRange3 = 0;
- var ulUnicodeRange4 = 0;
-
- for (var i = 0; i < font.glyphs.length; i += 1) {
- var glyph = font.glyphs.get(i);
- var unicode = glyph.unicode | 0;
-
- if (isNaN(glyph.advanceWidth)) {
- throw new Error('Glyph ' + glyph.name + ' (' + i + '): advanceWidth is not a number.');
- }
-
- if (firstCharIndex > unicode || firstCharIndex === undefined) {
- // ignore .notdef char
- if (unicode > 0) {
- firstCharIndex = unicode;
- }
- }
-
- if (lastCharIndex < unicode) {
- lastCharIndex = unicode;
- }
-
- var position = os2.getUnicodeRange(unicode);
- if (position < 32) {
- ulUnicodeRange1 |= 1 << position;
- } else if (position < 64) {
- ulUnicodeRange2 |= 1 << position - 32;
- } else if (position < 96) {
- ulUnicodeRange3 |= 1 << position - 64;
- } else if (position < 123) {
- ulUnicodeRange4 |= 1 << position - 96;
- } else {
- throw new Error('Unicode ranges bits > 123 are reserved for internal usage');
- }
- // Skip non-important characters.
- if (glyph.name === '.notdef') continue;
- var metrics = glyph.getMetrics();
- xMins.push(metrics.xMin);
- yMins.push(metrics.yMin);
- xMaxs.push(metrics.xMax);
- yMaxs.push(metrics.yMax);
- leftSideBearings.push(metrics.leftSideBearing);
- rightSideBearings.push(metrics.rightSideBearing);
- advanceWidths.push(glyph.advanceWidth);
- }
-
- var globals = {
- xMin: Math.min.apply(null, xMins),
- yMin: Math.min.apply(null, yMins),
- xMax: Math.max.apply(null, xMaxs),
- yMax: Math.max.apply(null, yMaxs),
- advanceWidthMax: Math.max.apply(null, advanceWidths),
- advanceWidthAvg: average(advanceWidths),
- minLeftSideBearing: Math.min.apply(null, leftSideBearings),
- maxLeftSideBearing: Math.max.apply(null, leftSideBearings),
- minRightSideBearing: Math.min.apply(null, rightSideBearings)
- };
- globals.ascender = font.ascender;
- globals.descender = font.descender;
-
- var headTable = head.make({
- flags: 3, // 00000011 (baseline for font at y=0; left sidebearing point at x=0)
- unitsPerEm: font.unitsPerEm,
- xMin: globals.xMin,
- yMin: globals.yMin,
- xMax: globals.xMax,
- yMax: globals.yMax,
- lowestRecPPEM: 3,
- createdTimestamp: font.createdTimestamp
- });
-
- var hheaTable = hhea.make({
- ascender: globals.ascender,
- descender: globals.descender,
- advanceWidthMax: globals.advanceWidthMax,
- minLeftSideBearing: globals.minLeftSideBearing,
- minRightSideBearing: globals.minRightSideBearing,
- xMaxExtent: globals.maxLeftSideBearing + (globals.xMax - globals.xMin),
- numberOfHMetrics: font.glyphs.length
- });
-
- var maxpTable = maxp.make(font.glyphs.length);
-
- var os2Table = os2.make({
- xAvgCharWidth: Math.round(globals.advanceWidthAvg),
- usWeightClass: font.tables.os2.usWeightClass,
- usWidthClass: font.tables.os2.usWidthClass,
- usFirstCharIndex: firstCharIndex,
- usLastCharIndex: lastCharIndex,
- ulUnicodeRange1: ulUnicodeRange1,
- ulUnicodeRange2: ulUnicodeRange2,
- ulUnicodeRange3: ulUnicodeRange3,
- ulUnicodeRange4: ulUnicodeRange4,
- fsSelection: font.tables.os2.fsSelection, // REGULAR
- // See http://typophile.com/node/13081 for more info on vertical metrics.
- // We get metrics for typical characters (such as "x" for xHeight).
- // We provide some fallback characters if characters are unavailable: their
- // ordering was chosen experimentally.
- sTypoAscender: globals.ascender,
- sTypoDescender: globals.descender,
- sTypoLineGap: 0,
- usWinAscent: globals.yMax,
- usWinDescent: Math.abs(globals.yMin),
- ulCodePageRange1: 1, // FIXME: hard-code Latin 1 support for now
- sxHeight: metricsForChar(font, 'xyvw', {yMax: Math.round(globals.ascender / 2)}).yMax,
- sCapHeight: metricsForChar(font, 'HIKLEFJMNTZBDPRAGOQSUVWXY', globals).yMax,
- usDefaultChar: font.hasChar(' ') ? 32 : 0, // Use space as the default character, if available.
- usBreakChar: font.hasChar(' ') ? 32 : 0 // Use space as the break character, if available.
- });
-
- var hmtxTable = hmtx.make(font.glyphs);
- var cmapTable = cmap.make(font.glyphs);
-
- var englishFamilyName = font.getEnglishName('fontFamily');
- var englishStyleName = font.getEnglishName('fontSubfamily');
- var englishFullName = englishFamilyName + ' ' + englishStyleName;
- var postScriptName = font.getEnglishName('postScriptName');
- if (!postScriptName) {
- postScriptName = englishFamilyName.replace(/\s/g, '') + '-' + englishStyleName;
- }
-
- var names = {};
- for (var n in font.names) {
- names[n] = font.names[n];
- }
-
- if (!names.uniqueID) {
- names.uniqueID = {en: font.getEnglishName('manufacturer') + ':' + englishFullName};
- }
-
- if (!names.postScriptName) {
- names.postScriptName = {en: postScriptName};
- }
-
- if (!names.preferredFamily) {
- names.preferredFamily = font.names.fontFamily;
- }
-
- if (!names.preferredSubfamily) {
- names.preferredSubfamily = font.names.fontSubfamily;
- }
-
- var languageTags = [];
- var nameTable = _name.make(names, languageTags);
- var ltagTable = (languageTags.length > 0 ? ltag.make(languageTags) : undefined);
-
- var postTable = post.make();
- var cffTable = cff.make(font.glyphs, {
- version: font.getEnglishName('version'),
- fullName: englishFullName,
- familyName: englishFamilyName,
- weightName: englishStyleName,
- postScriptName: postScriptName,
- unitsPerEm: font.unitsPerEm,
- fontBBox: [0, globals.yMin, globals.ascender, globals.advanceWidthMax]
- });
-
- var metaTable = (font.metas && Object.keys(font.metas).length > 0) ? meta.make(font.metas) : undefined;
-
- // The order does not matter because makeSfntTable() will sort them.
- var tables = [headTable, hheaTable, maxpTable, os2Table, nameTable, cmapTable, postTable, cffTable, hmtxTable];
- if (ltagTable) {
- tables.push(ltagTable);
- }
- // Optional tables
- if (font.tables.gsub) {
- tables.push(gsub.make(font.tables.gsub));
- }
- if (metaTable) {
- tables.push(metaTable);
- }
-
- var sfntTable = makeSfntTable(tables);
-
- // Compute the font's checkSum and store it in head.checkSumAdjustment.
- var bytes = sfntTable.encode();
- var checkSum = computeCheckSum(bytes);
- var tableFields = sfntTable.fields;
- var checkSumAdjusted = false;
- for (i = 0; i < tableFields.length; i += 1) {
- if (tableFields[i].name === 'head table') {
- tableFields[i].value.checkSumAdjustment = 0xB1B0AFBA - checkSum;
- checkSumAdjusted = true;
- break;
- }
- }
-
- if (!checkSumAdjusted) {
- throw new Error('Could not find head table with checkSum to adjust.');
- }
-
- return sfntTable;
-}
-
-exports.computeCheckSum = computeCheckSum;
-exports.make = makeSfntTable;
-exports.fontToTable = fontToSfntTable;
-
-},{"../check":10,"../table":22,"./cff":23,"./cmap":24,"./gsub":28,"./head":29,"./hhea":30,"./hmtx":31,"./ltag":34,"./maxp":35,"./meta":36,"./name":37,"./os2":38,"./post":39}],41:[function(_dereq_,module,exports){
-// Data types used in the OpenType font file.
-// All OpenType fonts use Motorola-style byte ordering (Big Endian)
-
-/* global WeakMap */
-
-'use strict';
-
-var check = _dereq_('./check');
-
-var LIMIT16 = 32768; // The limit at which a 16-bit number switches signs == 2^15
-var LIMIT32 = 2147483648; // The limit at which a 32-bit number switches signs == 2 ^ 31
-
-/**
- * @exports opentype.decode
- * @class
- */
-var decode = {};
-/**
- * @exports opentype.encode
- * @class
- */
-var encode = {};
-/**
- * @exports opentype.sizeOf
- * @class
- */
-var sizeOf = {};
-
-// Return a function that always returns the same value.
-function constant(v) {
- return function() {
- return v;
- };
-}
-
-// OpenType data types //////////////////////////////////////////////////////
-
-/**
- * Convert an 8-bit unsigned integer to a list of 1 byte.
- * @param {number}
- * @returns {Array}
- */
-encode.BYTE = function(v) {
- check.argument(v >= 0 && v <= 255, 'Byte value should be between 0 and 255.');
- return [v];
-};
-/**
- * @constant
- * @type {number}
- */
-sizeOf.BYTE = constant(1);
-
-/**
- * Convert a 8-bit signed integer to a list of 1 byte.
- * @param {string}
- * @returns {Array}
- */
-encode.CHAR = function(v) {
- return [v.charCodeAt(0)];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.CHAR = constant(1);
-
-/**
- * Convert an ASCII string to a list of bytes.
- * @param {string}
- * @returns {Array}
- */
-encode.CHARARRAY = function(v) {
- var b = [];
- for (var i = 0; i < v.length; i += 1) {
- b[i] = v.charCodeAt(i);
- }
-
- return b;
-};
-
-/**
- * @param {Array}
- * @returns {number}
- */
-sizeOf.CHARARRAY = function(v) {
- return v.length;
-};
-
-/**
- * Convert a 16-bit unsigned integer to a list of 2 bytes.
- * @param {number}
- * @returns {Array}
- */
-encode.USHORT = function(v) {
- return [(v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.USHORT = constant(2);
-
-/**
- * Convert a 16-bit signed integer to a list of 2 bytes.
- * @param {number}
- * @returns {Array}
- */
-encode.SHORT = function(v) {
- // Two's complement
- if (v >= LIMIT16) {
- v = -(2 * LIMIT16 - v);
- }
-
- return [(v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.SHORT = constant(2);
-
-/**
- * Convert a 24-bit unsigned integer to a list of 3 bytes.
- * @param {number}
- * @returns {Array}
- */
-encode.UINT24 = function(v) {
- return [(v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.UINT24 = constant(3);
-
-/**
- * Convert a 32-bit unsigned integer to a list of 4 bytes.
- * @param {number}
- * @returns {Array}
- */
-encode.ULONG = function(v) {
- return [(v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.ULONG = constant(4);
-
-/**
- * Convert a 32-bit unsigned integer to a list of 4 bytes.
- * @param {number}
- * @returns {Array}
- */
-encode.LONG = function(v) {
- // Two's complement
- if (v >= LIMIT32) {
- v = -(2 * LIMIT32 - v);
- }
-
- return [(v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.LONG = constant(4);
-
-encode.FIXED = encode.ULONG;
-sizeOf.FIXED = sizeOf.ULONG;
-
-encode.FWORD = encode.SHORT;
-sizeOf.FWORD = sizeOf.SHORT;
-
-encode.UFWORD = encode.USHORT;
-sizeOf.UFWORD = sizeOf.USHORT;
-
-/**
- * Convert a 32-bit Apple Mac timestamp integer to a list of 8 bytes, 64-bit timestamp.
- * @param {number}
- * @returns {Array}
- */
-encode.LONGDATETIME = function(v) {
- return [0, 0, 0, 0, (v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.LONGDATETIME = constant(8);
-
-/**
- * Convert a 4-char tag to a list of 4 bytes.
- * @param {string}
- * @returns {Array}
- */
-encode.TAG = function(v) {
- check.argument(v.length === 4, 'Tag should be exactly 4 ASCII characters.');
- return [v.charCodeAt(0),
- v.charCodeAt(1),
- v.charCodeAt(2),
- v.charCodeAt(3)];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.TAG = constant(4);
-
-// CFF data types ///////////////////////////////////////////////////////////
-
-encode.Card8 = encode.BYTE;
-sizeOf.Card8 = sizeOf.BYTE;
-
-encode.Card16 = encode.USHORT;
-sizeOf.Card16 = sizeOf.USHORT;
-
-encode.OffSize = encode.BYTE;
-sizeOf.OffSize = sizeOf.BYTE;
-
-encode.SID = encode.USHORT;
-sizeOf.SID = sizeOf.USHORT;
-
-// Convert a numeric operand or charstring number to a variable-size list of bytes.
-/**
- * Convert a numeric operand or charstring number to a variable-size list of bytes.
- * @param {number}
- * @returns {Array}
- */
-encode.NUMBER = function(v) {
- if (v >= -107 && v <= 107) {
- return [v + 139];
- } else if (v >= 108 && v <= 1131) {
- v = v - 108;
- return [(v >> 8) + 247, v & 0xFF];
- } else if (v >= -1131 && v <= -108) {
- v = -v - 108;
- return [(v >> 8) + 251, v & 0xFF];
- } else if (v >= -32768 && v <= 32767) {
- return encode.NUMBER16(v);
- } else {
- return encode.NUMBER32(v);
- }
-};
-
-/**
- * @param {number}
- * @returns {number}
- */
-sizeOf.NUMBER = function(v) {
- return encode.NUMBER(v).length;
-};
-
-/**
- * Convert a signed number between -32768 and +32767 to a three-byte value.
- * This ensures we always use three bytes, but is not the most compact format.
- * @param {number}
- * @returns {Array}
- */
-encode.NUMBER16 = function(v) {
- return [28, (v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.NUMBER16 = constant(3);
-
-/**
- * Convert a signed number between -(2^31) and +(2^31-1) to a five-byte value.
- * This is useful if you want to be sure you always use four bytes,
- * at the expense of wasting a few bytes for smaller numbers.
- * @param {number}
- * @returns {Array}
- */
-encode.NUMBER32 = function(v) {
- return [29, (v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF];
-};
-
-/**
- * @constant
- * @type {number}
- */
-sizeOf.NUMBER32 = constant(5);
-
-/**
- * @param {number}
- * @returns {Array}
- */
-encode.REAL = function(v) {
- var value = v.toString();
-
- // Some numbers use an epsilon to encode the value. (e.g. JavaScript will store 0.0000001 as 1e-7)
- // This code converts it back to a number without the epsilon.
- var m = /\.(\d*?)(?:9{5,20}|0{5,20})\d{0,2}(?:e(.+)|$)/.exec(value);
- if (m) {
- var epsilon = parseFloat('1e' + ((m[2] ? +m[2] : 0) + m[1].length));
- value = (Math.round(v * epsilon) / epsilon).toString();
- }
-
- var nibbles = '';
- var i;
- var ii;
- for (i = 0, ii = value.length; i < ii; i += 1) {
- var c = value[i];
- if (c === 'e') {
- nibbles += value[++i] === '-' ? 'c' : 'b';
- } else if (c === '.') {
- nibbles += 'a';
- } else if (c === '-') {
- nibbles += 'e';
- } else {
- nibbles += c;
- }
- }
-
- nibbles += (nibbles.length & 1) ? 'f' : 'ff';
- var out = [30];
- for (i = 0, ii = nibbles.length; i < ii; i += 2) {
- out.push(parseInt(nibbles.substr(i, 2), 16));
- }
-
- return out;
-};
-
-/**
- * @param {number}
- * @returns {number}
- */
-sizeOf.REAL = function(v) {
- return encode.REAL(v).length;
-};
-
-encode.NAME = encode.CHARARRAY;
-sizeOf.NAME = sizeOf.CHARARRAY;
-
-encode.STRING = encode.CHARARRAY;
-sizeOf.STRING = sizeOf.CHARARRAY;
-
-/**
- * @param {DataView} data
- * @param {number} offset
- * @param {number} numBytes
- * @returns {string}
- */
-decode.UTF8 = function(data, offset, numBytes) {
- var codePoints = [];
- var numChars = numBytes;
- for (var j = 0; j < numChars; j++, offset += 1) {
- codePoints[j] = data.getUint8(offset);
- }
-
- return String.fromCharCode.apply(null, codePoints);
-};
-
-/**
- * @param {DataView} data
- * @param {number} offset
- * @param {number} numBytes
- * @returns {string}
- */
-decode.UTF16 = function(data, offset, numBytes) {
- var codePoints = [];
- var numChars = numBytes / 2;
- for (var j = 0; j < numChars; j++, offset += 2) {
- codePoints[j] = data.getUint16(offset);
- }
-
- return String.fromCharCode.apply(null, codePoints);
-};
-
-/**
- * Convert a JavaScript string to UTF16-BE.
- * @param {string}
- * @returns {Array}
- */
-encode.UTF16 = function(v) {
- var b = [];
- for (var i = 0; i < v.length; i += 1) {
- var codepoint = v.charCodeAt(i);
- b[b.length] = (codepoint >> 8) & 0xFF;
- b[b.length] = codepoint & 0xFF;
- }
-
- return b;
-};
-
-/**
- * @param {string}
- * @returns {number}
- */
-sizeOf.UTF16 = function(v) {
- return v.length * 2;
-};
-
-// Data for converting old eight-bit Macintosh encodings to Unicode.
-// This representation is optimized for decoding; encoding is slower
-// and needs more memory. The assumption is that all opentype.js users
-// want to open fonts, but saving a font will be comperatively rare
-// so it can be more expensive. Keyed by IANA character set name.
-//
-// Python script for generating these strings:
-//
-// s = u''.join([chr(c).decode('mac_greek') for c in range(128, 256)])
-// print(s.encode('utf-8'))
-/**
- * @private
- */
-var eightBitMacEncodings = {
- 'x-mac-croatian': // Python: 'mac_croatian'
- 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®Š™´¨≠ŽØ∞±≤≥∆µ∂∑∏š∫ªºΩžø' +
- '¿¡¬√ƒ≈Ć«Č… ÀÃÕŒœĐ—“”‘’÷◊©⁄€‹›Æ»–·‚„‰ÂćÁčÈÍÎÏÌÓÔđÒÚÛÙıˆ˜¯πË˚¸Êæˇ',
- 'x-mac-cyrillic': // Python: 'mac_cyrillic'
- 'АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ†°Ґ£§•¶І®©™Ђђ≠Ѓѓ∞±≤≥іµґЈЄєЇїЉљЊњ' +
- 'јЅ¬√ƒ≈∆«»… ЋћЌќѕ–—“”‘’÷„ЎўЏџ№Ёёяабвгдежзийклмнопрстуфхцчшщъыьэю',
- 'x-mac-gaelic':
- // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/GAELIC.TXT
- 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØḂ±≤≥ḃĊċḊḋḞḟĠġṀæø' +
- 'ṁṖṗɼƒſṠ«»… ÀÃÕŒœ–—“”‘’ṡẛÿŸṪ€‹›Ŷŷṫ·Ỳỳ⁊ÂÊÁËÈÍÎÏÌÓÔ♣ÒÚÛÙıÝýŴŵẄẅẀẁẂẃ',
- 'x-mac-greek': // Python: 'mac_greek'
- 'Ĺ²É³ÖÜ΅àâä΄¨çéèê룙î‰ôö¦€ùûü†ΓΔΘΛΞΠß®©ΣΪ§≠°·Α±≤≥¥ΒΕΖΗΙΚΜΦΫΨΩ' +
- 'άΝ¬ΟΡ≈Τ«»… ΥΧΆΈœ–―“”‘’÷ΉΊΌΎέήίόΏύαβψδεφγηιξκλμνοπώρστθωςχυζϊϋΐΰ\u00AD',
- 'x-mac-icelandic': // Python: 'mac_iceland'
- 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûüÝ°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' +
- '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€ÐðÞþý·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ',
- 'x-mac-inuit':
- // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/INUIT.TXT
- 'ᐃᐄᐅᐆᐊᐋᐱᐲᐳᐴᐸᐹᑉᑎᑏᑐᑑᑕᑖᑦᑭᑮᑯᑰᑲᑳᒃᒋᒌᒍᒎᒐᒑ°ᒡᒥᒦ•¶ᒧ®©™ᒨᒪᒫᒻᓂᓃᓄᓅᓇᓈᓐᓯᓰᓱᓲᓴᓵᔅᓕᓖᓗ' +
- 'ᓘᓚᓛᓪᔨᔩᔪᔫᔭ… ᔮᔾᕕᕖᕗ–—“”‘’ᕘᕙᕚᕝᕆᕇᕈᕉᕋᕌᕐᕿᖀᖁᖂᖃᖄᖅᖏᖐᖑᖒᖓᖔᖕᙱᙲᙳᙴᙵᙶᖖᖠᖡᖢᖣᖤᖥᖦᕼŁł',
- 'x-mac-ce': // Python: 'mac_latin2'
- 'ÄĀāÉĄÖÜáąČäčĆć鏟ĎíďĒēĖóėôöõúĚěü†°Ę£§•¶ß®©™ę¨≠ģĮįĪ≤≥īĶ∂∑łĻļĽľĹĺŅ' +
- 'ņѬ√ńŇ∆«»… ňŐÕőŌ–—“”‘’÷◊ōŔŕŘ‹›řŖŗŠ‚„šŚśÁŤťÍŽžŪÓÔūŮÚůŰűŲųÝýķŻŁżĢˇ',
- macintosh: // Python: 'mac_roman'
- 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' +
- '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›fifl‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ',
- 'x-mac-romanian': // Python: 'mac_romanian'
- 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ĂȘ∞±≤≥¥µ∂∑∏π∫ªºΩăș' +
- '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›Țț‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ',
- 'x-mac-turkish': // Python: 'mac_turkish'
- 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' +
- '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ'
-};
-
-/**
- * Decodes an old-style Macintosh string. Returns either a Unicode JavaScript
- * string, or 'undefined' if the encoding is unsupported. For example, we do
- * not support Chinese, Japanese or Korean because these would need large
- * mapping tables.
- * @param {DataView} dataView
- * @param {number} offset
- * @param {number} dataLength
- * @param {string} encoding
- * @returns {string}
- */
-decode.MACSTRING = function(dataView, offset, dataLength, encoding) {
- var table = eightBitMacEncodings[encoding];
- if (table === undefined) {
- return undefined;
- }
-
- var result = '';
- for (var i = 0; i < dataLength; i++) {
- var c = dataView.getUint8(offset + i);
- // In all eight-bit Mac encodings, the characters 0x00..0x7F are
- // mapped to U+0000..U+007F; we only need to look up the others.
- if (c <= 0x7F) {
- result += String.fromCharCode(c);
- } else {
- result += table[c & 0x7F];
- }
- }
-
- return result;
-};
-
-// Helper function for encode.MACSTRING. Returns a dictionary for mapping
-// Unicode character codes to their 8-bit MacOS equivalent. This table
-// is not exactly a super cheap data structure, but we do not care because
-// encoding Macintosh strings is only rarely needed in typical applications.
-var macEncodingTableCache = typeof WeakMap === 'function' && new WeakMap();
-var macEncodingCacheKeys;
-var getMacEncodingTable = function(encoding) {
- // Since we use encoding as a cache key for WeakMap, it has to be
- // a String object and not a literal. And at least on NodeJS 2.10.1,
- // WeakMap requires that the same String instance is passed for cache hits.
- if (!macEncodingCacheKeys) {
- macEncodingCacheKeys = {};
- for (var e in eightBitMacEncodings) {
- /*jshint -W053 */ // Suppress "Do not use String as a constructor."
- macEncodingCacheKeys[e] = new String(e);
- }
- }
-
- var cacheKey = macEncodingCacheKeys[encoding];
- if (cacheKey === undefined) {
- return undefined;
- }
-
- // We can't do "if (cache.has(key)) {return cache.get(key)}" here:
- // since garbage collection may run at any time, it could also kick in
- // between the calls to cache.has() and cache.get(). In that case,
- // we would return 'undefined' even though we do support the encoding.
- if (macEncodingTableCache) {
- var cachedTable = macEncodingTableCache.get(cacheKey);
- if (cachedTable !== undefined) {
- return cachedTable;
- }
- }
-
- var decodingTable = eightBitMacEncodings[encoding];
- if (decodingTable === undefined) {
- return undefined;
- }
-
- var encodingTable = {};
- for (var i = 0; i < decodingTable.length; i++) {
- encodingTable[decodingTable.charCodeAt(i)] = i + 0x80;
- }
-
- if (macEncodingTableCache) {
- macEncodingTableCache.set(cacheKey, encodingTable);
- }
-
- return encodingTable;
-};
-
-/**
- * Encodes an old-style Macintosh string. Returns a byte array upon success.
- * If the requested encoding is unsupported, or if the input string contains
- * a character that cannot be expressed in the encoding, the function returns
- * 'undefined'.
- * @param {string} str
- * @param {string} encoding
- * @returns {Array}
- */
-encode.MACSTRING = function(str, encoding) {
- var table = getMacEncodingTable(encoding);
- if (table === undefined) {
- return undefined;
- }
-
- var result = [];
- for (var i = 0; i < str.length; i++) {
- var c = str.charCodeAt(i);
-
- // In all eight-bit Mac encodings, the characters 0x00..0x7F are
- // mapped to U+0000..U+007F; we only need to look up the others.
- if (c >= 0x80) {
- c = table[c];
- if (c === undefined) {
- // str contains a Unicode character that cannot be encoded
- // in the requested encoding.
- return undefined;
- }
- }
- result[i] = c;
- // result.push(c);
- }
-
- return result;
-};
-
-/**
- * @param {string} str
- * @param {string} encoding
- * @returns {number}
- */
-sizeOf.MACSTRING = function(str, encoding) {
- var b = encode.MACSTRING(str, encoding);
- if (b !== undefined) {
- return b.length;
- } else {
- return 0;
- }
-};
-
-// Helper for encode.VARDELTAS
-function isByteEncodable(value) {
- return value >= -128 && value <= 127;
-}
-
-// Helper for encode.VARDELTAS
-function encodeVarDeltaRunAsZeroes(deltas, pos, result) {
- var runLength = 0;
- var numDeltas = deltas.length;
- while (pos < numDeltas && runLength < 64 && deltas[pos] === 0) {
- ++pos;
- ++runLength;
- }
- result.push(0x80 | (runLength - 1));
- return pos;
-}
-
-// Helper for encode.VARDELTAS
-function encodeVarDeltaRunAsBytes(deltas, offset, result) {
- var runLength = 0;
- var numDeltas = deltas.length;
- var pos = offset;
- while (pos < numDeltas && runLength < 64) {
- var value = deltas[pos];
- if (!isByteEncodable(value)) {
- break;
- }
-
- // Within a byte-encoded run of deltas, a single zero is best
- // stored literally as 0x00 value. However, if we have two or
- // more zeroes in a sequence, it is better to start a new run.
- // Fore example, the sequence of deltas [15, 15, 0, 15, 15]
- // becomes 6 bytes (04 0F 0F 00 0F 0F) when storing the zero
- // within the current run, but 7 bytes (01 0F 0F 80 01 0F 0F)
- // when starting a new run.
- if (value === 0 && pos + 1 < numDeltas && deltas[pos + 1] === 0) {
- break;
- }
-
- ++pos;
- ++runLength;
- }
- result.push(runLength - 1);
- for (var i = offset; i < pos; ++i) {
- result.push((deltas[i] + 256) & 0xff);
- }
- return pos;
-}
-
-// Helper for encode.VARDELTAS
-function encodeVarDeltaRunAsWords(deltas, offset, result) {
- var runLength = 0;
- var numDeltas = deltas.length;
- var pos = offset;
- while (pos < numDeltas && runLength < 64) {
- var value = deltas[pos];
-
- // Within a word-encoded run of deltas, it is easiest to start
- // a new run (with a different encoding) whenever we encounter
- // a zero value. For example, the sequence [0x6666, 0, 0x7777]
- // needs 7 bytes when storing the zero inside the current run
- // (42 66 66 00 00 77 77), and equally 7 bytes when starting a
- // new run (40 66 66 80 40 77 77).
- if (value === 0) {
- break;
- }
-
- // Within a word-encoded run of deltas, a single value in the
- // range (-128..127) should be encoded within the current run
- // because it is more compact. For example, the sequence
- // [0x6666, 2, 0x7777] becomes 7 bytes when storing the value
- // literally (42 66 66 00 02 77 77), but 8 bytes when starting
- // a new run (40 66 66 00 02 40 77 77).
- if (isByteEncodable(value) && pos + 1 < numDeltas && isByteEncodable(deltas[pos + 1])) {
- break;
- }
-
- ++pos;
- ++runLength;
- }
- result.push(0x40 | (runLength - 1));
- for (var i = offset; i < pos; ++i) {
- var val = deltas[i];
- result.push(((val + 0x10000) >> 8) & 0xff, (val + 0x100) & 0xff);
- }
- return pos;
-}
-
-/**
- * Encode a list of variation adjustment deltas.
- *
- * Variation adjustment deltas are used in ‘gvar’ and ‘cvar’ tables.
- * They indicate how points (in ‘gvar’) or values (in ‘cvar’) get adjusted
- * when generating instances of variation fonts.
- *
- * @see https://www.microsoft.com/typography/otspec/gvar.htm
- * @see https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6gvar.html
- * @param {Array}
- * @return {Array}
- */
-encode.VARDELTAS = function(deltas) {
- var pos = 0;
- var result = [];
- while (pos < deltas.length) {
- var value = deltas[pos];
- if (value === 0) {
- pos = encodeVarDeltaRunAsZeroes(deltas, pos, result);
- } else if (value >= -128 && value <= 127) {
- pos = encodeVarDeltaRunAsBytes(deltas, pos, result);
- } else {
- pos = encodeVarDeltaRunAsWords(deltas, pos, result);
- }
- }
- return result;
-};
-
-// Convert a list of values to a CFF INDEX structure.
-// The values should be objects containing name / type / value.
-/**
- * @param {Array} l
- * @returns {Array}
- */
-encode.INDEX = function(l) {
- var i;
- //var offset, offsets, offsetEncoder, encodedOffsets, encodedOffset, data,
- // i, v;
- // Because we have to know which data type to use to encode the offsets,
- // we have to go through the values twice: once to encode the data and
- // calculate the offets, then again to encode the offsets using the fitting data type.
- var offset = 1; // First offset is always 1.
- var offsets = [offset];
- var data = [];
- for (i = 0; i < l.length; i += 1) {
- var v = encode.OBJECT(l[i]);
- Array.prototype.push.apply(data, v);
- offset += v.length;
- offsets.push(offset);
- }
-
- if (data.length === 0) {
- return [0, 0];
- }
-
- var encodedOffsets = [];
- var offSize = (1 + Math.floor(Math.log(offset) / Math.log(2)) / 8) | 0;
- var offsetEncoder = [undefined, encode.BYTE, encode.USHORT, encode.UINT24, encode.ULONG][offSize];
- for (i = 0; i < offsets.length; i += 1) {
- var encodedOffset = offsetEncoder(offsets[i]);
- Array.prototype.push.apply(encodedOffsets, encodedOffset);
- }
-
- return Array.prototype.concat(encode.Card16(l.length),
- encode.OffSize(offSize),
- encodedOffsets,
- data);
-};
-
-/**
- * @param {Array}
- * @returns {number}
- */
-sizeOf.INDEX = function(v) {
- return encode.INDEX(v).length;
-};
-
-/**
- * Convert an object to a CFF DICT structure.
- * The keys should be numeric.
- * The values should be objects containing name / type / value.
- * @param {Object} m
- * @returns {Array}
- */
-encode.DICT = function(m) {
- var d = [];
- var keys = Object.keys(m);
- var length = keys.length;
-
- for (var i = 0; i < length; i += 1) {
- // Object.keys() return string keys, but our keys are always numeric.
- var k = parseInt(keys[i], 0);
- var v = m[k];
- // Value comes before the key.
- d = d.concat(encode.OPERAND(v.value, v.type));
- d = d.concat(encode.OPERATOR(k));
- }
-
- return d;
-};
-
-/**
- * @param {Object}
- * @returns {number}
- */
-sizeOf.DICT = function(m) {
- return encode.DICT(m).length;
-};
-
-/**
- * @param {number}
- * @returns {Array}
- */
-encode.OPERATOR = function(v) {
- if (v < 1200) {
- return [v];
- } else {
- return [12, v - 1200];
- }
-};
-
-/**
- * @param {Array} v
- * @param {string}
- * @returns {Array}
- */
-encode.OPERAND = function(v, type) {
- var d = [];
- if (Array.isArray(type)) {
- for (var i = 0; i < type.length; i += 1) {
- check.argument(v.length === type.length, 'Not enough arguments given for type' + type);
- d = d.concat(encode.OPERAND(v[i], type[i]));
- }
- } else {
- if (type === 'SID') {
- d = d.concat(encode.NUMBER(v));
- } else if (type === 'offset') {
- // We make it easy for ourselves and always encode offsets as
- // 4 bytes. This makes offset calculation for the top dict easier.
- d = d.concat(encode.NUMBER32(v));
- } else if (type === 'number') {
- d = d.concat(encode.NUMBER(v));
- } else if (type === 'real') {
- d = d.concat(encode.REAL(v));
- } else {
- throw new Error('Unknown operand type ' + type);
- // FIXME Add support for booleans
- }
- }
-
- return d;
-};
-
-encode.OP = encode.BYTE;
-sizeOf.OP = sizeOf.BYTE;
-
-// memoize charstring encoding using WeakMap if available
-var wmm = typeof WeakMap === 'function' && new WeakMap();
-
-/**
- * Convert a list of CharString operations to bytes.
- * @param {Array}
- * @returns {Array}
- */
-encode.CHARSTRING = function(ops) {
- // See encode.MACSTRING for why we don't do "if (wmm && wmm.has(ops))".
- if (wmm) {
- var cachedValue = wmm.get(ops);
- if (cachedValue !== undefined) {
- return cachedValue;
- }
- }
-
- var d = [];
- var length = ops.length;
-
- for (var i = 0; i < length; i += 1) {
- var op = ops[i];
- d = d.concat(encode[op.type](op.value));
- }
-
- if (wmm) {
- wmm.set(ops, d);
- }
-
- return d;
-};
-
-/**
- * @param {Array}
- * @returns {number}
- */
-sizeOf.CHARSTRING = function(ops) {
- return encode.CHARSTRING(ops).length;
-};
-
-// Utility functions ////////////////////////////////////////////////////////
-
-/**
- * Convert an object containing name / type / value to bytes.
- * @param {Object}
- * @returns {Array}
- */
-encode.OBJECT = function(v) {
- var encodingFunction = encode[v.type];
- check.argument(encodingFunction !== undefined, 'No encoding function for type ' + v.type);
- return encodingFunction(v.value);
-};
-
-/**
- * @param {Object}
- * @returns {number}
- */
-sizeOf.OBJECT = function(v) {
- var sizeOfFunction = sizeOf[v.type];
- check.argument(sizeOfFunction !== undefined, 'No sizeOf function for type ' + v.type);
- return sizeOfFunction(v.value);
-};
-
-/**
- * Convert a table object to bytes.
- * A table contains a list of fields containing the metadata (name, type and default value).
- * The table itself has the field values set as attributes.
- * @param {opentype.Table}
- * @returns {Array}
- */
-encode.TABLE = function(table) {
- var d = [];
- var length = table.fields.length;
- var subtables = [];
- var subtableOffsets = [];
- var i;
-
- for (i = 0; i < length; i += 1) {
- var field = table.fields[i];
- var encodingFunction = encode[field.type];
- check.argument(encodingFunction !== undefined, 'No encoding function for field type ' + field.type + ' (' + field.name + ')');
- var value = table[field.name];
- if (value === undefined) {
- value = field.value;
- }
-
- var bytes = encodingFunction(value);
-
- if (field.type === 'TABLE') {
- subtableOffsets.push(d.length);
- d = d.concat([0, 0]);
- subtables.push(bytes);
- } else {
- d = d.concat(bytes);
- }
- }
-
- for (i = 0; i < subtables.length; i += 1) {
- var o = subtableOffsets[i];
- var offset = d.length;
- check.argument(offset < 65536, 'Table ' + table.tableName + ' too big.');
- d[o] = offset >> 8;
- d[o + 1] = offset & 0xff;
- d = d.concat(subtables[i]);
- }
-
- return d;
-};
-
-/**
- * @param {opentype.Table}
- * @returns {number}
- */
-sizeOf.TABLE = function(table) {
- var numBytes = 0;
- var length = table.fields.length;
-
- for (var i = 0; i < length; i += 1) {
- var field = table.fields[i];
- var sizeOfFunction = sizeOf[field.type];
- check.argument(sizeOfFunction !== undefined, 'No sizeOf function for field type ' + field.type + ' (' + field.name + ')');
- var value = table[field.name];
- if (value === undefined) {
- value = field.value;
- }
-
- numBytes += sizeOfFunction(value);
-
- // Subtables take 2 more bytes for offsets.
- if (field.type === 'TABLE') {
- numBytes += 2;
- }
- }
-
- return numBytes;
-};
-
-encode.RECORD = encode.TABLE;
-sizeOf.RECORD = sizeOf.TABLE;
-
-// Merge in a list of bytes.
-encode.LITERAL = function(v) {
- return v;
-};
-
-sizeOf.LITERAL = function(v) {
- return v.length;
-};
-
-exports.decode = decode;
-exports.encode = encode;
-exports.sizeOf = sizeOf;
-
-},{"./check":10}],42:[function(_dereq_,module,exports){
-(function (Buffer){
-'use strict';
-
-exports.isBrowser = function() {
- return typeof window !== 'undefined';
-};
-
-exports.isNode = function() {
- return typeof window === 'undefined';
-};
-
-exports.nodeBufferToArrayBuffer = function(buffer) {
- var ab = new ArrayBuffer(buffer.length);
- var view = new Uint8Array(ab);
- for (var i = 0; i < buffer.length; ++i) {
- view[i] = buffer[i];
- }
-
- return ab;
-};
-
-exports.arrayBufferToNodeBuffer = function(ab) {
- var buffer = new Buffer(ab.byteLength);
- var view = new Uint8Array(ab);
- for (var i = 0; i < buffer.length; ++i) {
- buffer[i] = view[i];
- }
-
- return buffer;
-};
-
-exports.checkArgument = function(expression, message) {
- if (!expression) {
- throw message;
- }
-};
-
-}).call(this,_dereq_("buffer").Buffer)
-},{"buffer":4}],43:[function(_dereq_,module,exports){
-// shim for using process in browser
-var process = module.exports = {};
-
-// cached from whatever global is present so that test runners that stub it
-// don't break things. But we need to wrap it in a try catch in case it is
-// wrapped in strict mode code which doesn't define any globals. It's inside a
-// function because try/catches deoptimize in certain engines.
-
-var cachedSetTimeout;
-var cachedClearTimeout;
-
-function defaultSetTimout() {
- throw new Error('setTimeout has not been defined');
-}
-function defaultClearTimeout () {
- throw new Error('clearTimeout has not been defined');
-}
-(function () {
- try {
- if (typeof setTimeout === 'function') {
- cachedSetTimeout = setTimeout;
- } else {
- cachedSetTimeout = defaultSetTimout;
- }
- } catch (e) {
- cachedSetTimeout = defaultSetTimout;
- }
- try {
- if (typeof clearTimeout === 'function') {
- cachedClearTimeout = clearTimeout;
- } else {
- cachedClearTimeout = defaultClearTimeout;
- }
- } catch (e) {
- cachedClearTimeout = defaultClearTimeout;
- }
-} ())
-function runTimeout(fun) {
- if (cachedSetTimeout === setTimeout) {
- //normal enviroments in sane situations
- return setTimeout(fun, 0);
- }
- // if setTimeout wasn't available but was latter defined
- if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) {
- cachedSetTimeout = setTimeout;
- return setTimeout(fun, 0);
- }
- try {
- // when when somebody has screwed with setTimeout but no I.E. maddness
- return cachedSetTimeout(fun, 0);
- } catch(e){
- try {
- // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally
- return cachedSetTimeout.call(null, fun, 0);
- } catch(e){
- // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error
- return cachedSetTimeout.call(this, fun, 0);
- }
- }
-
-
-}
-function runClearTimeout(marker) {
- if (cachedClearTimeout === clearTimeout) {
- //normal enviroments in sane situations
- return clearTimeout(marker);
- }
- // if clearTimeout wasn't available but was latter defined
- if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) {
- cachedClearTimeout = clearTimeout;
- return clearTimeout(marker);
- }
- try {
- // when when somebody has screwed with setTimeout but no I.E. maddness
- return cachedClearTimeout(marker);
- } catch (e){
- try {
- // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally
- return cachedClearTimeout.call(null, marker);
- } catch (e){
- // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error.
- // Some versions of I.E. have different rules for clearTimeout vs setTimeout
- return cachedClearTimeout.call(this, marker);
- }
- }
-
-
-
-}
-var queue = [];
-var draining = false;
-var currentQueue;
-var queueIndex = -1;
-
-function cleanUpNextTick() {
- if (!draining || !currentQueue) {
- return;
- }
- draining = false;
- if (currentQueue.length) {
- queue = currentQueue.concat(queue);
- } else {
- queueIndex = -1;
- }
- if (queue.length) {
- drainQueue();
- }
-}
-
-function drainQueue() {
- if (draining) {
- return;
- }
- var timeout = runTimeout(cleanUpNextTick);
- draining = true;
-
- var len = queue.length;
- while(len) {
- currentQueue = queue;
- queue = [];
- while (++queueIndex < len) {
- if (currentQueue) {
- currentQueue[queueIndex].run();
- }
- }
- queueIndex = -1;
- len = queue.length;
- }
- currentQueue = null;
- draining = false;
- runClearTimeout(timeout);
-}
-
-process.nextTick = function (fun) {
- var args = new Array(arguments.length - 1);
- if (arguments.length > 1) {
- for (var i = 1; i < arguments.length; i++) {
- args[i - 1] = arguments[i];
- }
- }
- queue.push(new Item(fun, args));
- if (queue.length === 1 && !draining) {
- runTimeout(drainQueue);
- }
-};
-
-// v8 likes predictible objects
-function Item(fun, array) {
- this.fun = fun;
- this.array = array;
-}
-Item.prototype.run = function () {
- this.fun.apply(null, this.array);
-};
-process.title = 'browser';
-process.browser = true;
-process.env = {};
-process.argv = [];
-process.version = ''; // empty string to avoid regexp issues
-process.versions = {};
-
-function noop() {}
-
-process.on = noop;
-process.addListener = noop;
-process.once = noop;
-process.off = noop;
-process.removeListener = noop;
-process.removeAllListeners = noop;
-process.emit = noop;
-
-process.binding = function (name) {
- throw new Error('process.binding is not supported');
-};
-
-process.cwd = function () { return '/' };
-process.chdir = function (dir) {
- throw new Error('process.chdir is not supported');
-};
-process.umask = function() { return 0; };
-
-},{}],44:[function(_dereq_,module,exports){
-var TINF_OK = 0;
-var TINF_DATA_ERROR = -3;
-
-function Tree() {
- this.table = new Uint16Array(16); /* table of code length counts */
- this.trans = new Uint16Array(288); /* code -> symbol translation table */
-}
-
-function Data(source, dest) {
- this.source = source;
- this.sourceIndex = 0;
- this.tag = 0;
- this.bitcount = 0;
-
- this.dest = dest;
- this.destLen = 0;
-
- this.ltree = new Tree(); /* dynamic length/symbol tree */
- this.dtree = new Tree(); /* dynamic distance tree */
-}
-
-/* --------------------------------------------------- *
- * -- uninitialized global data (static structures) -- *
- * --------------------------------------------------- */
-
-var sltree = new Tree();
-var sdtree = new Tree();
-
-/* extra bits and base tables for length codes */
-var length_bits = new Uint8Array(30);
-var length_base = new Uint16Array(30);
-
-/* extra bits and base tables for distance codes */
-var dist_bits = new Uint8Array(30);
-var dist_base = new Uint16Array(30);
-
-/* special ordering of code length codes */
-var clcidx = new Uint8Array([
- 16, 17, 18, 0, 8, 7, 9, 6,
- 10, 5, 11, 4, 12, 3, 13, 2,
- 14, 1, 15
-]);
-
-/* used by tinf_decode_trees, avoids allocations every call */
-var code_tree = new Tree();
-var lengths = new Uint8Array(288 + 32);
-
-/* ----------------------- *
- * -- utility functions -- *
- * ----------------------- */
-
-/* build extra bits and base tables */
-function tinf_build_bits_base(bits, base, delta, first) {
- var i, sum;
-
- /* build bits table */
- for (i = 0; i < delta; ++i) bits[i] = 0;
- for (i = 0; i < 30 - delta; ++i) bits[i + delta] = i / delta | 0;
-
- /* build base table */
- for (sum = first, i = 0; i < 30; ++i) {
- base[i] = sum;
- sum += 1 << bits[i];
- }
-}
-
-/* build the fixed huffman trees */
-function tinf_build_fixed_trees(lt, dt) {
- var i;
-
- /* build fixed length tree */
- for (i = 0; i < 7; ++i) lt.table[i] = 0;
-
- lt.table[7] = 24;
- lt.table[8] = 152;
- lt.table[9] = 112;
-
- for (i = 0; i < 24; ++i) lt.trans[i] = 256 + i;
- for (i = 0; i < 144; ++i) lt.trans[24 + i] = i;
- for (i = 0; i < 8; ++i) lt.trans[24 + 144 + i] = 280 + i;
- for (i = 0; i < 112; ++i) lt.trans[24 + 144 + 8 + i] = 144 + i;
-
- /* build fixed distance tree */
- for (i = 0; i < 5; ++i) dt.table[i] = 0;
-
- dt.table[5] = 32;
-
- for (i = 0; i < 32; ++i) dt.trans[i] = i;
-}
-
-/* given an array of code lengths, build a tree */
-var offs = new Uint16Array(16);
-
-function tinf_build_tree(t, lengths, off, num) {
- var i, sum;
-
- /* clear code length count table */
- for (i = 0; i < 16; ++i) t.table[i] = 0;
-
- /* scan symbol lengths, and sum code length counts */
- for (i = 0; i < num; ++i) t.table[lengths[off + i]]++;
-
- t.table[0] = 0;
-
- /* compute offset table for distribution sort */
- for (sum = 0, i = 0; i < 16; ++i) {
- offs[i] = sum;
- sum += t.table[i];
- }
-
- /* create code->symbol translation table (symbols sorted by code) */
- for (i = 0; i < num; ++i) {
- if (lengths[off + i]) t.trans[offs[lengths[off + i]]++] = i;
- }
-}
-
-/* ---------------------- *
- * -- decode functions -- *
- * ---------------------- */
-
-/* get one bit from source stream */
-function tinf_getbit(d) {
- /* check if tag is empty */
- if (!d.bitcount--) {
- /* load next tag */
- d.tag = d.source[d.sourceIndex++];
- d.bitcount = 7;
- }
-
- /* shift bit out of tag */
- var bit = d.tag & 1;
- d.tag >>>= 1;
-
- return bit;
-}
-
-/* read a num bit value from a stream and add base */
-function tinf_read_bits(d, num, base) {
- if (!num)
- return base;
-
- while (d.bitcount < 24) {
- d.tag |= d.source[d.sourceIndex++] << d.bitcount;
- d.bitcount += 8;
- }
-
- var val = d.tag & (0xffff >>> (16 - num));
- d.tag >>>= num;
- d.bitcount -= num;
- return val + base;
-}
-
-/* given a data stream and a tree, decode a symbol */
-function tinf_decode_symbol(d, t) {
- while (d.bitcount < 24) {
- d.tag |= d.source[d.sourceIndex++] << d.bitcount;
- d.bitcount += 8;
- }
-
- var sum = 0, cur = 0, len = 0;
- var tag = d.tag;
-
- /* get more bits while code value is above sum */
- do {
- cur = 2 * cur + (tag & 1);
- tag >>>= 1;
- ++len;
-
- sum += t.table[len];
- cur -= t.table[len];
- } while (cur >= 0);
-
- d.tag = tag;
- d.bitcount -= len;
-
- return t.trans[sum + cur];
-}
-
-/* given a data stream, decode dynamic trees from it */
-function tinf_decode_trees(d, lt, dt) {
- var hlit, hdist, hclen;
- var i, num, length;
-
- /* get 5 bits HLIT (257-286) */
- hlit = tinf_read_bits(d, 5, 257);
-
- /* get 5 bits HDIST (1-32) */
- hdist = tinf_read_bits(d, 5, 1);
-
- /* get 4 bits HCLEN (4-19) */
- hclen = tinf_read_bits(d, 4, 4);
-
- for (i = 0; i < 19; ++i) lengths[i] = 0;
-
- /* read code lengths for code length alphabet */
- for (i = 0; i < hclen; ++i) {
- /* get 3 bits code length (0-7) */
- var clen = tinf_read_bits(d, 3, 0);
- lengths[clcidx[i]] = clen;
- }
-
- /* build code length tree */
- tinf_build_tree(code_tree, lengths, 0, 19);
-
- /* decode code lengths for the dynamic trees */
- for (num = 0; num < hlit + hdist;) {
- var sym = tinf_decode_symbol(d, code_tree);
-
- switch (sym) {
- case 16:
- /* copy previous code length 3-6 times (read 2 bits) */
- var prev = lengths[num - 1];
- for (length = tinf_read_bits(d, 2, 3); length; --length) {
- lengths[num++] = prev;
- }
- break;
- case 17:
- /* repeat code length 0 for 3-10 times (read 3 bits) */
- for (length = tinf_read_bits(d, 3, 3); length; --length) {
- lengths[num++] = 0;
- }
- break;
- case 18:
- /* repeat code length 0 for 11-138 times (read 7 bits) */
- for (length = tinf_read_bits(d, 7, 11); length; --length) {
- lengths[num++] = 0;
- }
- break;
- default:
- /* values 0-15 represent the actual code lengths */
- lengths[num++] = sym;
- break;
- }
- }
-
- /* build dynamic trees */
- tinf_build_tree(lt, lengths, 0, hlit);
- tinf_build_tree(dt, lengths, hlit, hdist);
-}
-
-/* ----------------------------- *
- * -- block inflate functions -- *
- * ----------------------------- */
-
-/* given a stream and two trees, inflate a block of data */
-function tinf_inflate_block_data(d, lt, dt) {
- while (1) {
- var sym = tinf_decode_symbol(d, lt);
-
- /* check for end of block */
- if (sym === 256) {
- return TINF_OK;
- }
-
- if (sym < 256) {
- d.dest[d.destLen++] = sym;
- } else {
- var length, dist, offs;
- var i;
-
- sym -= 257;
-
- /* possibly get more bits from length code */
- length = tinf_read_bits(d, length_bits[sym], length_base[sym]);
-
- dist = tinf_decode_symbol(d, dt);
-
- /* possibly get more bits from distance code */
- offs = d.destLen - tinf_read_bits(d, dist_bits[dist], dist_base[dist]);
-
- /* copy match */
- for (i = offs; i < offs + length; ++i) {
- d.dest[d.destLen++] = d.dest[i];
- }
- }
- }
-}
-
-/* inflate an uncompressed block of data */
-function tinf_inflate_uncompressed_block(d) {
- var length, invlength;
- var i;
-
- /* unread from bitbuffer */
- while (d.bitcount > 8) {
- d.sourceIndex--;
- d.bitcount -= 8;
- }
-
- /* get length */
- length = d.source[d.sourceIndex + 1];
- length = 256 * length + d.source[d.sourceIndex];
-
- /* get one's complement of length */
- invlength = d.source[d.sourceIndex + 3];
- invlength = 256 * invlength + d.source[d.sourceIndex + 2];
-
- /* check length */
- if (length !== (~invlength & 0x0000ffff))
- return TINF_DATA_ERROR;
-
- d.sourceIndex += 4;
-
- /* copy block */
- for (i = length; i; --i)
- d.dest[d.destLen++] = d.source[d.sourceIndex++];
-
- /* make sure we start next block on a byte boundary */
- d.bitcount = 0;
-
- return TINF_OK;
-}
-
-/* inflate stream from source to dest */
-function tinf_uncompress(source, dest) {
- var d = new Data(source, dest);
- var bfinal, btype, res;
-
- do {
- /* read final block flag */
- bfinal = tinf_getbit(d);
-
- /* read block type (2 bits) */
- btype = tinf_read_bits(d, 2, 0);
-
- /* decompress block */
- switch (btype) {
- case 0:
- /* decompress uncompressed block */
- res = tinf_inflate_uncompressed_block(d);
- break;
- case 1:
- /* decompress block with fixed huffman trees */
- res = tinf_inflate_block_data(d, sltree, sdtree);
- break;
- case 2:
- /* decompress block with dynamic huffman trees */
- tinf_decode_trees(d, d.ltree, d.dtree);
- res = tinf_inflate_block_data(d, d.ltree, d.dtree);
- break;
- default:
- res = TINF_DATA_ERROR;
- }
-
- if (res !== TINF_OK)
- throw new Error('Data error');
-
- } while (!bfinal);
-
- if (d.destLen < d.dest.length) {
- if (typeof d.dest.slice === 'function')
- return d.dest.slice(0, d.destLen);
- else
- return d.dest.subarray(0, d.destLen);
- }
-
- return d.dest;
-}
-
-/* -------------------- *
- * -- initialization -- *
- * -------------------- */
-
-/* build fixed huffman trees */
-tinf_build_fixed_trees(sltree, sdtree);
-
-/* build extra bits and base tables */
-tinf_build_bits_base(length_bits, length_base, 4, 3);
-tinf_build_bits_base(dist_bits, dist_base, 2, 1);
-
-/* fix a special case */
-length_bits[28] = 0;
-length_base[28] = 258;
-
-module.exports = tinf_uncompress;
-
-},{}],45:[function(_dereq_,module,exports){
-(function(self) {
- 'use strict';
-
- if (self.fetch) {
- return
- }
-
- var support = {
- searchParams: 'URLSearchParams' in self,
- iterable: 'Symbol' in self && 'iterator' in Symbol,
- blob: 'FileReader' in self && 'Blob' in self && (function() {
- try {
- new Blob()
- return true
- } catch(e) {
- return false
- }
- })(),
- formData: 'FormData' in self,
- arrayBuffer: 'ArrayBuffer' in self
- }
-
- if (support.arrayBuffer) {
- var viewClasses = [
- '[object Int8Array]',
- '[object Uint8Array]',
- '[object Uint8ClampedArray]',
- '[object Int16Array]',
- '[object Uint16Array]',
- '[object Int32Array]',
- '[object Uint32Array]',
- '[object Float32Array]',
- '[object Float64Array]'
- ]
-
- var isDataView = function(obj) {
- return obj && DataView.prototype.isPrototypeOf(obj)
- }
-
- var isArrayBufferView = ArrayBuffer.isView || function(obj) {
- return obj && viewClasses.indexOf(Object.prototype.toString.call(obj)) > -1
- }
- }
-
- function normalizeName(name) {
- if (typeof name !== 'string') {
- name = String(name)
- }
- if (/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(name)) {
- throw new TypeError('Invalid character in header field name')
- }
- return name.toLowerCase()
- }
-
- function normalizeValue(value) {
- if (typeof value !== 'string') {
- value = String(value)
- }
- return value
- }
-
- // Build a destructive iterator for the value list
- function iteratorFor(items) {
- var iterator = {
- next: function() {
- var value = items.shift()
- return {done: value === undefined, value: value}
- }
- }
-
- if (support.iterable) {
- iterator[Symbol.iterator] = function() {
- return iterator
- }
- }
-
- return iterator
- }
-
- function Headers(headers) {
- this.map = {}
-
- if (headers instanceof Headers) {
- headers.forEach(function(value, name) {
- this.append(name, value)
- }, this)
- } else if (Array.isArray(headers)) {
- headers.forEach(function(header) {
- this.append(header[0], header[1])
- }, this)
- } else if (headers) {
- Object.getOwnPropertyNames(headers).forEach(function(name) {
- this.append(name, headers[name])
- }, this)
- }
- }
-
- Headers.prototype.append = function(name, value) {
- name = normalizeName(name)
- value = normalizeValue(value)
- var oldValue = this.map[name]
- this.map[name] = oldValue ? oldValue+','+value : value
- }
-
- Headers.prototype['delete'] = function(name) {
- delete this.map[normalizeName(name)]
- }
-
- Headers.prototype.get = function(name) {
- name = normalizeName(name)
- return this.has(name) ? this.map[name] : null
- }
-
- Headers.prototype.has = function(name) {
- return this.map.hasOwnProperty(normalizeName(name))
- }
-
- Headers.prototype.set = function(name, value) {
- this.map[normalizeName(name)] = normalizeValue(value)
- }
-
- Headers.prototype.forEach = function(callback, thisArg) {
- for (var name in this.map) {
- if (this.map.hasOwnProperty(name)) {
- callback.call(thisArg, this.map[name], name, this)
- }
- }
- }
-
- Headers.prototype.keys = function() {
- var items = []
- this.forEach(function(value, name) { items.push(name) })
- return iteratorFor(items)
- }
-
- Headers.prototype.values = function() {
- var items = []
- this.forEach(function(value) { items.push(value) })
- return iteratorFor(items)
- }
-
- Headers.prototype.entries = function() {
- var items = []
- this.forEach(function(value, name) { items.push([name, value]) })
- return iteratorFor(items)
- }
-
- if (support.iterable) {
- Headers.prototype[Symbol.iterator] = Headers.prototype.entries
- }
-
- function consumed(body) {
- if (body.bodyUsed) {
- return Promise.reject(new TypeError('Already read'))
- }
- body.bodyUsed = true
- }
-
- function fileReaderReady(reader) {
- return new Promise(function(resolve, reject) {
- reader.onload = function() {
- resolve(reader.result)
- }
- reader.onerror = function() {
- reject(reader.error)
- }
- })
- }
-
- function readBlobAsArrayBuffer(blob) {
- var reader = new FileReader()
- var promise = fileReaderReady(reader)
- reader.readAsArrayBuffer(blob)
- return promise
- }
-
- function readBlobAsText(blob) {
- var reader = new FileReader()
- var promise = fileReaderReady(reader)
- reader.readAsText(blob)
- return promise
- }
-
- function readArrayBufferAsText(buf) {
- var view = new Uint8Array(buf)
- var chars = new Array(view.length)
-
- for (var i = 0; i < view.length; i++) {
- chars[i] = String.fromCharCode(view[i])
- }
- return chars.join('')
- }
-
- function bufferClone(buf) {
- if (buf.slice) {
- return buf.slice(0)
- } else {
- var view = new Uint8Array(buf.byteLength)
- view.set(new Uint8Array(buf))
- return view.buffer
- }
- }
-
- function Body() {
- this.bodyUsed = false
-
- this._initBody = function(body) {
- this._bodyInit = body
- if (!body) {
- this._bodyText = ''
- } else if (typeof body === 'string') {
- this._bodyText = body
- } else if (support.blob && Blob.prototype.isPrototypeOf(body)) {
- this._bodyBlob = body
- } else if (support.formData && FormData.prototype.isPrototypeOf(body)) {
- this._bodyFormData = body
- } else if (support.searchParams && URLSearchParams.prototype.isPrototypeOf(body)) {
- this._bodyText = body.toString()
- } else if (support.arrayBuffer && support.blob && isDataView(body)) {
- this._bodyArrayBuffer = bufferClone(body.buffer)
- // IE 10-11 can't handle a DataView body.
- this._bodyInit = new Blob([this._bodyArrayBuffer])
- } else if (support.arrayBuffer && (ArrayBuffer.prototype.isPrototypeOf(body) || isArrayBufferView(body))) {
- this._bodyArrayBuffer = bufferClone(body)
- } else {
- throw new Error('unsupported BodyInit type')
- }
-
- if (!this.headers.get('content-type')) {
- if (typeof body === 'string') {
- this.headers.set('content-type', 'text/plain;charset=UTF-8')
- } else if (this._bodyBlob && this._bodyBlob.type) {
- this.headers.set('content-type', this._bodyBlob.type)
- } else if (support.searchParams && URLSearchParams.prototype.isPrototypeOf(body)) {
- this.headers.set('content-type', 'application/x-www-form-urlencoded;charset=UTF-8')
- }
- }
- }
-
- if (support.blob) {
- this.blob = function() {
- var rejected = consumed(this)
- if (rejected) {
- return rejected
- }
-
- if (this._bodyBlob) {
- return Promise.resolve(this._bodyBlob)
- } else if (this._bodyArrayBuffer) {
- return Promise.resolve(new Blob([this._bodyArrayBuffer]))
- } else if (this._bodyFormData) {
- throw new Error('could not read FormData body as blob')
- } else {
- return Promise.resolve(new Blob([this._bodyText]))
- }
- }
-
- this.arrayBuffer = function() {
- if (this._bodyArrayBuffer) {
- return consumed(this) || Promise.resolve(this._bodyArrayBuffer)
- } else {
- return this.blob().then(readBlobAsArrayBuffer)
- }
- }
- }
-
- this.text = function() {
- var rejected = consumed(this)
- if (rejected) {
- return rejected
- }
-
- if (this._bodyBlob) {
- return readBlobAsText(this._bodyBlob)
- } else if (this._bodyArrayBuffer) {
- return Promise.resolve(readArrayBufferAsText(this._bodyArrayBuffer))
- } else if (this._bodyFormData) {
- throw new Error('could not read FormData body as text')
- } else {
- return Promise.resolve(this._bodyText)
- }
- }
-
- if (support.formData) {
- this.formData = function() {
- return this.text().then(decode)
- }
- }
-
- this.json = function() {
- return this.text().then(JSON.parse)
- }
-
- return this
- }
-
- // HTTP methods whose capitalization should be normalized
- var methods = ['DELETE', 'GET', 'HEAD', 'OPTIONS', 'POST', 'PUT']
-
- function normalizeMethod(method) {
- var upcased = method.toUpperCase()
- return (methods.indexOf(upcased) > -1) ? upcased : method
- }
-
- function Request(input, options) {
- options = options || {}
- var body = options.body
-
- if (input instanceof Request) {
- if (input.bodyUsed) {
- throw new TypeError('Already read')
- }
- this.url = input.url
- this.credentials = input.credentials
- if (!options.headers) {
- this.headers = new Headers(input.headers)
- }
- this.method = input.method
- this.mode = input.mode
- if (!body && input._bodyInit != null) {
- body = input._bodyInit
- input.bodyUsed = true
- }
- } else {
- this.url = String(input)
- }
-
- this.credentials = options.credentials || this.credentials || 'omit'
- if (options.headers || !this.headers) {
- this.headers = new Headers(options.headers)
- }
- this.method = normalizeMethod(options.method || this.method || 'GET')
- this.mode = options.mode || this.mode || null
- this.referrer = null
-
- if ((this.method === 'GET' || this.method === 'HEAD') && body) {
- throw new TypeError('Body not allowed for GET or HEAD requests')
- }
- this._initBody(body)
- }
-
- Request.prototype.clone = function() {
- return new Request(this, { body: this._bodyInit })
- }
-
- function decode(body) {
- var form = new FormData()
- body.trim().split('&').forEach(function(bytes) {
- if (bytes) {
- var split = bytes.split('=')
- var name = split.shift().replace(/\+/g, ' ')
- var value = split.join('=').replace(/\+/g, ' ')
- form.append(decodeURIComponent(name), decodeURIComponent(value))
- }
- })
- return form
- }
-
- function parseHeaders(rawHeaders) {
- var headers = new Headers()
- rawHeaders.split(/\r?\n/).forEach(function(line) {
- var parts = line.split(':')
- var key = parts.shift().trim()
- if (key) {
- var value = parts.join(':').trim()
- headers.append(key, value)
- }
- })
- return headers
- }
-
- Body.call(Request.prototype)
-
- function Response(bodyInit, options) {
- if (!options) {
- options = {}
- }
-
- this.type = 'default'
- this.status = 'status' in options ? options.status : 200
- this.ok = this.status >= 200 && this.status < 300
- this.statusText = 'statusText' in options ? options.statusText : 'OK'
- this.headers = new Headers(options.headers)
- this.url = options.url || ''
- this._initBody(bodyInit)
- }
-
- Body.call(Response.prototype)
-
- Response.prototype.clone = function() {
- return new Response(this._bodyInit, {
- status: this.status,
- statusText: this.statusText,
- headers: new Headers(this.headers),
- url: this.url
- })
- }
-
- Response.error = function() {
- var response = new Response(null, {status: 0, statusText: ''})
- response.type = 'error'
- return response
- }
-
- var redirectStatuses = [301, 302, 303, 307, 308]
-
- Response.redirect = function(url, status) {
- if (redirectStatuses.indexOf(status) === -1) {
- throw new RangeError('Invalid status code')
- }
-
- return new Response(null, {status: status, headers: {location: url}})
- }
-
- self.Headers = Headers
- self.Request = Request
- self.Response = Response
-
- self.fetch = function(input, init) {
- return new Promise(function(resolve, reject) {
- var request = new Request(input, init)
- var xhr = new XMLHttpRequest()
-
- xhr.onload = function() {
- var options = {
- status: xhr.status,
- statusText: xhr.statusText,
- headers: parseHeaders(xhr.getAllResponseHeaders() || '')
- }
- options.url = 'responseURL' in xhr ? xhr.responseURL : options.headers.get('X-Request-URL')
- var body = 'response' in xhr ? xhr.response : xhr.responseText
- resolve(new Response(body, options))
- }
-
- xhr.onerror = function() {
- reject(new TypeError('Network request failed'))
- }
-
- xhr.ontimeout = function() {
- reject(new TypeError('Network request failed'))
- }
-
- xhr.open(request.method, request.url, true)
-
- if (request.credentials === 'include') {
- xhr.withCredentials = true
- }
-
- if ('responseType' in xhr && support.blob) {
- xhr.responseType = 'blob'
- }
-
- request.headers.forEach(function(value, name) {
- xhr.setRequestHeader(name, value)
- })
-
- xhr.send(typeof request._bodyInit === 'undefined' ? null : request._bodyInit)
- })
- }
- self.fetch.polyfill = true
-})(typeof self !== 'undefined' ? self : this);
-
-},{}],46:[function(_dereq_,module,exports){
-
-'use strict';
-
-var p5 = _dereq_('./core/core');
-_dereq_('./color/p5.Color');
-_dereq_('./core/p5.Element');
-_dereq_('./typography/p5.Font');
-_dereq_('./core/p5.Graphics');
-_dereq_('./core/p5.Renderer2D');
-
-_dereq_('./image/p5.Image');
-_dereq_('./math/p5.Vector');
-_dereq_('./io/p5.TableRow');
-_dereq_('./io/p5.Table');
-_dereq_('./io/p5.XML');
-
-_dereq_('./color/creating_reading');
-_dereq_('./color/setting');
-_dereq_('./core/constants');
-_dereq_('./utilities/conversion');
-_dereq_('./utilities/array_functions');
-_dereq_('./utilities/string_functions');
-_dereq_('./core/environment');
-_dereq_('./image/image');
-_dereq_('./image/loading_displaying');
-_dereq_('./image/pixels');
-_dereq_('./io/files');
-_dereq_('./events/keyboard');
-_dereq_('./events/acceleration'); //john
-_dereq_('./events/mouse');
-_dereq_('./utilities/time_date');
-_dereq_('./events/touch');
-_dereq_('./math/math');
-_dereq_('./math/calculation');
-_dereq_('./math/random');
-_dereq_('./math/noise');
-_dereq_('./math/trigonometry');
-_dereq_('./core/rendering');
-_dereq_('./core/2d_primitives');
-
-_dereq_('./core/attributes');
-_dereq_('./core/curves');
-_dereq_('./core/vertex');
-_dereq_('./core/structure');
-_dereq_('./core/transform');
-_dereq_('./typography/attributes');
-_dereq_('./typography/loading_displaying');
-
-_dereq_('./data/p5.TypedDict');
-
-_dereq_('./webgl/p5.RendererGL');
-_dereq_('./webgl/p5.Geometry');
-_dereq_('./webgl/p5.RendererGL.Retained');
-_dereq_('./webgl/p5.RendererGL.Immediate');
-_dereq_('./webgl/primitives');
-_dereq_('./webgl/loading');
-_dereq_('./webgl/p5.Matrix');
-_dereq_('./webgl/material');
-_dereq_('./webgl/light');
-_dereq_('./webgl/p5.Shader');
-_dereq_('./webgl/camera');
-_dereq_('./webgl/interaction');
-
-_dereq_('./core/init.js');
-
-
-module.exports = p5;
-
-},{"./color/creating_reading":48,"./color/p5.Color":49,"./color/setting":50,"./core/2d_primitives":51,"./core/attributes":52,"./core/constants":54,"./core/core":55,"./core/curves":56,"./core/environment":57,"./core/init.js":59,"./core/p5.Element":60,"./core/p5.Graphics":61,"./core/p5.Renderer2D":63,"./core/rendering":64,"./core/structure":66,"./core/transform":67,"./core/vertex":68,"./data/p5.TypedDict":69,"./events/acceleration":70,"./events/keyboard":71,"./events/mouse":72,"./events/touch":73,"./image/image":75,"./image/loading_displaying":76,"./image/p5.Image":77,"./image/pixels":78,"./io/files":79,"./io/p5.Table":80,"./io/p5.TableRow":81,"./io/p5.XML":82,"./math/calculation":83,"./math/math":84,"./math/noise":85,"./math/p5.Vector":86,"./math/random":88,"./math/trigonometry":89,"./typography/attributes":90,"./typography/loading_displaying":91,"./typography/p5.Font":92,"./utilities/array_functions":93,"./utilities/conversion":94,"./utilities/string_functions":95,"./utilities/time_date":96,"./webgl/camera":97,"./webgl/interaction":98,"./webgl/light":99,"./webgl/loading":100,"./webgl/material":101,"./webgl/p5.Geometry":102,"./webgl/p5.Matrix":103,"./webgl/p5.RendererGL":106,"./webgl/p5.RendererGL.Immediate":104,"./webgl/p5.RendererGL.Retained":105,"./webgl/p5.Shader":107,"./webgl/primitives":109}],47:[function(_dereq_,module,exports){
-/**
- * @module Conversion
- * @submodule Color Conversion
- * @for p5
- * @requires core
- */
-
-'use strict';
-
-/**
- * Conversions adapted from .
- *
- * In these functions, hue is always in the range [0,1); all other components
- * are in the range [0,1]. 'Brightness' and 'value' are used interchangeably.
- */
-
-var p5 = _dereq_('../core/core');
-p5.ColorConversion = {};
-
-/**
- * Convert an HSBA array to HSLA.
- */
-p5.ColorConversion._hsbaToHSLA = function(hsba) {
- var hue = hsba[0];
- var sat = hsba[1];
- var val = hsba[2];
-
- // Calculate lightness.
- var li = (2 - sat) * val / 2;
-
- // Convert saturation.
- if (li !== 0) {
- if (li === 1) {
- sat = 0;
- } else if (li < 0.5) {
- sat = sat / (2 - sat);
- } else {
- sat = sat * val / (2 - li * 2);
- }
- }
-
- // Hue and alpha stay the same.
- return [hue, sat, li, hsba[3]];
-};
-
-/**
- * Convert an HSBA array to RGBA.
- */
-p5.ColorConversion._hsbaToRGBA = function(hsba) {
- var hue = hsba[0] * 6; // We will split hue into 6 sectors.
- var sat = hsba[1];
- var val = hsba[2];
-
- var RGBA = [];
-
- if (sat === 0) {
- RGBA = [val, val, val, hsba[3]]; // Return early if grayscale.
- } else {
- var sector = Math.floor(hue);
- var tint1 = val * (1 - sat);
- var tint2 = val * (1 - sat * (hue - sector));
- var tint3 = val * (1 - sat * (1 + sector - hue));
- var red, green, blue;
- if (sector === 1) { // Yellow to green.
- red = tint2;
- green = val;
- blue = tint1;
- } else if (sector === 2) { // Green to cyan.
- red = tint1;
- green = val;
- blue = tint3;
- } else if (sector === 3) { // Cyan to blue.
- red = tint1;
- green = tint2;
- blue = val;
- } else if (sector === 4) { // Blue to magenta.
- red = tint3;
- green = tint1;
- blue = val;
- } else if (sector === 5) { // Magenta to red.
- red = val;
- green = tint1;
- blue = tint2;
- } else { // Red to yellow (sector could be 0 or 6).
- red = val;
- green = tint3;
- blue = tint1;
- }
- RGBA = [red, green, blue, hsba[3]];
- }
-
- return RGBA;
-};
-
-/**
- * Convert an HSLA array to HSBA.
- */
-p5.ColorConversion._hslaToHSBA = function(hsla) {
- var hue = hsla[0];
- var sat = hsla[1];
- var li = hsla[2];
-
- // Calculate brightness.
- var val;
- if (li < 0.5) {
- val = (1 + sat) * li;
- } else {
- val = li + sat - li * sat;
- }
-
- // Convert saturation.
- sat = 2 * (val - li) / val;
-
- // Hue and alpha stay the same.
- return [hue, sat, val, hsla[3]];
-};
-
-/**
- * Convert an HSLA array to RGBA.
- *
- * We need to change basis from HSLA to something that can be more easily be
- * projected onto RGBA. We will choose hue and brightness as our first two
- * components, and pick a convenient third one ('zest') so that we don't need
- * to calculate formal HSBA saturation.
- */
-p5.ColorConversion._hslaToRGBA = function(hsla){
- var hue = hsla[0] * 6; // We will split hue into 6 sectors.
- var sat = hsla[1];
- var li = hsla[2];
-
- var RGBA = [];
-
- if (sat === 0) {
- RGBA = [li, li, li, hsla[3]]; // Return early if grayscale.
- } else {
-
- // Calculate brightness.
- var val;
- if (li < 0.5) {
- val = (1 + sat) * li;
- } else {
- val = li + sat - li * sat;
- }
-
- // Define zest.
- var zest = 2 * li - val;
-
- // Implement projection (project onto green by default).
- var hzvToRGB = function(hue, zest, val) {
- if (hue < 0) { // Hue must wrap to allow projection onto red and blue.
- hue += 6;
- } else if (hue >= 6) {
- hue -= 6;
- }
- if (hue < 1) { // Red to yellow (increasing green).
- return (zest + (val - zest) * hue);
- } else if (hue < 3) { // Yellow to cyan (greatest green).
- return val;
- } else if (hue < 4) { // Cyan to blue (decreasing green).
- return (zest + (val - zest) * (4 - hue));
- } else { // Blue to red (least green).
- return zest;
- }
- };
-
- // Perform projections, offsetting hue as necessary.
- RGBA = [hzvToRGB(hue + 2, zest, val),
- hzvToRGB(hue , zest, val),
- hzvToRGB(hue - 2, zest, val),
- hsla[3]];
- }
-
- return RGBA;
-};
-
-/**
- * Convert an RGBA array to HSBA.
- */
-p5.ColorConversion._rgbaToHSBA = function(rgba) {
- var red = rgba[0];
- var green = rgba[1];
- var blue = rgba[2];
-
- var val = Math.max(red, green, blue);
- var chroma = val - Math.min(red, green, blue);
-
- var hue, sat;
- if (chroma === 0) { // Return early if grayscale.
- hue = 0;
- sat = 0;
- }
- else {
- sat = chroma / val;
- if (red === val) { // Magenta to yellow.
- hue = (green - blue) / chroma;
- } else if (green === val) { // Yellow to cyan.
- hue = 2 + (blue - red) / chroma;
- } else if (blue === val) { // Cyan to magenta.
- hue = 4 + (red - green) / chroma;
- }
- if (hue < 0) { // Confine hue to the interval [0, 1).
- hue += 6;
- } else if (hue >= 6) {
- hue -= 6;
- }
- }
-
- return [hue / 6, sat, val, rgba[3]];
-};
-
-/**
- * Convert an RGBA array to HSLA.
- */
-p5.ColorConversion._rgbaToHSLA = function(rgba) {
- var red = rgba[0];
- var green = rgba[1];
- var blue = rgba[2];
-
- var val = Math.max(red, green, blue);
- var min = Math.min(red, green, blue);
- var li = val + min; // We will halve this later.
- var chroma = val - min;
-
- var hue, sat;
- if (chroma === 0) { // Return early if grayscale.
- hue = 0;
- sat = 0;
- } else {
- if (li < 1) {
- sat = chroma / li;
- } else {
- sat = chroma / (2 - li);
- }
- if (red === val) { // Magenta to yellow.
- hue = (green - blue) / chroma;
- } else if (green === val) { // Yellow to cyan.
- hue = 2 + (blue - red) / chroma;
- } else if (blue === val) { // Cyan to magenta.
- hue = 4 + (red - green) / chroma;
- }
- if (hue < 0) { // Confine hue to the interval [0, 1).
- hue += 6;
- } else if (hue >= 6) {
- hue -= 6;
- }
- }
-
- return [hue / 6, sat, li / 2, rgba[3]];
-};
-
-module.exports = p5.ColorConversion;
-
-},{"../core/core":55}],48:[function(_dereq_,module,exports){
-/**
- * @module Color
- * @submodule Creating & Reading
- * @for p5
- * @requires core
- * @requires constants
- */
-
-'use strict';
-
-var p5 = _dereq_('../core/core');
-var constants = _dereq_('../core/constants');
-_dereq_('./p5.Color');
-_dereq_('../core/error_helpers');
-
-/**
- * Extracts the alpha value from a color or pixel array.
- *
- * @method alpha
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the alpha value
- * @example
- *
- *
- * noStroke();
- * c = color(0, 126, 255, 102);
- * fill(c);
- * rect(15, 15, 35, 70);
- * value = alpha(c); // Sets 'value' to 102
- * fill(value);
- * rect(50, 15, 35, 70);
- *
- *
- *
- * @alt
- * Left half of canvas light blue and right half light charcoal grey.
- * Left half of canvas light purple and right half a royal blue.
- * Left half of canvas salmon pink and the right half white.
- * Yellow rect in middle right of canvas, with 55 pixel width and height.
- * Yellow ellipse in top left canvas, black ellipse in bottom right,both 80x80.
- * Bright fuschia rect in middle of canvas, 60 pixel width and height.
- * Two bright green rects on opposite sides of the canvas, both 45x80.
- * Four blue rects in each corner of the canvas, each are 35x35.
- * Bright sea green rect on left and darker rect on right of canvas, both 45x80.
- * Dark green rect on left and light green rect on right of canvas, both 45x80.
- * Dark blue rect on left and light teal rect on right of canvas, both 45x80.
- * blue rect on left and green on right, both with black outlines & 35x60.
- * salmon pink rect on left and black on right, both 35x60.
- * 4 rects, tan, brown, brownish purple and purple, with white outlines & 20x60.
- * light pastel green rect on left and dark grey rect on right, both 35x60.
- * yellow rect on left and red rect on right, both with black outlines & 35x60.
- * grey canvas
- * deep pink rect on left and grey rect on right, both 35x60.
- */
-p5.prototype.alpha = function(c) {
- p5._validateParameters('alpha', arguments);
- return this.color(c)._getAlpha();
-};
-
-/**
- * Extracts the blue value from a color or pixel array.
- *
- * @method blue
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the blue value
- * @example
- *
- *
- * c = color(175, 100, 220); // Define color 'c'
- * fill(c); // Use color variable 'c' as fill color
- * rect(15, 20, 35, 60); // Draw left rectangle
- *
- * blueValue = blue(c); // Get blue in 'c'
- * print(blueValue); // Prints "220.0"
- * fill(0, 0, blueValue); // Use 'blueValue' in new fill
- * rect(50, 20, 35, 60); // Draw right rectangle
- *
- *
- *
- * @alt
- * Left half of canvas light purple and right half a royal blue.
- *
- */
-p5.prototype.blue = function(c) {
- p5._validateParameters('blue', arguments);
- return this.color(c)._getBlue();
-};
-
-/**
- * Extracts the HSB brightness value from a color or pixel array.
- *
- * @method brightness
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the brightness value
- * @example
- *
- *
- * noStroke();
- * colorMode(HSB, 255);
- * c = color(0, 126, 255);
- * fill(c);
- * rect(15, 20, 35, 60);
- * value = brightness(c); // Sets 'value' to 255
- * fill(value);
- * rect(50, 20, 35, 60);
- *
- *
- *
- * @alt
- * Left half of canvas salmon pink and the right half white.
- *
- */
-p5.prototype.brightness = function(c) {
- p5._validateParameters('brightness', arguments);
- return this.color(c)._getBrightness();
-};
-
-/**
- * Creates colors for storing in variables of the color datatype. The
- * parameters are interpreted as RGB or HSB values depending on the
- * current colorMode(). The default mode is RGB values from 0 to 255
- * and, therefore, the function call color(255, 204, 0) will return a
- * bright yellow color.
- *
- * Note that if only one value is provided to color(), it will be interpreted
- * as a grayscale value. Add a second value, and it will be used for alpha
- * transparency. When three values are specified, they are interpreted as
- * either RGB or HSB values. Adding a fourth value applies alpha
- * transparency.
- *
- * If a single string argument is provided, RGB, RGBA and Hex CSS color
- * strings and all named color strings are supported. In this case, an alpha
- * number value as a second argument is not supported, the RGBA form should be
- * used.
- *
- * @method color
- * @param {Number} gray number specifying value between white
- * and black.
- * @param {Number} [alpha] alpha value relative to current color range
- * (default is 0-255)
- * @return {p5.Color} resulting color
- *
- * @example
- *
- *
- * var c = color(255, 204, 0); // Define color 'c'
- * fill(c); // Use color variable 'c' as fill color
- * noStroke(); // Don't draw a stroke around shapes
- * rect(30, 20, 55, 55); // Draw rectangle
- *
- *
- *
- *
- *
- * var c = color(255, 204, 0); // Define color 'c'
- * fill(c); // Use color variable 'c' as fill color
- * noStroke(); // Don't draw a stroke around shapes
- * ellipse(25, 25, 80, 80); // Draw left circle
- *
- * // Using only one value with color()
- * // generates a grayscale value.
- * var c = color(65); // Update 'c' with grayscale value
- * fill(c); // Use updated 'c' as fill color
- * ellipse(75, 75, 80, 80); // Draw right circle
- *
- *
- *
- *
- *
- * // Named SVG & CSS colors may be used,
- * var c = color('magenta');
- * fill(c); // Use 'c' as fill color
- * noStroke(); // Don't draw a stroke around shapes
- * rect(20, 20, 60, 60); // Draw rectangle
- *
- *
- *
- *
- *
- * // as can hex color codes:
- * noStroke(); // Don't draw a stroke around shapes
- * var c = color('#0f0');
- * fill(c); // Use 'c' as fill color
- * rect(0, 10, 45, 80); // Draw rectangle
- *
- * c = color('#00ff00');
- * fill(c); // Use updated 'c' as fill color
- * rect(55, 10, 45, 80); // Draw rectangle
- *
- *
- *
- *
- *
- * // RGB and RGBA color strings are also supported:
- * // these all set to the same color (solid blue)
- * var c;
- * noStroke(); // Don't draw a stroke around shapes
- * c = color('rgb(0,0,255)');
- * fill(c); // Use 'c' as fill color
- * rect(10, 10, 35, 35); // Draw rectangle
- *
- * c = color('rgb(0%, 0%, 100%)');
- * fill(c); // Use updated 'c' as fill color
- * rect(55, 10, 35, 35); // Draw rectangle
- *
- * c = color('rgba(0, 0, 255, 1)');
- * fill(c); // Use updated 'c' as fill color
- * rect(10, 55, 35, 35); // Draw rectangle
- *
- * c = color('rgba(0%, 0%, 100%, 1)');
- * fill(c); // Use updated 'c' as fill color
- * rect(55, 55, 35, 35); // Draw rectangle
- *
- *
- *
- *
- *
- * // HSL color is also supported and can be specified
- * // by value
- * var c;
- * noStroke(); // Don't draw a stroke around shapes
- * c = color('hsl(160, 100%, 50%)');
- * fill(c); // Use 'c' as fill color
- * rect(0, 10, 45, 80); // Draw rectangle
- *
- * c = color('hsla(160, 100%, 50%, 0.5)');
- * fill(c); // Use updated 'c' as fill color
- * rect(55, 10, 45, 80); // Draw rectangle
- *
- *
- *
- *
- *
- * // HSB color is also supported and can be specified
- * // by value
- * var c;
- * noStroke(); // Don't draw a stroke around shapes
- * c = color('hsb(160, 100%, 50%)');
- * fill(c); // Use 'c' as fill color
- * rect(0, 10, 45, 80); // Draw rectangle
- *
- * c = color('hsba(160, 100%, 50%, 0.5)');
- * fill(c); // Use updated 'c' as fill color
- * rect(55, 10, 45, 80); // Draw rectangle
- *
- *
- *
- *
- *
- * var c; // Declare color 'c'
- * noStroke(); // Don't draw a stroke around shapes
- *
- * // If no colorMode is specified, then the
- * // default of RGB with scale of 0-255 is used.
- * c = color(50, 55, 100); // Create a color for 'c'
- * fill(c); // Use color variable 'c' as fill color
- * rect(0, 10, 45, 80); // Draw left rect
- *
- * colorMode(HSB, 100); // Use HSB with scale of 0-100
- * c = color(50, 55, 100); // Update 'c' with new color
- * fill(c); // Use updated 'c' as fill color
- * rect(55, 10, 45, 80); // Draw right rect
- *
- *
- *
- * @alt
- * Yellow rect in middle right of canvas, with 55 pixel width and height.
- * Yellow ellipse in top left of canvas, black ellipse in bottom right,both 80x80.
- * Bright fuschia rect in middle of canvas, 60 pixel width and height.
- * Two bright green rects on opposite sides of the canvas, both 45x80.
- * Four blue rects in each corner of the canvas, each are 35x35.
- * Bright sea green rect on left and darker rect on right of canvas, both 45x80.
- * Dark green rect on left and lighter green rect on right of canvas, both 45x80.
- * Dark blue rect on left and light teal rect on right of canvas, both 45x80.
- *
- */
-/**
- * @method color
- * @param {Number} v1 red or hue value relative to
- * the current color range
- * @param {Number} v2 green or saturation value
- * relative to the current color range
- * @param {Number} v3 blue or brightness value
- * relative to the current color range
- * @param {Number} [alpha]
- * @return {p5.Color}
- */
-
-/**
- * @method color
- * @param {String} value a color string
- * @param {Number} [alpha]
- * @return {p5.Color}
- */
-/**
- * @method color
- * @param {Array} values an array containing the red,green,blue &
- * and alpha components of the color
- * @return {p5.Color}
- */
-/**
- * @method color
- * @param {p5.Color} color
- * @return {p5.Color}
- */
-
-p5.prototype.color = function() {
- if (arguments[0] instanceof p5.Color) {
- return arguments[0]; // Do nothing if argument is already a color object.
- } else if (arguments[0] instanceof Array) {
- if (this instanceof p5.Renderer) {
- return new p5.Color(this, arguments[0]);
- } else {
- return new p5.Color(this._renderer, arguments[0]);
- }
- } else {
- p5._validateParameters('color', arguments);
- if (this instanceof p5.Renderer) {
- return new p5.Color(this, arguments);
- } else {
- return new p5.Color(this._renderer, arguments);
- }
- }
-};
-
-/**
- * Extracts the green value from a color or pixel array.
- *
- * @method green
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the green value
- * @example
- *
- *
- * c = color(20, 75, 200); // Define color 'c'
- * fill(c); // Use color variable 'c' as fill color
- * rect(15, 20, 35, 60); // Draw left rectangle
- *
- * greenValue = green(c); // Get green in 'c'
- * print(greenValue); // Print "75.0"
- * fill(0, greenValue, 0); // Use 'greenValue' in new fill
- * rect(50, 20, 35, 60); // Draw right rectangle
- *
- *
- *
- * @alt
- * blue rect on left and green on right, both with black outlines & 35x60.
- *
- */
-
-p5.prototype.green = function(c) {
- p5._validateParameters('green', arguments);
- return this.color(c)._getGreen();
-};
-
-/**
- * Extracts the hue value from a color or pixel array.
- *
- * Hue exists in both HSB and HSL. This function will return the
- * HSB-normalized hue when supplied with an HSB color object (or when supplied
- * with a pixel array while the color mode is HSB), but will default to the
- * HSL-normalized hue otherwise. (The values will only be different if the
- * maximum hue setting for each system is different.)
- *
- * @method hue
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the hue
- * @example
- *
- *
- * noStroke();
- * colorMode(HSB, 255);
- * c = color(0, 126, 255);
- * fill(c);
- * rect(15, 20, 35, 60);
- * value = hue(c); // Sets 'value' to "0"
- * fill(value);
- * rect(50, 20, 35, 60);
- *
- *
- *
- * @alt
- * salmon pink rect on left and black on right, both 35x60.
- *
- */
-
-p5.prototype.hue = function(c) {
- p5._validateParameters('hue', arguments);
- return this.color(c)._getHue();
-};
-
-/**
- * Blends two colors to find a third color somewhere between them. The amt
- * parameter is the amount to interpolate between the two values where 0.0
- * equal to the first color, 0.1 is very near the first color, 0.5 is halfway
- * in between, etc. An amount below 0 will be treated as 0. Likewise, amounts
- * above 1 will be capped at 1. This is different from the behavior of lerp(),
- * but necessary because otherwise numbers outside the range will produce
- * strange and unexpected colors.
- *
- * The way that colours are interpolated depends on the current color mode.
- *
- * @method lerpColor
- * @param {p5.Color} c1 interpolate from this color
- * @param {p5.Color} c2 interpolate to this color
- * @param {Number} amt number between 0 and 1
- * @return {p5.Color} interpolated color
- * @example
- *
- *
- * colorMode(RGB);
- * stroke(255);
- * background(51);
- * from = color(218, 165, 32);
- * to = color(72, 61, 139);
- * colorMode(RGB); // Try changing to HSB.
- * interA = lerpColor(from, to, .33);
- * interB = lerpColor(from, to, .66);
- * fill(from);
- * rect(10, 20, 20, 60);
- * fill(interA);
- * rect(30, 20, 20, 60);
- * fill(interB);
- * rect(50, 20, 20, 60);
- * fill(to);
- * rect(70, 20, 20, 60);
- *
- *
- *
- * @alt
- * 4 rects one tan, brown, brownish purple, purple, with white outlines & 20x60
- *
- */
-
-p5.prototype.lerpColor = function(c1, c2, amt) {
- p5._validateParameters('lerpColor', arguments);
- var mode = this._renderer._colorMode;
- var maxes = this._renderer._colorMaxes;
- var l0, l1, l2, l3;
- var fromArray, toArray;
-
- if (mode === constants.RGB) {
- fromArray = arguments[0].levels.map(function(level) {
- return level / 255;
- });
- toArray = arguments[1].levels.map(function(level) {
- return level / 255;
- });
- } else if (mode === constants.HSB) {
- arguments[0]._getBrightness(); // Cache hsba so it definitely exists.
- arguments[1]._getBrightness();
- fromArray = arguments[0].hsba;
- toArray = arguments[1].hsba;
- } else if (mode === constants.HSL) {
- arguments[0]._getLightness(); // Cache hsla so it definitely exists.
- arguments[1]._getLightness();
- fromArray = arguments[0].hsla;
- toArray = arguments[1].hsla;
- } else {
- throw new Error (mode + 'cannot be used for interpolation.');
- }
-
- // Prevent extrapolation.
- amt = Math.max(Math.min(arguments[2], 1), 0);
-
- // Define lerp here itself if user isn't using math module.
- // Maintains the definition as found in math/calculation.js
- if(typeof this.lerp === 'undefined') {
- this.lerp = function (start, stop, amt) {
- return amt*(stop-start)+start;
- };
- }
-
- // Perform interpolation.
- l0 = this.lerp(fromArray[0], toArray[0], amt);
- l1 = this.lerp(fromArray[1], toArray[1], amt);
- l2 = this.lerp(fromArray[2], toArray[2], amt);
- l3 = this.lerp(fromArray[3], toArray[3], amt);
-
- // Scale components.
- l0 *= maxes[mode][0];
- l1 *= maxes[mode][1];
- l2 *= maxes[mode][2];
- l3 *= maxes[mode][3];
-
- return this.color(l0, l1, l2, l3);
-};
-
-/**
- * Extracts the HSL lightness value from a color or pixel array.
- *
- * @method lightness
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the lightness
- * @example
- *
- *
- * noStroke();
- * colorMode(HSL);
- * c = color(156, 100, 50, 1);
- * fill(c);
- * rect(15, 20, 35, 60);
- * value = lightness(c); // Sets 'value' to 50
- * fill(value);
- * rect(50, 20, 35, 60);
- *
- *
- *
- * @alt
- * light pastel green rect on left and dark grey rect on right, both 35x60.
- *
- */
-p5.prototype.lightness = function(c) {
- p5._validateParameters('lightness', arguments);
- return this.color(c)._getLightness();
-};
-
-/**
- * Extracts the red value from a color or pixel array.
- *
- * @method red
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the red value
- * @example
- *
- *
- * c = color(255, 204, 0); // Define color 'c'
- * fill(c); // Use color variable 'c' as fill color
- * rect(15, 20, 35, 60); // Draw left rectangle
- *
- * redValue = red(c); // Get red in 'c'
- * print(redValue); // Print "255.0"
- * fill(redValue, 0, 0); // Use 'redValue' in new fill
- * rect(50, 20, 35, 60); // Draw right rectangle
- *
- *
- *
- *
- *
- * colorMode(RGB, 255);
- * var c = color(127, 255, 0);
- * colorMode(RGB, 1);
- * var myColor = red(c);
- * print(myColor);
- *
- *
- *
- * @alt
- * yellow rect on left and red rect on right, both with black outlines and 35x60.
- * grey canvas
- */
-p5.prototype.red = function(c) {
- p5._validateParameters('red', arguments);
- return this.color(c)._getRed();
-};
-
-/**
- * Extracts the saturation value from a color or pixel array.
- *
- * Saturation is scaled differently in HSB and HSL. This function will return
- * the HSB saturation when supplied with an HSB color object (or when supplied
- * with a pixel array while the color mode is HSB), but will default to the
- * HSL saturation otherwise.
- *
- * @method saturation
- * @param {p5.Color|Array} color p5.Color object or pixel array
- * @return {Number} the saturation value
- * @example
- *
- *
- * noStroke();
- * colorMode(HSB, 255);
- * c = color(0, 126, 255);
- * fill(c);
- * rect(15, 20, 35, 60);
- * value = saturation(c); // Sets 'value' to 126
- * fill(value);
- * rect(50, 20, 35, 60);
- *
- *
- *
- * @alt
- *deep pink rect on left and grey rect on right, both 35x60.
- *
- */
-
-p5.prototype.saturation = function(c) {
- p5._validateParameters('saturation', arguments);
- return this.color(c)._getSaturation();
-};
-
-module.exports = p5;
-
-},{"../core/constants":54,"../core/core":55,"../core/error_helpers":58,"./p5.Color":49}],49:[function(_dereq_,module,exports){
-/**
- * @module Color
- * @submodule Creating & Reading
- * @for p5
- * @requires core
- * @requires constants
- * @requires color_conversion
- */
-
-var p5 = _dereq_('../core/core');
-var constants = _dereq_('../core/constants');
-var color_conversion = _dereq_('./color_conversion');
-
-/**
- * Each color stores the color mode and level maxes that applied at the
- * time of its construction. These are used to interpret the input arguments
- * (at construction and later for that instance of color) and to format the
- * output e.g. when saturation() is requested.
- *
- * Internally we store an array representing the ideal RGBA values in floating
- * point form, normalized from 0 to 1. From this we calculate the closest
- * screen color (RGBA levels from 0 to 255) and expose this to the renderer.
- *
- * We also cache normalized, floating point components of the color in various
- * representations as they are calculated. This is done to prevent repeating a
- * conversion that has already been performed.
- *
- * @class p5.Color
- * @constructor
- */
-p5.Color = function(renderer, vals) {
-
- // Record color mode and maxes at time of construction.
- this._storeModeAndMaxes(renderer._colorMode, renderer._colorMaxes);
-
- // Calculate normalized RGBA values.
- if (this.mode !== constants.RGB &&
- this.mode !== constants.HSL &&
- this.mode !== constants.HSB) {
- throw new Error(this.mode + ' is an invalid colorMode.');
- } else {
- this._array = p5.Color._parseInputs.apply(this, vals);
- }
-
- // Expose closest screen color.
- this._calculateLevels();
- this.name = 'p5.Color'; // for friendly debugger system
- return this;
-};
-
-p5.Color.prototype.toString = function() {
- var a = this.levels;
- var alpha = this._array[3]; // String representation uses normalized alpha.
- return 'rgba('+a[0]+','+a[1]+','+a[2]+','+ alpha +')';
-};
-
-p5.Color.prototype.setRed = function(new_red) {
- this._array[0] = new_red / this.maxes[constants.RGB][0];
- this._calculateLevels();
-};
-
-p5.Color.prototype.setGreen = function(new_green) {
- this._array[1] = new_green / this.maxes[constants.RGB][1];
- this._calculateLevels();
-};
-
-p5.Color.prototype.setBlue = function(new_blue) {
- this._array[2] = new_blue / this.maxes[constants.RGB][2];
- this._calculateLevels();
-};
-
-p5.Color.prototype.setAlpha = function(new_alpha) {
- this._array[3] = new_alpha / this.maxes[this.mode][3];
- this._calculateLevels();
-};
-
-// calculates and stores the closest screen levels
-p5.Color.prototype._calculateLevels = function() {
- this.levels = this._array.map(function(level) {
- return Math.round(level * 255);
- });
-};
-
-p5.Color.prototype._getAlpha = function() {
- return this._array[3] * this.maxes[this.mode][3];
-};
-
-// stores the color mode and maxes in this instance of Color
-// for later use (by _parseInputs())
-p5.Color.prototype._storeModeAndMaxes = function(new_mode, new_maxes) {
- this.mode = new_mode;
- this.maxes = new_maxes;
-};
-
-p5.Color.prototype._getMode = function() {
- return this.mode;
-};
-
-p5.Color.prototype._getMaxes = function() {
- return this.maxes;
-};
-
-p5.Color.prototype._getBlue = function() {
- return this._array[2] * this.maxes[constants.RGB][2];
-};
-
-p5.Color.prototype._getBrightness = function() {
- if (!this.hsba) {
- this.hsba = color_conversion._rgbaToHSBA(this._array);
- }
- return this.hsba[2] * this.maxes[constants.HSB][2];
-};
-
-p5.Color.prototype._getGreen = function() {
- return this._array[1] * this.maxes[constants.RGB][1];
-};
-
-/**
- * Hue is the same in HSB and HSL, but the maximum value may be different.
- * This function will return the HSB-normalized saturation when supplied with
- * an HSB color object, but will default to the HSL-normalized saturation
- * otherwise.
- */
-p5.Color.prototype._getHue = function() {
- if (this.mode === constants.HSB) {
- if (!this.hsba) {
- this.hsba = color_conversion._rgbaToHSBA(this._array);
- }
- return this.hsba[0] * this.maxes[constants.HSB][0];
- } else {
- if (!this.hsla) {
- this.hsla = color_conversion._rgbaToHSLA(this._array);
- }
- return this.hsla[0] * this.maxes[constants.HSL][0];
- }
-};
-
-p5.Color.prototype._getLightness = function() {
- if (!this.hsla) {
- this.hsla = color_conversion._rgbaToHSLA(this._array);
- }
- return this.hsla[2] * this.maxes[constants.HSL][2];
-};
-
-p5.Color.prototype._getRed = function() {
- return this._array[0] * this.maxes[constants.RGB][0];
-};
-
-/**
- * Saturation is scaled differently in HSB and HSL. This function will return
- * the HSB saturation when supplied with an HSB color object, but will default
- * to the HSL saturation otherwise.
- */
-p5.Color.prototype._getSaturation = function() {
- if (this.mode === constants.HSB) {
- if (!this.hsba) {
- this.hsba = color_conversion._rgbaToHSBA(this._array);
- }
- return this.hsba[1] * this.maxes[constants.HSB][1];
- } else {
- if (!this.hsla) {
- this.hsla = color_conversion._rgbaToHSLA(this._array);
- }
- return this.hsla[1] * this.maxes[constants.HSL][1];
- }
-};
-
-/**
- * CSS named colors.
- */
-var namedColors = {
- aliceblue: '#f0f8ff',
- antiquewhite: '#faebd7',
- aqua: '#00ffff',
- aquamarine: '#7fffd4',
- azure: '#f0ffff',
- beige: '#f5f5dc',
- bisque: '#ffe4c4',
- black: '#000000',
- blanchedalmond: '#ffebcd',
- blue: '#0000ff',
- blueviolet: '#8a2be2',
- brown: '#a52a2a',
- burlywood: '#deb887',
- cadetblue: '#5f9ea0',
- chartreuse: '#7fff00',
- chocolate: '#d2691e',
- coral: '#ff7f50',
- cornflowerblue: '#6495ed',
- cornsilk: '#fff8dc',
- crimson: '#dc143c',
- cyan: '#00ffff',
- darkblue: '#00008b',
- darkcyan: '#008b8b',
- darkgoldenrod: '#b8860b',
- darkgray: '#a9a9a9',
- darkgreen: '#006400',
- darkgrey: '#a9a9a9',
- darkkhaki: '#bdb76b',
- darkmagenta: '#8b008b',
- darkolivegreen: '#556b2f',
- darkorange: '#ff8c00',
- darkorchid: '#9932cc',
- darkred: '#8b0000',
- darksalmon: '#e9967a',
- darkseagreen: '#8fbc8f',
- darkslateblue: '#483d8b',
- darkslategray: '#2f4f4f',
- darkslategrey: '#2f4f4f',
- darkturquoise: '#00ced1',
- darkviolet: '#9400d3',
- deeppink: '#ff1493',
- deepskyblue: '#00bfff',
- dimgray: '#696969',
- dimgrey: '#696969',
- dodgerblue: '#1e90ff',
- firebrick: '#b22222',
- floralwhite: '#fffaf0',
- forestgreen: '#228b22',
- fuchsia: '#ff00ff',
- gainsboro: '#dcdcdc',
- ghostwhite: '#f8f8ff',
- gold: '#ffd700',
- goldenrod: '#daa520',
- gray: '#808080',
- green: '#008000',
- greenyellow: '#adff2f',
- grey: '#808080',
- honeydew: '#f0fff0',
- hotpink: '#ff69b4',
- indianred: '#cd5c5c',
- indigo: '#4b0082',
- ivory: '#fffff0',
- khaki: '#f0e68c',
- lavender: '#e6e6fa',
- lavenderblush: '#fff0f5',
- lawngreen: '#7cfc00',
- lemonchiffon: '#fffacd',
- lightblue: '#add8e6',
- lightcoral: '#f08080',
- lightcyan: '#e0ffff',
- lightgoldenrodyellow: '#fafad2',
- lightgray: '#d3d3d3',
- lightgreen: '#90ee90',
- lightgrey: '#d3d3d3',
- lightpink: '#ffb6c1',
- lightsalmon: '#ffa07a',
- lightseagreen: '#20b2aa',
- lightskyblue: '#87cefa',
- lightslategray: '#778899',
- lightslategrey: '#778899',
- lightsteelblue: '#b0c4de',
- lightyellow: '#ffffe0',
- lime: '#00ff00',
- limegreen: '#32cd32',
- linen: '#faf0e6',
- magenta: '#ff00ff',
- maroon: '#800000',
- mediumaquamarine: '#66cdaa',
- mediumblue: '#0000cd',
- mediumorchid: '#ba55d3',
- mediumpurple: '#9370db',
- mediumseagreen: '#3cb371',
- mediumslateblue: '#7b68ee',
- mediumspringgreen: '#00fa9a',
- mediumturquoise: '#48d1cc',
- mediumvioletred: '#c71585',
- midnightblue: '#191970',
- mintcream: '#f5fffa',
- mistyrose: '#ffe4e1',
- moccasin: '#ffe4b5',
- navajowhite: '#ffdead',
- navy: '#000080',
- oldlace: '#fdf5e6',
- olive: '#808000',
- olivedrab: '#6b8e23',
- orange: '#ffa500',
- orangered: '#ff4500',
- orchid: '#da70d6',
- palegoldenrod: '#eee8aa',
- palegreen: '#98fb98',
- paleturquoise: '#afeeee',
- palevioletred: '#db7093',
- papayawhip: '#ffefd5',
- peachpuff: '#ffdab9',
- peru: '#cd853f',
- pink: '#ffc0cb',
- plum: '#dda0dd',
- powderblue: '#b0e0e6',
- purple: '#800080',
- red: '#ff0000',
- rosybrown: '#bc8f8f',
- royalblue: '#4169e1',
- saddlebrown: '#8b4513',
- salmon: '#fa8072',
- sandybrown: '#f4a460',
- seagreen: '#2e8b57',
- seashell: '#fff5ee',
- sienna: '#a0522d',
- silver: '#c0c0c0',
- skyblue: '#87ceeb',
- slateblue: '#6a5acd',
- slategray: '#708090',
- slategrey: '#708090',
- snow: '#fffafa',
- springgreen: '#00ff7f',
- steelblue: '#4682b4',
- tan: '#d2b48c',
- teal: '#008080',
- thistle: '#d8bfd8',
- tomato: '#ff6347',
- turquoise: '#40e0d0',
- violet: '#ee82ee',
- wheat: '#f5deb3',
- white: '#ffffff',
- whitesmoke: '#f5f5f5',
- yellow: '#ffff00',
- yellowgreen: '#9acd32'
-};
-
-/**
- * These regular expressions are used to build up the patterns for matching
- * viable CSS color strings: fragmenting the regexes in this way increases the
- * legibility and comprehensibility of the code.
- *
- * Note that RGB values of .9 are not parsed by IE, but are supported here for
- * color string consistency.
- */
-var WHITESPACE = /\s*/; // Match zero or more whitespace characters.
-var INTEGER = /(\d{1,3})/; // Match integers: 79, 255, etc.
-var DECIMAL = /((?:\d+(?:\.\d+)?)|(?:\.\d+))/; // Match 129.6, 79, .9, etc.
-var PERCENT = new RegExp(DECIMAL.source + '%'); // Match 12.9%, 79%, .9%, etc.
-
-/**
- * Full color string patterns. The capture groups are necessary.
- */
-var colorPatterns = {
- // Match colors in format #XXX, e.g. #416.
- HEX3: /^#([a-f0-9])([a-f0-9])([a-f0-9])$/i,
-
- // Match colors in format #XXXX, e.g. #5123.
- HEX4: /^#([a-f0-9])([a-f0-9])([a-f0-9])([a-f0-9])$/i,
-
- // Match colors in format #XXXXXX, e.g. #b4d455.
- HEX6: /^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i,
-
- // Match colors in format #XXXXXXXX, e.g. #b4d45535.
- HEX8: /^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i,
-
- // Match colors in format rgb(R, G, B), e.g. rgb(255, 0, 128).
- RGB: new RegExp([
- '^rgb\\(',
- INTEGER.source,
- ',',
- INTEGER.source,
- ',',
- INTEGER.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format rgb(R%, G%, B%), e.g. rgb(100%, 0%, 28.9%).
- RGB_PERCENT: new RegExp([
- '^rgb\\(',
- PERCENT.source,
- ',',
- PERCENT.source,
- ',',
- PERCENT.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format rgb(R, G, B, A), e.g. rgb(255, 0, 128, 0.25).
- RGBA: new RegExp([
- '^rgba\\(',
- INTEGER.source,
- ',',
- INTEGER.source,
- ',',
- INTEGER.source,
- ',',
- DECIMAL.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format rgb(R%, G%, B%, A), e.g. rgb(100%, 0%, 28.9%, 0.5).
- RGBA_PERCENT: new RegExp([
- '^rgba\\(',
- PERCENT.source,
- ',',
- PERCENT.source,
- ',',
- PERCENT.source,
- ',',
- DECIMAL.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format hsla(H, S%, L%), e.g. hsl(100, 40%, 28.9%).
- HSL: new RegExp([
- '^hsl\\(',
- INTEGER.source,
- ',',
- PERCENT.source,
- ',',
- PERCENT.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format hsla(H, S%, L%, A), e.g. hsla(100, 40%, 28.9%, 0.5).
- HSLA: new RegExp([
- '^hsla\\(',
- INTEGER.source,
- ',',
- PERCENT.source,
- ',',
- PERCENT.source,
- ',',
- DECIMAL.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format hsb(H, S%, B%), e.g. hsb(100, 40%, 28.9%).
- HSB: new RegExp([
- '^hsb\\(',
- INTEGER.source,
- ',',
- PERCENT.source,
- ',',
- PERCENT.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i'),
-
- // Match colors in format hsba(H, S%, B%, A), e.g. hsba(100, 40%, 28.9%, 0.5).
- HSBA: new RegExp([
- '^hsba\\(',
- INTEGER.source,
- ',',
- PERCENT.source,
- ',',
- PERCENT.source,
- ',',
- DECIMAL.source,
- '\\)$'
- ].join(WHITESPACE.source), 'i')
-};
-
-/**
- * For a number of different inputs, returns a color formatted as [r, g, b, a]
- * arrays, with each component normalized between 0 and 1.
- *
- * @param {Array} [...args] An 'array-like' object that represents a list of
- * arguments
- * @return {Number[]} a color formatted as [r, g, b, a]
- * Example:
- * input ==> output
- * g ==> [g, g, g, 255]
- * g,a ==> [g, g, g, a]
- * r, g, b ==> [r, g, b, 255]
- * r, g, b, a ==> [r, g, b, a]
- * [g] ==> [g, g, g, 255]
- * [g, a] ==> [g, g, g, a]
- * [r, g, b] ==> [r, g, b, 255]
- * [r, g, b, a] ==> [r, g, b, a]
- * @example
- *
- *
- * // todo
- *
- *
- *
- * @alt
- * //todo
- *
- */
-p5.Color._parseInputs = function() {
- var numArgs = arguments.length;
- var mode = this.mode;
- var maxes = this.maxes;
- var results = [];
-
- if (numArgs >= 3) { // Argument is a list of component values.
-
- results[0] = arguments[0] / maxes[mode][0];
- results[1] = arguments[1] / maxes[mode][1];
- results[2] = arguments[2] / maxes[mode][2];
-
- // Alpha may be undefined, so default it to 100%.
- if (typeof arguments[3] === 'number') {
- results[3] = arguments[3] / maxes[mode][3];
- } else {
- results[3] = 1;
- }
-
- // Constrain components to the range [0,1].
- results = results.map(function(value) {
- return Math.max(Math.min(value, 1), 0);
- });
-
- // Convert to RGBA and return.
- if (mode === constants.HSL) {
- return color_conversion._hslaToRGBA(results);
- } else if (mode === constants.HSB) {
- return color_conversion._hsbaToRGBA(results);
- } else {
- return results;
- }
-
- } else if (numArgs === 1 && typeof arguments[0] === 'string') {
-
- var str = arguments[0].trim().toLowerCase();
-
- // Return if string is a named colour.
- if (namedColors[str]) {
- return p5.Color._parseInputs.apply(this, [namedColors[str]]);
- }
-
- // Try RGBA pattern matching.
- if (colorPatterns.HEX3.test(str)) { // #rgb
- results = colorPatterns.HEX3.exec(str).slice(1).map(function(color) {
- return parseInt(color + color, 16) / 255;
- });
- results[3] = 1;
- return results;
- } else if (colorPatterns.HEX6.test(str)) { // #rrggbb
- results = colorPatterns.HEX6.exec(str).slice(1).map(function(color) {
- return parseInt(color, 16) / 255;
- });
- results[3] = 1;
- return results;
- } else if (colorPatterns.HEX4.test(str)) { // #rgba
- results = colorPatterns.HEX4.exec(str).slice(1).map(function(color) {
- return parseInt(color + color, 16) / 255;
- });
- return results;
- } else if (colorPatterns.HEX8.test(str)) { // #rrggbbaa
- results = colorPatterns.HEX8.exec(str).slice(1).map(function(color) {
- return parseInt(color, 16) / 255;
- });
- return results;
- } else if (colorPatterns.RGB.test(str)) { // rgb(R,G,B)
- results = colorPatterns.RGB.exec(str).slice(1).map(function(color) {
- return color / 255;
- });
- results[3] = 1;
- return results;
- } else if (colorPatterns.RGB_PERCENT.test(str)) { // rgb(R%,G%,B%)
- results = colorPatterns.RGB_PERCENT.exec(str).slice(1)
- .map(function(color) {
- return parseFloat(color) / 100;
- });
- results[3] = 1;
- return results;
- } else if (colorPatterns.RGBA.test(str)) { // rgba(R,G,B,A)
- results = colorPatterns.RGBA.exec(str).slice(1)
- .map(function(color, idx) {
- if (idx === 3) {
- return parseFloat(color);
- }
- return color / 255;
- });
- return results;
- } else if (colorPatterns.RGBA_PERCENT.test(str)) { // rgba(R%,G%,B%,A%)
- results = colorPatterns.RGBA_PERCENT.exec(str).slice(1)
- .map(function(color, idx) {
- if (idx === 3) {
- return parseFloat(color);
- }
- return parseFloat(color) / 100;
- });
- return results;
- }
-
- // Try HSLA pattern matching.
- if (colorPatterns.HSL.test(str)) { // hsl(H,S,L)
- results = colorPatterns.HSL.exec(str).slice(1)
- .map(function(color, idx) {
- if (idx === 0) {
- return parseInt(color, 10) / 360;
- }
- return parseInt(color, 10) / 100;
- });
- results[3] = 1;
- } else if (colorPatterns.HSLA.test(str)) { // hsla(H,S,L,A)
- results = colorPatterns.HSLA.exec(str).slice(1)
- .map(function(color, idx) {
- if (idx === 0) {
- return parseInt(color, 10) / 360;
- }
- else if (idx === 3) {
- return parseFloat(color);
- }
- return parseInt(color, 10) / 100;
- });
- }
- results = results.map(function(value) {
- return Math.max(Math.min(value, 1), 0);
- });
- if (results.length) {
- return color_conversion._hslaToRGBA(results);
- }
-
- // Try HSBA pattern matching.
- if (colorPatterns.HSB.test(str)) { // hsb(H,S,B)
- results = colorPatterns.HSB.exec(str).slice(1)
- .map(function(color, idx) {
- if (idx === 0) {
- return parseInt(color, 10) / 360;
- }
- return parseInt(color, 10) / 100;
- });
- results[3] = 1;
- } else if (colorPatterns.HSBA.test(str)) { // hsba(H,S,B,A)
- results = colorPatterns.HSBA.exec(str).slice(1)
- .map(function(color, idx) {
- if (idx === 0) {
- return parseInt(color, 10) / 360;
- }
- else if (idx === 3) {
- return parseFloat(color);
- }
- return parseInt(color, 10) / 100;
- });
- }
- results = results.map(function(value) {
- return Math.max(Math.min(value, 1), 0);
- });
-
- if (results.length) {
- return color_conversion._hsbaToRGBA(results);
- }
-
- // Input did not match any CSS color pattern: default to white.
- results = [1, 1, 1, 1];
-
- } else if ((numArgs === 1 || numArgs === 2) &&
- typeof arguments[0] === 'number') { // 'Grayscale' mode.
-
- /**
- * For HSB and HSL, interpret the gray level as a brightness/lightness
- * value (they are equivalent when chroma is zero). For RGB, normalize the
- * gray level according to the blue maximum.
- */
- results[0] = arguments[0] / maxes[mode][2];
- results[1] = arguments[0] / maxes[mode][2];
- results[2] = arguments[0] / maxes[mode][2];
-
- // Alpha may be undefined, so default it to 100%.
- if (typeof arguments[1] === 'number') {
- results[3] = arguments[1] / maxes[mode][3];
- } else {
- results[3] = 1;
- }
-
- // Constrain components to the range [0,1].
- results = results.map(function(value) {
- return Math.max(Math.min(value, 1), 0);
- });
-
- } else {
- throw new Error (arguments + 'is not a valid color representation.');
- }
-
- return results;
-};
-
-module.exports = p5.Color;
-
-},{"../core/constants":54,"../core/core":55,"./color_conversion":47}],50:[function(_dereq_,module,exports){
-/**
- * @module Color
- * @submodule Setting
- * @for p5
- * @requires core
- * @requires constants
- */
-
-'use strict';
-
-var p5 = _dereq_('../core/core');
-var constants = _dereq_('../core/constants');
-_dereq_('./p5.Color');
-
-/**
- * The background() function sets the color used for the background of the
- * p5.js canvas. The default background is light gray. This function is
- * typically used within draw() to clear the display window at the beginning
- * of each frame, but it can be used inside setup() to set the background on
- * the first frame of animation or if the background need only be set once.
- *
- * The color is either specified in terms of the RGB, HSB, or HSL color
- * depending on the current colorMode. (The default color space is RGB, with
- * each value in the range from 0 to 255).
- *
- * If a single string argument is provided, RGB, RGBA and Hex CSS color strings
- * and all named color strings are supported. In this case, an alpha number
- * value as a second argument is not supported, the RGBA form should be used.
- *
- * A p5.Color object can also be provided to set the background color.
- *
- * A p5.Image can also be provided to set the background iamge.
- *
- * @method background
- * @param {p5.Color} color any value created by the color() function
- * @param {Number} [a] opacity of the background relative to current
- * color range (default is 0-100)
- * @chainable
- *
- * @example
- *
- *
- * // Grayscale integer value
- * background(51);
- *
- *
- *
- *
- *
- * // R, G & B integer values
- * background(255, 204, 0);
- *
- *
- *
- *
- *
- * // H, S & B integer values
- * colorMode(HSB);
- * background(255, 204, 100);
- *
- *
- *
- *
- *
- * // Named SVG/CSS color string
- * background('red');
- *
- *
- *
- *
- *
- * // three-digit hexadecimal RGB notation
- * background('#fae');
- *
- *
- *
- *
- *
- * // six-digit hexadecimal RGB notation
- * background('#222222');
- *
- *
- *
- *
- *
- * // integer RGB notation
- * background('rgb(0,255,0)');
- *
- *
- *
- *
- *
- * // integer RGBA notation
- * background('rgba(0,255,0, 0.25)');
- *
- *
- *
- *
- *
- * // percentage RGB notation
- * background('rgb(100%,0%,10%)');
- *
- *
- *
- *
- *
- * // percentage RGBA notation
- * background('rgba(100%,0%,100%,0.5)');
- *
- *
- *
- *
- *
- * // p5 Color object
- * background(color(0, 0, 255));
- *
- *
- *
- * @alt
- * canvas with darkest charcoal grey background.
- * canvas with yellow background.
- * canvas with royal blue background.
- * canvas with red background.
- * canvas with pink background.
- * canvas with black background.
- * canvas with bright green background.
- * canvas with soft green background.
- * canvas with red background.
- * canvas with light purple background.
- * canvas with blue background.
- */
-
-/**
- * @method background
- * @param {String} colorstring color string, possible formats include: integer
- * rgb() or rgba(), percentage rgb() or rgba(),
- * 3-digit hex, 6-digit hex
- * @param {Number} [a]
- * @chainable
- */
-
-/**
- * @method background
- * @param {Number} gray specifies a value between white and black
- * @param {Number} [a]
- * @chainable
- */
-
-/**
- * @method background
- * @param {Number} v1 red or hue value (depending on the current color
- * mode)
- * @param {Number} v2 green or saturation value (depending on the current
- * color mode)
- * @param {Number} v3 blue or brightness value (depending on the current
- * color mode)
- * @param {Number} [a]
- * @chainable
- */
-
-/**
- * @method background
- * @param {p5.Image} image image created with loadImage() or createImage(),
- * to set as background
- * (must be same size as the sketch window)
- * @param {Number} [a]
- * @chainable
- */
-p5.prototype.background = function() {
- if (arguments[0] instanceof p5.Image) {
- this.image(arguments[0], 0, 0, this.width, this.height);
- } else {
- this._renderer.background.apply(this._renderer, arguments);
- }
- return this;
-};
-
-/**
- * Clears the pixels within a buffer. This function only works on p5.Canvas
- * objects created with the createCanvas() function; it won't work with the
- * main display window. Unlike the main graphics context, pixels in
- * additional graphics areas created with createGraphics() can be entirely
- * or partially transparent. This function clears everything to make all of
- * the pixels 100% transparent.
- *
- * @method clear
- * @chainable
- * @example
- *
- *
- * // Clear the screen on mouse press.
- * function setup() {
- * createCanvas(100, 100);
- * }
- *
- * function draw() {
- * ellipse(mouseX, mouseY, 20, 20);
- * }
- *
- * function mousePressed() {
- * clear();
- * }
- *
- *
- *
- * @alt
- * 20x20 white ellipses are continually drawn at mouse x and y coordinates.
- *
- */
-
-p5.prototype.clear = function() {
- this._renderer.clear();
- return this;
-};
-
-/**
- * colorMode() changes the way p5.js interprets color data. By default, the
- * parameters for fill(), stroke(), background(), and color() are defined by
- * values between 0 and 255 using the RGB color model. This is equivalent to
- * setting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB
- * system instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You
- * can also use HSL.
- *
- * Note: existing color objects remember the mode that they were created in,
- * so you can change modes as you like without affecting their appearance.
- *
- *
- * @method colorMode
- * @param {Constant} mode either RGB, HSB or HSL, corresponding to
- * Red/Green/Blue and Hue/Saturation/Brightness
- * (or Lightness)
- * @param {Number} [max] range for all values
- * @chainable
- */
-/**
- * @method colorMode
- * @param {Constant} mode
- * @param {Number} max1 range for the red or hue depending on the
- * current color mode
- * @param {Number} max2 range for the green or saturation depending
- * on the current color mode
- * @param {Number} max3 range for the blue or brightness/lighntess
- * depending on the current color mode
- * @param {Number} [maxA] range for the alpha
- * @chainable
- *
- * @example
- *
- *
- * noStroke();
- * colorMode(RGB, 100);
- * for (i = 0; i < 100; i++) {
- * for (j = 0; j < 100; j++) {
- * stroke(i, j, 0);
- * point(i, j);
- * }
- * }
- *
- *
- *
- *
- *
- * noStroke();
- * colorMode(HSB, 100);
- * for (i = 0; i < 100; i++) {
- * for (j = 0; j < 100; j++) {
- * stroke(i, j, 100);
- * point(i, j);
- * }
- * }
- *
- *
- *
- *
- *
- * colorMode(RGB, 255);
- * var c = color(127, 255, 0);
- *
- * colorMode(RGB, 1);
- * var myColor = c._getRed();
- * text(myColor, 10, 10, 80, 80);
- *
- *
- *
- *
- *
- * noFill();
- * colorMode(RGB, 255, 255, 255, 1);
- * background(255);
- *
- * strokeWeight(4);
- * stroke(255, 0 , 10, 0.3);
- * ellipse(40, 40, 50, 50);
- * ellipse(50, 50, 40, 40);
- *
- *
- *
- * @alt
- *Green to red gradient from bottom L to top R. shading originates from top left.
- *Rainbow gradient from left to right. Brightness increasing to white at top.
- *unknown image.
- *50x50 ellipse at middle L & 40x40 ellipse at center. Transluscent pink outlines.
- *
- */
-p5.prototype.colorMode = function() {
- if (arguments[0] === constants.RGB ||
- arguments[0] === constants.HSB ||
- arguments[0] === constants.HSL) {
-
- // Set color mode.
- this._renderer._colorMode = arguments[0];
-
- // Set color maxes.
- var maxes = this._renderer._colorMaxes[this._renderer._colorMode];
- if (arguments.length === 2) {
- maxes[0] = arguments[1]; // Red
- maxes[1] = arguments[1]; // Green
- maxes[2] = arguments[1]; // Blue
- maxes[3] = arguments[1]; // Alpha
- } else if (arguments.length === 4) {
- maxes[0] = arguments[1]; // Red
- maxes[1] = arguments[2]; // Green
- maxes[2] = arguments[3]; // Blue
- } else if (arguments.length === 5) {
- maxes[0] = arguments[1]; // Red
- maxes[1] = arguments[2]; // Green
- maxes[2] = arguments[3]; // Blue
- maxes[3] = arguments[4]; // Alpha
- }
- }
-
- return this;
-};
-
-/**
- * Sets the color used to fill shapes. For example, if you run
- * fill(204, 102, 0), all subsequent shapes will be filled with orange. This
- * color is either specified in terms of the RGB or HSB color depending on
- * the current colorMode(). (The default color space is RGB, with each value
- * in the range from 0 to 255).
- *
- * If a single string argument is provided, RGB, RGBA and Hex CSS color strings
- * and all named color strings are supported. In this case, an alpha number
- * value as a second argument is not supported, the RGBA form should be used.
- *
- * A p5 Color object can also be provided to set the fill color.
- *
- * @method fill
- * @param {Number} v1 red or hue value relative to
- * the current color range
- * @param {Number} v2 green or saturation value
- * relative to the current color range
- * @param {Number} v3 blue or brightness value
- * relative to the current color range
- * @param {Number} [alpha]
- * @chainable
- */
-
-/**
- * @method fill
- * @param {String} value a color string
- * @param {Number} [alpha]
- * @chainable
- */
-
-/**
- * @method fill
- * @param {Number[]} values an array containing the red,green,blue &
- * and alpha components of the color
- * @chainable
- */
-
-/**
- * @method fill
- * @param {p5.Color} color the fill color
- * @param {Number} [alpha]
- * @chainable
- *
- * @example
- *
- *
- * // Grayscale integer value
- * fill(51);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // R, G & B integer values
- * fill(255, 204, 0);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // H, S & B integer values
- * colorMode(HSB);
- * fill(255, 204, 100);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // Named SVG/CSS color string
- * fill('red');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // three-digit hexadecimal RGB notation
- * fill('#fae');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // six-digit hexadecimal RGB notation
- * fill('#222222');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // integer RGB notation
- * fill('rgb(0,255,0)');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // integer RGBA notation
- * fill('rgba(0,255,0, 0.25)');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // percentage RGB notation
- * fill('rgb(100%,0%,10%)');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // percentage RGBA notation
- * fill('rgba(100%,0%,100%,0.5)');
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // p5 Color object
- * fill(color(0, 0, 255));
- * rect(20, 20, 60, 60);
- *
- *
- * @alt
- * 60x60 dark charcoal grey rect with black outline in center of canvas.
- * 60x60 yellow rect with black outline in center of canvas.
- * 60x60 royal blue rect with black outline in center of canvas.
- * 60x60 red rect with black outline in center of canvas.
- * 60x60 pink rect with black outline in center of canvas.
- * 60x60 black rect with black outline in center of canvas.
- * 60x60 light green rect with black outline in center of canvas.
- * 60x60 soft green rect with black outline in center of canvas.
- * 60x60 red rect with black outline in center of canvas.
- * 60x60 dark fushcia rect with black outline in center of canvas.
- * 60x60 blue rect with black outline in center of canvas.
- */
-
-p5.prototype.fill = function() {
- this._renderer._setProperty('_fillSet', true);
- this._renderer._setProperty('_doFill', true);
- this._renderer.fill.apply(this._renderer, arguments);
- return this;
-};
-
-/**
- * Disables filling geometry. If both noStroke() and noFill() are called,
- * nothing will be drawn to the screen.
- *
- * @method noFill
- * @chainable
- * @example
- *
- *
- * rect(15, 10, 55, 55);
- * noFill();
- * rect(20, 20, 60, 60);
- *
- *
- * @alt
- * white rect top middle and noFill rect center. Both 60x60 with black outlines.
- */
-p5.prototype.noFill = function() {
- if(this._renderer.isP3D) {
- this._renderer.noFill();
- }
- this._renderer._setProperty('_doFill', false);
- return this;
-};
-
-/**
- * Disables drawing the stroke (outline). If both noStroke() and noFill()
- * are called, nothing will be drawn to the screen.
- *
- * @method noStroke
- * @chainable
- * @example
- *
- *
- * noStroke();
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- * @alt
- *60x60 white rect at center. no outline.
- *
- */
-
-p5.prototype.noStroke = function() {
- if(this._renderer.isP3D) {
- this._renderer.noStroke();
- }
- this._renderer._setProperty('_doStroke', false);
- return this;
-};
-
-/**
- * Sets the color used to draw lines and borders around shapes. This color
- * is either specified in terms of the RGB or HSB color depending on the
- * current colorMode() (the default color space is RGB, with each value in
- * the range from 0 to 255).
- *
- * If a single string argument is provided, RGB, RGBA and Hex CSS color
- * strings and all named color strings are supported. In this case, an alpha
- * number value as a second argument is not supported, the RGBA form should be
- * used.
- *
- * A p5 Color object can also be provided to set the stroke color.
- *
- *
- * @method stroke
- * @param {Number} v1 red or hue value relative to
- * the current color range
- * @param {Number} v2 green or saturation value
- * relative to the current color range
- * @param {Number} v3 blue or brightness value
- * relative to the current color range
- * @param {Number} [alpha]
- * @chainable
- */
-
-/**
- * @method stroke
- * @param {String} value a color string
- * @param {Number} [alpha]
- * @chainable
- */
-
-/**
- * @method stroke
- * @param {Number[]} values an array containing the red,green,blue &
- * and alpha components of the color
- * @chainable
- */
-
-/**
- * @method stroke
- * @param {p5.Color} color the stroke color
- * @param {Number} [alpha]
- * @chainable
- *
- * @example
- *
- *
- * // Grayscale integer value
- * strokeWeight(4);
- * stroke(51);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // R, G & B integer values
- * stroke(255, 204, 0);
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // H, S & B integer values
- * colorMode(HSB);
- * strokeWeight(4);
- * stroke(255, 204, 100);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // Named SVG/CSS color string
- * stroke('red');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // three-digit hexadecimal RGB notation
- * stroke('#fae');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // six-digit hexadecimal RGB notation
- * stroke('#222222');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // integer RGB notation
- * stroke('rgb(0,255,0)');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // integer RGBA notation
- * stroke('rgba(0,255,0,0.25)');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // percentage RGB notation
- * stroke('rgb(100%,0%,10%)');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // percentage RGBA notation
- * stroke('rgba(100%,0%,100%,0.5)');
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- *
- *
- * // p5 Color object
- * stroke(color(0, 0, 255));
- * strokeWeight(4);
- * rect(20, 20, 60, 60);
- *
- *
- *
- * @alt
- * 60x60 white rect at center. Dark charcoal grey outline.
- * 60x60 white rect at center. Yellow outline.
- * 60x60 white rect at center. Royal blue outline.
- * 60x60 white rect at center. Red outline.
- * 60x60 white rect at center. Pink outline.
- * 60x60 white rect at center. Black outline.
- * 60x60 white rect at center. Bright green outline.
- * 60x60 white rect at center. Soft green outline.
- * 60x60 white rect at center. Red outline.
- * 60x60 white rect at center. Dark fushcia outline.
- * 60x60 white rect at center. Blue outline.
- */
-
-p5.prototype.stroke = function() {
- this._renderer._setProperty('_strokeSet', true);
- this._renderer._setProperty('_doStroke', true);
- this._renderer.stroke.apply(this._renderer, arguments);
- return this;
-};
-
-module.exports = p5;
-
-},{"../core/constants":54,"../core/core":55,"./p5.Color":49}],51:[function(_dereq_,module,exports){
-/**
- * @module Shape
- * @submodule 2D Primitives
- * @for p5
- * @requires core
- * @requires constants
- */
-
-'use strict';
-
-var p5 = _dereq_('./core');
-var constants = _dereq_('./constants');
-var canvas = _dereq_('./canvas');
-_dereq_('./error_helpers');
-
-/**
- * Draw an arc to the screen. If called with only a, b, c, d, start, and
- * stop, the arc will be drawn as an open pie. If mode is provided, the arc
- * will be drawn either open, as a chord, or as a pie as specified. The
- * origin may be changed with the ellipseMode() function.
- * Note that drawing a full circle (ex: 0 to TWO_PI) will appear blank
- * because 0 and TWO_PI are the same position on the unit circle. The
- * best way to handle this is by using the ellipse() function instead
- * to create a closed ellipse, and to use the arc() function
- * only to draw parts of an ellipse.
- *
- * @method arc
- * @param {Number} a x-coordinate of the arc's ellipse
- * @param {Number} b y-coordinate of the arc's ellipse
- * @param {Number} c width of the arc's ellipse by default
- * @param {Number} d height of the arc's ellipse by default
- * @param {Number} start angle to start the arc, specified in radians
- * @param {Number} stop angle to stop the arc, specified in radians
- * @param {Constant} [mode] optional parameter to determine the way of drawing
- * the arc. either CHORD or PIE
- * @chainable
- * @example
- *
- *
- * arc(50, 55, 50, 50, 0, HALF_PI);
- * noFill();
- * arc(50, 55, 60, 60, HALF_PI, PI);
- * arc(50, 55, 70, 70, PI, PI+QUARTER_PI);
- * arc(50, 55, 80, 80, PI+QUARTER_PI, TWO_PI);
- *
- *
- *
- *
- *
- * arc(50, 50, 80, 80, 0, PI+QUARTER_PI, OPEN);
- *
- *
- *
- *
- *
- * arc(50, 50, 80, 80, 0, PI+QUARTER_PI, CHORD);
- *
- *
- *
- *
- *
- * arc(50, 50, 80, 80, 0, PI+QUARTER_PI, PIE);
- *
- *
- *
- * @alt
- *shattered outline of an ellipse with a quarter of a white circle bottom-right.
- *white ellipse with black outline with top right missing.
- *white ellipse with top right missing with black outline around shape.
- *white ellipse with top right quarter missing with black outline around the shape.
- *
- */
-p5.prototype.arc = function(x, y, w, h, start, stop, mode) {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
-
- p5._validateParameters('arc', args);
- if (!this._renderer._doStroke && !this._renderer._doFill) {
- return this;
- }
- if (this._angleMode === constants.DEGREES) {
- start = this.radians(start);
- stop = this.radians(stop);
- }
-
- // Make all angles positive...
- while (start < 0) {
- start += constants.TWO_PI;
- }
- while (stop < 0) {
- stop += constants.TWO_PI;
- }
- // ...and confine them to the interval [0,TWO_PI).
- start %= constants.TWO_PI;
- stop %= constants.TWO_PI;
-
- // account for full circle
- if (stop === start) {
- stop += constants.TWO_PI;
- }
-
- // Adjust angles to counter linear scaling.
- if (start <= constants.HALF_PI) {
- start = Math.atan(w / h * Math.tan(start));
- } else if (start > constants.HALF_PI && start <= 3 * constants.HALF_PI) {
- start = Math.atan(w / h * Math.tan(start)) + constants.PI;
- } else {
- start = Math.atan(w / h * Math.tan(start)) + constants.TWO_PI;
- }
- if (stop <= constants.HALF_PI) {
- stop = Math.atan(w / h * Math.tan(stop));
- } else if (stop > constants.HALF_PI && stop <= 3 * constants.HALF_PI) {
- stop = Math.atan(w / h * Math.tan(stop)) + constants.PI;
- } else {
- stop = Math.atan(w / h * Math.tan(stop)) + constants.TWO_PI;
- }
-
- // Exceed the interval if necessary in order to preserve the size and
- // orientation of the arc.
- if (start > stop) {
- stop += constants.TWO_PI;
- }
- // p5 supports negative width and heights for ellipses
- w = Math.abs(w);
- h = Math.abs(h);
- this._renderer.arc(x, y, w, h, start, stop, mode);
- return this;
-};
-
-/**
- * Draws an ellipse (oval) to the screen. An ellipse with equal width and
- * height is a circle. By default, the first two parameters set the location,
- * and the third and fourth parameters set the shape's width and height. If
- * no height is specified, the value of width is used for both the width and
- * height. If a negative height or width is specified, the absolute value is taken.
- * The origin may be changed with the ellipseMode() function.
- *
- * @method ellipse
- * @param {Number} x x-coordinate of the ellipse.
- * @param {Number} y y-coordinate of the ellipse.
- * @param {Number} w width of the ellipse.
- * @param {Number} [h] height of the ellipse.
- * @chainable
- * @example
- *
- *
- * ellipse(56, 46, 55, 55);
- *
- *
- *
- * @alt
- *white ellipse with black outline in middle-right of canvas that is 55x55.
- *
- */
-p5.prototype.ellipse = function() {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- // Duplicate 3rd argument if only 3 given.
- if (args.length === 3) {
- args.push(args[2]);
- }
-
- p5._validateParameters('ellipse', args);
- // p5 supports negative width and heights for rects
- if (args[2] < 0){args[2] = Math.abs(args[2]);}
- if (args[3] < 0){args[3] = Math.abs(args[3]);}
- if (!this._renderer._doStroke && !this._renderer._doFill) {
- return this;
- }
- var vals = canvas.modeAdjust(
- args[0],
- args[1],
- args[2],
- args[3],
- this._renderer._ellipseMode);
- args[0] = vals.x;
- args[1] = vals.y;
- args[2] = vals.w;
- args[3] = vals.h;
- this._renderer.ellipse(args);
- return this;
-};
-/**
- * Draws a line (a direct path between two points) to the screen. The version
- * of line() with four parameters draws the line in 2D. To color a line, use
- * the stroke() function. A line cannot be filled, therefore the fill()
- * function will not affect the color of a line. 2D lines are drawn with a
- * width of one pixel by default, but this can be changed with the
- * strokeWeight() function.
- *
- * @method line
- * @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
- * @chainable
- * @example
- *
- *
- * line(30, 20, 85, 75);
- *
- *
- *
- *
- *
- * line(30, 20, 85, 20);
- * stroke(126);
- * line(85, 20, 85, 75);
- * stroke(255);
- * line(85, 75, 30, 75);
- *
- *
- *
- * @alt
- *line 78 pixels long running from mid-top to bottom-right of canvas.
- *3 lines of various stroke sizes. Form top, bottom and right sides of a square.
- *
- */
-////commented out original
-// p5.prototype.line = function(x1, y1, x2, y2) {
-// if (!this._renderer._doStroke) {
-// return this;
-// }
-// if(this._renderer.isP3D){
-// } else {
-// this._renderer.line(x1, y1, x2, y2);
-// }
-// };
-p5.prototype.line = function() {
- if (!this._renderer._doStroke) {
- return this;
- }
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
-
- p5._validateParameters('line', args);
- //check whether we should draw a 3d line or 2d
- if (this._renderer.isP3D) {
- this._renderer.line(
- args[0],
- args[1],
- args[2],
- args[3],
- args[4],
- args[5]);
- } else {
- this._renderer.line(
- args[0],
- args[1],
- args[2],
- args[3]);
- }
- return this;
-};
-
-/**
- * Draws a point, a coordinate in space at the dimension of one pixel.
- * The first parameter is the horizontal value for the point, the second
- * value is the vertical value for the point. The color of the point is
- * determined by the current stroke.
- *
- * @method point
- * @param {Number} x the x-coordinate
- * @param {Number} y the y-coordinate
- * @chainable
- * @example
- *
- *
- * point(30, 20);
- * point(85, 20);
- * point(85, 75);
- * point(30, 75);
- *
- *
- *
- * @alt
- *4 points centered in the middle-right of the canvas.
- *
- */
-p5.prototype.point = function() {
- if (!this._renderer._doStroke) {
- return this;
- }
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
-
- p5._validateParameters('point', args);
- //check whether we should draw a 3d line or 2d
- if (this._renderer.isP3D) {
- this._renderer.point(
- args[0],
- args[1],
- args[2]
- );
- } else {
- this._renderer.point(
- args[0],
- args[1]
- );
- }
- return this;
-};
-
-
-/**
- * Draw a quad. A quad is a quadrilateral, a four sided polygon. It is
- * similar to a rectangle, but the angles between its edges are not
- * constrained to ninety degrees. The first pair of parameters (x1,y1)
- * sets the first vertex and the subsequent pairs should proceed
- * clockwise or counter-clockwise around the defined shape.
- *
- * @method quad
- * @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
- * @param {Number} x3 the x-coordinate of the third point
- * @param {Number} y3 the y-coordinate of the third point
- * @param {Number} x4 the x-coordinate of the fourth point
- * @param {Number} y4 the y-coordinate of the fourth point
- * @chainable
- * @example
- *
- *
- * quad(38, 31, 86, 20, 69, 63, 30, 76);
- *
- *
- *
- * @alt
- *irregular white quadrilateral shape with black outline mid-right of canvas.
- *
- */
-/**
- * @method quad
- * @param {Number} x1
- * @param {Number} y1
- * @param {Number} x2
- * @param {Number} y2
- * @param {Number} x3
- * @param {Number} y3
- * @param {Number} x4
- * @param {Number} y4
- * @chainable
- */
-p5.prototype.quad = function() {
- if (!this._renderer._doStroke && !this._renderer._doFill) {
- return this;
- }
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
-
- p5._validateParameters('quad', args);
- if (this._renderer.isP3D) {
- this._renderer.quad(
- args[0],
- args[1],
- args[2],
- args[3],
- args[4],
- args[5],
- args[6],
- args[7],
- args[8],
- args[9],
- args[10],
- args[11]
- );
- } else {
- this._renderer.quad(
- args[0],
- args[1],
- args[2],
- args[3],
- args[4],
- args[5],
- args[6],
- args[7]
- );
- }
- return this;
-};
-
-/**
-* Draws a rectangle to the screen. A rectangle is a four-sided shape with
-* every angle at ninety degrees. By default, the first two parameters set
-* the location of the upper-left corner, the third sets the width, and the
-* fourth sets the height. The way these parameters are interpreted, however,
-* may be changed with the rectMode() function.
-*
-* The fifth, sixth, seventh and eighth parameters, if specified,
-* determine corner radius for the top-right, top-left, lower-right and
-* lower-left corners, respectively. An omitted corner radius parameter is set
-* to the value of the previously specified radius value in the parameter list.
-*
-* @method rect
-* @param {Number} x x-coordinate of the rectangle.
-* @param {Number} y y-coordinate of the rectangle.
-* @param {Number} w width of the rectangle.
-* @param {Number} h height of the rectangle.
-* @param {Number} [tl] optional radius of top-left corner.
-* @param {Number} [tr] optional radius of top-right corner.
-* @param {Number} [br] optional radius of bottom-right corner.
-* @param {Number} [bl] optional radius of bottom-left corner.
-* @return {p5} the p5 object.
-* @example
-*
-*
-* // Draw a rectangle at location (30, 20) with a width and height of 55.
-* rect(30, 20, 55, 55);
-*
-*
-*
-*
-*
-* // Draw a rectangle with rounded corners, each having a radius of 20.
-* rect(30, 20, 55, 55, 20);
-*
-*
-*
-*
-*
-* // Draw a rectangle with rounded corners having the following radii:
-* // top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5.
-* rect(30, 20, 55, 55, 20, 15, 10, 5);
-*
-*
-*
-* @alt
-* 55x55 white rect with black outline in mid-right of canvas.
-* 55x55 white rect with black outline and rounded edges in mid-right of canvas.
-* 55x55 white rect with black outline and rounded edges of different radii.
-*/
-/**
-* @method rect
-* @param {Number} x
-* @param {Number} y
-* @param {Number} w
-* @param {Number} h
-* @param {Number} [detailX]
-* @param {Number} [detailY]
-* @chainable
-*/
-p5.prototype.rect = function() {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- if (!this._renderer._doStroke && !this._renderer._doFill) {
- return this;
- }
-
- p5._validateParameters('rect', args);
- var vals = canvas.modeAdjust(
- args[0],
- args[1],
- args[2],
- args[3],
- this._renderer._rectMode);
- args[0] = vals.x;
- args[1] = vals.y;
- args[2] = vals.w;
- args[3] = vals.h;
- this._renderer.rect(args);
- return this;
-};
-
-/**
-* A triangle is a plane created by connecting three points. The first two
-* arguments specify the first point, the middle two arguments specify the
-* second point, and the last two arguments specify the third point.
-*
-* @method triangle
-* @param {Number} x1 x-coordinate of the first point
-* @param {Number} y1 y-coordinate of the first point
-* @param {Number} x2 x-coordinate of the second point
-* @param {Number} y2 y-coordinate of the second point
-* @param {Number} x3 x-coordinate of the third point
-* @param {Number} y3 y-coordinate of the third point
-* @chainable
-* @example
-*
-*
-* triangle(30, 75, 58, 20, 86, 75);
-*
-*
-*
-*@alt
-* white triangle with black outline in mid-right of canvas.
-*
-*/
-p5.prototype.triangle = function() {
-
- if (!this._renderer._doStroke && !this._renderer._doFill) {
- return this;
- }
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
-
- p5._validateParameters('triangle', args);
- this._renderer.triangle(args);
- return this;
-};
-
-module.exports = p5;
-
-},{"./canvas":53,"./constants":54,"./core":55,"./error_helpers":58}],52:[function(_dereq_,module,exports){
-/**
- * @module Shape
- * @submodule Attributes
- * @for p5
- * @requires core
- * @requires constants
- */
-
-'use strict';
-
-var p5 = _dereq_('./core');
-var constants = _dereq_('./constants');
-
-/**
- * Modifies the location from which ellipses are drawn by changing the way
- * in which parameters given to ellipse() are interpreted.
- *
- * The default mode is ellipseMode(CENTER), which interprets the first two
- * parameters of ellipse() as the shape's center point, while the third and
- * fourth parameters are its width and height.
- *
- * ellipseMode(RADIUS) also uses the first two parameters of ellipse() as
- * the shape's center point, but uses the third and fourth parameters to
- * specify half of the shapes's width and height.
- *
- * ellipseMode(CORNER) interprets the first two parameters of ellipse() as
- * the upper-left corner of the shape, while the third and fourth parameters
- * are its width and height.
- *
- * ellipseMode(CORNERS) interprets the first two parameters of ellipse() as
- * the location of one corner of the ellipse's bounding box, and the third
- * and fourth parameters as the location of the opposite corner.
- *
- * The parameter must be written in ALL CAPS because Javascript is a
- * case-sensitive language.
- *
- * @method ellipseMode
- * @param {Constant} mode either CENTER, RADIUS, CORNER, or CORNERS
- * @chainable
- * @example
- *
- *
- * ellipseMode(RADIUS); // Set ellipseMode to RADIUS
- * fill(255); // Set fill to white
- * ellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode
- *
- * ellipseMode(CENTER); // Set ellipseMode to CENTER
- * fill(100); // Set fill to gray
- * ellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode
- *
- *
- *
- *
- *
- * ellipseMode(CORNER); // Set ellipseMode is CORNER
- * fill(255); // Set fill to white
- * ellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode
- *
- * ellipseMode(CORNERS); // Set ellipseMode to CORNERS
- * fill(100); // Set fill to gray
- * ellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode
- *
- *
- *
- * @alt
- * 60x60 white ellipse and 30x30 grey ellipse with black outlines at center.
- * 60x60 white ellipse @center and 30x30 grey ellipse top-right, black outlines.
- *
- */
-p5.prototype.ellipseMode = function(m) {
- if (m === constants.CORNER ||
- m === constants.CORNERS ||
- m === constants.RADIUS ||
- m === constants.CENTER) {
- this._renderer._ellipseMode = m;
- }
- return this;
-};
-
-/**
- * Draws all geometry with jagged (aliased) edges. Note that smooth() is
- * active by default, so it is necessary to call noSmooth() to disable
- * smoothing of geometry, images, and fonts.
- *
- * @method noSmooth
- * @chainable
- * @example
- *
- *
- * background(0);
- * noStroke();
- * smooth();
- * ellipse(30, 48, 36, 36);
- * noSmooth();
- * ellipse(70, 48, 36, 36);
- *
- *
- *
- * @alt
- * 2 pixelated 36x36 white ellipses to left & right of center, black background
- *
- */
-p5.prototype.noSmooth = function() {
- this._renderer.noSmooth();
- return this;
-};
-
-/**
- * Modifies the location from which rectangles are drawn by changing the way
- * in which parameters given to rect() are interpreted.
- *
- * The default mode is rectMode(CORNER), which interprets the first two
- * parameters of rect() as the upper-left corner of the shape, while the
- * third and fourth parameters are its width and height.
- *
- * rectMode(CORNERS) interprets the first two parameters of rect() as the
- * location of one corner, and the third and fourth parameters as the
- * location of the opposite corner.
- *
- * rectMode(CENTER) interprets the first two parameters of rect() as the
- * shape's center point, while the third and fourth parameters are its
- * width and height.
- *
- * rectMode(RADIUS) also uses the first two parameters of rect() as the
- * shape's center point, but uses the third and fourth parameters to specify
- * half of the shapes's width and height.
- *
- * The parameter must be written in ALL CAPS because Javascript is a
- * case-sensitive language.
- *
- * @method rectMode
- * @param {Constant} mode either CORNER, CORNERS, CENTER, or RADIUS
- * @chainable
- * @example
- *
- *
- * rectMode(CORNER); // Default rectMode is CORNER
- * fill(255); // Set fill to white
- * rect(25, 25, 50, 50); // Draw white rect using CORNER mode
- *
- * rectMode(CORNERS); // Set rectMode to CORNERS
- * fill(100); // Set fill to gray
- * rect(25, 25, 50, 50); // Draw gray rect using CORNERS mode
- *
- *
- *
- *
- *
- * rectMode(RADIUS); // Set rectMode to RADIUS
- * fill(255); // Set fill to white
- * rect(50, 50, 30, 30); // Draw white rect using RADIUS mode
- *
- * rectMode(CENTER); // Set rectMode to CENTER
- * fill(100); // Set fill to gray
- * rect(50, 50, 30, 30); // Draw gray rect using CENTER mode
- *
- *
- *
- * @alt
- * 50x50 white rect at center and 25x25 grey rect in the top left of the other.
- * 50x50 white rect at center and 25x25 grey rect in the center of the other.
- *
- */
-p5.prototype.rectMode = function(m) {
- if (m === constants.CORNER ||
- m === constants.CORNERS ||
- m === constants.RADIUS ||
- m === constants.CENTER) {
- this._renderer._rectMode = m;
- }
- return this;
-};
-
-/**
- * Draws all geometry with smooth (anti-aliased) edges. smooth() will also
- * improve image quality of resized images. Note that smooth() is active by
- * default; noSmooth() can be used to disable smoothing of geometry,
- * images, and fonts.
- *
- * @method smooth
- * @chainable
- * @example
- *
- *
- * background(0);
- * noStroke();
- * smooth();
- * ellipse(30, 48, 36, 36);
- * noSmooth();
- * ellipse(70, 48, 36, 36);
- *
- *
- *
- * @alt
- * 2 pixelated 36x36 white ellipses one left one right of center. On black.
- *
- */
-p5.prototype.smooth = function() {
- this._renderer.smooth();
- return this;
-};
-
-/**
- * Sets the style for rendering line endings. These ends are either squared,
- * extended, or rounded, each of which specified with the corresponding
- * parameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND.
- *
- * @method strokeCap
- * @param {Constant} cap either SQUARE, PROJECT, or ROUND
- * @chainable
- * @example
- *
- *
- * strokeWeight(12.0);
- * strokeCap(ROUND);
- * line(20, 30, 80, 30);
- * strokeCap(SQUARE);
- * line(20, 50, 80, 50);
- * strokeCap(PROJECT);
- * line(20, 70, 80, 70);
- *
- *
- *
- * @alt
- * 3 lines. Top line: rounded ends, mid: squared, bottom:longer squared ends.
- *
- */
-p5.prototype.strokeCap = function(cap) {
- if (cap === constants.ROUND ||
- cap === constants.SQUARE ||
- cap === constants.PROJECT) {
- this._renderer.strokeCap(cap);
- }
- return this;
-};
-
-/**
- * Sets the style of the joints which connect line segments. These joints
- * are either mitered, beveled, or rounded and specified with the
- * corresponding parameters MITER, BEVEL, and ROUND. The default joint is
- * MITER.
- *
- * @method strokeJoin
- * @param {Constant} join either MITER, BEVEL, ROUND
- * @chainable
- * @example
- *
- *
- * noFill();
- * strokeWeight(10.0);
- * strokeJoin(MITER);
- * beginShape();
- * vertex(35, 20);
- * vertex(65, 50);
- * vertex(35, 80);
- * endShape();
- *
- *
- *
- *
- *
- * noFill();
- * strokeWeight(10.0);
- * strokeJoin(BEVEL);
- * beginShape();
- * vertex(35, 20);
- * vertex(65, 50);
- * vertex(35, 80);
- * endShape();
- *
- *
- *
- *
- *
- * noFill();
- * strokeWeight(10.0);
- * strokeJoin(ROUND);
- * beginShape();
- * vertex(35, 20);
- * vertex(65, 50);
- * vertex(35, 80);
- * endShape();
- *
- *
- *
- * @alt
- * Right-facing arrowhead shape with pointed tip in center of canvas.
- * Right-facing arrowhead shape with flat tip in center of canvas.
- * Right-facing arrowhead shape with rounded tip in center of canvas.
- *
- */
-p5.prototype.strokeJoin = function(join) {
- if (join === constants.ROUND ||
- join === constants.BEVEL ||
- join === constants.MITER) {
- this._renderer.strokeJoin(join);
- }
- return this;
-};
-
-/**
- * Sets the width of the stroke used for lines, points, and the border
- * around shapes. All widths are set in units of pixels.
- *
- * @method strokeWeight
- * @param {Number} weight the weight (in pixels) of the stroke
- * @return {p5} the p5 object
- * @example
- *
- *
- * strokeWeight(1); // Default
- * line(20, 20, 80, 20);
- * strokeWeight(4); // Thicker
- * line(20, 40, 80, 40);
- * strokeWeight(10); // Beastly
- * line(20, 70, 80, 70);
- *
- *
- *
- * @alt
- * 3 horizontal black lines. Top line: thin, mid: medium, bottom:thick.
- *
- */
-p5.prototype.strokeWeight = function(w) {
- this._renderer.strokeWeight(w);
- return this;
-};
-
-module.exports = p5;
-
-},{"./constants":54,"./core":55}],53:[function(_dereq_,module,exports){
-/**
- * @requires constants
- */
-
-var constants = _dereq_('./constants');
-
-module.exports = {
-
- modeAdjust: function(a, b, c, d, mode) {
- if (mode === constants.CORNER) {
- return { x: a, y: b, w: c, h: d };
- } else if (mode === constants.CORNERS) {
- return { x: a, y: b, w: c-a, h: d-b };
- } else if (mode === constants.RADIUS) {
- return { x: a-c, y: b-d, w: 2*c, h: 2*d };
- } else if (mode === constants.CENTER) {
- return { x: a-c*0.5, y: b-d*0.5, w: c, h: d };
- }
- },
-
- arcModeAdjust: function(a, b, c, d, mode) {
- if (mode === constants.CORNER) {
- return { x: a+c*0.5, y: b+d*0.5, w: c, h: d };
- } else if (mode === constants.CORNERS) {
- return { x: a, y: b, w: c+a, h: d+b };
- } else if (mode === constants.RADIUS) {
- return { x: a, y: b, w: 2*c, h: 2*d };
- } else if (mode === constants.CENTER) {
- return { x: a, y: b, w: c, h: d };
- }
- }
-
-};
-
-
-},{"./constants":54}],54:[function(_dereq_,module,exports){
-/**
- * @module Constants
- * @submodule Constants
- * @for p5
- */
-
-var PI = Math.PI;
-
-module.exports = {
-
- // GRAPHICS RENDERER
- /**
- * @property {String} P2D
- * @final
- */
- P2D: 'p2d',
- /**
- * @property {String} WEBGL
- * @final
- */
- WEBGL: 'webgl',
-
- // ENVIRONMENT
- ARROW: 'default',
- CROSS: 'crosshair',
- HAND: 'pointer',
- MOVE: 'move',
- TEXT: 'text',
- WAIT: 'wait',
-
- // TRIGONOMETRY
-
- /**
- * HALF_PI is a mathematical constant with the value
- * 1.57079632679489661923. It is half the ratio of the
- * circumference of a circle to its diameter. It is useful in
- * combination with the trigonometric functions sin() and cos().
- *
- * @property {Number} HALF_PI
- * @final
- *
- * @example
- *
- * arc(50, 50, 80, 80, 0, HALF_PI);
- *
- *
- * @alt
- * 80x80 white quarter-circle with curve toward bottom right of canvas.
- *
- */
- HALF_PI: PI / 2,
- /**
- * PI is a mathematical constant with the value
- * 3.14159265358979323846. It is the ratio of the circumference
- * of a circle to its diameter. It is useful in combination with
- * the trigonometric functions sin() and cos().
- *
- * @property {Number} PI
- * @final
- *
- * @example
- *
- * arc(50, 50, 80, 80, 0, PI);
- *
- *
- * @alt
- * white half-circle with curve toward bottom of canvas.
- *
- */
- PI: PI,
- /**
- * QUARTER_PI is a mathematical constant with the value 0.7853982.
- * It is one quarter the ratio of the circumference of a circle to
- * its diameter. It is useful in combination with the trigonometric
- * functions sin() and cos().
- *
- * @property {Number} QUARTER_PI
- * @final
- *
- * @example
- *
- * arc(50, 50, 80, 80, 0, QUARTER_PI);
- *
- *
- * @alt
- * white eighth-circle rotated about 40 degrees with curve bottom right canvas.
- *
- */
- QUARTER_PI: PI / 4,
- /**
- * TAU is an alias for TWO_PI, a mathematical constant with the
- * value 6.28318530717958647693. It is twice the ratio of the
- * circumference of a circle to its diameter. It is useful in
- * combination with the trigonometric functions sin() and cos().
- *
- * @property {Number} TAU
- * @final
- *
- * @example
- *
- * arc(50, 50, 80, 80, 0, TAU);
- *
- *
- * @alt
- * 80x80 white ellipse shape in center of canvas.
- *
- */
- TAU: PI * 2,
- /**
- * TWO_PI is a mathematical constant with the value
- * 6.28318530717958647693. It is twice the ratio of the
- * circumference of a circle to its diameter. It is useful in
- * combination with the trigonometric functions sin() and cos().
- *
- * @property {Number} TWO_PI
- * @final
- *
- * @example
- *
- * arc(50, 50, 80, 80, 0, TWO_PI);
- *
- *
- * @alt
- * 80x80 white ellipse shape in center of canvas.
- *
- */
- TWO_PI: PI * 2,
- /**
- * @property {String} DEGREES
- * @final
- */
- DEGREES: 'degrees',
- /**
- * @property {String} RADIANS
- * @final
- */
- RADIANS: 'radians',
- DEG_TO_RAD: PI / 180.0,
- RAD_TO_DEG: 180.0 / PI,
-
- // SHAPE
- /**
- * @property {String} CORNER
- * @final
- */
- CORNER: 'corner',
- /**
- * @property {String} CORNERS
- * @final
- */
- CORNERS: 'corners',
- /**
- * @property {String} RADIUS
- * @final
- */
- RADIUS: 'radius',
- /**
- * @property {String} RIGHT
- * @final
- */
- RIGHT: 'right',
- /**
- * @property {String} LEFT
- * @final
- */
- LEFT: 'left',
- /**
- * @property {String} CENTER
- * @final
- */
- CENTER: 'center',
- /**
- * @property {String} TOP
- * @final
- */
- TOP: 'top',
- /**
- * @property {String} BOTTOM
- * @final
- */
- BOTTOM: 'bottom',
- /**
- * @property {String} BASELINE
- * @final
- * @default alphabetic
- */
- BASELINE: 'alphabetic',
- /**
- * @property {Number} POINTS
- * @final
- * @default 0x0000
- */
- POINTS: 0x0000,
- /**
- * @property {Number} LINES
- * @final
- * @default 0x0001
- */
- LINES: 0x0001,
- /**
- * @property {Number} LINE_STRIP
- * @final
- * @default 0x0003
- */
- LINE_STRIP: 0x0003,
- /**
- * @property {Number} LINE_LOOP
- * @final
- * @default 0x0002
- */
- LINE_LOOP: 0x0002,
- /**
- * @property {Number} TRIANGLES
- * @final
- * @default 0x0004
- */
- TRIANGLES: 0x0004,
- /**
- * @property {Number} TRIANGLE_FAN
- * @final
- * @default 0x0006
- */
- TRIANGLE_FAN: 0x0006,
- /**
- * @property {Number} TRIANGLE_STRIP
- * @final
- * @default 0x0005
- */
- TRIANGLE_STRIP: 0x0005,
- /**
- * @property {String} QUADS
- * @final
- */
- QUADS: 'quads',
- /**
- * @property {String} QUAD_STRIP
- * @final
- * @default quad_strip
- */
- QUAD_STRIP: 'quad_strip',
- /**
- * @property {String} CLOSE
- * @final
- */
- CLOSE: 'close',
- /**
- * @property {String} OPEN
- * @final
- */
- OPEN: 'open',
- /**
- * @property {String} CHORD
- * @final
- */
- CHORD: 'chord',
- /**
- * @property {String} PIE
- * @final
- */
- PIE: 'pie',
- /**
- * @property {String} PROJECT
- * @final
- * @default square
- */
- PROJECT: 'square', // PEND: careful this is counterintuitive
- /**
- * @property {String} SQUARE
- * @final
- * @default butt
- */
- SQUARE: 'butt',
- /**
- * @property {String} ROUND
- * @final
- */
- ROUND: 'round',
- /**
- * @property {String} BEVEL
- * @final
- */
- BEVEL: 'bevel',
- /**
- * @property {String} MITER
- * @final
- */
- MITER: 'miter',
-
- // COLOR
- /**
- * @property {String} RGB
- * @final
- */
- RGB: 'rgb',
- /**
- * @property {String} HSB
- * @final
- */
- HSB: 'hsb',
- /**
- * @property {String} HSL
- * @final
- */
- HSL: 'hsl',
-
- // DOM EXTENSION
- AUTO: 'auto',
-
- // INPUT
- ALT: 18,
- BACKSPACE: 8,
- CONTROL: 17,
- DELETE: 46,
- DOWN_ARROW: 40,
- ENTER: 13,
- ESCAPE: 27,
- LEFT_ARROW: 37,
- OPTION: 18,
- RETURN: 13,
- RIGHT_ARROW: 39,
- SHIFT: 16,
- TAB: 9,
- UP_ARROW: 38,
-
- // RENDERING
- /**
- * @property {String} BLEND
- * @final
- * @default source-over
- */
- BLEND: 'source-over',
- /**
- * @property {String} ADD
- * @final
- * @default lighter
- */
- ADD: 'lighter',
- //ADD: 'add', //
- //SUBTRACT: 'subtract', //
- /**
- * @property {String} DARKEST
- * @final
- */
- DARKEST: 'darken',
- /**
- * @property {String} LIGHTEST
- * @final
- * @default lighten
- */
- LIGHTEST: 'lighten',
- /**
- * @property {String} DIFFERENCE
- * @final
- */
- DIFFERENCE: 'difference',
- /**
- * @property {String} EXCLUSION
- * @final
- */
- EXCLUSION: 'exclusion',
- /**
- * @property {String} MULTIPLY
- * @final
- */
- MULTIPLY: 'multiply',
- /**
- * @property {String} SCREEN
- * @final
- */
- SCREEN: 'screen',
- /**
- * @property {String} REPLACE
- * @final
- * @default copy
- */
- REPLACE: 'copy',
- /**
- * @property {String} OVERLAY
- * @final
- */
- OVERLAY: 'overlay',
- /**
- * @property {String} HARD_LIGHT
- * @final
- */
- HARD_LIGHT: 'hard-light',
- /**
- * @property {String} SOFT_LIGHT
- * @final
- */
- SOFT_LIGHT: 'soft-light',
- /**
- * @property {String} DODGE
- * @final
- * @default color-dodge
- */
- DODGE: 'color-dodge',
- /**
- * @property {String} BURN
- * @final
- * @default color-burn
- */
- BURN: 'color-burn',
-
- // FILTERS
- /**
- * @property {String} THRESHOLD
- * @final
- */
- THRESHOLD: 'threshold',
- /**
- * @property {String} GRAY
- * @final
- */
- GRAY: 'gray',
- /**
- * @property {String} OPAQUE
- * @final
- */
- OPAQUE: 'opaque',
- /**
- * @property {String} INVERT
- * @final
- */
- INVERT: 'invert',
- /**
- * @property {String} POSTERIZE
- * @final
- */
- POSTERIZE: 'posterize',
- /**
- * @property {String} DILATE
- * @final
- */
- DILATE: 'dilate',
- /**
- * @property {String} ERODE
- * @final
- */
- ERODE: 'erode',
- /**
- * @property {String} BLUR
- * @final
- */
- BLUR: 'blur',
-
- // TYPOGRAPHY
- /**
- * @property {String} NORMAL
- * @final
- */
- NORMAL: 'normal',
- /**
- * @property {String} ITALIC
- * @final
- */
- ITALIC: 'italic',
- /**
- * @property {String} BOLD
- * @final
- */
- BOLD: 'bold',
-
- // TYPOGRAPHY-INTERNAL
- _DEFAULT_TEXT_FILL: '#000000',
- _DEFAULT_LEADMULT: 1.25,
- _CTX_MIDDLE: 'middle',
-
- // VERTICES
- LINEAR: 'linear',
- QUADRATIC: 'quadratic',
- BEZIER: 'bezier',
- CURVE: 'curve',
-
- // WEBGL DRAWMODES
- STROKE: 'stroke',
- FILL: 'fill',
- TEXTURE: 'texture',
- IMMEDIATE: 'immediate',
-
- // DEVICE-ORIENTATION
- /**
- * @property {String} LANDSCAPE
- * @final
- */
- LANDSCAPE: 'landscape',
- /**
- * @property {String} PORTRAIT
- * @final
- */
- PORTRAIT: 'portrait',
-
- // DEFAULTS
- _DEFAULT_STROKE: '#000000',
- _DEFAULT_FILL: '#FFFFFF'
-
-};
-
-},{}],55:[function(_dereq_,module,exports){
-/**
- * @module Structure
- * @submodule Structure
- * @for p5
- * @requires constants
- */
-
-'use strict';
-
-_dereq_('./shim');
-
-// Core needs the PVariables object
-var constants = _dereq_('./constants');
-
-/**
- * This is the p5 instance constructor.
- *
- * A p5 instance holds all the properties and methods related to
- * a p5 sketch. It expects an incoming sketch closure and it can also
- * take an optional node parameter for attaching the generated p5 canvas
- * to a node. The sketch closure takes the newly created p5 instance as
- * its sole argument and may optionally set preload(), setup(), and/or
- * draw() properties on it for running a sketch.
- *
- * A p5 sketch can run in "global" or "instance" mode:
- * "global" - all properties and methods are attached to the window
- * "instance" - all properties and methods are bound to this p5 object
- *
- * @param {function} sketch a closure that can set optional preload(),
- * setup(), and/or draw() properties on the
- * given p5 instance
- * @param {HTMLElement|boolean} [node] element to attach canvas to, if a
- * boolean is passed in use it as sync
- * @param {boolean} [sync] start synchronously (optional)
- * @return {p5} a p5 instance
- */
-var p5 = function(sketch, node, sync) {
-
- if (arguments.length === 2 && typeof node === 'boolean') {
- sync = node;
- node = undefined;
- }
-
- //////////////////////////////////////////////
- // PUBLIC p5 PROPERTIES AND METHODS
- //////////////////////////////////////////////
-
-
- /**
- * Called directly before setup(), the preload() function is used to handle
- * asynchronous loading of external files. If a preload function is
- * defined, setup() will wait until any load calls within have finished.
- * Nothing besides load calls should be inside preload (loadImage,
- * loadJSON, loadFont, loadStrings, etc).
- * By default the text "loading..." will be displayed. To make your own
- * loading page, include an HTML element with id "p5_loading" in your
- * page. More information here.
- *
- * @method preload
- * @example
- *
- * var img;
- * var c;
- * function preload() { // preload() runs once
- * img = loadImage('assets/laDefense.jpg');
- * }
- *
- * function setup() { // setup() waits until preload() is done
- * img.loadPixels();
- * // get color of middle pixel
- * c = img.get(img.width/2, img.height/2);
- * }
- *
- * function draw() {
- * background(c);
- * image(img, 25, 25, 50, 50);
- * }
- *
- *
- * @alt
- * nothing displayed
- *
- */
-
- /**
- * The setup() function is called once when the program starts. It's used to
- * define initial environment properties such as screen size and background
- * color and to load media such as images and fonts as the program starts.
- * There can only be one setup() function for each program and it shouldn't
- * be called again after its initial execution.
- *
- * Note: Variables declared within setup() are not accessible within other
- * functions, including draw().
- *
- * @method setup
- * @example
- *
- * var a = 0;
- *
- * function setup() {
- * background(0);
- * noStroke();
- * fill(102);
- * }
- *
- * function draw() {
- * rect(a++%width, 10, 2, 80);
- * }
- *
- *
- * @alt
- * nothing displayed
- *
- */
-
- /**
- * Called directly after setup(), the draw() function continuously executes
- * the lines of code contained inside its block until the program is stopped
- * or noLoop() is called. Note if noLoop() is called in setup(), draw() will
- * still be executed once before stopping. draw() is called automatically and
- * should never be called explicitly.
- *
- * It should always be controlled with noLoop(), redraw() and loop(). After
- * noLoop() stops the code in draw() from executing, redraw() causes the
- * code inside draw() to execute once, and loop() will cause the code
- * inside draw() to resume executing continuously.
- *
- * The number of times draw() executes in each second may be controlled with
- * the frameRate() function.
- *
- * There can only be one draw() function for each sketch, and draw() must
- * exist if you want the code to run continuously, or to process events such
- * as mousePressed(). Sometimes, you might have an empty call to draw() in
- * your program, as shown in the above example.
- *
- * It is important to note that the drawing coordinate system will be reset
- * at the beginning of each draw() call. If any transformations are performed
- * within draw() (ex: scale, rotate, translate, their effects will be
- * undone at the beginning of draw(), so transformations will not accumulate
- * over time. On the other hand, styling applied (ex: fill, stroke, etc) will
- * remain in effect.
- *
- * @method draw
- * @example
- *
- * var yPos = 0;
- * function setup() { // setup() runs once
- * frameRate(30);
- * }
- * function draw() { // draw() loops forever, until stopped
- * background(204);
- * yPos = yPos - 1;
- * if (yPos < 0) {
- * yPos = height;
- * }
- * line(0, yPos, width, yPos);
- * }
- *
- *
- * @alt
- * nothing displayed
- *
- */
-
-
- //////////////////////////////////////////////
- // PRIVATE p5 PROPERTIES AND METHODS
- //////////////////////////////////////////////
-
- this._setupDone = false;
- // for handling hidpi
- this._pixelDensity = Math.ceil(window.devicePixelRatio) || 1;
- this._userNode = node;
- this._curElement = null;
- this._elements = [];
- this._requestAnimId = 0;
- this._preloadCount = 0;
- this._isGlobal = false;
- this._loop = true;
- this._styles = [];
- this._defaultCanvasSize = {
- width: 100,
- height: 100
- };
- this._events = { // keep track of user-events for unregistering later
- 'mousemove': null,
- 'mousedown': null,
- 'mouseup': null,
- 'dragend': null,
- 'dragover': null,
- 'click': null,
- 'mouseover': null,
- 'mouseout': null,
- 'keydown': null,
- 'keyup': null,
- 'keypress': null,
- 'touchstart': null,
- 'touchmove': null,
- 'touchend': null,
- 'resize': null,
- 'blur': null
- };
-
- this._events.wheel = null;
- this._loadingScreenId = 'p5_loading';
-
- if (window.DeviceOrientationEvent) {
- this._events.deviceorientation = null;
- }
- if (window.DeviceMotionEvent && !window._isNodeWebkit) {
- this._events.devicemotion = null;
- }
-
- this._start = function () {
- // Find node if id given
- if (this._userNode) {
- if (typeof this._userNode === 'string') {
- this._userNode = document.getElementById(this._userNode);
- }
- }
-
- var userPreload = this.preload || window.preload; // look for "preload"
- if (userPreload) {
-
- // Setup loading screen
- // Set loading scfeen into dom if not present
- // Otherwise displays and removes user provided loading screen
- var loadingScreen = document.getElementById(this._loadingScreenId);
- if(!loadingScreen){
- loadingScreen = document.createElement('div');
- loadingScreen.innerHTML = 'Loading...';
- loadingScreen.style.position = 'absolute';
- loadingScreen.id = this._loadingScreenId;
- var node = this._userNode || document.body;
- node.appendChild(loadingScreen);
- }
- // var methods = this._preloadMethods;
- for (var method in this._preloadMethods){
- // default to p5 if no object defined
- this._preloadMethods[method] = this._preloadMethods[method] || p5;
- var obj = this._preloadMethods[method];
- //it's p5, check if it's global or instance
- if (obj === p5.prototype || obj === p5){
- obj = this._isGlobal ? window : this;
- }
- this._registeredPreloadMethods[method] = obj[method];
- obj[method] = this._wrapPreload(obj, method);
- }
-
- userPreload();
- this._runIfPreloadsAreDone();
- } else {
- this._setup();
- this._runFrames();
- this._draw();
- }
- }.bind(this);
-
- this._runIfPreloadsAreDone = function(){
- var context = this._isGlobal ? window : this;
- if (context._preloadCount === 0) {
- var loadingScreen = document.getElementById(context._loadingScreenId);
- if (loadingScreen) {
- loadingScreen.parentNode.removeChild(loadingScreen);
- }
- context._setup();
- context._runFrames();
- context._draw();
- }
- };
-
- this._decrementPreload = function(){
- var context = this._isGlobal ? window : this;
- if(typeof context.preload === 'function'){
- context._setProperty('_preloadCount', context._preloadCount - 1);
- context._runIfPreloadsAreDone();
- }
- };
-
- this._wrapPreload = function(obj, fnName){
- return function(){
- //increment counter
- this._incrementPreload();
- //call original function
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- // args.push(this._decrementPreload.bind(this));
- return this._registeredPreloadMethods[fnName].apply(obj, args);
- }.bind(this);
- };
-
- this._incrementPreload = function(){
- var context = this._isGlobal ? window : this;
- context._setProperty('_preloadCount', context._preloadCount + 1);
- };
-
- this._setup = function() {
-
- // Always create a default canvas.
- // Later on if the user calls createCanvas, this default one
- // will be replaced
- this.createCanvas(
- this._defaultCanvasSize.width,
- this._defaultCanvasSize.height,
- 'p2d',
- true
- );
-
- // return preload functions to their normal vals if switched by preload
- var context = this._isGlobal ? window : this;
- if (typeof context.preload === 'function') {
- for (var f in this._preloadMethods) {
- context[f] = this._preloadMethods[f][f];
- if (context[f] && this) {
- context[f] = context[f].bind(this);
- }
- }
- }
-
- // Short-circuit on this, in case someone used the library in "global"
- // mode earlier
- if (typeof context.setup === 'function') {
- context.setup();
- }
-
- // unhide any hidden canvases that were created
- var canvases = document.getElementsByTagName('canvas');
- for (var i = 0; i < canvases.length; i++) {
- var k = canvases[i];
- if (k.dataset.hidden === 'true') {
- k.style.visibility = '';
- delete(k.dataset.hidden);
- }
- }
- this._setupDone = true;
-
- }.bind(this);
-
- this._draw = function () {
- var now = window.performance.now();
- var time_since_last = now - this._lastFrameTime;
- var target_time_between_frames = 1000 / this._targetFrameRate;
-
- // only draw if we really need to; don't overextend the browser.
- // draw if we're within 5ms of when our next frame should paint
- // (this will prevent us from giving up opportunities to draw
- // again when it's really about time for us to do so). fixes an
- // issue where the frameRate is too low if our refresh loop isn't
- // in sync with the browser. note that we have to draw once even
- // if looping is off, so we bypass the time delay if that
- // is the case.
- var epsilon = 5;
- if (!this._loop ||
- time_since_last >= target_time_between_frames - epsilon) {
-
- //mandatory update values(matrixs and stack)
-
- this.redraw();
- this._frameRate = 1000.0/(now - this._lastFrameTime);
- this._lastFrameTime = now;
-
- // If the user is actually using mouse module, then update
- // coordinates, otherwise skip. We can test this by simply
- // checking if any of the mouse functions are available or not.
- // NOTE : This reflects only in complete build or modular build.
- if(typeof this._updateMouseCoords !== 'undefined') {
- this._updateMouseCoords();
- }
- }
-
- // get notified the next time the browser gives us
- // an opportunity to draw.
- if (this._loop) {
- this._requestAnimId = window.requestAnimationFrame(this._draw);
- }
- }.bind(this);
-
- this._runFrames = function() {
- if (this._updateInterval) {
- clearInterval(this._updateInterval);
- }
- }.bind(this);
-
- this._setProperty = function(prop, value) {
- this[prop] = value;
- if (this._isGlobal) {
- window[prop] = value;
- }
- }.bind(this);
-
- /**
- * Removes the entire p5 sketch. This will remove the canvas and any
- * elements created by p5.js. It will also stop the draw loop and unbind
- * any properties or methods from the window global scope. It will
- * leave a variable p5 in case you wanted to create a new p5 sketch.
- * If you like, you can set p5 = null to erase it. While all functions and
- * variables and objects created by the p5 library will be removed, any
- * other global variables created by your code will remain.
- *
- * @method remove
- * @example
- *
- * function draw() {
- * ellipse(50, 50, 10, 10);
- * }
- *
- * function mousePressed() {
- * remove(); // remove whole sketch on mouse press
- * }
- *
- *
- * @alt
- * nothing displayed
- *
- */
- this.remove = function() {
- if (this._curElement) {
-
- // stop draw
- this._loop = false;
- if (this._requestAnimId) {
- window.cancelAnimationFrame(this._requestAnimId);
- }
-
- // unregister events sketch-wide
- for (var ev in this._events) {
- window.removeEventListener(ev, this._events[ev]);
- }
-
- // remove DOM elements created by p5, and listeners
- for (var i=0; icolorMode(). (The default color space is RGB, with each value
+ * in the range from 0 to 255). The alpha range by default is also 0 to 255.
+ *
+ * If a single string argument is provided, RGB, RGBA and Hex CSS color strings
+ * and all named color strings are supported. In this case, an alpha number
+ * value as a second argument is not supported, the RGBA form should be used.
+ *
+ * A p5 Color object can also be provided to set the fill color.
+ *
+ * @method fill
+ * @param {Number} v1 red or hue value relative to
+ * the current color range
+ * @param {Number} v2 green or saturation value
+ * relative to the current color range
+ * @param {Number} v3 blue or brightness value
+ * relative to the current color range
+ * @param {Number} [alpha]
+ * @chainable
+ * @example
+ *
+ *
+ * // Grayscale integer value
+ * fill(51);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // R, G & B integer values
+ * fill(255, 204, 0);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // H, S & B integer values
+ * colorMode(HSB);
+ * fill(255, 204, 100);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // Named SVG/CSS color string
+ * fill('red');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // three-digit hexadecimal RGB notation
+ * fill('#fae');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // six-digit hexadecimal RGB notation
+ * fill('#222222');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // integer RGB notation
+ * fill('rgb(0,255,0)');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // integer RGBA notation
+ * fill('rgba(0,255,0, 0.25)');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // percentage RGB notation
+ * fill('rgb(100%,0%,10%)');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // percentage RGBA notation
+ * fill('rgba(100%,0%,100%,0.5)');
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // p5 Color object
+ * fill(color(0, 0, 255));
+ * rect(20, 20, 60, 60);
+ *
+ *
+ * @alt
+ * 60x60 dark charcoal grey rect with black outline in center of canvas.
+ * 60x60 yellow rect with black outline in center of canvas.
+ * 60x60 royal blue rect with black outline in center of canvas.
+ * 60x60 red rect with black outline in center of canvas.
+ * 60x60 pink rect with black outline in center of canvas.
+ * 60x60 black rect with black outline in center of canvas.
+ * 60x60 light green rect with black outline in center of canvas.
+ * 60x60 soft green rect with black outline in center of canvas.
+ * 60x60 red rect with black outline in center of canvas.
+ * 60x60 dark fushcia rect with black outline in center of canvas.
+ * 60x60 blue rect with black outline in center of canvas.
+ */
-p5.prototype._registeredMethods = { init: [], pre: [], post: [], remove: [] };
+/**
+ * @method fill
+ * @param {String} value a color string
+ * @chainable
+ */
-p5.prototype._registeredPreloadMethods = {};
+/**
+ * @method fill
+ * @param {Number} gray a gray value
+ * @param {Number} [alpha]
+ * @chainable
+ */
-p5.prototype.registerPreloadMethod = function(fnString, obj) {
- // obj = obj || p5.prototype;
- if (!p5.prototype._preloadMethods.hasOwnProperty(fnString)) {
- p5.prototype._preloadMethods[fnString] = obj;
- }
-};
+/**
+ * @method fill
+ * @param {Number[]} values an array containing the red,green,blue &
+ * and alpha components of the color
+ * @chainable
+ */
-p5.prototype.registerMethod = function(name, m) {
- if (!p5.prototype._registeredMethods.hasOwnProperty(name)) {
- p5.prototype._registeredMethods[name] = [];
- }
- p5.prototype._registeredMethods[name].push(m);
+/**
+ * @method fill
+ * @param {p5.Color} color the fill color
+ * @chainable
+ */
+p5.prototype.fill = function() {
+ this._renderer._setProperty('_fillSet', true);
+ this._renderer._setProperty('_doFill', true);
+ this._renderer.fill.apply(this._renderer, arguments);
+ return this;
};
-p5.prototype._createFriendlyGlobalFunctionBinder = function(options) {
- options = options || {};
-
- var globalObject = options.globalObject || window;
- var log = options.log || console.log.bind(console);
- var propsToForciblyOverwrite = {
- // p5.print actually always overwrites an existing global function,
- // albeit one that is very unlikely to be used:
- //
- // https://developer.mozilla.org/en-US/docs/Web/API/Window/print
- 'print': true
- };
-
- return function(prop, value) {
- if (!p5.disableFriendlyErrors &&
- typeof(IS_MINIFIED) === 'undefined' &&
- typeof(value) === 'function' &&
- !(prop in p5.prototype._preloadMethods)) {
- try {
- // Because p5 has so many common function names, it's likely
- // that users may accidentally overwrite global p5 functions with
- // their own variables. Let's allow this but log a warning to
- // help users who may be doing this unintentionally.
- //
- // For more information, see:
- //
- // https://github.com/processing/p5.js/issues/1317
-
- if (prop in globalObject && !(prop in propsToForciblyOverwrite)) {
- throw new Error('global "' + prop + '" already exists');
- }
-
- // It's possible that this might throw an error because there
- // are a lot of edge-cases in which `Object.defineProperty` might
- // not succeed; since this functionality is only intended to
- // help beginners anyways, we'll just catch such an exception
- // if it occurs, and fall back to legacy behavior.
- Object.defineProperty(globalObject, prop, {
- configurable: true,
- enumerable: true,
- get: function() {
- return value;
- },
- set: function(newValue) {
- Object.defineProperty(globalObject, prop, {
- configurable: true,
- enumerable: true,
- value: newValue,
- writable: true
- });
- log(
- 'You just changed the value of "' + prop + '", which was ' +
- 'a p5 function. This could cause problems later if you\'re ' +
- 'not careful.'
- );
- }
- });
- } catch (e) {
- log(
- 'p5 had problems creating the global function "' + prop + '", ' +
- 'possibly because your code is already using that name as ' +
- 'a variable. You may want to rename your variable to something ' +
- 'else.'
- );
- globalObject[prop] = value;
- }
- } else {
- globalObject[prop] = value;
- }
- };
+/**
+ * Disables filling geometry. If both noStroke() and noFill() are called,
+ * nothing will be drawn to the screen.
+ *
+ * @method noFill
+ * @chainable
+ * @example
+ *
+ *
+ * rect(15, 10, 55, 55);
+ * noFill();
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(0);
+ * noFill();
+ * stroke(100, 100, 240);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * box(45, 45, 45);
+ * }
+ *
+ *
+ *
+ * @alt
+ * white rect top middle and noFill rect center. Both 60x60 with black outlines.
+ * black canvas with purple cube wireframe spinning
+ */
+p5.prototype.noFill = function() {
+ this._renderer._setProperty('_doFill', false);
+ return this;
};
-
-module.exports = p5;
-
-},{"./constants":54,"./shim":65}],56:[function(_dereq_,module,exports){
/**
- * @module Shape
- * @submodule Curves
- * @for p5
- * @requires core
+ * Disables drawing the stroke (outline). If both noStroke() and noFill()
+ * are called, nothing will be drawn to the screen.
+ *
+ * @method noStroke
+ * @chainable
+ * @example
+ *
+ *
+ * noStroke();
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(0);
+ * noStroke();
+ * fill(240, 150, 150);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * box(45, 45, 45);
+ * }
+ *
+ *
+ *
+ * @alt
+ * 60x60 white rect at center. no outline.
+ * black canvas with pink cube spinning
*/
-
-'use strict';
-
-var p5 = _dereq_('./core');
-_dereq_('./error_helpers');
-
-var bezierDetail = 20;
-var curveDetail = 20;
+p5.prototype.noStroke = function() {
+ this._renderer._setProperty('_doStroke', false);
+ return this;
+};
/**
- * Draws a cubic Bezier curve on the screen. These curves are defined by a
- * series of anchor and control points. The first two parameters specify
- * the first anchor point and the last two parameters specify the other
- * anchor point, which become the first and last points on the curve. The
- * middle parameters specify the two control points which define the shape
- * of the curve. Approximately speaking, control points "pull" the curve
- * towards them.
Bezier curves were developed by French
- * automotive engineer Pierre Bezier, and are commonly used in computer
- * graphics to define gently sloping curves. See also curve().
+ * Sets the color used to draw lines and borders around shapes. This color
+ * is either specified in terms of the RGB or HSB color depending on the
+ * current colorMode() (the default color space is RGB, with each value in
+ * the range from 0 to 255). The alpha range by default is also 0 to 255.
+ *
+ * If a single string argument is provided, RGB, RGBA and Hex CSS color
+ * strings and all named color strings are supported. In this case, an alpha
+ * number value as a second argument is not supported, the RGBA form should be
+ * used.
+ *
+ * A p5 Color object can also be provided to set the stroke color.
+ *
+ *
+ * @method stroke
+ * @param {Number} v1 red or hue value relative to
+ * the current color range
+ * @param {Number} v2 green or saturation value
+ * relative to the current color range
+ * @param {Number} v3 blue or brightness value
+ * relative to the current color range
+ * @param {Number} [alpha]
+ * @chainable
*
- * @method bezier
- * @param {Number} x1 x-coordinate for the first anchor point
- * @param {Number} y1 y-coordinate for the first anchor point
- * @param {Number} x2 x-coordinate for the first control point
- * @param {Number} y2 y-coordinate for the first control point
- * @param {Number} x3 x-coordinate for the second control point
- * @param {Number} y3 y-coordinate for the second control point
- * @param {Number} x4 x-coordinate for the second anchor point
- * @param {Number} y4 y-coordinate for the second anchor point
- * @return {p5} the p5 object
* @example
*
*
- * noFill();
- * stroke(255, 102, 0);
- * line(85, 20, 10, 10);
- * line(90, 90, 15, 80);
- * stroke(0, 0, 0);
- * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+ * // Grayscale integer value
+ * strokeWeight(4);
+ * stroke(51);
+ * rect(20, 20, 60, 60);
*
*
- * @alt
- * stretched black s-shape in center with orange lines extending from end points.
- * stretched black s-shape with 10 5x5 white ellipses along the shape.
- * stretched black s-shape with 7 5x5 ellipses and orange lines along the shape.
- * stretched black s-shape with 17 small orange lines extending from under shape.
- * horseshoe shape with orange ends facing left and black curved center.
- * horseshoe shape with orange ends facing left and black curved center.
- * Line shaped like right-facing arrow,points move with mouse-x and warp shape.
- * horizontal line that hooks downward on the right and 13 5x5 ellipses along it.
- * right curving line mid-right of canvas with 7 short lines radiating from it.
- */
-/**
- * @method bezier
- * @param {Number} z1 z-coordinate for the first anchor point
- * @param {Number} z2 z-coordinate for the first control point
- * @param {Number} z3 z-coordinate for the first anchor point
- * @param {Number} z4 z-coordinate for the first control point
- * @chainable
- * @example
+ *
*
*
- *background(0, 0, 0);
- *noFill();
- *stroke(255);
- *bezier(250,250,0, 100,100,0, 100,0,0, 0,100,0);
+ * // R, G & B integer values
+ * stroke(255, 204, 0);
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
*
*
-*/
-p5.prototype.bezier = function() {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
-
- p5._validateParameters('bezier', args);
- if (!this._renderer._doStroke && !this._renderer._doFill) {
- return this;
- }
- if (this._renderer.isP3D){
- args.push(bezierDetail);//adding value of bezier detail to the args array
- this._renderer.bezier(args);
- } else{
- this._renderer.bezier(args[0],args[1],
- args[2],args[3],
- args[4],args[5],
- args[6],args[7]);
- }
-
- return this;
-};
-
-/**
- * Sets the resolution at which Beziers display.
*
- * The default value is 20.
+ *
+ *
+ * // H, S & B integer values
+ * colorMode(HSB);
+ * strokeWeight(4);
+ * stroke(255, 204, 100);
+ * rect(20, 20, 60, 60);
+ *
+ *
*
- * @param {Number} detail resolution of the curves
- * @chainable
- * @example
*
*
- * background(204);
- * bezierDetail(50);
- * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+ * // Named SVG/CSS color string
+ * stroke('red');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
*
*
*
- * @alt
- * stretched black s-shape with 7 5x5 ellipses and orange lines along the shape.
+ *
+ *
+ * // three-digit hexadecimal RGB notation
+ * stroke('#fae');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // six-digit hexadecimal RGB notation
+ * stroke('#222222');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // integer RGB notation
+ * stroke('rgb(0,255,0)');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // integer RGBA notation
+ * stroke('rgba(0,255,0,0.25)');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // percentage RGB notation
+ * stroke('rgb(100%,0%,10%)');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // percentage RGBA notation
+ * stroke('rgba(100%,0%,100%,0.5)');
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
+ *
+ *
+ *
+ * // p5 Color object
+ * stroke(color(0, 0, 255));
+ * strokeWeight(4);
+ * rect(20, 20, 60, 60);
+ *
+ *
*
+ * @alt
+ * 60x60 white rect at center. Dark charcoal grey outline.
+ * 60x60 white rect at center. Yellow outline.
+ * 60x60 white rect at center. Royal blue outline.
+ * 60x60 white rect at center. Red outline.
+ * 60x60 white rect at center. Pink outline.
+ * 60x60 white rect at center. Black outline.
+ * 60x60 white rect at center. Bright green outline.
+ * 60x60 white rect at center. Soft green outline.
+ * 60x60 white rect at center. Red outline.
+ * 60x60 white rect at center. Dark fushcia outline.
+ * 60x60 white rect at center. Blue outline.
*/
-p5.prototype.bezierDetail = function(d) {
- bezierDetail = d;
+
+/**
+ * @method stroke
+ * @param {String} value a color string
+ * @chainable
+ */
+
+/**
+ * @method stroke
+ * @param {Number} gray a gray value
+ * @param {Number} [alpha]
+ * @chainable
+ */
+
+/**
+ * @method stroke
+ * @param {Number[]} values an array containing the red,green,blue &
+ * and alpha components of the color
+ * @chainable
+ */
+
+/**
+ * @method stroke
+ * @param {p5.Color} color the stroke color
+ * @chainable
+ */
+
+p5.prototype.stroke = function() {
+ this._renderer._setProperty('_strokeSet', true);
+ this._renderer._setProperty('_doStroke', true);
+ this._renderer.stroke.apply(this._renderer, arguments);
return this;
};
-/**
- * Evaluates the Bezier at position t for points a, b, c, d.
- * The parameters a and d are the first and last points
- * on the curve, and b and c are the control points.
- * The final parameter t varies between 0 and 1.
- * This can be done once with the x coordinates and a second time
- * with the y coordinates to get the location of a bezier curve at t.
- *
- * @method bezierPoint
- * @param {Number} a coordinate of first point on the curve
- * @param {Number} b coordinate of first control point
- * @param {Number} c coordinate of second control point
- * @param {Number} d coordinate of second point on the curve
- * @param {Number} t value between 0 and 1
- * @return {Number} the value of the Bezier at position t
- * @example
- *
- *
- * noFill();
- * x1 = 85, x2 = 10, x3 = 90, x4 = 15;
- * y1 = 20, y2 = 10, y3 = 90, y4 = 80;
- * bezier(x1, y1, x2, y2, x3, y3, x4, y4);
- * fill(255);
- * steps = 10;
- * for (i = 0; i <= steps; i++) {
- * t = i / steps;
- * x = bezierPoint(x1, x2, x3, x4, t);
- * y = bezierPoint(y1, y2, y3, y4, t);
- * ellipse(x, y, 5, 5);
- * }
- *
- *
- *
- * @alt
- * stretched black s-shape with 17 small orange lines extending from under shape.
- *
- */
-p5.prototype.bezierPoint = function(a, b, c, d, t) {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
+module.exports = p5;
+
+},{"../core/constants":19,"../core/main":25,"./p5.Color":17}],19:[function(_dereq_,module,exports){
+/**
+ * @module Constants
+ * @submodule Constants
+ * @for p5
+ */
+
+'use strict';
+
+var PI = Math.PI;
+
+module.exports = {
+ // GRAPHICS RENDERER
+ /**
+ * @property {String} P2D
+ * @final
+ */
+ P2D: 'p2d',
+ /**
+ * @property {String} WEBGL
+ * @final
+ */
+ WEBGL: 'webgl',
+
+ // ENVIRONMENT
+ /**
+ * @property {String} ARROW
+ * @final
+ */
+ ARROW: 'default',
+ /**
+ * @property {String} CROSS
+ * @final
+ */
+ CROSS: 'crosshair',
+ /**
+ * @property {String} HAND
+ * @final
+ */
+ HAND: 'pointer',
+ /**
+ * @property {String} MOVE
+ * @final
+ */
+ MOVE: 'move',
+ /**
+ * @property {String} TEXT
+ * @final
+ */
+ TEXT: 'text',
+ /**
+ * @property {String} WAIT
+ * @final
+ */
+ WAIT: 'wait',
+
+ // TRIGONOMETRY
+
+ /**
+ * HALF_PI is a mathematical constant with the value
+ * 1.57079632679489661923. It is half the ratio of the
+ * circumference of a circle to its diameter. It is useful in
+ * combination with the trigonometric functions sin() and cos().
+ *
+ * @property {Number} HALF_PI
+ * @final
+ *
+ * @example
+ *
+ * arc(50, 50, 80, 80, 0, HALF_PI);
+ *
+ *
+ * @alt
+ * 80x80 white quarter-circle with curve toward bottom right of canvas.
+ *
+ */
+ HALF_PI: PI / 2,
+ /**
+ * PI is a mathematical constant with the value
+ * 3.14159265358979323846. It is the ratio of the circumference
+ * of a circle to its diameter. It is useful in combination with
+ * the trigonometric functions sin() and cos().
+ *
+ * @property {Number} PI
+ * @final
+ *
+ * @example
+ *
+ * arc(50, 50, 80, 80, 0, PI);
+ *
+ *
+ * @alt
+ * white half-circle with curve toward bottom of canvas.
+ *
+ */
+ PI: PI,
+ /**
+ * QUARTER_PI is a mathematical constant with the value 0.7853982.
+ * It is one quarter the ratio of the circumference of a circle to
+ * its diameter. It is useful in combination with the trigonometric
+ * functions sin() and cos().
+ *
+ * @property {Number} QUARTER_PI
+ * @final
+ *
+ * @example
+ *
+ * arc(50, 50, 80, 80, 0, QUARTER_PI);
+ *
+ *
+ * @alt
+ * white eighth-circle rotated about 40 degrees with curve bottom right canvas.
+ *
+ */
+ QUARTER_PI: PI / 4,
+ /**
+ * TAU is an alias for TWO_PI, a mathematical constant with the
+ * value 6.28318530717958647693. It is twice the ratio of the
+ * circumference of a circle to its diameter. It is useful in
+ * combination with the trigonometric functions sin() and cos().
+ *
+ * @property {Number} TAU
+ * @final
+ *
+ * @example
+ *
+ * arc(50, 50, 80, 80, 0, TAU);
+ *
+ *
+ * @alt
+ * 80x80 white ellipse shape in center of canvas.
+ *
+ */
+ TAU: PI * 2,
+ /**
+ * TWO_PI is a mathematical constant with the value
+ * 6.28318530717958647693. It is twice the ratio of the
+ * circumference of a circle to its diameter. It is useful in
+ * combination with the trigonometric functions sin() and cos().
+ *
+ * @property {Number} TWO_PI
+ * @final
+ *
+ * @example
+ *
+ * arc(50, 50, 80, 80, 0, TWO_PI);
+ *
+ *
+ * @alt
+ * 80x80 white ellipse shape in center of canvas.
+ *
+ */
+ TWO_PI: PI * 2,
+ /**
+ * Constant to be used with angleMode() function, to set the mode which
+ * p5.js interprates and calculates angles (either DEGREES or RADIANS).
+ * @property {String} DEGREES
+ * @final
+ *
+ * @example
+ *
+ * function setup() {
+ * angleMode(DEGREES);
+ * }
+ *
+ */
+ DEGREES: 'degrees',
+ /**
+ * Constant to be used with angleMode() function, to set the mode which
+ * p5.js interprates and calculates angles (either RADIANS or DEGREES).
+ * @property {String} RADIANS
+ * @final
+ *
+ * @example
+ *
+ * function setup() {
+ * angleMode(RADIANS);
+ * }
+ *
+ */
+ RADIANS: 'radians',
+ DEG_TO_RAD: PI / 180.0,
+ RAD_TO_DEG: 180.0 / PI,
+
+ // SHAPE
+ /**
+ * @property {String} CORNER
+ * @final
+ */
+ CORNER: 'corner',
+ /**
+ * @property {String} CORNERS
+ * @final
+ */
+ CORNERS: 'corners',
+ /**
+ * @property {String} RADIUS
+ * @final
+ */
+ RADIUS: 'radius',
+ /**
+ * @property {String} RIGHT
+ * @final
+ */
+ RIGHT: 'right',
+ /**
+ * @property {String} LEFT
+ * @final
+ */
+ LEFT: 'left',
+ /**
+ * @property {String} CENTER
+ * @final
+ */
+ CENTER: 'center',
+ /**
+ * @property {String} TOP
+ * @final
+ */
+ TOP: 'top',
+ /**
+ * @property {String} BOTTOM
+ * @final
+ */
+ BOTTOM: 'bottom',
+ /**
+ * @property {String} BASELINE
+ * @final
+ * @default alphabetic
+ */
+ BASELINE: 'alphabetic',
+ /**
+ * @property {Number} POINTS
+ * @final
+ * @default 0x0000
+ */
+ POINTS: 0x0000,
+ /**
+ * @property {Number} LINES
+ * @final
+ * @default 0x0001
+ */
+ LINES: 0x0001,
+ /**
+ * @property {Number} LINE_STRIP
+ * @final
+ * @default 0x0003
+ */
+ LINE_STRIP: 0x0003,
+ /**
+ * @property {Number} LINE_LOOP
+ * @final
+ * @default 0x0002
+ */
+ LINE_LOOP: 0x0002,
+ /**
+ * @property {Number} TRIANGLES
+ * @final
+ * @default 0x0004
+ */
+ TRIANGLES: 0x0004,
+ /**
+ * @property {Number} TRIANGLE_FAN
+ * @final
+ * @default 0x0006
+ */
+ TRIANGLE_FAN: 0x0006,
+ /**
+ * @property {Number} TRIANGLE_STRIP
+ * @final
+ * @default 0x0005
+ */
+ TRIANGLE_STRIP: 0x0005,
+ /**
+ * @property {String} QUADS
+ * @final
+ */
+ QUADS: 'quads',
+ /**
+ * @property {String} QUAD_STRIP
+ * @final
+ * @default quad_strip
+ */
+ QUAD_STRIP: 'quad_strip',
+ /**
+ * @property {String} CLOSE
+ * @final
+ */
+ CLOSE: 'close',
+ /**
+ * @property {String} OPEN
+ * @final
+ */
+ OPEN: 'open',
+ /**
+ * @property {String} CHORD
+ * @final
+ */
+ CHORD: 'chord',
+ /**
+ * @property {String} PIE
+ * @final
+ */
+ PIE: 'pie',
+ /**
+ * @property {String} PROJECT
+ * @final
+ * @default square
+ */
+ PROJECT: 'square', // PEND: careful this is counterintuitive
+ /**
+ * @property {String} SQUARE
+ * @final
+ * @default butt
+ */
+ SQUARE: 'butt',
+ /**
+ * @property {String} ROUND
+ * @final
+ */
+ ROUND: 'round',
+ /**
+ * @property {String} BEVEL
+ * @final
+ */
+ BEVEL: 'bevel',
+ /**
+ * @property {String} MITER
+ * @final
+ */
+ MITER: 'miter',
+
+ // COLOR
+ /**
+ * @property {String} RGB
+ * @final
+ */
+ RGB: 'rgb',
+ /**
+ * @property {String} HSB
+ * @final
+ */
+ HSB: 'hsb',
+ /**
+ * @property {String} HSL
+ * @final
+ */
+ HSL: 'hsl',
+
+ // DOM EXTENSION
+ /**
+ * @property {String} AUTO
+ * @final
+ */
+ AUTO: 'auto',
- p5._validateParameters('bezierPoint', args);
- var adjustedT = 1-args[4];
- return Math.pow(adjustedT,3)*args[0] +
- 3*(Math.pow(adjustedT,2))*args[4]*args[1] +
- 3*adjustedT*Math.pow(args[4],2)*args[2] +
- Math.pow(args[4],3)*args[3];
-};
+ // INPUT
+ ALT: 18,
+ BACKSPACE: 8,
+ CONTROL: 17,
+ DELETE: 46,
+ DOWN_ARROW: 40,
+ ENTER: 13,
+ ESCAPE: 27,
+ LEFT_ARROW: 37,
+ OPTION: 18,
+ RETURN: 13,
+ RIGHT_ARROW: 39,
+ SHIFT: 16,
+ TAB: 9,
+ UP_ARROW: 38,
-/**
- * Evaluates the tangent to the Bezier at position t for points a, b, c, d.
- * The parameters a and d are the first and last points
- * on the curve, and b and c are the control points.
- * The final parameter t varies between 0 and 1.
- *
- * @method bezierTangent
- * @param {Number} a coordinate of first point on the curve
- * @param {Number} b coordinate of first control point
- * @param {Number} c coordinate of second control point
- * @param {Number} d coordinate of second point on the curve
- * @param {Number} t value between 0 and 1
- * @return {Number} the tangent at position t
- * @example
- *
- *
- * noFill();
- * bezier(85, 20, 10, 10, 90, 90, 15, 80);
- * steps = 6;
- * fill(255);
- * for (i = 0; i <= steps; i++) {
- * t = i / steps;
- * // Get the location of the point
- * x = bezierPoint(85, 10, 90, 15, t);
- * y = bezierPoint(20, 10, 90, 80, t);
- * // Get the tangent points
- * tx = bezierTangent(85, 10, 90, 15, t);
- * ty = bezierTangent(20, 10, 90, 80, t);
- * // Calculate an angle from the tangent points
- * a = atan2(ty, tx);
- * a += PI;
- * stroke(255, 102, 0);
- * line(x, y, cos(a)*30 + x, sin(a)*30 + y);
- * // The following line of code makes a line
- * // inverse of the above line
- * //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y);
- * stroke(0);
- * ellipse(x, y, 5, 5);
- * }
- *
- *
- *
- *
- *
- * noFill();
- * bezier(85, 20, 10, 10, 90, 90, 15, 80);
- * stroke(255, 102, 0);
- * steps = 16;
- * for (i = 0; i <= steps; i++) {
- * t = i / steps;
- * x = bezierPoint(85, 10, 90, 15, t);
- * y = bezierPoint(20, 10, 90, 80, t);
- * tx = bezierTangent(85, 10, 90, 15, t);
- * ty = bezierTangent(20, 10, 90, 80, t);
- * a = atan2(ty, tx);
- * a -= HALF_PI;
- * line(x, y, cos(a)*8 + x, sin(a)*8 + y);
- * }
- *
- *
- *
- * @alt
- * s-shaped line with 17 short orange lines extending from underside of shape
- *
- */
-p5.prototype.bezierTangent = function(a, b, c, d, t) {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
+ // RENDERING
+ /**
+ * @property {String} BLEND
+ * @final
+ * @default source-over
+ */
+ BLEND: 'source-over',
+ /**
+ * @property {String} ADD
+ * @final
+ * @default lighter
+ */
+ ADD: 'lighter',
+ //ADD: 'add', //
+ //SUBTRACT: 'subtract', //
+ /**
+ * @property {String} DARKEST
+ * @final
+ */
+ DARKEST: 'darken',
+ /**
+ * @property {String} LIGHTEST
+ * @final
+ * @default lighten
+ */
+ LIGHTEST: 'lighten',
+ /**
+ * @property {String} DIFFERENCE
+ * @final
+ */
+ DIFFERENCE: 'difference',
+ /**
+ * @property {String} EXCLUSION
+ * @final
+ */
+ EXCLUSION: 'exclusion',
+ /**
+ * @property {String} MULTIPLY
+ * @final
+ */
+ MULTIPLY: 'multiply',
+ /**
+ * @property {String} SCREEN
+ * @final
+ */
+ SCREEN: 'screen',
+ /**
+ * @property {String} REPLACE
+ * @final
+ * @default copy
+ */
+ REPLACE: 'copy',
+ /**
+ * @property {String} OVERLAY
+ * @final
+ */
+ OVERLAY: 'overlay',
+ /**
+ * @property {String} HARD_LIGHT
+ * @final
+ */
+ HARD_LIGHT: 'hard-light',
+ /**
+ * @property {String} SOFT_LIGHT
+ * @final
+ */
+ SOFT_LIGHT: 'soft-light',
+ /**
+ * @property {String} DODGE
+ * @final
+ * @default color-dodge
+ */
+ DODGE: 'color-dodge',
+ /**
+ * @property {String} BURN
+ * @final
+ * @default color-burn
+ */
+ BURN: 'color-burn',
- p5._validateParameters('bezierTangent', args);
- var adjustedT = 1-args[4];
- return 3*args[3]*Math.pow(args[4],2) -
- 3*args[2]*Math.pow(args[4],2) +
- 6*args[2]*adjustedT*args[4] -
- 6*args[1]*adjustedT*args[4] +
- 3*args[1]*Math.pow(adjustedT,2) -
- 3*args[0]*Math.pow(adjustedT,2);
-};
+ // FILTERS
+ /**
+ * @property {String} THRESHOLD
+ * @final
+ */
+ THRESHOLD: 'threshold',
+ /**
+ * @property {String} GRAY
+ * @final
+ */
+ GRAY: 'gray',
+ /**
+ * @property {String} OPAQUE
+ * @final
+ */
+ OPAQUE: 'opaque',
+ /**
+ * @property {String} INVERT
+ * @final
+ */
+ INVERT: 'invert',
+ /**
+ * @property {String} POSTERIZE
+ * @final
+ */
+ POSTERIZE: 'posterize',
+ /**
+ * @property {String} DILATE
+ * @final
+ */
+ DILATE: 'dilate',
+ /**
+ * @property {String} ERODE
+ * @final
+ */
+ ERODE: 'erode',
+ /**
+ * @property {String} BLUR
+ * @final
+ */
+ BLUR: 'blur',
-/**
- * Draws a curved line on the screen between two points, given as the
- * middle four parameters. The first two parameters are a control point, as
- * if the curve came from this point even though it's not drawn. The last
- * two parameters similarly describe the other control point.
- * Longer curves can be created by putting a series of curve() functions
- * together or using curveVertex(). An additional function called
- * curveTightness() provides control for the visual quality of the curve.
- * The curve() function is an implementation of Catmull-Rom splines.
- *
- * @method curve
- * @param {Number} x1 x-coordinate for the beginning control point
- * @param {Number} y1 y-coordinate for the beginning control point
- * @param {Number} x2 x-coordinate for the first point
- * @param {Number} y2 y-coordinate for the first point
- * @param {Number} x3 x-coordinate for the second point
- * @param {Number} y3 y-coordinate for the second point
- * @param {Number} x4 x-coordinate for the ending control point
- * @param {Number} y4 y-coordinate for the ending control point
- * @return {p5} the p5 object
- * @example
- *
- *
- * noFill();
- * stroke(255, 102, 0);
- * curve(5, 26, 5, 26, 73, 24, 73, 61);
- * stroke(0);
- * curve(5, 26, 73, 24, 73, 61, 15, 65);
- * stroke(255, 102, 0);
- * curve(73, 24, 73, 61, 15, 65, 15, 65);
- *
- *
- *
- *
- * // Define the curve points as JavaScript objects
- * p1 = {x: 5, y: 26}, p2 = {x: 73, y: 24}
- * p3 = {x: 73, y: 61}, p4 = {x: 15, y: 65}
- * noFill();
- * stroke(255, 102, 0);
- * curve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y)
- * stroke(0);
- * curve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y)
- * stroke(255, 102, 0);
- * curve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y)
- *
- *
- *
- * @alt
- * horseshoe shape with orange ends facing left and black curved center.
- * horseshoe shape with orange ends facing left and black curved center.
- *
- */
-/**
- * @method curve
- * @param {Number} z1 z-coordinate for the beginning control point
- * @param {Number} z2 z-coordinate for the first point
- * @param {Number} z3 z-coordinate for the second point
- * @param {Number} z4 z-coordinate for the ending control point
- * @chainable
- * @example
- *
- *
- * noFill();
- * stroke(255, 102, 0);
- * curve(5,26,0, 5,26,0, 73,24,0, 73,61,0);
- * stroke(0);
- * curve(5,26,0, 73,24,0, 73,61,0, 15,65,0);
- * stroke(255, 102, 0);
- * curve(73,24,0, 73,61,0, 15,65,0, 15,65,0);
- *
- *
- *
- * @alt
- * curving black and orange lines.
- */
-p5.prototype.curve = function() {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
+ // TYPOGRAPHY
+ /**
+ * @property {String} NORMAL
+ * @final
+ */
+ NORMAL: 'normal',
+ /**
+ * @property {String} ITALIC
+ * @final
+ */
+ ITALIC: 'italic',
+ /**
+ * @property {String} BOLD
+ * @final
+ */
+ BOLD: 'bold',
- p5._validateParameters('curve', args);
- if (!this._renderer._doStroke) {
- return this;
- }
- if (this._renderer.isP3D){
- args.push(curveDetail);
- this._renderer.curve(args);
- } else{
- this._renderer.curve(args[0],args[1],
- args[2],args[3],
- args[4],args[5],
- args[6],args[7]);
- }
- return this;
-};
+ // TYPOGRAPHY-INTERNAL
+ _DEFAULT_TEXT_FILL: '#000000',
+ _DEFAULT_LEADMULT: 1.25,
+ _CTX_MIDDLE: 'middle',
-/**
- * Sets the resolution at which curves display.
- *
- * The default value is 20.
- *
- * @param {Number} resolution of the curves
- * @chainable
- * @example
- *
- *
- * background(204);
- * curveDetail(20);
- * curve(5, 26, 5, 26, 73, 24, 73, 61);
- *
- *
- *
- * @alt
- * white arch shape in top-mid canvas.
- *
- */
-p5.prototype.curveDetail = function(d) {
- curveDetail = d;
- return this;
-};
+ // VERTICES
+ LINEAR: 'linear',
+ QUADRATIC: 'quadratic',
+ BEZIER: 'bezier',
+ CURVE: 'curve',
-/**
- * Modifies the quality of forms created with curve() and curveVertex().
- * The parameter tightness determines how the curve fits to the vertex
- * points. The value 0.0 is the default value for tightness (this value
- * defines the curves to be Catmull-Rom splines) and the value 1.0 connects
- * all the points with straight lines. Values within the range -5.0 and 5.0
- * will deform the curves but will leave them recognizable and as values
- * increase in magnitude, they will continue to deform.
- *
- * @method curveTightness
- * @param {Number} amount of deformation from the original vertices
- * @chainable
- * @example
- *
- *
- * // Move the mouse left and right to see the curve change
- *
- * function setup() {
- * createCanvas(100, 100);
- * noFill();
- * }
- *
- * function draw() {
- * background(204);
- * var t = map(mouseX, 0, width, -5, 5);
- * curveTightness(t);
- * beginShape();
- * curveVertex(10, 26);
- * curveVertex(10, 26);
- * curveVertex(83, 24);
- * curveVertex(83, 61);
- * curveVertex(25, 65);
- * curveVertex(25, 65);
- * endShape();
- * }
- *
- *
- *
- * @alt
- * Line shaped like right-facing arrow,points move with mouse-x and warp shape.
- */
-p5.prototype.curveTightness = function (t) {
- this._renderer._curveTightness = t;
-};
+ // WEBGL DRAWMODES
+ STROKE: 'stroke',
+ FILL: 'fill',
+ TEXTURE: 'texture',
+ IMMEDIATE: 'immediate',
-/**
- * Evaluates the curve at position t for points a, b, c, d.
- * The parameter t varies between 0 and 1, a and d are points
- * on the curve, and b and c are the control points.
- * This can be done once with the x coordinates and a second time
- * with the y coordinates to get the location of a curve at t.
- *
- * @method curvePoint
- * @param {Number} a coordinate of first point on the curve
- * @param {Number} b coordinate of first control point
- * @param {Number} c coordinate of second control point
- * @param {Number} d coordinate of second point on the curve
- * @param {Number} t value between 0 and 1
- * @return {Number} bezier value at position t
- * @example
- *
- *
- * noFill();
- * curve(5, 26, 5, 26, 73, 24, 73, 61);
- * curve(5, 26, 73, 24, 73, 61, 15, 65);
- * fill(255);
- * ellipseMode(CENTER);
- * steps = 6;
- * for (i = 0; i <= steps; i++) {
- * t = i / steps;
- * x = curvePoint(5, 5, 73, 73, t);
- * y = curvePoint(26, 26, 24, 61, t);
- * ellipse(x, y, 5, 5);
- * x = curvePoint(5, 73, 73, 15, t);
- * y = curvePoint(26, 24, 61, 65, t);
- * ellipse(x, y, 5, 5);
- * }
- *
- *
- *
- *line hooking down to right-bottom with 13 5x5 white ellipse points
- */
-p5.prototype.curvePoint = function(a, b, c, d, t) {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
+ //WEBGL TEXTURE WRAP AND FILTERING
+ // LINEAR already exists above
+ NEAREST: 'nearest',
+ REPEAT: 'repeat',
+ CLAMP: 'clamp',
+ MIRROR: 'mirror',
- p5._validateParameters('curvePoint', args);
- var t3 = args[4]*args[4]*args[4],
- t2 = args[4]*args[4],
- f1 = -0.5 * t3 + t2 - 0.5 * args[4],
- f2 = 1.5 * t3 - 2.5 * t2 + 1.0,
- f3 = -1.5 * t3 + 2.0 * t2 + 0.5 * args[4],
- f4 = 0.5 * t3 - 0.5 * t2;
- return args[0]*f1 + args[1]*f2 + args[2]*f3 + args[3]*f4;
-};
+ // DEVICE-ORIENTATION
+ /**
+ * @property {String} LANDSCAPE
+ * @final
+ */
+ LANDSCAPE: 'landscape',
+ /**
+ * @property {String} PORTRAIT
+ * @final
+ */
+ PORTRAIT: 'portrait',
-/**
- * Evaluates the tangent to the curve at position t for points a, b, c, d.
- * The parameter t varies between 0 and 1, a and d are points on the curve,
- * and b and c are the control points.
- *
- * @method curveTangent
- * @param {Number} a coordinate of first point on the curve
- * @param {Number} b coordinate of first control point
- * @param {Number} c coordinate of second control point
- * @param {Number} d coordinate of second point on the curve
- * @param {Number} t value between 0 and 1
- * @return {Number} the tangent at position t
- * @example
- *
- *
- * noFill();
- * curve(5, 26, 73, 24, 73, 61, 15, 65);
- * steps = 6;
- * for (i = 0; i <= steps; i++) {
- * t = i / steps;
- * x = curvePoint(5, 73, 73, 15, t);
- * y = curvePoint(26, 24, 61, 65, t);
- * //ellipse(x, y, 5, 5);
- * tx = curveTangent(5, 73, 73, 15, t);
- * ty = curveTangent(26, 24, 61, 65, t);
- * a = atan2(ty, tx);
- * a -= PI/2.0;
- * line(x, y, cos(a)*8 + x, sin(a)*8 + y);
- * }
- *
- *
- *
- * @alt
- *right curving line mid-right of canvas with 7 short lines radiating from it.
- */
-p5.prototype.curveTangent = function(a, b, c, d, t) {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
+ // DEFAULTS
+ _DEFAULT_STROKE: '#000000',
+ _DEFAULT_FILL: '#FFFFFF',
- p5._validateParameters('curveTangent', args);
- var t2 = args[4]*args[4],
- f1 = (-3*t2)/2 + 2*args[4] - 0.5,
- f2 = (9*t2)/2 - 5*args[4],
- f3 = (-9*t2)/2 + 4*args[4] + 0.5,
- f4 = (3*t2)/2 - args[4];
- return args[0]*f1 + args[1]*f2 + args[2]*f3 + args[3]*f4;
-};
+ /**
+ * @property {String} GRID
+ * @final
+ */
+ GRID: 'grid',
-module.exports = p5;
+ /**
+ * @property {String} AXES
+ * @final
+ */
+ AXES: 'axes'
+};
-},{"./core":55,"./error_helpers":58}],57:[function(_dereq_,module,exports){
+},{}],20:[function(_dereq_,module,exports){
/**
* @module Environment
* @submodule Environment
@@ -45766,7 +46903,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('./core');
+var p5 = _dereq_('./main');
var C = _dereq_('./constants');
var standardCursors = [C.ARROW, C.CROSS, C.HAND, C.MOVE, C.TEXT, C.WAIT];
@@ -45778,7 +46915,7 @@ p5.prototype._targetFrameRate = 60;
var _windowPrint = window.print;
/**
- * The print() function writes to the console area of your browser.
+ * The print() function writes to the console area of your browser.
* This function is often helpful for looking at the data a program is
* producing. This function creates a new line of text for each call to
* the function. Individual elements can be
@@ -45790,43 +46927,40 @@ var _windowPrint = window.print;
* @example
*
* var x = 10;
- * print("The value of x is " + x);
+ * print('The value of x is ' + x);
* // prints "The value of x is 10"
*
* @alt
* default grey canvas
*/
-p5.prototype.print = function(args) {
- if (arguments.length === 0) {
+p5.prototype.print = function() {
+ if (!arguments.length) {
_windowPrint();
- }
- else {
+ } else {
console.log.apply(console, arguments);
}
};
-
/**
- * The system variable frameCount contains the number of frames that have
- * been displayed since the program started. Inside setup() the value is 0,
+ * The system variable frameCount contains the number of frames that have
+ * been displayed since the program started. Inside setup() the value is 0,
* after the first iteration of draw it is 1, etc.
*
- * @property {Number} frameCount
+ * @property {Integer} frameCount
* @readOnly
* @example
*
- * function setup() {
- * frameRate(30);
- * textSize(20);
- * textSize(30);
- * textAlign(CENTER);
- * }
+ * function setup() {
+ * frameRate(30);
+ * textSize(30);
+ * textAlign(CENTER);
+ * }
*
- * function draw() {
- * background(200);
- * text(frameCount, width/2, height/2);
- * }
- *
+ * function draw() {
+ * background(200);
+ * text(frameCount, width / 2, height / 2);
+ * }
+
*
* @alt
* numbers rapidly counting upward with frame count set to 30.
@@ -45851,8 +46985,9 @@ p5.prototype.frameCount = 0;
* fill(0, 200, 0);
* ellipse(25, 25, 50, 50);
*
- * if (!focused) { // or "if (focused === false)"
- * stroke(200,0,0);
+ * if (!focused) {
+ // or "if (focused === false)"
+ * stroke(200, 0, 0);
* line(0, 0, 100, 100);
* line(100, 0, 0, 100);
* }
@@ -45863,15 +46998,13 @@ p5.prototype.frameCount = 0;
* green 50x50 ellipse at top left. Red X covers canvas when page focus changes
*
*/
-p5.prototype.focused = (document.hasFocus());
+p5.prototype.focused = document.hasFocus();
/**
* Sets the cursor to a predefined symbol or an image, or makes it visible
* if already hidden. If you are trying to set an image as the cursor, the
- * recommended size is 16x16 or 32x32 pixels. It is not possible to load an
- * image as the cursor if you are exporting your program for the Web, and not
- * all MODES work with all browsers. The values for parameters x and y must
- * be less than the dimensions of the image.
+ * recommended size is 16x16 or 32x32 pixels. The values for parameters x and y
+ * must be less than the dimensions of the image.
*
* @method cursor
* @param {String|Constant} type either ARROW, CROSS, HAND, MOVE, TEXT, or
@@ -45883,7 +47016,7 @@ p5.prototype.focused = (document.hasFocus());
* // Move the mouse left and right across the image
* // to see the cursor change from a cross to a hand
* function draw() {
- * line(width/2, 0, width/2, height);
+ * line(width / 2, 0, width / 2, height);
* if (mouseX < 50) {
* cursor(CROSS);
* } else {
@@ -45909,8 +47042,10 @@ p5.prototype.cursor = function(type, x, y) {
// https://developer.mozilla.org/en-US/docs/Web/CSS/cursor
coords = x + ' ' + y;
}
- if ((type.substring(0, 7) === 'http://') ||
- (type.substring(0, 8) === 'https://')) {
+ if (
+ type.substring(0, 7) === 'http://' ||
+ type.substring(0, 8) === 'https://'
+ ) {
// Image (absolute url)
cursor = 'url(' + type + ') ' + coords + ', auto';
} else if (/\.(cur|jpg|jpeg|gif|png|CUR|JPG|JPEG|GIF|PNG)$/.test(type)) {
@@ -45928,24 +47063,24 @@ p5.prototype.cursor = function(type, x, y) {
* Specifies the number of frames to be displayed every second. For example,
* the function call frameRate(30) will attempt to refresh 30 times a second.
* If the processor is not fast enough to maintain the specified rate, the
- * frame rate will not be achieved. Setting the frame rate within setup() is
- * recommended. The default rate is 60 frames per second. This is the same as
- * setFrameRate(val).
+ * frame rate will not be achieved. Setting the frame rate within setup() is
+ * recommended. The default frame rate is based on the frame rate of the display
+ * (here also called "refresh rate"), which is set to 60 frames per second on most
+ * computers. A frame rate of 24 frames per second (usual for movies) or above
+ * will be enough for smooth animations
+ * This is the same as setFrameRate(val).
*
- * Calling frameRate() with no arguments returns the current framerate. The
+ * Calling frameRate() with no arguments returns the current framerate. The
* draw function must run at least once before it will return a value. This
- * is the same as getFrameRate().
+ * is the same as getFrameRate().
*
- * Calling frameRate() with arguments that are not of the type numbers
+ * Calling frameRate() with arguments that are not of the type numbers
* or are non positive also returns current framerate.
*
* @method frameRate
* @param {Number} fps number of frames to be displayed every second
* @chainable
- */
-/**
- * @method frameRate
- * @return {Number} current frameRate
+ *
* @example
*
*
@@ -45956,35 +47091,41 @@ p5.prototype.cursor = function(type, x, y) {
* function setup() {
* background(200);
* frameRate(fr); // Attempt to refresh at starting FPS
- * clr = color(255,0,0);
+ * clr = color(255, 0, 0);
* }
*
* function draw() {
* background(200);
* rectX = rectX += 1; // Move Rectangle
*
- * if (rectX >= width) { // If you go off screen.
- * if (fr == 30) {
- * clr = color(0,0,255);
+ * if (rectX >= width) {
+ // If you go off screen.
+ * if (fr === 30) {
+ * clr = color(0, 0, 255);
* fr = 10;
* frameRate(fr); // make frameRate 10 FPS
* } else {
- * clr = color(255,0,0);
+ * clr = color(255, 0, 0);
* fr = 30;
* frameRate(fr); // make frameRate 30 FPS
* }
* rectX = 0;
* }
* fill(clr);
- * rect(rectX, 40, 20,20);
+ * rect(rectX, 40, 20, 20);
* }
- *
+ *
*
* @alt
* blue rect moves left to right, followed by red rect moving faster. Loops.
*
*/
+/**
+ * @method frameRate
+ * @return {Number} current frameRate
+ */
p5.prototype.frameRate = function(fps) {
+ p5._validateParameters('frameRate', arguments);
if (typeof fps !== 'number' || fps < 0) {
return this._frameRate;
} else {
@@ -45996,6 +47137,7 @@ p5.prototype.frameRate = function(fps) {
/**
* Returns the current framerate.
*
+ * @private
* @return {Number} current frameRate
*/
p5.prototype.getFrameRate = function() {
@@ -46006,11 +47148,12 @@ p5.prototype.getFrameRate = function() {
* Specifies the number of frames to be displayed every second. For example,
* the function call frameRate(30) will attempt to refresh 30 times a second.
* If the processor is not fast enough to maintain the specified rate, the
- * frame rate will not be achieved. Setting the frame rate within setup() is
+ * frame rate will not be achieved. Setting the frame rate within setup() is
* recommended. The default rate is 60 frames per second.
*
- * Calling frameRate() with no arguments returns the current framerate.
+ * Calling frameRate() with no arguments returns the current framerate.
*
+ * @private
* @param {Number} [fps] number of frames to be displayed every second
*/
p5.prototype.setFrameRate = function(fps) {
@@ -46042,10 +47185,11 @@ p5.prototype.noCursor = function() {
this._curElement.elt.style.cursor = 'none';
};
-
/**
- * System variable that stores the width of the entire screen display. This
- * is used to run a full-screen program on any display size.
+ * System variable that stores the width of the screen display according to The
+ * default pixelDensity. This is used to run a
+ * full-screen program on any display size. To return actual screen size,
+ * multiply this by pixelDensity.
*
* @property {Number} displayWidth
* @readOnly
@@ -46061,8 +47205,10 @@ p5.prototype.noCursor = function() {
p5.prototype.displayWidth = screen.width;
/**
- * System variable that stores the height of the entire screen display. This
- * is used to run a full-screen program on any display size.
+ * System variable that stores the height of the screen display according to The
+ * default pixelDensity. This is used to run a
+ * full-screen program on any display size. To return actual screen size,
+ * multiply this by pixelDensity.
*
* @property {Number} displayHeight
* @readOnly
@@ -46103,781 +47249,1947 @@ p5.prototype.windowWidth = getWindowWidth();
*
* createCanvas(windowWidth, windowHeight);
*
-*@alt
+ *@alt
* no display.
*
-*/
+ */
p5.prototype.windowHeight = getWindowHeight();
-/**
- * The windowResized() function is called once every time the browser window
- * is resized. This is a good place to resize the canvas or do any other
- * adjustments to accommodate the new window size.
- *
- * @method windowResized
- * @example
- *
- * function setup() {
- * createCanvas(windowWidth, windowHeight);
- * }
- *
- * function draw() {
- * background(0, 100, 200);
- * }
- *
- * function windowResized() {
- * resizeCanvas(windowWidth, windowHeight);
- * }
- *
- * @alt
- * no display.
- */
-p5.prototype._onresize = function(e){
- this._setProperty('windowWidth', getWindowWidth());
- this._setProperty('windowHeight', getWindowHeight());
- var context = this._isGlobal ? window : this;
- var executeDefault;
- if (typeof context.windowResized === 'function') {
- executeDefault = context.windowResized(e);
- if (executeDefault !== undefined && !executeDefault) {
- e.preventDefault();
+/**
+ * The windowResized() function is called once every time the browser window
+ * is resized. This is a good place to resize the canvas or do any other
+ * adjustments to accommodate the new window size.
+ *
+ * @method windowResized
+ * @example
+ *
+ * function setup() {
+ * createCanvas(windowWidth, windowHeight);
+ * }
+ *
+ * function draw() {
+ * background(0, 100, 200);
+ * }
+ *
+ * function windowResized() {
+ * resizeCanvas(windowWidth, windowHeight);
+ * }
+ *
+ * @alt
+ * no display.
+ */
+p5.prototype._onresize = function(e) {
+ this._setProperty('windowWidth', getWindowWidth());
+ this._setProperty('windowHeight', getWindowHeight());
+ var context = this._isGlobal ? window : this;
+ var executeDefault;
+ if (typeof context.windowResized === 'function') {
+ executeDefault = context.windowResized(e);
+ if (executeDefault !== undefined && !executeDefault) {
+ e.preventDefault();
+ }
+ }
+};
+
+function getWindowWidth() {
+ return (
+ window.innerWidth ||
+ (document.documentElement && document.documentElement.clientWidth) ||
+ (document.body && document.body.clientWidth) ||
+ 0
+ );
+}
+
+function getWindowHeight() {
+ return (
+ window.innerHeight ||
+ (document.documentElement && document.documentElement.clientHeight) ||
+ (document.body && document.body.clientHeight) ||
+ 0
+ );
+}
+
+/**
+ * System variable that stores the width of the drawing canvas. This value
+ * is set by the first parameter of the createCanvas() function.
+ * For example, the function call createCanvas(320, 240) sets the width
+ * variable to the value 320. The value of width defaults to 100 if
+ * createCanvas() is not used in a program.
+ *
+ * @property {Number} width
+ * @readOnly
+ */
+p5.prototype.width = 0;
+
+/**
+ * System variable that stores the height of the drawing canvas. This value
+ * is set by the second parameter of the createCanvas() function. For
+ * example, the function call createCanvas(320, 240) sets the height
+ * variable to the value 240. The value of height defaults to 100 if
+ * createCanvas() is not used in a program.
+ *
+ * @property {Number} height
+ * @readOnly
+ */
+p5.prototype.height = 0;
+
+/**
+ * If argument is given, sets the sketch to fullscreen or not based on the
+ * value of the argument. If no argument is given, returns the current
+ * fullscreen state. Note that due to browser restrictions this can only
+ * be called on user input, for example, on mouse press like the example
+ * below.
+ *
+ * @method fullscreen
+ * @param {Boolean} [val] whether the sketch should be in fullscreen mode
+ * or not
+ * @return {Boolean} current fullscreen state
+ * @example
+ *
+ *
+ * // Clicking in the box toggles fullscreen on and off.
+ * function setup() {
+ * background(200);
+ * }
+ * function mousePressed() {
+ * if (mouseX > 0 && mouseX < 100 && mouseY > 0 && mouseY < 100) {
+ * var fs = fullscreen();
+ * fullscreen(!fs);
+ * }
+ * }
+ *
+ *
+ *
+ * @alt
+ * no display.
+ *
+ */
+p5.prototype.fullscreen = function(val) {
+ p5._validateParameters('fullscreen', arguments);
+ // no arguments, return fullscreen or not
+ if (typeof val === 'undefined') {
+ return (
+ document.fullscreenElement ||
+ document.webkitFullscreenElement ||
+ document.mozFullScreenElement ||
+ document.msFullscreenElement
+ );
+ } else {
+ // otherwise set to fullscreen or not
+ if (val) {
+ launchFullscreen(document.documentElement);
+ } else {
+ exitFullscreen();
+ }
+ }
+};
+
+/**
+ * Sets the pixel scaling for high pixel density displays. By default
+ * pixel density is set to match display density, call pixelDensity(1)
+ * to turn this off. Calling pixelDensity() with no arguments returns
+ * the current pixel density of the sketch.
+ *
+ * @method pixelDensity
+ * @param {Number} val whether or how much the sketch should scale
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * pixelDensity(1);
+ * createCanvas(100, 100);
+ * background(200);
+ * ellipse(width / 2, height / 2, 50, 50);
+ * }
+ *
+ *
+ *
+ *
+ * function setup() {
+ * pixelDensity(3.0);
+ * createCanvas(100, 100);
+ * background(200);
+ * ellipse(width / 2, height / 2, 50, 50);
+ * }
+ *
+ *
+ *
+ * @alt
+ * fuzzy 50x50 white ellipse with black outline in center of canvas.
+ * sharp 50x50 white ellipse with black outline in center of canvas.
+ */
+/**
+ * @method pixelDensity
+ * @returns {Number} current pixel density of the sketch
+ */
+p5.prototype.pixelDensity = function(val) {
+ p5._validateParameters('pixelDensity', arguments);
+ var returnValue;
+ if (typeof val === 'number') {
+ if (val !== this._pixelDensity) {
+ this._pixelDensity = val;
+ this._pixelsDirty = true;
+ }
+ returnValue = this;
+ this.resizeCanvas(this.width, this.height, true); // as a side effect, it will clear the canvas
+ } else {
+ returnValue = this._pixelDensity;
+ }
+ return returnValue;
+};
+
+/**
+ * Returns the pixel density of the current display the sketch is running on.
+ *
+ * @method displayDensity
+ * @returns {Number} current pixel density of the display
+ * @example
+ *
+ *
+ * function setup() {
+ * var density = displayDensity();
+ * pixelDensity(density);
+ * createCanvas(100, 100);
+ * background(200);
+ * ellipse(width / 2, height / 2, 50, 50);
+ * }
+ *
+ *
+ *
+ * @alt
+ * 50x50 white ellipse with black outline in center of canvas.
+ */
+p5.prototype.displayDensity = function() {
+ return window.devicePixelRatio;
+};
+
+function launchFullscreen(element) {
+ var enabled =
+ document.fullscreenEnabled ||
+ document.webkitFullscreenEnabled ||
+ document.mozFullScreenEnabled ||
+ document.msFullscreenEnabled;
+ if (!enabled) {
+ throw new Error('Fullscreen not enabled in this browser.');
+ }
+ if (element.requestFullscreen) {
+ element.requestFullscreen();
+ } else if (element.mozRequestFullScreen) {
+ element.mozRequestFullScreen();
+ } else if (element.webkitRequestFullscreen) {
+ element.webkitRequestFullscreen();
+ } else if (element.msRequestFullscreen) {
+ element.msRequestFullscreen();
+ }
+}
+
+function exitFullscreen() {
+ if (document.exitFullscreen) {
+ document.exitFullscreen();
+ } else if (document.mozCancelFullScreen) {
+ document.mozCancelFullScreen();
+ } else if (document.webkitExitFullscreen) {
+ document.webkitExitFullscreen();
+ } else if (document.msExitFullscreen) {
+ document.msExitFullscreen();
+ }
+}
+
+/**
+ * Gets the current URL.
+ * @method getURL
+ * @return {String} url
+ * @example
+ *
+ *
+ * var url;
+ * var x = 100;
+ *
+ * function setup() {
+ * fill(0);
+ * noStroke();
+ * url = getURL();
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * text(url, x, height / 2);
+ * x--;
+ * }
+ *
+ *
+ *
+ * @alt
+ * current url (http://p5js.org/reference/#/p5/getURL) moves right to left.
+ *
+ */
+p5.prototype.getURL = function() {
+ return location.href;
+};
+/**
+ * Gets the current URL path as an array.
+ * @method getURLPath
+ * @return {String[]} path components
+ * @example
+ *
+ * function setup() {
+ * var urlPath = getURLPath();
+ * for (var i = 0; i < urlPath.length; i++) {
+ * text(urlPath[i], 10, i * 20 + 20);
+ * }
+ * }
+ *
+ *
+ * @alt
+ *no display
+ *
+ */
+p5.prototype.getURLPath = function() {
+ return location.pathname.split('/').filter(function(v) {
+ return v !== '';
+ });
+};
+/**
+ * Gets the current URL params as an Object.
+ * @method getURLParams
+ * @return {Object} URL params
+ * @example
+ *
+ *
+ * // Example: http://p5js.org?year=2014&month=May&day=15
+ *
+ * function setup() {
+ * var params = getURLParams();
+ * text(params.day, 10, 20);
+ * text(params.month, 10, 40);
+ * text(params.year, 10, 60);
+ * }
+ *
+ *
+ * @alt
+ * no display.
+ *
+ */
+p5.prototype.getURLParams = function() {
+ var re = /[?&]([^&=]+)(?:[&=])([^&=]+)/gim;
+ var m;
+ var v = {};
+ while ((m = re.exec(location.search)) != null) {
+ if (m.index === re.lastIndex) {
+ re.lastIndex++;
+ }
+ v[m[1]] = m[2];
+ }
+ return v;
+};
+
+module.exports = p5;
+
+},{"./constants":19,"./main":25}],21:[function(_dereq_,module,exports){
+/**
+ * @for p5
+ * @requires core
+ */
+
+'use strict';
+
+var p5 = _dereq_('./main');
+var constants = _dereq_('./constants');
+
+if (typeof IS_MINIFIED !== 'undefined') {
+ p5._validateParameters = p5._friendlyFileLoadError = function() {};
+} else {
+ var doFriendlyWelcome = false; // TEMP until we get it all working LM
+ // for parameter validation
+ var dataDoc = _dereq_('../../docs/reference/data.json');
+ var arrDoc = JSON.parse(JSON.stringify(dataDoc));
+
+ // -- Borrowed from jQuery 1.11.3 --
+ var class2type = {};
+ var toString = class2type.toString;
+ var names = [
+ 'Boolean',
+ 'Number',
+ 'String',
+ 'Function',
+ 'Array',
+ 'Date',
+ 'RegExp',
+ 'Object',
+ 'Error'
+ ];
+ for (var n = 0; n < names.length; n++) {
+ class2type['[object ' + names[n] + ']'] = names[n].toLowerCase();
+ }
+ var getType = function(obj) {
+ if (obj == null) {
+ return obj + '';
+ }
+ return typeof obj === 'object' || typeof obj === 'function'
+ ? class2type[toString.call(obj)] || 'object'
+ : typeof obj;
+ };
+
+ // -- End borrow --
+
+ var friendlyWelcome = function() {
+ // p5.js brand - magenta: #ED225D
+ //var astrixBgColor = 'transparent';
+ //var astrixTxtColor = '#ED225D';
+ //var welcomeBgColor = '#ED225D';
+ //var welcomeTextColor = 'white';
+ console.log(
+ ' _ \n' +
+ ' /\\| |/\\ \n' +
+ " \\ ` ' / \n" +
+ ' / , . \\ \n' +
+ ' \\/|_|\\/ ' +
+ '\n\n> p5.js says: Welcome! ' +
+ 'This is your friendly debugger. ' +
+ 'To turn me off switch to using “p5.min.js”.'
+ );
+ };
+
+ /**
+ * Prints out a fancy, colorful message to the console log
+ *
+ * @private
+ * @param {String} message the words to be said
+ * @param {String} func the name of the function to link
+ * @param {Number|String} color CSS color string or error type
+ *
+ * @return console logs
+ */
+ // Wrong number of params, undefined param, wrong type
+ var FILE_LOAD = 3;
+ var ERR_PARAMS = 3;
+ // p5.js blue, p5.js orange, auto dark green; fallback p5.js darkened magenta
+ // See testColors below for all the color codes and names
+ var typeColors = ['#2D7BB6', '#EE9900', '#4DB200', '#C83C00'];
+ var report = function(message, func, color) {
+ if (doFriendlyWelcome) {
+ friendlyWelcome();
+ doFriendlyWelcome = false;
+ }
+ if ('undefined' === getType(color)) {
+ color = '#B40033'; // dark magenta
+ } else if (getType(color) === 'number') {
+ // Type to color
+ color = typeColors[color];
+ }
+ if (func === 'loadX') {
+ console.log('> p5.js says: ' + message);
+ } else if (func.substring(0, 4) === 'load') {
+ console.log(
+ '> p5.js says: ' +
+ message +
+ '[https://github.com/processing/p5.js/wiki/Local-server]'
+ );
+ } else {
+ console.log(
+ '> p5.js says: ' +
+ message +
+ ' [http://p5js.org/reference/#p5/' +
+ func +
+ ']'
+ );
+ }
+ };
+
+ var errorCases = {
+ '0': {
+ fileType: 'image',
+ method: 'loadImage',
+ message: ' hosting the image online,'
+ },
+ '1': {
+ fileType: 'XML file',
+ method: 'loadXML'
+ },
+ '2': {
+ fileType: 'table file',
+ method: 'loadTable'
+ },
+ '3': {
+ fileType: 'text file',
+ method: 'loadStrings'
+ },
+ '4': {
+ fileType: 'font',
+ method: 'loadFont',
+ message: ' hosting the font online,'
+ },
+ '5': {
+ fileType: 'json',
+ method: 'loadJSON'
+ },
+ '6': {
+ fileType: 'file',
+ method: 'loadBytes'
+ },
+ '7': {
+ method: 'loadX',
+ message:
+ "In case your large file isn't fetched successfully," +
+ 'we recommend splitting the file into smaller segments and fetching those.'
+ }
+ };
+ p5._friendlyFileLoadError = function(errorType, filePath) {
+ var errorInfo = errorCases[errorType];
+ var message;
+ if (errorType === 7) {
+ message = errorInfo.message;
+ } else {
+ message =
+ 'It looks like there was a problem' +
+ ' loading your ' +
+ errorInfo.fileType +
+ '.' +
+ ' Try checking if the file path [' +
+ filePath +
+ '] is correct,' +
+ (errorInfo.message || '') +
+ ' or running a local server.';
+ }
+ report(message, errorInfo.method, FILE_LOAD);
+ };
+
+ var docCache = {};
+ var builtinTypes = [
+ 'null',
+ 'number',
+ 'string',
+ 'boolean',
+ 'constant',
+ 'function',
+ 'any',
+ 'integer'
+ ];
+
+ // validateParameters() helper functions:
+ // lookupParamDoc() for querying data.json
+ var lookupParamDoc = function(func) {
+ // look for the docs in the `data.json` datastructure
+
+ var ichDot = func.lastIndexOf('.');
+ var funcName = func.substr(ichDot + 1);
+ var funcClass = func.substr(0, ichDot) || 'p5';
+
+ var queryResult;
+ var classitems = arrDoc.classitems;
+ for (var ici = 0; ici < classitems.length; ici++) {
+ var x = classitems[ici];
+ if (x.name === funcName && x.class === funcClass) {
+ queryResult = x;
+ break;
+ }
+ }
+
+ // different JSON structure for funct with multi-format
+ var overloads = [];
+ if (queryResult.hasOwnProperty('overloads')) {
+ // add all the overloads
+ for (var i = 0; i < queryResult.overloads.length; i++) {
+ overloads.push({ formats: queryResult.overloads[i].params });
+ }
+ } else {
+ // no overloads, just add the main method definition
+ overloads.push({ formats: queryResult.params || [] });
+ }
+
+ // parse the parameter types for each overload
+ var mapConstants = {};
+ var maxParams = 0;
+ overloads.forEach(function(overload) {
+ var formats = overload.formats;
+
+ // keep a record of the maximum number of arguments
+ // this method requires.
+ if (maxParams < formats.length) {
+ maxParams = formats.length;
+ }
+
+ // calculate the minimum number of arguments
+ // this overload requires.
+ var minParams = formats.length;
+ while (minParams > 0 && formats[minParams - 1].optional) {
+ minParams--;
+ }
+ overload.minParams = minParams;
+
+ // loop through each parameter position, and parse its types
+ formats.forEach(function(format) {
+ // split this parameter's types
+ format.types = format.type.split('|').map(function ct(type) {
+ // array
+ if (type.substr(type.length - 2, 2) === '[]') {
+ return {
+ name: type,
+ array: ct(type.substr(0, type.length - 2))
+ };
+ }
+
+ var lowerType = type.toLowerCase();
+
+ // contant
+ if (lowerType === 'constant') {
+ var constant;
+ if (mapConstants.hasOwnProperty(format.name)) {
+ constant = mapConstants[format.name];
+ } else {
+ // parse possible constant values from description
+ var myRe = /either\s+(?:[A-Z0-9_]+\s*,?\s*(?:or)?\s*)+/g;
+ var values = {};
+ var names = [];
+
+ constant = mapConstants[format.name] = {
+ values: values,
+ names: names
+ };
+
+ var myArray = myRe.exec(format.description);
+ if (func === 'endShape' && format.name === 'mode') {
+ values[constants.CLOSE] = true;
+ names.push('CLOSE');
+ } else {
+ var match = myArray[0];
+ var reConst = /[A-Z0-9_]+/g;
+ var matchConst;
+ while ((matchConst = reConst.exec(match)) !== null) {
+ var name = matchConst[0];
+ if (constants.hasOwnProperty(name)) {
+ values[constants[name]] = true;
+ names.push(name);
+ }
+ }
+ }
+ }
+ return {
+ name: type,
+ builtin: lowerType,
+ names: constant.names,
+ values: constant.values
+ };
+ }
+
+ // function
+ if (lowerType.substr(0, 'function'.length) === 'function') {
+ lowerType = 'function';
+ }
+ // builtin
+ if (builtinTypes.indexOf(lowerType) >= 0) {
+ return { name: type, builtin: lowerType };
+ }
+
+ // find type's prototype
+ var t = window;
+ var typeParts = type.split('.');
+
+ // special-case 'p5' since it may be non-global
+ if (typeParts[0] === 'p5') {
+ t = p5;
+ typeParts.shift();
+ }
+
+ typeParts.forEach(function(p) {
+ t = t && t[p];
+ });
+ if (t) {
+ return { name: type, prototype: t };
+ }
+
+ return { name: type, type: lowerType };
+ });
+ });
+ });
+ return {
+ overloads: overloads,
+ maxParams: maxParams
+ };
+ };
+
+ var isNumber = function(param) {
+ switch (typeof param) {
+ case 'number':
+ return true;
+ case 'string':
+ return !isNaN(param);
+ default:
+ return false;
+ }
+ };
+
+ var testParamType = function(param, type) {
+ var isArray = param instanceof Array;
+ var matches = true;
+ if (type.array && isArray) {
+ for (var i = 0; i < param.length; i++) {
+ var error = testParamType(param[i], type.array);
+ if (error) return error / 2; // half error for elements
+ }
+ } else if (type.prototype) {
+ matches = param instanceof type.prototype;
+ } else if (type.builtin) {
+ switch (type.builtin) {
+ case 'number':
+ matches = isNumber(param);
+ break;
+ case 'integer':
+ matches = isNumber(param) && Number(param) === Math.floor(param);
+ break;
+ case 'boolean':
+ case 'any':
+ matches = true;
+ break;
+ case 'array':
+ matches = isArray;
+ break;
+ case 'string':
+ matches = /*typeof param === 'number' ||*/ typeof param === 'string';
+ break;
+ case 'constant':
+ matches = type.values.hasOwnProperty(param);
+ break;
+ case 'function':
+ matches = param instanceof Function;
+ break;
+ case 'null':
+ matches = param === null;
+ break;
+ }
+ } else {
+ matches = typeof param === type.t;
+ }
+ return matches ? 0 : 1;
+ };
+
+ // testType() for non-object type parameter validation
+ var testParamTypes = function(param, types) {
+ var minScore = 9999;
+ for (var i = 0; minScore > 0 && i < types.length; i++) {
+ var score = testParamType(param, types[i]);
+ if (minScore > score) minScore = score;
+ }
+ return minScore;
+ };
+
+ // generate a score (higher is worse) for applying these args to
+ // this overload.
+ var scoreOverload = function(args, argCount, overload, minScore) {
+ var score = 0;
+ var formats = overload.formats;
+ var minParams = overload.minParams;
+
+ // check for too few/many args
+ // the score is double number of extra/missing args
+ if (argCount < minParams) {
+ score = (minParams - argCount) * 2;
+ } else if (argCount > formats.length) {
+ score = (argCount - formats.length) * 2;
+ }
+
+ // loop through the formats, adding up the error score for each arg.
+ // quit early if the score gets higher than the previous best overload.
+ for (var p = 0; score <= minScore && p < formats.length; p++) {
+ var arg = args[p];
+ var format = formats[p];
+ // '== null' checks for 'null' and typeof 'undefined'
+ if (arg == null) {
+ // handle non-optional and non-trailing undefined args
+ if (!format.optional || p < minParams || p < argCount) {
+ score += 1;
+ }
+ } else {
+ score += testParamTypes(arg, format.types);
+ }
+ }
+ return score;
+ };
+
+ // gets a list of errors for this overload
+ var getOverloadErrors = function(args, argCount, overload) {
+ var formats = overload.formats;
+ var minParams = overload.minParams;
+
+ // check for too few/many args
+ if (argCount < minParams) {
+ return [
+ {
+ type: 'TOO_FEW_ARGUMENTS',
+ argCount: argCount,
+ minParams: minParams
+ }
+ ];
+ } else if (argCount > formats.length) {
+ return [
+ {
+ type: 'TOO_MANY_ARGUMENTS',
+ argCount: argCount,
+ maxParams: formats.length
+ }
+ ];
+ }
+
+ var errorArray = [];
+ for (var p = 0; p < formats.length; p++) {
+ var arg = args[p];
+ var format = formats[p];
+ // '== null' checks for 'null' and typeof 'undefined'
+ if (arg == null) {
+ // handle non-optional and non-trailing undefined args
+ if (!format.optional || p < minParams || p < argCount) {
+ errorArray.push({
+ type: 'EMPTY_VAR',
+ position: p,
+ format: format
+ });
+ }
+ } else if (testParamTypes(arg, format.types) > 0) {
+ errorArray.push({
+ type: 'WRONG_TYPE',
+ position: p,
+ format: format,
+ arg: arg
+ });
+ }
+ }
+
+ return errorArray;
+ };
+
+ // a custom error type, used by the mocha
+ // tests when expecting validation errors
+ p5.ValidationError = (function(name) {
+ var err = function(message, func) {
+ this.message = message;
+ this.func = func;
+ if ('captureStackTrace' in Error) Error.captureStackTrace(this, err);
+ else this.stack = new Error().stack;
+ };
+ err.prototype = Object.create(Error.prototype);
+ err.prototype.name = name;
+ err.prototype.constructor = err;
+ return err;
+ })('ValidationError');
+
+ // function for generating console.log() msg
+ p5._friendlyParamError = function(errorObj, func) {
+ var message;
+
+ function formatType() {
+ var format = errorObj.format;
+ return format.types
+ .map(function(type) {
+ return type.names ? type.names.join('|') : type.name;
+ })
+ .join('|');
+ }
+
+ switch (errorObj.type) {
+ case 'EMPTY_VAR':
+ message =
+ func +
+ '() was expecting ' +
+ formatType() +
+ ' for parameter #' +
+ errorObj.position +
+ ' (zero-based index), received an empty variable instead.' +
+ ' If not intentional, this is often a problem with scope:' +
+ ' [https://p5js.org/examples/data-variable-scope.html]';
+ break;
+ case 'WRONG_TYPE':
+ var arg = errorObj.arg;
+ var argType =
+ arg instanceof Array
+ ? 'array'
+ : arg === null ? 'null' : arg.name || typeof arg;
+ message =
+ func +
+ '() was expecting ' +
+ formatType() +
+ ' for parameter #' +
+ errorObj.position +
+ ' (zero-based index), received ' +
+ argType +
+ ' instead';
+ break;
+ case 'TOO_FEW_ARGUMENTS':
+ message =
+ func +
+ '() was expecting at least ' +
+ errorObj.minParams +
+ ' arguments, but received only ' +
+ errorObj.argCount;
+ break;
+ case 'TOO_MANY_ARGUMENTS':
+ message =
+ func +
+ '() was expecting no more than ' +
+ errorObj.maxParams +
+ ' arguments, but received ' +
+ errorObj.argCount;
+ break;
+ }
+
+ if (message) {
+ if (p5._throwValidationErrors) {
+ throw new p5.ValidationError(message);
+ }
+
+ try {
+ var re = /Function\.validateParameters.*[\r\n].*[\r\n].*\(([^)]*)/;
+ var location = re.exec(new Error().stack)[1];
+ if (location) {
+ message += ' at ' + location;
+ }
+ } catch (err) {}
+
+ report(message + '.', func, ERR_PARAMS);
+ }
+ };
+
+ /**
+ * Validates parameters
+ * param {String} func the name of the function
+ * param {Array} args user input arguments
+ *
+ * example:
+ * var a;
+ * ellipse(10,10,a,5);
+ * console ouput:
+ * "It looks like ellipse received an empty variable in spot #2."
+ *
+ * example:
+ * ellipse(10,"foo",5,5);
+ * console output:
+ * "ellipse was expecting a number for parameter #1,
+ * received "foo" instead."
+ */
+ p5._validateParameters = function validateParameters(func, args) {
+ if (p5.disableFriendlyErrors) {
+ return; // skip FES
+ }
+
+ // lookup the docs in the 'data.json' file
+ var docs = docCache[func] || (docCache[func] = lookupParamDoc(func));
+ var overloads = docs.overloads;
+
+ // ignore any trailing `undefined` arguments
+ var argCount = args.length;
+ // '== null' checks for 'null' and typeof 'undefined'
+ while (argCount > 0 && args[argCount - 1] == null) argCount--;
+
+ // find the overload with the best score
+ var minScore = 99999;
+ var minOverload;
+ for (var i = 0; i < overloads.length; i++) {
+ var score = scoreOverload(args, argCount, overloads[i], minScore);
+ if (score === 0) {
+ return; // done!
+ } else if (minScore > score) {
+ // this score is better that what we have so far...
+ minScore = score;
+ minOverload = i;
+ }
+ }
+
+ // this should _always_ be true here...
+ if (minScore > 0) {
+ // get the errors for the best overload
+ var errorArray = getOverloadErrors(
+ args,
+ argCount,
+ overloads[minOverload]
+ );
+
+ // generate err msg
+ for (var n = 0; n < errorArray.length; n++) {
+ p5._friendlyParamError(errorArray[n], func);
+ }
+ }
+ };
+
+ /**
+ * Prints out all the colors in the color pallete with white text.
+ * For color blindness testing.
+ */
+ /* function testColors() {
+ var str = 'A box of biscuits, a box of mixed biscuits and a biscuit mixer';
+ report(str, 'print', '#ED225D'); // p5.js magenta
+ report(str, 'print', '#2D7BB6'); // p5.js blue
+ report(str, 'print', '#EE9900'); // p5.js orange
+ report(str, 'print', '#A67F59'); // p5.js light brown
+ report(str, 'print', '#704F21'); // p5.js gold
+ report(str, 'print', '#1CC581'); // auto cyan
+ report(str, 'print', '#FF6625'); // auto orange
+ report(str, 'print', '#79EB22'); // auto green
+ report(str, 'print', '#B40033'); // p5.js darkened magenta
+ report(str, 'print', '#084B7F'); // p5.js darkened blue
+ report(str, 'print', '#945F00'); // p5.js darkened orange
+ report(str, 'print', '#6B441D'); // p5.js darkened brown
+ report(str, 'print', '#2E1B00'); // p5.js darkened gold
+ report(str, 'print', '#008851'); // auto dark cyan
+ report(str, 'print', '#C83C00'); // auto dark orange
+ report(str, 'print', '#4DB200'); // auto dark green
+ } */
+
+ p5.prototype._validateParameters = p5.validateParameters;
+}
+
+// This is a lazily-defined list of p5 symbols that may be
+// misused by beginners at top-level code, outside of setup/draw. We'd like
+// to detect these errors and help the user by suggesting they move them
+// into setup/draw.
+//
+// For more details, see https://github.com/processing/p5.js/issues/1121.
+var misusedAtTopLevelCode = null;
+var FAQ_URL =
+ 'https://github.com/processing/p5.js/wiki/p5.js-overview' +
+ '#why-cant-i-assign-variables-using-p5-functions-and-' +
+ 'variables-before-setup';
+
+var defineMisusedAtTopLevelCode = function() {
+ var uniqueNamesFound = {};
+
+ var getSymbols = function(obj) {
+ return Object.getOwnPropertyNames(obj)
+ .filter(function(name) {
+ if (name[0] === '_') {
+ return false;
+ }
+ if (name in uniqueNamesFound) {
+ return false;
+ }
+
+ uniqueNamesFound[name] = true;
+
+ return true;
+ })
+ .map(function(name) {
+ var type;
+
+ if (typeof obj[name] === 'function') {
+ type = 'function';
+ } else if (name === name.toUpperCase()) {
+ type = 'constant';
+ } else {
+ type = 'variable';
+ }
+
+ return { name: name, type: type };
+ });
+ };
+
+ misusedAtTopLevelCode = [].concat(
+ getSymbols(p5.prototype),
+ // At present, p5 only adds its constants to p5.prototype during
+ // construction, which may not have happened at the time a
+ // ReferenceError is thrown, so we'll manually add them to our list.
+ getSymbols(_dereq_('./constants'))
+ );
+
+ // This will ultimately ensure that we report the most specific error
+ // possible to the user, e.g. advising them about HALF_PI instead of PI
+ // when their code misuses the former.
+ misusedAtTopLevelCode.sort(function(a, b) {
+ return b.name.length - a.name.length;
+ });
+};
+
+var helpForMisusedAtTopLevelCode = function(e, log) {
+ if (!log) {
+ log = console.log.bind(console);
+ }
+
+ if (!misusedAtTopLevelCode) {
+ defineMisusedAtTopLevelCode();
+ }
+
+ // If we find that we're logging lots of false positives, we can
+ // uncomment the following code to avoid displaying anything if the
+ // user's code isn't likely to be using p5's global mode. (Note that
+ // setup/draw are more likely to be defined due to JS function hoisting.)
+ //
+ //if (!('setup' in window || 'draw' in window)) {
+ // return;
+ //}
+
+ misusedAtTopLevelCode.some(function(symbol) {
+ // Note that while just checking for the occurrence of the
+ // symbol name in the error message could result in false positives,
+ // a more rigorous test is difficult because different browsers
+ // log different messages, and the format of those messages may
+ // change over time.
+ //
+ // For example, if the user uses 'PI' in their code, it may result
+ // in any one of the following messages:
+ //
+ // * 'PI' is undefined (Microsoft Edge)
+ // * ReferenceError: PI is undefined (Firefox)
+ // * Uncaught ReferenceError: PI is not defined (Chrome)
+
+ if (e.message && e.message.match('\\W?' + symbol.name + '\\W') !== null) {
+ log(
+ "Did you just try to use p5.js's " +
+ symbol.name +
+ (symbol.type === 'function' ? '() ' : ' ') +
+ symbol.type +
+ '? If so, you may want to ' +
+ "move it into your sketch's setup() function.\n\n" +
+ 'For more details, see: ' +
+ FAQ_URL
+ );
+ return true;
}
- }
+ });
};
-function getWindowWidth() {
- return window.innerWidth ||
- document.documentElement && document.documentElement.clientWidth ||
- document.body && document.body.clientWidth ||
- 0;
-}
+// Exposing this primarily for unit testing.
+p5.prototype._helpForMisusedAtTopLevelCode = helpForMisusedAtTopLevelCode;
-function getWindowHeight() {
- return window.innerHeight ||
- document.documentElement && document.documentElement.clientHeight ||
- document.body && document.body.clientHeight ||
- 0;
+if (document.readyState !== 'complete') {
+ window.addEventListener('error', helpForMisusedAtTopLevelCode, false);
+
+ // Our job is only to catch ReferenceErrors that are thrown when
+ // global (non-instance mode) p5 APIs are used at the top-level
+ // scope of a file, so we'll unbind our error listener now to make
+ // sure we don't log false positives later.
+ window.addEventListener('load', function() {
+ window.removeEventListener('error', helpForMisusedAtTopLevelCode, false);
+ });
}
-/**
- * System variable that stores the width of the drawing canvas. This value
- * is set by the first parameter of the createCanvas() function.
- * For example, the function call createCanvas(320, 240) sets the width
- * variable to the value 320. The value of width defaults to 100 if
- * createCanvas() is not used in a program.
- *
- * @property {Number} width
- * @readOnly
- */
-p5.prototype.width = 0;
+module.exports = p5;
+},{"../../docs/reference/data.json":1,"./constants":19,"./main":25}],22:[function(_dereq_,module,exports){
/**
- * System variable that stores the height of the drawing canvas. This value
- * is set by the second parameter of the createCanvas() function. For
- * example, the function call createCanvas(320, 240) sets the height
- * variable to the value 240. The value of height defaults to 100 if
- * createCanvas() is not used in a program.
- *
- * @property {Number} height
- * @readOnly
+ * @requires constants
*/
-p5.prototype.height = 0;
-/**
- * If argument is given, sets the sketch to fullscreen or not based on the
- * value of the argument. If no argument is given, returns the current
- * fullscreen state. Note that due to browser restrictions this can only
- * be called on user input, for example, on mouse press like the example
- * below.
- *
- * @method fullscreen
- * @param {Boolean} [val] whether the sketch should be in fullscreen mode
- * or not
- * @return {Boolean} current fullscreen state
- * @example
- *
- *
- * // Clicking in the box toggles fullscreen on and off.
- * function setup() {
- * background(200);
- * }
- * function mousePressed() {
- * if (mouseX > 0 && mouseX < 100 && mouseY > 0 && mouseY < 100) {
- * var fs = fullscreen();
- * fullscreen(!fs);
- * }
- * }
- *
- *
- *
- * @alt
- * no display.
- *
- */
-p5.prototype.fullscreen = function(val) {
- // no arguments, return fullscreen or not
- if (typeof val === 'undefined') {
- return document.fullscreenElement ||
- document.webkitFullscreenElement ||
- document.mozFullScreenElement ||
- document.msFullscreenElement;
- } else { // otherwise set to fullscreen or not
- if (val) {
- launchFullscreen(document.documentElement);
- } else {
- exitFullscreen();
+'use strict';
+
+var constants = _dereq_('./constants');
+
+module.exports = {
+ modeAdjust: function(a, b, c, d, mode) {
+ if (mode === constants.CORNER) {
+ return { x: a, y: b, w: c, h: d };
+ } else if (mode === constants.CORNERS) {
+ return { x: a, y: b, w: c - a, h: d - b };
+ } else if (mode === constants.RADIUS) {
+ return { x: a - c, y: b - d, w: 2 * c, h: 2 * d };
+ } else if (mode === constants.CENTER) {
+ return { x: a - c * 0.5, y: b - d * 0.5, w: c, h: d };
}
}
};
+},{"./constants":19}],23:[function(_dereq_,module,exports){
+'use strict';
+
+var p5 = _dereq_('../core/main');
+
/**
- * Sets the pixel scaling for high pixel density displays. By default
- * pixel density is set to match display density, call pixelDensity(1)
- * to turn this off. Calling pixelDensity() with no arguments returns
- * the current pixel density of the sketch.
- *
+ * _globalInit
*
- * @method pixelDensity
- * @param {Number} [val] whether or how much the sketch should scale
- * @returns {Number} current pixel density of the sketch
- * @example
- *
- *
- * function setup() {
- * pixelDensity(1);
- * createCanvas(100, 100);
- * background(200);
- * ellipse(width/2, height/2, 50, 50);
- * }
- *
- *
- *
- *
- * function setup() {
- * pixelDensity(3.0);
- * createCanvas(100, 100);
- * background(200);
- * ellipse(width/2, height/2, 50, 50);
- * }
- *
- *
+ * TODO: ???
+ * if sketch is on window
+ * assume "global" mode
+ * and instantiate p5 automatically
+ * otherwise do nothing
*
- * @alt
- * fuzzy 50x50 white ellipse with black outline in center of canvas.
- * sharp 50x50 white ellipse with black outline in center of canvas.
+ * @private
+ * @return {Undefined}
*/
-p5.prototype.pixelDensity = function(val) {
- if (typeof val === 'number') {
- this._pixelDensity = val;
- } else {
- return this._pixelDensity;
+var _globalInit = function() {
+ if (!window.mocha) {
+ // If there is a setup or draw function on the window
+ // then instantiate p5 in "global" mode
+ if (
+ ((window.setup && typeof window.setup === 'function') ||
+ (window.draw && typeof window.draw === 'function')) &&
+ !p5.instance
+ ) {
+ new p5();
+ }
}
- this.resizeCanvas(this.width, this.height, true);
};
+// TODO: ???
+
+// if the page is ready, initialize p5 immediately
+if (document.readyState === 'complete') {
+ _globalInit();
+ // if the page is still loading, add an event listener
+ // and initialize p5 as soon as it finishes loading
+} else {
+ window.addEventListener('load', _globalInit, false);
+}
+
+},{"../core/main":25}],24:[function(_dereq_,module,exports){
/**
- * Returns the pixel density of the current display the sketch is running on.
- *
- * @method displayDensity
- * @returns {Number} current pixel density of the display
- * @example
- *
- *
- * function setup() {
- * var density = displayDensity();
- * pixelDensity(density);
- * createCanvas(100, 100);
- * background(200);
- * ellipse(width/2, height/2, 50, 50);
- * }
- *
- *
- *
- * @alt
- * 50x50 white ellipse with black outline in center of canvas.
+ * @for p5
+ * @requires core
+ * These are functions that are part of the Processing API but are not part of
+ * the p5.js API. In some cases they have a new name, in others, they are
+ * removed completely. Not all unsupported Processing functions are listed here
+ * but we try to include ones that a user coming from Processing might likely
+ * call.
*/
-p5.prototype.displayDensity = function() {
- return window.devicePixelRatio;
+
+'use strict';
+
+var p5 = _dereq_('./main');
+
+p5.prototype.exit = function() {
+ throw new Error('exit() not implemented, see remove()');
};
-function launchFullscreen(element) {
- var enabled = document.fullscreenEnabled ||
- document.webkitFullscreenEnabled ||
- document.mozFullScreenEnabled ||
- document.msFullscreenEnabled;
- if (!enabled) {
- throw new Error('Fullscreen not enabled in this browser.');
- }
- if(element.requestFullscreen) {
- element.requestFullscreen();
- } else if(element.mozRequestFullScreen) {
- element.mozRequestFullScreen();
- } else if(element.webkitRequestFullscreen) {
- element.webkitRequestFullscreen();
- } else if(element.msRequestFullscreen) {
- element.msRequestFullscreen();
- }
-}
+p5.prototype.pushStyle = function() {
+ throw new Error('pushStyle() not used, see push()');
+};
-function exitFullscreen() {
- if(document.exitFullscreen) {
- document.exitFullscreen();
- } else if(document.mozCancelFullScreen) {
- document.mozCancelFullScreen();
- } else if(document.webkitExitFullscreen) {
- document.webkitExitFullscreen();
- } else if (document.msExitFullscreen) {
- document.msExitFullscreen();
- }
-}
+p5.prototype.popStyle = function() {
+ throw new Error('popStyle() not used, see pop()');
+};
+
+p5.prototype.size = function() {
+ var s = 'size() is not a valid p5 function, to set the size of the ';
+ s += 'drawing canvas, please use createCanvas() instead';
+ throw new Error(s);
+};
+module.exports = p5;
+},{"./main":25}],25:[function(_dereq_,module,exports){
/**
- * Gets the current URL.
- * @method getURL
- * @return {String} url
- * @example
- *
- *
- * var url;
- * var x = 100;
- *
- * function setup() {
- * fill(0);
- * noStroke();
- * url = getURL();
- * }
- *
- * function draw() {
- * background(200);
- * text(url, x, height/2);
- * x--;
- * }
- *
- *
- *
- * @alt
- * current url (http://p5js.org/reference/#/p5/getURL) moves right to left.
- *
+ * @module Structure
+ * @submodule Structure
+ * @for p5
+ * @requires constants
*/
-p5.prototype.getURL = function() {
- return location.href;
-};
+
+'use strict';
+
+_dereq_('./shim');
+
+// Core needs the PVariables object
+var constants = _dereq_('./constants');
+
/**
- * Gets the current URL path as an array.
- * @method getURLPath
- * @return {String[]} path components
- * @example
- *
- * function setup() {
- * var urlPath = getURLPath();
- * for (var i=0; i<urlPath.length; i++) {
- * text(urlPath[i], 10, i*20+20);
- * }
- * }
- *
- *
- * @alt
- *no display
+ * This is the p5 instance constructor.
*
- */
-p5.prototype.getURLPath = function() {
- return location.pathname.split('/').filter(function(v){return v!=='';});
-};
-/**
- * Gets the current URL params as an Object.
- * @method getURLParams
- * @return {Object} URL params
- * @example
- *
- *
- * // Example: http://p5js.org?year=2014&month=May&day=15
+ * A p5 instance holds all the properties and methods related to
+ * a p5 sketch. It expects an incoming sketch closure and it can also
+ * take an optional node parameter for attaching the generated p5 canvas
+ * to a node. The sketch closure takes the newly created p5 instance as
+ * its sole argument and may optionally set preload(), setup(), and/or
+ * draw() properties on it for running a sketch.
*
- * function setup() {
- * var params = getURLParams();
- * text(params.day, 10, 20);
- * text(params.month, 10, 40);
- * text(params.year, 10, 60);
- * }
- *
- *
- * @alt
- * no display.
+ * A p5 sketch can run in "global" or "instance" mode:
+ * "global" - all properties and methods are attached to the window
+ * "instance" - all properties and methods are bound to this p5 object
*
+ * @class p5
+ * @constructor
+ * @param {function} sketch a closure that can set optional preload(),
+ * setup(), and/or draw() properties on the
+ * given p5 instance
+ * @param {HTMLElement|Boolean} [node] element to attach canvas to, if a
+ * boolean is passed in use it as sync
+ * @param {Boolean} [sync] start synchronously (optional)
+ * @return {p5} a p5 instance
*/
-p5.prototype.getURLParams = function() {
- var re = /[?&]([^&=]+)(?:[&=])([^&=]+)/gim;
- var m;
- var v={};
- while ((m = re.exec(location.search)) != null) {
- if (m.index === re.lastIndex) {
- re.lastIndex++;
- }
- v[m[1]]=m[2];
+var p5 = function(sketch, node, sync) {
+ if (typeof node === 'boolean' && typeof sync === 'undefined') {
+ sync = node;
+ node = undefined;
}
- return v;
-};
-module.exports = p5;
+ //////////////////////////////////////////////
+ // PUBLIC p5 PROPERTIES AND METHODS
+ //////////////////////////////////////////////
+
+ /**
+ * Called directly before setup(), the preload() function is used to handle
+ * asynchronous loading of external files in a blocking way. If a preload
+ * function is defined, setup() will wait until any load calls within have
+ * finished. Nothing besides load calls (loadImage, loadJSON, loadFont,
+ * loadStrings, etc.) should be inside the preload function. If asynchronous
+ * loading is preferred, the load methods can instead be called in setup()
+ * or anywhere else with the use of a callback parameter.
+ *
+ * By default the text "loading..." will be displayed. To make your own
+ * loading page, include an HTML element with id "p5_loading" in your
+ * page. More information here.
+ *
+ * @method preload
+ * @example
+ *
+ * var img;
+ * var c;
+ * function preload() {
+ // preload() runs once
+ * img = loadImage('assets/laDefense.jpg');
+ * }
+ *
+ * function setup() {
+ // setup() waits until preload() is done
+ * img.loadPixels();
+ * // get color of middle pixel
+ * c = img.get(img.width / 2, img.height / 2);
+ * }
+ *
+ * function draw() {
+ * background(c);
+ * image(img, 25, 25, 50, 50);
+ * }
+ *
+ *
+ * @alt
+ * nothing displayed
+ *
+ */
+
+ /**
+ * The setup() function is called once when the program starts. It's used to
+ * define initial environment properties such as screen size and background
+ * color and to load media such as images and fonts as the program starts.
+ * There can only be one setup() function for each program and it shouldn't
+ * be called again after its initial execution.
+ *
+ * Note: Variables declared within setup() are not accessible within other
+ * functions, including draw().
+ *
+ * @method setup
+ * @example
+ *
+ * var a = 0;
+ *
+ * function setup() {
+ * background(0);
+ * noStroke();
+ * fill(102);
+ * }
+ *
+ * function draw() {
+ * rect(a++ % width, 10, 2, 80);
+ * }
+ *
+ *
+ * @alt
+ * nothing displayed
+ *
+ */
+
+ /**
+ * Called directly after setup(), the draw() function continuously executes
+ * the lines of code contained inside its block until the program is stopped
+ * or noLoop() is called. Note if noLoop() is called in setup(), draw() will
+ * still be executed once before stopping. draw() is called automatically and
+ * should never be called explicitly.
+ *
+ * It should always be controlled with noLoop(), redraw() and loop(). After
+ * noLoop() stops the code in draw() from executing, redraw() causes the
+ * code inside draw() to execute once, and loop() will cause the code
+ * inside draw() to resume executing continuously.
+ *
+ * The number of times draw() executes in each second may be controlled with
+ * the frameRate() function.
+ *
+ * There can only be one draw() function for each sketch, and draw() must
+ * exist if you want the code to run continuously, or to process events such
+ * as mousePressed(). Sometimes, you might have an empty call to draw() in
+ * your program, as shown in the above example.
+ *
+ * It is important to note that the drawing coordinate system will be reset
+ * at the beginning of each draw() call. If any transformations are performed
+ * within draw() (ex: scale, rotate, translate), their effects will be
+ * undone at the beginning of draw(), so transformations will not accumulate
+ * over time. On the other hand, styling applied (ex: fill, stroke, etc) will
+ * remain in effect.
+ *
+ * @method draw
+ * @example
+ *
+ * var yPos = 0;
+ * function setup() {
+ // setup() runs once
+ * frameRate(30);
+ * }
+ * function draw() {
+ // draw() loops forever, until stopped
+ * background(204);
+ * yPos = yPos - 1;
+ * if (yPos < 0) {
+ * yPos = height;
+ * }
+ * line(0, yPos, width, yPos);
+ * }
+ *
+ *
+ * @alt
+ * nothing displayed
+ *
+ */
+
+ //////////////////////////////////////////////
+ // PRIVATE p5 PROPERTIES AND METHODS
+ //////////////////////////////////////////////
+
+ this._setupDone = false;
+ // for handling hidpi
+ this._pixelDensity = Math.ceil(window.devicePixelRatio) || 1;
+ this._userNode = node;
+ this._curElement = null;
+ this._elements = [];
+ this._requestAnimId = 0;
+ this._preloadCount = 0;
+ this._isGlobal = false;
+ this._loop = true;
+ this._initializeInstanceVariables();
+ this._defaultCanvasSize = {
+ width: 100,
+ height: 100
+ };
+ this._events = {
+ // keep track of user-events for unregistering later
+ mousemove: null,
+ mousedown: null,
+ mouseup: null,
+ dragend: null,
+ dragover: null,
+ click: null,
+ dblclick: null,
+ mouseover: null,
+ mouseout: null,
+ keydown: null,
+ keyup: null,
+ keypress: null,
+ touchstart: null,
+ touchmove: null,
+ touchend: null,
+ resize: null,
+ blur: null
+ };
+
+ this._events.wheel = null;
+ this._loadingScreenId = 'p5_loading';
+
+ // Allows methods to be registered on an instance that
+ // are instance-specific.
+ this._registeredMethods = {};
+ var methods = Object.getOwnPropertyNames(p5.prototype._registeredMethods);
+ for (var i = 0; i < methods.length; i++) {
+ var prop = methods[i];
+ this._registeredMethods[prop] = p5.prototype._registeredMethods[
+ prop
+ ].slice();
+ }
+
+ if (window.DeviceOrientationEvent) {
+ this._events.deviceorientation = null;
+ }
+ if (window.DeviceMotionEvent && !window._isNodeWebkit) {
+ this._events.devicemotion = null;
+ }
+
+ this._start = function() {
+ // Find node if id given
+ if (this._userNode) {
+ if (typeof this._userNode === 'string') {
+ this._userNode = document.getElementById(this._userNode);
+ }
+ }
+
+ var context = this._isGlobal ? window : this;
+ var userPreload = context.preload;
+ if (userPreload) {
+ // Setup loading screen
+ // Set loading screen into dom if not present
+ // Otherwise displays and removes user provided loading screen
+ var loadingScreen = document.getElementById(this._loadingScreenId);
+ if (!loadingScreen) {
+ loadingScreen = document.createElement('div');
+ loadingScreen.innerHTML = 'Loading...';
+ loadingScreen.style.position = 'absolute';
+ loadingScreen.id = this._loadingScreenId;
+ var node = this._userNode || document.body;
+ node.appendChild(loadingScreen);
+ }
+ var methods = this._preloadMethods;
+ for (var method in methods) {
+ // default to p5 if no object defined
+ methods[method] = methods[method] || p5;
+ var obj = methods[method];
+ //it's p5, check if it's global or instance
+ if (obj === p5.prototype || obj === p5) {
+ if (this._isGlobal) {
+ window[method] = this._wrapPreload(this, method);
+ }
+ obj = this;
+ }
+ this._registeredPreloadMethods[method] = obj[method];
+ obj[method] = this._wrapPreload(obj, method);
+ }
+
+ userPreload();
+ this._runIfPreloadsAreDone();
+ } else {
+ this._setup();
+ this._runFrames();
+ this._draw();
+ }
+ }.bind(this);
+
+ this._runIfPreloadsAreDone = function() {
+ var context = this._isGlobal ? window : this;
+ if (context._preloadCount === 0) {
+ var loadingScreen = document.getElementById(context._loadingScreenId);
+ if (loadingScreen) {
+ loadingScreen.parentNode.removeChild(loadingScreen);
+ }
+ context._setup();
+ context._runFrames();
+ context._draw();
+ }
+ };
+
+ this._decrementPreload = function() {
+ var context = this._isGlobal ? window : this;
+ if (typeof context.preload === 'function') {
+ context._setProperty('_preloadCount', context._preloadCount - 1);
+ context._runIfPreloadsAreDone();
+ }
+ };
+
+ this._wrapPreload = function(obj, fnName) {
+ return function() {
+ //increment counter
+ this._incrementPreload();
+ //call original function
+ return this._registeredPreloadMethods[fnName].apply(obj, arguments);
+ }.bind(this);
+ };
+
+ this._incrementPreload = function() {
+ var context = this._isGlobal ? window : this;
+ context._setProperty('_preloadCount', context._preloadCount + 1);
+ };
-},{"./constants":54,"./core":55}],58:[function(_dereq_,module,exports){
-/**
- * @for p5
- * @requires core
- */
+ this._setup = function() {
+ // Always create a default canvas.
+ // Later on if the user calls createCanvas, this default one
+ // will be replaced
+ this.createCanvas(
+ this._defaultCanvasSize.width,
+ this._defaultCanvasSize.height,
+ 'p2d'
+ );
-'use strict';
+ // return preload functions to their normal vals if switched by preload
+ var context = this._isGlobal ? window : this;
+ if (typeof context.preload === 'function') {
+ for (var f in this._preloadMethods) {
+ context[f] = this._preloadMethods[f][f];
+ if (context[f] && this) {
+ context[f] = context[f].bind(this);
+ }
+ }
+ }
-var p5 = _dereq_('./core');
-var doFriendlyWelcome = false; // TEMP until we get it all working LM
-// for parameter validation
-var dataDoc = _dereq_('../../docs/reference/data.json');
-var arrDoc = JSON.parse(JSON.stringify(dataDoc));
-
-// -- Borrowed from jQuery 1.11.3 --
-var class2type = {};
-var toString = class2type.toString;
-var names = ['Boolean', 'Number', 'String', 'Function',
- 'Array', 'Date', 'RegExp', 'Object', 'Error'];
-for (var n=0; n p5.js says: '+message+
- '[https://github.com/processing/p5.js/wiki/Local-server]'
- );
- }
- else{
- console.log(
- '> p5.js says: '+message+' [http://p5js.org/reference/#p5/'+func+
- ']'
- );
- }
-}
+ // only draw if we really need to; don't overextend the browser.
+ // draw if we're within 5ms of when our next frame should paint
+ // (this will prevent us from giving up opportunities to draw
+ // again when it's really about time for us to do so). fixes an
+ // issue where the frameRate is too low if our refresh loop isn't
+ // in sync with the browser. note that we have to draw once even
+ // if looping is off, so we bypass the time delay if that
+ // is the case.
+ var epsilon = 5;
+ if (
+ !this._loop ||
+ time_since_last >= target_time_between_frames - epsilon
+ ) {
+ //mandatory update values(matrixs and stack)
-var errorCases = {
- '0': {
- fileType: 'image',
- method: 'loadImage',
- message: ' hosting the image online,'
- },
- '1': {
- fileType: 'XML file',
- method: 'loadXML'
- },
- '2': {
- fileType: 'table file',
- method: 'loadTable'
- },
- '3': {
- fileType: 'text file',
- method: 'loadStrings'
- },
- '4': {
- fileType: 'font',
- method: 'loadFont',
- message: ' hosting the font online,'
- },
-};
-p5._friendlyFileLoadError = function (errorType, filePath) {
- var errorInfo = errorCases[ errorType ];
- var message = 'It looks like there was a problem' +
- ' loading your ' + errorInfo.fileType + '.' +
- ' Try checking if the file path [' + filePath + '] is correct,' +
- (errorInfo.message || '') + ' or running a local server.';
- report(message, errorInfo.method, FILE_LOAD);
-};
-
-/**
-* Validates parameters
-* param {String} func the name of the function
-* param {Array} args user input arguments
-*
-* example:
-* var a;
-* ellipse(10,10,a,5);
-* console ouput:
-* "It looks like ellipse received an empty variable in spot #2."
-*
-* example:
-* ellipse(10,"foo",5,5);
-* console output:
-* "ellipse was expecting a number for parameter #1,
-* received "foo" instead."
-*/
-p5._validateParameters = function validateParameters(func, args) {
- if (p5.disableFriendlyErrors ||
- typeof(IS_MINIFIED) !== 'undefined') {
- return; // skip FES
- }
- var arrDoc = lookupParamDoc(func);
- var errorArray = [];
- var minErrCount = 999999;
- if (arrDoc.length > 1){ // func has multiple formats
- for (var i = 0; i < arrDoc.length; i++) {
- var arrError = testParamFormat(args, arrDoc[i]);
- if( arrError.length === 0) {
- return; // no error
- }
- // see if this is the format with min number of err
- if( minErrCount > arrError.length) {
- minErrCount = arrError.length;
- errorArray = arrError;
+ this.redraw();
+ this._frameRate = 1000.0 / (now - this._lastFrameTime);
+ this._lastFrameTime = now;
+
+ // If the user is actually using mouse module, then update
+ // coordinates, otherwise skip. We can test this by simply
+ // checking if any of the mouse functions are available or not.
+ // NOTE : This reflects only in complete build or modular build.
+ if (typeof this._updateMouseCoords !== 'undefined') {
+ this._updateMouseCoords();
}
}
- // generate err msg
- for (var n = 0; n < errorArray.length; n++) {
- p5._friendlyParamError(errorArray[n], func);
+
+ // get notified the next time the browser gives us
+ // an opportunity to draw.
+ if (this._loop) {
+ this._requestAnimId = window.requestAnimationFrame(this._draw);
}
- } else { // func has a single format
- errorArray = testParamFormat(args, arrDoc[0]);
- for(var m = 0; m < errorArray.length; m++) {
- p5._friendlyParamError(errorArray[m], func);
+ }.bind(this);
+
+ this._runFrames = function() {
+ if (this._updateInterval) {
+ clearInterval(this._updateInterval);
}
- }
-};
-// validateParameters() helper functions:
-// lookupParamDoc() for querying data.json
-function lookupParamDoc(func){
- var queryResult = arrDoc.classitems.
- filter(function (x) { return x.name === func; });
- // different JSON structure for funct with multi-format
- if (queryResult[0].hasOwnProperty('overloads')){
- var res = [];
- for(var i = 0; i < queryResult[0].overloads.length; i++) {
- res.push(queryResult[0].overloads[i].params);
+ }.bind(this);
+
+ this._setProperty = function(prop, value) {
+ this[prop] = value;
+ if (this._isGlobal) {
+ window[prop] = value;
}
- return res;
- } else {
- return [queryResult[0].params];
- }
-}
-function testParamFormat(args, format){
- var errorArray = [];
- var error;
- for (var p = 0; p < format.length; p++) {
- var argType = typeof(args[p]);
- if ('undefined' === argType || null === argType) {
- if (format[p].optional !== true) {
- error = {type:'EMPTY_VAR', position: p};
- errorArray.push(error);
+ }.bind(this);
+
+ /**
+ * Removes the entire p5 sketch. This will remove the canvas and any
+ * elements created by p5.js. It will also stop the draw loop and unbind
+ * any properties or methods from the window global scope. It will
+ * leave a variable p5 in case you wanted to create a new p5 sketch.
+ * If you like, you can set p5 = null to erase it. While all functions and
+ * variables and objects created by the p5 library will be removed, any
+ * other global variables created by your code will remain.
+ *
+ * @method remove
+ * @example
+ *
+ * function draw() {
+ * ellipse(50, 50, 10, 10);
+ * }
+ *
+ * function mousePressed() {
+ * remove(); // remove whole sketch on mouse press
+ * }
+ *
+ *
+ * @alt
+ * nothing displayed
+ *
+ */
+ this.remove = function() {
+ var loadingScreen = document.getElementById(this._loadingScreenId);
+ if (loadingScreen) {
+ loadingScreen.parentNode.removeChild(loadingScreen);
+ // Add 1 to preload counter to prevent the sketch ever executing setup()
+ this._incrementPreload();
+ }
+ if (this._curElement) {
+ // stop draw
+ this._loop = false;
+ if (this._requestAnimId) {
+ window.cancelAnimationFrame(this._requestAnimId);
}
- } else {
- var types = format[p].type.split('|'); // case accepting multi-types
- if (argType === 'object'){ // if object, test for class
- if (!testParamClass(args[p], types)) { // if fails to pass
- error = {type:'WRONG_CLASS', position: p,
- correctClass: types[p], wrongClass: args[p].name};
- errorArray.push(error);
+
+ // unregister events sketch-wide
+ for (var ev in this._events) {
+ window.removeEventListener(ev, this._events[ev]);
+ }
+
+ // remove DOM elements created by p5, and listeners
+ for (var i = 0; i < this._elements.length; i++) {
+ var e = this._elements[i];
+ if (e.elt.parentNode) {
+ e.elt.parentNode.removeChild(e.elt);
}
- }else{ // not object, test for type
- if (!testParamType(args[p], types)) { // if fails to pass
- error = {type:'WRONG_TYPE', position: p,
- correctType: types[p], wrongType: argType};
- errorArray.push(error);
+ for (var elt_ev in e._events) {
+ e.elt.removeEventListener(elt_ev, e._events[elt_ev]);
}
}
+
+ // call any registered remove functions
+ var self = this;
+ this._registeredMethods.remove.forEach(function(f) {
+ if (typeof f !== 'undefined') {
+ f.call(self);
+ }
+ });
}
- }
- return errorArray;
-}
-// testClass() for object type parameter validation
-// Returns true if PASS, false if FAIL
-function testParamClass(param, types){
- for (var i = 0; i < types.length; i++) {
- if (types[i] === 'Array') {
- if(param instanceof Array) {
- return true;
+ // remove window bound properties and methods
+ if (this._isGlobal) {
+ for (var p in p5.prototype) {
+ try {
+ delete window[p];
+ } catch (x) {
+ window[p] = undefined;
+ }
}
- } else {
- if (param.name === types[i]) {
- return true; // class name match, pass
- } else if (types[i] === 'Constant') {
- return true; // accepts any constant, pass
+ for (var p2 in this) {
+ if (this.hasOwnProperty(p2)) {
+ try {
+ delete window[p2];
+ } catch (x) {
+ window[p2] = undefined;
+ }
+ }
}
+ p5.instance = null;
}
- }
- return false;
-}
-// testType() for non-object type parameter validation
-// Returns true if PASS, false if FAIL
-function testParamType(param, types){
- for (var i = 0; i < types.length; i++) {
- if (typeof(param) === types[i].toLowerCase()) {
- return true; // type match, pass
- } else if (types[i] === 'Constant') {
- return true; // accepts any constant, pass
- }
- }
- return false;
-}
-// function for generating console.log() msg
-p5._friendlyParamError = function (errorObj, func) {
- var message;
- switch (errorObj.type){
- case 'EMPTY_VAR':
- message = 'It looks like ' + func +
- '() received an empty variable in spot #' + errorObj.position +
- ' (zero-based index). If not intentional, this is often a problem' +
- ' with scope: [https://p5js.org/examples/data-variable-scope.html].';
- report(message, func, ERR_PARAMS);
- break;
- case 'WRONG_CLASS':
- message = func + '() was expecting ' + errorObj.correctClass +
- ' for parameter #' + errorObj.position + ' (zero-based index), received ';
- // Wrap strings in quotes
- message += 'an object with name '+ errorObj.wrongClass +' instead.';
- report(message, func, ERR_PARAMS);
- break;
- case 'WRONG_TYPE':
- message = func + '() was expecting ' + errorObj.correctType +
- ' for parameter #' + errorObj.position + ' (zero-based index), received ';
- // Wrap strings in quotes
- message += errorObj.wrongType + ' instead.';
- report(message, func, ERR_PARAMS);
- }
-};
-function friendlyWelcome() {
- // p5.js brand - magenta: #ED225D
- //var astrixBgColor = 'transparent';
- //var astrixTxtColor = '#ED225D';
- //var welcomeBgColor = '#ED225D';
- //var welcomeTextColor = 'white';
- console.log(
- ' _ \n'+
- ' /\\| |/\\ \n'+
- ' \\ ` \' / \n'+
- ' / , . \\ \n'+
- ' \\/|_|\\/ '+
- '\n\n> p5.js says: Welcome! '+
- 'This is your friendly debugger. ' +
- 'To turn me off switch to using “p5.min.js”.'
- );
-}
-
-/**
- * Prints out all the colors in the color pallete with white text.
- * For color blindness testing.
- */
-/* function testColors() {
- var str = 'A box of biscuits, a box of mixed biscuits and a biscuit mixer';
- report(str, 'print', '#ED225D'); // p5.js magenta
- report(str, 'print', '#2D7BB6'); // p5.js blue
- report(str, 'print', '#EE9900'); // p5.js orange
- report(str, 'print', '#A67F59'); // p5.js light brown
- report(str, 'print', '#704F21'); // p5.js gold
- report(str, 'print', '#1CC581'); // auto cyan
- report(str, 'print', '#FF6625'); // auto orange
- report(str, 'print', '#79EB22'); // auto green
- report(str, 'print', '#B40033'); // p5.js darkened magenta
- report(str, 'print', '#084B7F'); // p5.js darkened blue
- report(str, 'print', '#945F00'); // p5.js darkened orange
- report(str, 'print', '#6B441D'); // p5.js darkened brown
- report(str, 'print', '#2E1B00'); // p5.js darkened gold
- report(str, 'print', '#008851'); // auto dark cyan
- report(str, 'print', '#C83C00'); // auto dark orange
- report(str, 'print', '#4DB200'); // auto dark green
-} */
+ }.bind(this);
-// This is a lazily-defined list of p5 symbols that may be
-// misused by beginners at top-level code, outside of setup/draw. We'd like
-// to detect these errors and help the user by suggesting they move them
-// into setup/draw.
-//
-// For more details, see https://github.com/processing/p5.js/issues/1121.
-var misusedAtTopLevelCode = null;
-var FAQ_URL = 'https://github.com/processing/p5.js/wiki/' +
- 'Frequently-Asked-Questions' +
- '#why-cant-i-assign-variables-using-p5-functions-and-' +
- 'variables-before-setup';
+ // call any registered init functions
+ this._registeredMethods.init.forEach(function(f) {
+ if (typeof f !== 'undefined') {
+ f.call(this);
+ }
+ }, this);
-function defineMisusedAtTopLevelCode() {
- var uniqueNamesFound = {};
+ var friendlyBindGlobal = this._createFriendlyGlobalFunctionBinder();
- var getSymbols = function(obj) {
- return Object.getOwnPropertyNames(obj).filter(function(name) {
- if (name[0] === '_') {
- return false;
+ // If the user has created a global setup or draw function,
+ // assume "global" mode and make everything global (i.e. on the window)
+ if (!sketch) {
+ this._isGlobal = true;
+ p5.instance = this;
+ // Loop through methods on the prototype and attach them to the window
+ for (var p in p5.prototype) {
+ if (typeof p5.prototype[p] === 'function') {
+ var ev = p.substring(2);
+ if (!this._events.hasOwnProperty(ev)) {
+ if (Math.hasOwnProperty(p) && Math[p] === p5.prototype[p]) {
+ // Multiple p5 methods are just native Math functions. These can be
+ // called without any binding.
+ friendlyBindGlobal(p, p5.prototype[p]);
+ } else {
+ friendlyBindGlobal(p, p5.prototype[p].bind(this));
+ }
+ }
+ } else {
+ friendlyBindGlobal(p, p5.prototype[p]);
}
- if (name in uniqueNamesFound) {
- return false;
+ }
+ // Attach its properties to the window
+ for (var p2 in this) {
+ if (this.hasOwnProperty(p2)) {
+ friendlyBindGlobal(p2, this[p2]);
}
+ }
+ } else {
+ // Else, the user has passed in a sketch closure that may set
+ // user-provided 'setup', 'draw', etc. properties on this instance of p5
+ sketch(this);
+ }
- uniqueNamesFound[name] = true;
+ // Bind events to window (not using container div bc key events don't work)
- return true;
- }).map(function(name) {
- var type;
+ for (var e in this._events) {
+ var f = this['_on' + e];
+ if (f) {
+ var m = f.bind(this);
+ window.addEventListener(e, m, { passive: false });
+ this._events[e] = m;
+ }
+ }
- if (typeof(obj[name]) === 'function') {
- type = 'function';
- } else if (name === name.toUpperCase()) {
- type = 'constant';
- } else {
- type = 'variable';
- }
+ var focusHandler = function() {
+ this._setProperty('focused', true);
+ }.bind(this);
+ var blurHandler = function() {
+ this._setProperty('focused', false);
+ }.bind(this);
+ window.addEventListener('focus', focusHandler);
+ window.addEventListener('blur', blurHandler);
+ this.registerMethod('remove', function() {
+ window.removeEventListener('focus', focusHandler);
+ window.removeEventListener('blur', blurHandler);
+ });
- return {name: name, type: type};
- });
- };
+ if (sync) {
+ this._start();
+ } else {
+ if (document.readyState === 'complete') {
+ this._start();
+ } else {
+ window.addEventListener('load', this._start.bind(this), false);
+ }
+ }
+};
- misusedAtTopLevelCode = [].concat(
- getSymbols(p5.prototype),
- // At present, p5 only adds its constants to p5.prototype during
- // construction, which may not have happened at the time a
- // ReferenceError is thrown, so we'll manually add them to our list.
- getSymbols(_dereq_('./constants'))
- );
+p5.prototype._initializeInstanceVariables = function() {
+ this._styles = [];
- // This will ultimately ensure that we report the most specific error
- // possible to the user, e.g. advising them about HALF_PI instead of PI
- // when their code misuses the former.
- misusedAtTopLevelCode.sort(function(a, b) {
- return b.name.length - a.name.length;
- });
-}
+ this._bezierDetail = 20;
+ this._curveDetail = 20;
-function helpForMisusedAtTopLevelCode(e, log) {
- if (!log) {
- log = console.log.bind(console);
- }
+ this._colorMode = constants.RGB;
+ this._colorMaxes = {
+ rgb: [255, 255, 255, 255],
+ hsb: [360, 100, 100, 1],
+ hsl: [360, 100, 100, 1]
+ };
- if (!misusedAtTopLevelCode) {
- defineMisusedAtTopLevelCode();
- }
+ this._pixelsDirty = true;
+};
- // If we find that we're logging lots of false positives, we can
- // uncomment the following code to avoid displaying anything if the
- // user's code isn't likely to be using p5's global mode. (Note that
- // setup/draw are more likely to be defined due to JS function hoisting.)
- //
- //if (!('setup' in window || 'draw' in window)) {
- // return;
- //}
+// This is a pointer to our global mode p5 instance, if we're in
+// global mode.
+p5.instance = null;
- misusedAtTopLevelCode.some(function(symbol) {
- // Note that while just checking for the occurrence of the
- // symbol name in the error message could result in false positives,
- // a more rigorous test is difficult because different browsers
- // log different messages, and the format of those messages may
- // change over time.
- //
- // For example, if the user uses 'PI' in their code, it may result
- // in any one of the following messages:
- //
- // * 'PI' is undefined (Microsoft Edge)
- // * ReferenceError: PI is undefined (Firefox)
- // * Uncaught ReferenceError: PI is not defined (Chrome)
+// Allows for the friendly error system to be turned off when creating a sketch,
+// which can give a significant boost to performance when needed.
+p5.disableFriendlyErrors = false;
- if (e.message && e.message.match('\\W?'+symbol.name+'\\W') !== null) {
- log('Did you just try to use p5.js\'s ' + symbol.name +
- (symbol.type === 'function' ? '() ' : ' ') + symbol.type +
- '? If so, you may want to ' +
- 'move it into your sketch\'s setup() function.\n\n' +
- 'For more details, see: ' + FAQ_URL);
- return true;
- }
- });
+// attach constants to p5 prototype
+for (var k in constants) {
+ p5.prototype[k] = constants[k];
}
-// Exposing this primarily for unit testing.
-p5.prototype._helpForMisusedAtTopLevelCode = helpForMisusedAtTopLevelCode;
-p5.prototype._validateParameters = p5.validateParameters;
+// functions that cause preload to wait
+// more can be added by using registerPreloadMethod(func)
+p5.prototype._preloadMethods = {
+ loadJSON: p5.prototype,
+ loadImage: p5.prototype,
+ loadStrings: p5.prototype,
+ loadXML: p5.prototype,
+ loadBytes: p5.prototype,
+ loadTable: p5.prototype,
+ loadFont: p5.prototype,
+ loadModel: p5.prototype,
+ loadShader: p5.prototype
+};
-if (document.readyState !== 'complete') {
- window.addEventListener('error', helpForMisusedAtTopLevelCode, false);
+p5.prototype._registeredMethods = { init: [], pre: [], post: [], remove: [] };
- // Our job is only to catch ReferenceErrors that are thrown when
- // global (non-instance mode) p5 APIs are used at the top-level
- // scope of a file, so we'll unbind our error listener now to make
- // sure we don't log false positives later.
- window.addEventListener('load', function() {
- window.removeEventListener('error', helpForMisusedAtTopLevelCode, false);
- });
-}
+p5.prototype._registeredPreloadMethods = {};
-module.exports = p5;
+p5.prototype.registerPreloadMethod = function(fnString, obj) {
+ // obj = obj || p5.prototype;
+ if (!p5.prototype._preloadMethods.hasOwnProperty(fnString)) {
+ p5.prototype._preloadMethods[fnString] = obj;
+ }
+};
-},{"../../docs/reference/data.json":1,"./constants":54,"./core":55}],59:[function(_dereq_,module,exports){
+p5.prototype.registerMethod = function(name, m) {
+ var target = this || p5.prototype;
+ if (!target._registeredMethods.hasOwnProperty(name)) {
+ target._registeredMethods[name] = [];
+ }
+ target._registeredMethods[name].push(m);
+};
-var p5 = _dereq_('../core/core');
+// create a function which provides a standardized process for binding
+// globals; this is implemented as a factory primarily so that there's a
+// way to redefine what "global" means for the binding function so it
+// can be used in scenarios like unit testing where the window object
+// might not exist
+p5.prototype._createFriendlyGlobalFunctionBinder = function(options) {
+ options = options || {};
+ var globalObject = options.globalObject || window;
+ var log = options.log || console.log.bind(console);
+ var propsToForciblyOverwrite = {
+ // p5.print actually always overwrites an existing global function,
+ // albeit one that is very unlikely to be used:
+ //
+ // https://developer.mozilla.org/en-US/docs/Web/API/Window/print
+ print: true
+ };
-/**
- * _globalInit
- *
- * TODO: ???
- * if sketch is on window
- * assume "global" mode
- * and instantiate p5 automatically
- * otherwise do nothing
- *
- * @return {Undefined}
- */
-var _globalInit = function() {
- if (!window.PHANTOMJS && !window.mocha) {
- // If there is a setup or draw function on the window
- // then instantiate p5 in "global" mode
- if(((window.setup && typeof window.setup === 'function') ||
- (window.draw && typeof window.draw === 'function')) &&
- !p5.instance) {
- new p5();
+ return function(prop, value) {
+ if (
+ !p5.disableFriendlyErrors &&
+ typeof IS_MINIFIED === 'undefined' &&
+ typeof value === 'function' &&
+ !(prop in p5.prototype._preloadMethods)
+ ) {
+ try {
+ // Because p5 has so many common function names, it's likely
+ // that users may accidentally overwrite global p5 functions with
+ // their own variables. Let's allow this but log a warning to
+ // help users who may be doing this unintentionally.
+ //
+ // For more information, see:
+ //
+ // https://github.com/processing/p5.js/issues/1317
+
+ if (prop in globalObject && !(prop in propsToForciblyOverwrite)) {
+ throw new Error('global "' + prop + '" already exists');
+ }
+
+ // It's possible that this might throw an error because there
+ // are a lot of edge-cases in which `Object.defineProperty` might
+ // not succeed; since this functionality is only intended to
+ // help beginners anyways, we'll just catch such an exception
+ // if it occurs, and fall back to legacy behavior.
+ Object.defineProperty(globalObject, prop, {
+ configurable: true,
+ enumerable: true,
+ get: function() {
+ return value;
+ },
+ set: function(newValue) {
+ Object.defineProperty(globalObject, prop, {
+ configurable: true,
+ enumerable: true,
+ value: newValue,
+ writable: true
+ });
+ log(
+ 'You just changed the value of "' +
+ prop +
+ '", which was ' +
+ "a p5 function. This could cause problems later if you're " +
+ 'not careful.'
+ );
+ }
+ });
+ } catch (e) {
+ log(
+ 'p5 had problems creating the global function "' +
+ prop +
+ '", ' +
+ 'possibly because your code is already using that name as ' +
+ 'a variable. You may want to rename your variable to something ' +
+ 'else.'
+ );
+ globalObject[prop] = value;
+ }
+ } else {
+ globalObject[prop] = value;
}
- }
+ };
};
-// TODO: ???
-if (document.readyState === 'complete') {
- _globalInit();
-} else {
- window.addEventListener('load', _globalInit , false);
-}
-},{"../core/core":55}],60:[function(_dereq_,module,exports){
+module.exports = p5;
+
+},{"./constants":19,"./shim":35}],26:[function(_dereq_,module,exports){
/**
* @module DOM
* @submodule DOM
* @for p5.Element
*/
-var p5 = _dereq_('./core');
+'use strict';
+
+var p5 = _dereq_('./main');
/**
* Base class for all elements added to a sketch, including canvas,
@@ -46885,18 +49197,29 @@ var p5 = _dereq_('./core');
* included in the core functionality, methods in brown are added
* with the p5.dom
* library.
- * It is not called directly, but p5.Element
- * objects are created by calling createCanvas, createGraphics,
- * or in the p5.dom library, createDiv, createImg, createInput, etc.
+ * It is not called directly, but p5.Element
+ * objects are created by calling createCanvas, createGraphics,
+ * or in the p5.dom library, createDiv, createImg, createInput, etc.
*
* @class p5.Element
- * @constructor
* @param {String} elt DOM node that is wrapped
* @param {p5} [pInst] pointer to p5 instance
*/
p5.Element = function(elt, pInst) {
/**
* Underlying HTML element. All normal HTML methods can be called on this.
+ * @example
+ *
+ *
+ * createCanvas(300, 500);
+ * background(0, 0, 0, 0);
+ * var input = createInput();
+ * input.position(20, 225);
+ * var inputElem = new p5.Element(input.elt);
+ * inputElem.style('width:450px;');
+ * inputElem.value('some string');
+ *
+ *
*
* @property elt
* @readOnly
@@ -46906,34 +49229,30 @@ p5.Element = function(elt, pInst) {
this._events = {};
this.width = this.elt.offsetWidth;
this.height = this.elt.offsetHeight;
- this.name = 'p5.Element'; // for friendly debugger system
};
/**
*
* Attaches the element to the parent specified. A way of setting
* the container for the element. Accepts either a string ID, DOM
- * node, or p5.Element. If no arguments given, parent node is returned.
+ * node, or p5.Element. If no arguments given, parent node is returned.
* For more ways to position the canvas, see the
*
* positioning the canvas wiki page.
*
* @method parent
- * @param {String|p5.Element|Object} parent the ID, DOM node, or p5.Element
+ * @param {String|p5.Element|Object} parent the ID, DOM node, or p5.Element
* of desired parent element
* @chainable
- */
-/**
- * @method parent
- * @return {p5.Element}
*
* @example
- *
+ *
* // in the html file:
- * <div id="myContainer"></div>
+ * // <div id="myContainer"></div>
+ *
* // in the js file:
* var cnv = createCanvas(100, 100);
- * cnv.parent("myContainer");
+ * cnv.parent('myContainer');
*
*
* var div0 = createDiv('this is the parent');
@@ -46946,7 +49265,7 @@ p5.Element = function(elt, pInst) {
* var div1 = createDiv('this is the child');
* div1.parent('apples'); // use id
*
- *
+ *
* var elt = document.getElementById('myParentDiv');
* var div1 = createDiv('this is the child');
* div1.parent(elt); // use element from page
@@ -46954,23 +49273,27 @@ p5.Element = function(elt, pInst) {
*
* @alt
* no display.
+ */
+/**
+ * @method parent
+ * @return {p5.Element}
*
*/
p5.Element.prototype.parent = function(p) {
- if (arguments.length === 0){
+ if (typeof p === 'undefined') {
return this.elt.parentNode;
- } else {
- if (typeof p === 'string') {
- if (p[0] === '#') {
- p = p.substring(1);
- }
- p = document.getElementById(p);
- } else if (p instanceof p5.Element) {
- p = p.elt;
+ }
+
+ if (typeof p === 'string') {
+ if (p[0] === '#') {
+ p = p.substring(1);
}
- p.appendChild(this.elt);
- return this;
+ p = document.getElementById(p);
+ } else if (p instanceof p5.Element) {
+ p = p.elt;
}
+ p.appendChild(this.elt);
+ return this;
};
/**
@@ -46981,10 +49304,6 @@ p5.Element.prototype.parent = function(p) {
* @method id
* @param {String} id ID of the element
* @chainable
- */
-/**
- * @method id
- * @return {String} the id of the element
*
* @example
*
@@ -46992,23 +49311,26 @@ p5.Element.prototype.parent = function(p) {
* var cnv = createCanvas(100, 100);
* // Assigns a CSS selector ID to
* // the canvas element.
- * cnv.id("mycanvas");
+ * cnv.id('mycanvas');
* }
*
*
* @alt
* no display.
- *
+ */
+/**
+ * @method id
+ * @return {String} the id of the element
*/
p5.Element.prototype.id = function(id) {
- if (arguments.length === 0) {
+ if (typeof id === 'undefined') {
return this.elt.id;
- } else {
- this.elt.id = id;
- this.width = this.elt.offsetWidth;
- this.height = this.elt.offsetHeight;
- return this;
}
+
+ this.elt.id = id;
+ this.width = this.elt.offsetWidth;
+ this.height = this.elt.offsetHeight;
+ return this;
};
/**
@@ -47019,24 +49341,39 @@ p5.Element.prototype.id = function(id) {
* @method class
* @param {String} class class to add
* @chainable
+ *
+ * @example
+ *
+ * function setup() {
+ * var cnv = createCanvas(100, 100);
+ * // Assigns a CSS selector class 'small'
+ * // to the canvas element.
+ * cnv.class('small');
+ * }
+ *
+ *
+ * @alt
+ * no display.
*/
/**
* @method class
* @return {String} the class of the element
*/
p5.Element.prototype.class = function(c) {
- if (arguments.length === 0) {
+ if (typeof c === 'undefined') {
return this.elt.className;
- } else {
- this.elt.className = c;
- return this;
}
+
+ this.elt.className = c;
+ return this;
};
/**
- * The .mousePressed() function is called once after every time a
- * mouse button is pressed over the element. This can be used to
- * attach element specific event listeners.
+ * The .mousePressed() function is called once after every time a
+ * mouse button is pressed over the element.
+ * Some mobile browsers may also trigger this event on a touch screen,
+ * if the user performs a quick tap.
+ * This can be used to attach element specific event listeners.
*
* @method mousePressed
* @param {Function|Boolean} fxn function to be fired when mouse is
@@ -47052,14 +49389,14 @@ p5.Element.prototype.class = function(c) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mousePressed(changeGray); // attach listener for
- * // canvas click only
+ * // canvas click only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires with any click anywhere
@@ -47077,14 +49414,23 @@ p5.Element.prototype.class = function(c) {
* no display.
*
*/
-p5.Element.prototype.mousePressed = function (fxn) {
- adjustListener('mousedown', fxn, this);
- adjustListener('touchstart', fxn, this);
+p5.Element.prototype.mousePressed = function(fxn) {
+ // Prepend the mouse property setters to the event-listener.
+ // This is required so that mouseButton is set correctly prior to calling the callback (fxn).
+ // For details, see https://github.com/processing/p5.js/issues/3087.
+ var eventPrependedFxn = function(event) {
+ this._pInst._setProperty('mouseIsPressed', true);
+ this._pInst._setMouseButton(event);
+ // Pass along the return-value of the callback:
+ return fxn();
+ };
+ // Pass along the event-prepended form of the callback.
+ adjustListener('mousedown', eventPrependedFxn, this);
return this;
};
/**
- * The .doubleClicked() function is called once after every time a
+ * The .doubleClicked() function is called once after every time a
* mouse button is pressed twice over the element. This can be used to
* attach element and action specific event listeners.
*
@@ -47102,14 +49448,14 @@ p5.Element.prototype.mousePressed = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.doubleClicked(changeGray); // attach listener for
- * // canvas click only
+ * // canvas double click only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires with any double click anywhere
@@ -47117,7 +49463,7 @@ p5.Element.prototype.mousePressed = function (fxn) {
* d = d + 10;
* }
*
- * // this function fires only when cnv is clicked
+ * // this function fires only when cnv is double clicked
* function changeGray() {
* g = random(0, 255);
* }
@@ -47127,14 +49473,13 @@ p5.Element.prototype.mousePressed = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.doubleClicked = function (fxn) {
- adjustListener('doubleClicked', fxn, this);
+p5.Element.prototype.doubleClicked = function(fxn) {
+ adjustListener('dblclick', fxn, this);
return this;
};
-
/**
- * The .mouseWheel() function is called once after every time a
+ * The .mouseWheel() function is called once after every time a
* mouse wheel is scrolled over the element. This can be used to
* attach element specific event listeners.
*
@@ -47162,14 +49507,14 @@ p5.Element.prototype.doubleClicked = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mouseWheel(changeSize); // attach listener for
- * // activity on canvas only
+ * // activity on canvas only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires with mousewheel movement
@@ -47194,15 +49539,17 @@ p5.Element.prototype.doubleClicked = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.mouseWheel = function (fxn) {
+p5.Element.prototype.mouseWheel = function(fxn) {
adjustListener('wheel', fxn, this);
return this;
};
/**
- * The .mouseReleased() function is called once after every time a
- * mouse button is released over the element. This can be used to
- * attach element specific event listeners.
+ * The .mouseReleased() function is called once after every time a
+ * mouse button is released over the element.
+ * Some mobile browsers may also trigger this event on a touch screen,
+ * if the user performs a quick tap.
+ * This can be used to attach element specific event listeners.
*
* @method mouseReleased
* @param {Function|Boolean} fxn function to be fired when mouse is
@@ -47218,14 +49565,14 @@ p5.Element.prototype.mouseWheel = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mouseReleased(changeGray); // attach listener for
- * // activity on canvas only
+ * // activity on canvas only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires after the mouse has been
@@ -47246,17 +49593,17 @@ p5.Element.prototype.mouseWheel = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.mouseReleased = function (fxn) {
+p5.Element.prototype.mouseReleased = function(fxn) {
adjustListener('mouseup', fxn, this);
- adjustListener('touchend', fxn, this);
return this;
};
-
/**
- * The .mouseClicked() function is called once after a mouse button is
- * pressed and released over the element. This can be used to
- * attach element specific event listeners.
+ * The .mouseClicked() function is called once after a mouse button is
+ * pressed and released over the element.
+ * Some mobile browsers may also trigger this event on a touch screen,
+ * if the user performs a quick tap.
+ * This can be used to attach element specific event listeners.
*
* @method mouseClicked
* @param {Function|Boolean} fxn function to be fired when mouse is
@@ -47274,14 +49621,14 @@ p5.Element.prototype.mouseReleased = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mouseClicked(changeGray); // attach listener for
- * // activity on canvas only
+ * // activity on canvas only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires after the mouse has been
@@ -47302,13 +49649,13 @@ p5.Element.prototype.mouseReleased = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.mouseClicked = function (fxn) {
+p5.Element.prototype.mouseClicked = function(fxn) {
adjustListener('click', fxn, this);
return this;
};
/**
- * The .mouseMoved() function is called once every time a
+ * The .mouseMoved() function is called once every time a
* mouse moves over the element. This can be used to attach an
* element specific event listener.
*
@@ -47326,7 +49673,7 @@ p5.Element.prototype.mouseClicked = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mouseMoved(changeSize); // attach listener for
- * // activity on canvas only
+ * // activity on canvas only
* d = 10;
* g = 100;
* }
@@ -47334,7 +49681,7 @@ p5.Element.prototype.mouseClicked = function (fxn) {
* function draw() {
* background(g);
* fill(200);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires when mouse moves anywhere on
@@ -47360,14 +49707,13 @@ p5.Element.prototype.mouseClicked = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.mouseMoved = function (fxn) {
+p5.Element.prototype.mouseMoved = function(fxn) {
adjustListener('mousemove', fxn, this);
- adjustListener('touchmove', fxn, this);
return this;
};
/**
- * The .mouseOver() function is called once after every time a
+ * The .mouseOver() function is called once after every time a
* mouse moves onto the element. This can be used to attach an
* element specific event listener.
*
@@ -47381,7 +49727,6 @@ p5.Element.prototype.mouseMoved = function (fxn) {
*
* var cnv;
* var d;
- * var g;
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mouseOver(changeGray);
@@ -47389,7 +49734,7 @@ p5.Element.prototype.mouseMoved = function (fxn) {
* }
*
* function draw() {
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* function changeGray() {
@@ -47405,14 +49750,13 @@ p5.Element.prototype.mouseMoved = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.mouseOver = function (fxn) {
+p5.Element.prototype.mouseOver = function(fxn) {
adjustListener('mouseover', fxn, this);
return this;
};
-
/**
- * The .changed() function is called when the value of an
+ * The .changed() function is called when the value of an
* element changes.
* This can be used to attach an element specific event listener.
*
@@ -47440,7 +49784,7 @@ p5.Element.prototype.mouseOver = function (fxn) {
* function mySelectEvent() {
* var item = sel.value();
* background(200);
- * text("it's a "+item+"!", 50, 50);
+ * text("it's a " + item + '!', 50, 50);
* }
*
*
@@ -47448,7 +49792,7 @@ p5.Element.prototype.mouseOver = function (fxn) {
* var cnv;
*
* function setup() {
- * checkbox = createCheckbox(" fill");
+ * checkbox = createCheckbox(' fill');
* checkbox.changed(changeFill);
* cnv = createCanvas(100, 100);
* cnv.position(0, 30);
@@ -47473,13 +49817,13 @@ p5.Element.prototype.mouseOver = function (fxn) {
* dropdown: pear, kiwi, grape. When selected text "its a" + selection shown.
*
*/
-p5.Element.prototype.changed = function (fxn) {
+p5.Element.prototype.changed = function(fxn) {
adjustListener('change', fxn, this);
return this;
};
/**
- * The .input() function is called when any user input is
+ * The .input() function is called when any user input is
* detected with an element. The input event is often used
* to detect keystrokes in a input element, or changes on a
* slider element. This can be used to attach an element specific
@@ -47508,13 +49852,13 @@ p5.Element.prototype.changed = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.input = function (fxn) {
+p5.Element.prototype.input = function(fxn) {
adjustListener('input', fxn, this);
return this;
};
/**
- * The .mouseOut() function is called once after every time a
+ * The .mouseOut() function is called once after every time a
* mouse moves off the element. This can be used to attach an
* element specific event listener.
*
@@ -47528,7 +49872,6 @@ p5.Element.prototype.input = function (fxn) {
*
* var cnv;
* var d;
- * var g;
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.mouseOut(changeGray);
@@ -47536,7 +49879,7 @@ p5.Element.prototype.input = function (fxn) {
* }
*
* function draw() {
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* function changeGray() {
@@ -47551,13 +49894,13 @@ p5.Element.prototype.input = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.mouseOut = function (fxn) {
+p5.Element.prototype.mouseOut = function(fxn) {
adjustListener('mouseout', fxn, this);
return this;
};
/**
- * The .touchStarted() function is called once after every time a touch is
+ * The .touchStarted() function is called once after every time a touch is
* registered. This can be used to attach element specific event listeners.
*
* @method touchStarted
@@ -47574,14 +49917,14 @@ p5.Element.prototype.mouseOut = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.touchStarted(changeGray); // attach listener for
- * // canvas click only
+ * // canvas click only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires with any touch anywhere
@@ -47599,14 +49942,13 @@ p5.Element.prototype.mouseOut = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.touchStarted = function (fxn) {
+p5.Element.prototype.touchStarted = function(fxn) {
adjustListener('touchstart', fxn, this);
- adjustListener('mousedown', fxn, this);
return this;
};
/**
- * The .touchMoved() function is called once after every time a touch move is
+ * The .touchMoved() function is called once after every time a touch move is
* registered. This can be used to attach element specific event listeners.
*
* @method touchMoved
@@ -47622,7 +49964,7 @@ p5.Element.prototype.touchStarted = function (fxn) {
* function setup() {
* cnv = createCanvas(100, 100);
* cnv.touchMoved(changeGray); // attach listener for
- * // canvas click only
+ * // canvas click only
* g = 100;
* }
*
@@ -47640,14 +49982,13 @@ p5.Element.prototype.touchStarted = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.touchMoved = function (fxn) {
+p5.Element.prototype.touchMoved = function(fxn) {
adjustListener('touchmove', fxn, this);
- adjustListener('mousemove', fxn, this);
return this;
};
/**
- * The .touchEnded() function is called once after every time a touch is
+ * The .touchEnded() function is called once after every time a touch is
* registered. This can be used to attach element specific event listeners.
*
* @method touchEnded
@@ -47663,15 +50004,15 @@ p5.Element.prototype.touchMoved = function (fxn) {
* var g;
* function setup() {
* cnv = createCanvas(100, 100);
- * cnv.touchEnded(changeGray); // attach listener for
- * // canvas click only
+ * cnv.touchEnded(changeGray); // attach listener for
+ * // canvas click only
* d = 10;
* g = 100;
* }
*
* function draw() {
* background(g);
- * ellipse(width/2, height/2, d, d);
+ * ellipse(width / 2, height / 2, d, d);
* }
*
* // this function fires with any touch anywhere
@@ -47690,16 +50031,13 @@ p5.Element.prototype.touchMoved = function (fxn) {
* no display.
*
*/
-p5.Element.prototype.touchEnded = function (fxn) {
+p5.Element.prototype.touchEnded = function(fxn) {
adjustListener('touchend', fxn, this);
- adjustListener('mouseup', fxn, this);
return this;
};
-
-
/**
- * The .dragOver() function is called once after every time a
+ * The .dragOver() function is called once after every time a
* file is dragged over the element. This can be used to attach an
* element specific event listener.
*
@@ -47717,7 +50055,7 @@ p5.Element.prototype.touchEnded = function (fxn) {
* var c = createCanvas(100, 100);
* background(200);
* textAlign(CENTER);
- * text('Drag file', width/2, height/2);
+ * text('Drag file', width / 2, height / 2);
* c.dragOver(dragOverCallback);
* }
*
@@ -47725,13 +50063,13 @@ p5.Element.prototype.touchEnded = function (fxn) {
* // a file is dragged over the canvas
* function dragOverCallback() {
* background(240);
- * text('Dragged over', width/2, height/2);
+ * text('Dragged over', width / 2, height / 2);
* }
*
* @alt
* nothing displayed
*/
-p5.Element.prototype.dragOver = function (fxn) {
+p5.Element.prototype.dragOver = function(fxn) {
adjustListener('dragover', fxn, this);
return this;
};
@@ -47755,7 +50093,7 @@ p5.Element.prototype.dragOver = function (fxn) {
* var c = createCanvas(100, 100);
* background(200);
* textAlign(CENTER);
- * text('Drag file', width/2, height/2);
+ * text('Drag file', width / 2, height / 2);
* c.dragLeave(dragLeaveCallback);
* }
*
@@ -47763,27 +50101,27 @@ p5.Element.prototype.dragOver = function (fxn) {
* // a file is dragged out of the canvas
* function dragLeaveCallback() {
* background(240);
- * text('Dragged off', width/2, height/2);
+ * text('Dragged off', width / 2, height / 2);
* }
*
* @alt
* nothing displayed
*/
-p5.Element.prototype.dragLeave = function (fxn) {
+p5.Element.prototype.dragLeave = function(fxn) {
adjustListener('dragleave', fxn, this);
return this;
};
/**
- * The .drop() function is called for each file dropped on the element.
+ * The .drop() function is called for each file dropped on the element.
* It requires a callback that is passed a p5.File object. You can
* optionally pass two callbacks, the first one (required) is triggered
* for each file dropped when the file is loaded. The second (optional)
* is triggered just once when a file (or files) are dropped.
*
* @method drop
- * @param {Function|Boolean} callback callback triggered when files are dropped.
- * @param {Function|Boolean} fxn callback to receive loaded file.
+ * @param {Function} callback callback triggered when files are dropped.
+ * @param {Function} [fxn] callback to receive loaded file.
* @chainable
* @example
*
@@ -47791,22 +50129,43 @@ p5.Element.prototype.dragLeave = function (fxn) {
* var c = createCanvas(100, 100);
* background(200);
* textAlign(CENTER);
- * text('drop image', width/2, height/2);
+ * text('drop file', width / 2, height / 2);
* c.drop(gotFile);
* }
*
* function gotFile(file) {
- * var img = createImg(file.data).hide();
- * // Draw the image onto the canvas
- * image(img, 0, 0, width, height);
+ * background(200);
+ * text('received file:', width / 2, height / 2);
+ * text(file.name, width / 2, height / 2 + 50);
+ * }
+ *
+ *
+ *
+ * var img;
+ *
+ * function setup() {
+ * var c = createCanvas(100, 100);
+ * background(200);
+ * textAlign(CENTER);
+ * text('drop image', width / 2, height / 2);
+ * c.drop(gotFile);
+ * }
+ *
+ * function draw() {
+ * if (img) {
+ * image(img, 0, 0, width, height);
+ * }
+ * }
+ *
+ * function gotFile(file) {
+ * img = createImg(file.data).hide();
* }
*
*
* @alt
* Canvas turns into whatever image is dragged/dropped onto it.
- *
*/
-p5.Element.prototype.drop = function (callback, fxn) {
+p5.Element.prototype.drop = function(callback, fxn) {
// Make a file loader callback and trigger user's callback
function makeLoader(theFile) {
// Making a p5.File object
@@ -47819,50 +50178,59 @@ p5.Element.prototype.drop = function (callback, fxn) {
// Is the file stuff supported?
if (window.File && window.FileReader && window.FileList && window.Blob) {
-
// If you want to be able to drop you've got to turn off
// a lot of default behavior
- attachListener('dragover',function(evt) {
- evt.stopPropagation();
- evt.preventDefault();
- },this);
+ attachListener(
+ 'dragover',
+ function(evt) {
+ evt.stopPropagation();
+ evt.preventDefault();
+ },
+ this
+ );
// If this is a drag area we need to turn off the default behavior
- attachListener('dragleave',function(evt) {
- evt.stopPropagation();
- evt.preventDefault();
- },this);
+ attachListener(
+ 'dragleave',
+ function(evt) {
+ evt.stopPropagation();
+ evt.preventDefault();
+ },
+ this
+ );
// If just one argument it's the callback for the files
- if (arguments.length > 1) {
+ if (typeof fxn !== 'undefined') {
attachListener('drop', fxn, this);
}
// Deal with the files
- attachListener('drop', function(evt) {
-
- evt.stopPropagation();
- evt.preventDefault();
-
- // A FileList
- var files = evt.dataTransfer.files;
-
- // Load each one and trigger the callback
- for (var i = 0; i < files.length; i++) {
- var f = files[i];
- var reader = new FileReader();
- reader.onload = makeLoader(f);
-
-
- // Text or data?
- // This should likely be improved
- if (f.type.indexOf('text') > -1) {
- reader.readAsText(f);
- } else {
- reader.readAsDataURL(f);
+ attachListener(
+ 'drop',
+ function(evt) {
+ evt.stopPropagation();
+ evt.preventDefault();
+
+ // A FileList
+ var files = evt.dataTransfer.files;
+
+ // Load each one and trigger the callback
+ for (var i = 0; i < files.length; i++) {
+ var f = files[i];
+ var reader = new FileReader();
+ reader.onload = makeLoader(f);
+
+ // Text or data?
+ // This should likely be improved
+ if (f.type.indexOf('text') > -1) {
+ reader.readAsText(f);
+ } else {
+ reader.readAsDataURL(f);
+ }
}
- }
- }, this);
+ },
+ this
+ );
} else {
console.log('The File APIs are not fully supported in this browser.');
}
@@ -47874,8 +50242,7 @@ p5.Element.prototype.drop = function (callback, fxn) {
function adjustListener(ev, fxn, ctx) {
if (fxn === false) {
detachListener(ev, ctx);
- }
- else {
+ } else {
attachListener(ev, fxn, ctx);
}
return this;
@@ -47905,21 +50272,22 @@ function detachListener(ev, ctx) {
* Helper fxn for sharing pixel methods
*
*/
-p5.Element.prototype._setProperty = function (prop, value) {
+p5.Element.prototype._setProperty = function(prop, value) {
this[prop] = value;
};
-
module.exports = p5.Element;
-},{"./core":55}],61:[function(_dereq_,module,exports){
+},{"./main":25}],27:[function(_dereq_,module,exports){
/**
* @module Rendering
* @submodule Rendering
* @for p5
*/
-var p5 = _dereq_('./core');
+'use strict';
+
+var p5 = _dereq_('./main');
var constants = _dereq_('./constants');
/**
@@ -47930,7 +50298,6 @@ var constants = _dereq_('./constants');
* extensive, but mirror the normal drawing API for p5.
*
* @class p5.Graphics
- * @constructor
* @extends p5.Element
* @param {Number} w width
* @param {Number} h height
@@ -47938,15 +50305,26 @@ var constants = _dereq_('./constants');
* @param {p5} [pInst] pointer to p5 instance
*/
p5.Graphics = function(w, h, renderer, pInst) {
-
var r = renderer || constants.P2D;
this.canvas = document.createElement('canvas');
- var node = this._userNode || document.body;
+ var node = pInst._userNode || document.body;
node.appendChild(this.canvas);
p5.Element.call(this, this.canvas, pInst, false);
- this._styles = [];
+
+ // bind methods and props of p5 to the new object
+ for (var p in p5.prototype) {
+ if (!this[p]) {
+ if (typeof p5.prototype[p] === 'function') {
+ this[p] = p5.prototype[p].bind(this);
+ } else {
+ this[p] = p5.prototype[p];
+ }
+ }
+ }
+
+ p5.prototype._initializeInstanceVariables.apply(this);
this.width = w;
this.height = h;
this._pixelDensity = pInst._pixelDensity;
@@ -47956,32 +50334,78 @@ p5.Graphics = function(w, h, renderer, pInst) {
} else {
this._renderer = new p5.Renderer2D(this.canvas, this, false);
}
+ pInst._elements.push(this);
this._renderer.resize(w, h);
this._renderer._applyDefaults();
-
- pInst._elements.push(this);
-
- // bind methods and props of p5 to the new object
- for (var p in p5.prototype) {
- if (!this[p]) {
- if (typeof p5.prototype[p] === 'function') {
- this[p] = p5.prototype[p].bind(this);
- } else {
- this[p] = p5.prototype[p];
- }
- }
- }
- this.name = 'p5.Graphics'; // for friendly debugger system
return this;
};
p5.Graphics.prototype = Object.create(p5.Element.prototype);
+/**
+ * Removes a Graphics object from the page and frees any resources
+ * associated with it.
+ *
+ * @method remove
+ *
+ * @example
+ *
+ * var bg;
+ * function setup() {
+ * bg = createCanvas(100, 100);
+ * bg.background(0);
+ * image(bg, 0, 0);
+ * bg.remove();
+ * }
+ *
+ *
+ *
+ * var bg;
+ * function setup() {
+ * pixelDensity(1);
+ * createCanvas(100, 100);
+ * stroke(255);
+ * fill(0);
+ *
+ * // create and draw the background image
+ * bg = createGraphics(100, 100);
+ * bg.background(200);
+ * bg.ellipse(50, 50, 80, 80);
+ * }
+ * function draw() {
+ * var t = millis() / 1000;
+ * // draw the background
+ * if (bg) {
+ * image(bg, frameCount % 100, 0);
+ * image(bg, frameCount % 100 - 100, 0);
+ * }
+ * // draw the foreground
+ * var p = p5.Vector.fromAngle(t, 35).add(50, 50);
+ * ellipse(p.x, p.y, 30);
+ * }
+ * function mouseClicked() {
+ * // remove the background
+ * if (bg) {
+ * bg.remove();
+ * bg = null;
+ * }
+ * }
+ *
+ *
+ * @alt
+ * no image
+ * a multi-colored circle moving back and forth over a scrolling background.
+ *
+ */
p5.Graphics.prototype.remove = function() {
if (this.elt.parentNode) {
this.elt.parentNode.removeChild(this.elt);
}
+ var idx = this._pInst._elements.indexOf(this);
+ if (idx !== -1) {
+ this._pInst._elements.splice(idx, 1);
+ }
for (var elt_ev in this._events) {
this.elt.removeEventListener(elt_ev, this._events[elt_ev]);
}
@@ -47989,14 +50413,16 @@ p5.Graphics.prototype.remove = function() {
module.exports = p5.Graphics;
-},{"./constants":54,"./core":55}],62:[function(_dereq_,module,exports){
+},{"./constants":19,"./main":25}],28:[function(_dereq_,module,exports){
/**
* @module Rendering
* @submodule Rendering
* @for p5
*/
-var p5 = _dereq_('./core');
+'use strict';
+
+var p5 = _dereq_('./main');
var constants = _dereq_('../core/constants');
/**
@@ -48013,9 +50439,7 @@ var constants = _dereq_('../core/constants');
*/
p5.Renderer = function(elt, pInst, isMainCanvas) {
p5.Element.call(this, elt, pInst);
- this.name = 'p5.Renderer'; // for friendly debugger system
this.canvas = elt;
- this._pInst = pInst;
if (isMainCanvas) {
this._isMainCanvas = true;
// for pixel method sharing with pimage
@@ -48023,19 +50447,20 @@ p5.Renderer = function(elt, pInst, isMainCanvas) {
this._pInst._setProperty('canvas', this.canvas);
this._pInst._setProperty('width', this.width);
this._pInst._setProperty('height', this.height);
- } else { // hide if offscreen buffer by default
+ } else {
+ // hide if offscreen buffer by default
this.canvas.style.display = 'none';
this._styles = []; // non-main elt styles stored in p5.Renderer
}
-
this._textSize = 12;
this._textLeading = 15;
this._textFont = 'sans-serif';
this._textStyle = constants.NORMAL;
this._textAscent = null;
this._textDescent = null;
-
+ this._textAlign = constants.LEFT;
+ this._textBaseline = constants.BASELINE;
this._rectMode = constants.CORNER;
this._ellipseMode = constants.CENTER;
@@ -48047,19 +50472,42 @@ p5.Renderer = function(elt, pInst, isMainCanvas) {
this._doFill = true;
this._strokeSet = false;
this._fillSet = false;
- this._colorMode = constants.RGB;
- this._colorMaxes = {
- rgb: [255, 255, 255, 255],
- hsb: [360, 100, 100, 1],
- hsl: [360, 100, 100, 1]
- };
-
};
p5.Renderer.prototype = Object.create(p5.Element.prototype);
+// the renderer should return a 'style' object that it wishes to
+// store on the push stack.
+p5.Renderer.prototype.push = function() {
+ return {
+ properties: {
+ _doStroke: this._doStroke,
+ _strokeSet: this._strokeSet,
+ _doFill: this._doFill,
+ _fillSet: this._fillSet,
+ _tint: this._tint,
+ _imageMode: this._imageMode,
+ _rectMode: this._rectMode,
+ _ellipseMode: this._ellipseMode,
+ _textFont: this._textFont,
+ _textLeading: this._textLeading,
+ _textSize: this._textSize,
+ _textAlign: this._textAlign,
+ _textBaseline: this._textBaseline,
+ _textStyle: this._textStyle
+ }
+ };
+};
-
+// a pop() operation is in progress
+// the renderer is passed the 'style' object that it returned
+// from its push() method.
+p5.Renderer.prototype.pop = function(style) {
+ if (style.properties) {
+ // copy the style properties back into the renderer
+ Object.assign(this, style.properties);
+ }
+};
/**
* Resize our canvas element.
@@ -48069,7 +50517,7 @@ p5.Renderer.prototype.resize = function(w, h) {
this.height = h;
this.elt.width = w * this._pInst._pixelDensity;
this.elt.height = h * this._pInst._pixelDensity;
- this.elt.style.width = w +'px';
+ this.elt.style.width = w + 'px';
this.elt.style.height = h + 'px';
if (this._isMainCanvas) {
this._pInst._setProperty('width', this.width);
@@ -48078,20 +50526,16 @@ p5.Renderer.prototype.resize = function(w, h) {
};
p5.Renderer.prototype.textLeading = function(l) {
-
- if (arguments.length && arguments[0]) {
-
+ if (typeof l === 'number') {
this._setProperty('_textLeading', l);
- return this;
+ return this._pInst;
}
return this._textLeading;
};
p5.Renderer.prototype.textSize = function(s) {
-
- if (arguments.length && arguments[0]) {
-
+ if (typeof s === 'number') {
this._setProperty('_textSize', s);
this._setProperty('_textLeading', s * constants._DEFAULT_LEADMULT);
return this._applyTextProperties();
@@ -48101,12 +50545,12 @@ p5.Renderer.prototype.textSize = function(s) {
};
p5.Renderer.prototype.textStyle = function(s) {
-
- if (arguments.length && arguments[0]) {
-
- if (s === constants.NORMAL ||
+ if (s) {
+ if (
+ s === constants.NORMAL ||
s === constants.ITALIC ||
- s === constants.BOLD) {
+ s === constants.BOLD
+ ) {
this._setProperty('_textStyle', s);
}
@@ -48124,14 +50568,148 @@ p5.Renderer.prototype.textAscent = function() {
};
p5.Renderer.prototype.textDescent = function() {
-
if (this._textDescent === null) {
this._updateTextMetrics();
}
return this._textDescent;
};
-p5.Renderer.prototype._applyDefaults = function(){
+p5.Renderer.prototype.textAlign = function(h, v) {
+ if (typeof h !== 'undefined') {
+ this._setProperty('_textAlign', h);
+
+ if (typeof v !== 'undefined') {
+ this._setProperty('_textBaseline', v);
+ }
+
+ return this._applyTextProperties();
+ } else {
+ return {
+ horizontal: this._textAlign,
+ vertical: this._textBaseline
+ };
+ }
+};
+
+p5.Renderer.prototype.text = function(str, x, y, maxWidth, maxHeight) {
+ var p = this._pInst,
+ cars,
+ n,
+ ii,
+ jj,
+ line,
+ testLine,
+ testWidth,
+ words,
+ totalHeight,
+ finalMaxHeight = Number.MAX_VALUE;
+
+ if (!(this._doFill || this._doStroke)) {
+ return;
+ }
+
+ if (typeof str === 'undefined') {
+ return;
+ } else if (typeof str !== 'string') {
+ str = str.toString();
+ }
+
+ str = str.replace(/(\t)/g, ' ');
+ cars = str.split('\n');
+
+ if (typeof maxWidth !== 'undefined') {
+ totalHeight = 0;
+ for (ii = 0; ii < cars.length; ii++) {
+ line = '';
+ words = cars[ii].split(' ');
+ for (n = 0; n < words.length; n++) {
+ testLine = line + words[n] + ' ';
+ testWidth = this.textWidth(testLine);
+ if (testWidth > maxWidth) {
+ line = words[n] + ' ';
+ totalHeight += p.textLeading();
+ } else {
+ line = testLine;
+ }
+ }
+ }
+
+ if (this._rectMode === constants.CENTER) {
+ x -= maxWidth / 2;
+ y -= maxHeight / 2;
+ }
+
+ switch (this._textAlign) {
+ case constants.CENTER:
+ x += maxWidth / 2;
+ break;
+ case constants.RIGHT:
+ x += maxWidth;
+ break;
+ }
+
+ var baselineHacked = false;
+ if (typeof maxHeight !== 'undefined') {
+ switch (this._textBaseline) {
+ case constants.BOTTOM:
+ y += maxHeight - totalHeight;
+ break;
+ case constants.CENTER:
+ y += (maxHeight - totalHeight) / 2;
+ break;
+ case constants.BASELINE:
+ baselineHacked = true;
+ this._textBaseline = constants.TOP;
+ break;
+ }
+
+ // remember the max-allowed y-position for any line (fix to #928)
+ finalMaxHeight = y + maxHeight - p.textAscent();
+ }
+
+ for (ii = 0; ii < cars.length; ii++) {
+ line = '';
+ words = cars[ii].split(' ');
+ for (n = 0; n < words.length; n++) {
+ testLine = line + words[n] + ' ';
+ testWidth = this.textWidth(testLine);
+ if (testWidth > maxWidth && line.length > 0) {
+ this._renderText(p, line, x, y, finalMaxHeight);
+ line = words[n] + ' ';
+ y += p.textLeading();
+ } else {
+ line = testLine;
+ }
+ }
+
+ this._renderText(p, line, x, y, finalMaxHeight);
+ y += p.textLeading();
+
+ if (baselineHacked) {
+ this._textBaseline = constants.BASELINE;
+ }
+ }
+ } else {
+ // Offset to account for vertically centering multiple lines of text - no
+ // need to adjust anything for vertical align top or baseline
+ var offset = 0,
+ vAlign = p.textAlign().vertical;
+ if (vAlign === constants.CENTER) {
+ offset = (cars.length - 1) * p.textLeading() / 2;
+ } else if (vAlign === constants.BOTTOM) {
+ offset = (cars.length - 1) * p.textLeading();
+ }
+
+ for (jj = 0; jj < cars.length; jj++) {
+ this._renderText(p, cars[jj], x, y - offset, finalMaxHeight);
+ y += p.textLeading();
+ }
+ }
+
+ return p;
+};
+
+p5.Renderer.prototype._applyDefaults = function() {
return this;
};
@@ -48139,15 +50717,12 @@ p5.Renderer.prototype._applyDefaults = function(){
* Helper fxn to check font type (system or otf)
*/
p5.Renderer.prototype._isOpenType = function(f) {
-
f = f || this._textFont;
- return (typeof f === 'object' && f.font && f.font.supported);
+ return typeof f === 'object' && f.font && f.font.supported;
};
p5.Renderer.prototype._updateTextMetrics = function() {
-
if (this._isOpenType()) {
-
this._setProperty('_textAscent', this._textFont._textAscent());
this._setProperty('_textDescent', this._textFont._textDescent());
return this;
@@ -48202,7 +50777,7 @@ function calculateOffset(object) {
do {
currentLeft += object.offsetLeft;
currentTop += object.offsetTop;
- } while (object = object.offsetParent);
+ } while ((object = object.offsetParent));
} else {
currentLeft += object.offsetLeft;
currentTop += object.offsetTop;
@@ -48212,10 +50787,10 @@ function calculateOffset(object) {
module.exports = p5.Renderer;
-},{"../core/constants":54,"./core":55}],63:[function(_dereq_,module,exports){
+},{"../core/constants":19,"./main":25}],29:[function(_dereq_,module,exports){
+'use strict';
-var p5 = _dereq_('./core');
-var canvas = _dereq_('./canvas');
+var p5 = _dereq_('./main');
var constants = _dereq_('./constants');
var filters = _dereq_('../image/filters');
@@ -48229,9 +50804,8 @@ _dereq_('./p5.Renderer');
var styleEmpty = 'rgba(0,0,0,0)';
// var alphaThreshold = 0.00125; // minimum visible
-p5.Renderer2D = function(elt, pInst, isMainCanvas){
+p5.Renderer2D = function(elt, pInst, isMainCanvas) {
p5.Renderer.call(this, elt, pInst, isMainCanvas);
- this.name = 'p5.Renderer2D'; // for friendly debugger system
this.drawingContext = this.canvas.getContext('2d');
this._pInst._setProperty('drawingContext', this.drawingContext);
return this;
@@ -48247,10 +50821,12 @@ p5.Renderer2D.prototype._applyDefaults = function() {
this.drawingContext.font = 'normal 12px sans-serif';
};
-p5.Renderer2D.prototype.resize = function(w,h) {
- p5.Renderer.prototype.resize.call(this, w,h);
- this.drawingContext.scale(this._pInst._pixelDensity,
- this._pInst._pixelDensity);
+p5.Renderer2D.prototype.resize = function(w, h) {
+ p5.Renderer.prototype.resize.call(this, w, h);
+ this.drawingContext.scale(
+ this._pInst._pixelDensity,
+ this._pInst._pixelDensity
+ );
};
//////////////////////////////////////////////
@@ -48259,16 +50835,14 @@ p5.Renderer2D.prototype.resize = function(w,h) {
p5.Renderer2D.prototype.background = function() {
this.drawingContext.save();
- this.drawingContext.setTransform(1, 0, 0, 1, 0, 0);
- this.drawingContext.scale(this._pInst._pixelDensity,
- this._pInst._pixelDensity);
+ this.resetMatrix();
if (arguments[0] instanceof p5.Image) {
this._pInst.image(arguments[0], 0, 0, this.width, this.height);
} else {
var curFill = this._getFill();
// create background rect
- var color = this._pInst.color.apply(this, arguments);
+ var color = this._pInst.color.apply(this._pInst, arguments);
var newFill = color.toString();
this._setFill(newFill);
this.drawingContext.fillRect(0, 0, this.width, this.height);
@@ -48276,19 +50850,26 @@ p5.Renderer2D.prototype.background = function() {
this._setFill(curFill);
}
this.drawingContext.restore();
+
+ this._pInst._pixelsDirty = true;
};
p5.Renderer2D.prototype.clear = function() {
+ this.drawingContext.save();
+ this.resetMatrix();
this.drawingContext.clearRect(0, 0, this.width, this.height);
+ this.drawingContext.restore();
+
+ this._pInst._pixelsDirty = true;
};
p5.Renderer2D.prototype.fill = function() {
- var color = this._pInst.color.apply(this, arguments);
+ var color = this._pInst.color.apply(this._pInst, arguments);
this._setFill(color.toString());
};
p5.Renderer2D.prototype.stroke = function() {
- var color = this._pInst.color.apply(this, arguments);
+ var color = this._pInst.color.apply(this._pInst, arguments);
this._setStroke(color.toString());
};
@@ -48296,8 +50877,17 @@ p5.Renderer2D.prototype.stroke = function() {
// IMAGE | Loading & Displaying
//////////////////////////////////////////////
-p5.Renderer2D.prototype.image =
- function (img, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight) {
+p5.Renderer2D.prototype.image = function(
+ img,
+ sx,
+ sy,
+ sWidth,
+ sHeight,
+ dx,
+ dy,
+ dWidth,
+ dHeight
+) {
var cnv;
try {
if (this._tint) {
@@ -48311,16 +50901,31 @@ p5.Renderer2D.prototype.image =
if (!cnv) {
cnv = img.canvas || img.elt;
}
- this.drawingContext.drawImage(cnv, sx, sy, sWidth, sHeight, dx, dy,
- dWidth, dHeight);
+ var s = 1;
+ if (img.width && img.width > 0) {
+ s = cnv.width / img.width;
+ }
+ this.drawingContext.drawImage(
+ cnv,
+ s * sx,
+ s * sy,
+ s * sWidth,
+ s * sHeight,
+ dx,
+ dy,
+ dWidth,
+ dHeight
+ );
} catch (e) {
if (e.name !== 'NS_ERROR_NOT_AVAILABLE') {
throw e;
}
}
+
+ this._pInst._pixelsDirty = true;
};
-p5.Renderer2D.prototype._getTintedImageCanvas = function (img) {
+p5.Renderer2D.prototype._getTintedImageCanvas = function(img) {
if (!img.canvas) {
return img;
}
@@ -48345,7 +50950,6 @@ p5.Renderer2D.prototype._getTintedImageCanvas = function (img) {
return tmpCanvas;
};
-
//////////////////////////////////////////////
// IMAGE | Pixels
//////////////////////////////////////////////
@@ -48357,11 +50961,7 @@ p5.Renderer2D.prototype.blend = function() {
var currBlend = this.drawingContext.globalCompositeOperation;
var blendMode = arguments[arguments.length - 1];
- var copyArgs = Array.prototype.slice.call(
- arguments,
- 0,
- arguments.length - 1
- );
+ var copyArgs = Array.prototype.slice.call(arguments, 0, arguments.length - 1);
this.drawingContext.globalCompositeOperation = blendMode;
if (this._pInst) {
@@ -48372,7 +50972,7 @@ p5.Renderer2D.prototype.blend = function() {
this.drawingContext.globalCompositeOperation = currBlend;
};
-p5.Renderer2D.prototype.copy = function () {
+p5.Renderer2D.prototype.copy = function() {
var srcImage, sx, sy, sw, sh, dx, dy, dw, dh;
if (arguments.length === 9) {
srcImage = arguments[0];
@@ -48397,37 +50997,56 @@ p5.Renderer2D.prototype.copy = function () {
} else {
throw new Error('Signature not supported');
}
- p5.Renderer2D._copyHelper(srcImage, sx, sy, sw, sh, dx, dy, dw, dh);
+ p5.Renderer2D._copyHelper(this, srcImage, sx, sy, sw, sh, dx, dy, dw, dh);
+
+ this._pInst._pixelsDirty = true;
};
-p5.Renderer2D._copyHelper =
-function (srcImage, sx, sy, sw, sh, dx, dy, dw, dh) {
+p5.Renderer2D._copyHelper = function(
+ dstImage,
+ srcImage,
+ sx,
+ sy,
+ sw,
+ sh,
+ dx,
+ dy,
+ dw,
+ dh
+) {
srcImage.loadPixels();
var s = srcImage.canvas.width / srcImage.width;
- this.drawingContext.drawImage(srcImage.canvas,
- s * sx, s * sy, s * sw, s * sh, dx, dy, dw, dh);
+ dstImage.drawingContext.drawImage(
+ srcImage.canvas,
+ s * sx,
+ s * sy,
+ s * sw,
+ s * sh,
+ dx,
+ dy,
+ dw,
+ dh
+ );
};
p5.Renderer2D.prototype.get = function(x, y, w, h) {
- if (x === undefined && y === undefined &&
- w === undefined && h === undefined){
- x = 0;
- y = 0;
- w = this.width;
- h = this.height;
- } else if (w === undefined && h === undefined) {
- w = 1;
- h = 1;
+ if (typeof w === 'undefined' && typeof h === 'undefined') {
+ if (typeof x === 'undefined' && typeof y === 'undefined') {
+ x = y = 0;
+ w = this.width;
+ h = this.height;
+ } else {
+ w = h = 1;
+ }
}
// if the section does not overlap the canvas
- if(x + w < 0 || y + h < 0 || x > this.width || y > this.height){
+ if (x + w < 0 || y + h < 0 || x >= this.width || y >= this.height) {
+ // TODO: is this valid for w,h > 1 ?
return [0, 0, 0, 255];
}
var ctx = this._pInst || this;
- ctx.loadPixels();
-
var pd = ctx._pixelDensity;
// round down to get integer numbers
@@ -48438,14 +51057,20 @@ p5.Renderer2D.prototype.get = function(x, y, w, h) {
var sx = x * pd;
var sy = y * pd;
- if (w === 1 && h === 1 && !(this instanceof p5.RendererGL)){
- var imageData = this.drawingContext.getImageData(sx, sy, 1, 1).data;
- //imageData = [0,0,0,0];
+ if (w === 1 && h === 1 && !(this instanceof p5.RendererGL)) {
+ var imageData, index;
+ if (ctx._pixelsDirty) {
+ imageData = this.drawingContext.getImageData(sx, sy, 1, 1).data;
+ index = 0;
+ } else {
+ imageData = ctx.pixels;
+ index = (sx + sy * this.width * pd) * 4;
+ }
return [
- imageData[0],
- imageData[1],
- imageData[2],
- imageData[3]
+ imageData[index + 0],
+ imageData[index + 1],
+ imageData[index + 2],
+ imageData[index + 3]
];
} else {
//auto constrain the width and height to
@@ -48456,47 +51081,51 @@ p5.Renderer2D.prototype.get = function(x, y, w, h) {
var sh = dh * pd;
var region = new p5.Image(dw, dh);
- region.canvas.getContext('2d').drawImage(this.canvas, sx, sy, sw, sh,
- 0, 0, dw, dh);
+ region.canvas
+ .getContext('2d')
+ .drawImage(this.canvas, sx, sy, sw, sh, 0, 0, dw, dh);
return region;
}
};
-p5.Renderer2D.prototype.loadPixels = function () {
- var pd = this._pixelDensity || this._pInst._pixelDensity;
+p5.Renderer2D.prototype.loadPixels = function() {
+ var ctx = this._pInst || this; // if called by p5.Image
+ if (!ctx._pixelsDirty) return;
+ ctx._pixelsDirty = false;
+
+ var pd = ctx._pixelDensity;
var w = this.width * pd;
var h = this.height * pd;
var imageData = this.drawingContext.getImageData(0, 0, w, h);
// @todo this should actually set pixels per object, so diff buffers can
// have diff pixel arrays.
- if (this._pInst) {
- this._pInst._setProperty('imageData', imageData);
- this._pInst._setProperty('pixels', imageData.data);
- } else { // if called by p5.Image
- this._setProperty('imageData', imageData);
- this._setProperty('pixels', imageData.data);
- }
+ ctx._setProperty('imageData', imageData);
+ ctx._setProperty('pixels', imageData.data);
};
-p5.Renderer2D.prototype.set = function (x, y, imgOrCol) {
+p5.Renderer2D.prototype.set = function(x, y, imgOrCol) {
// round down to get integer numbers
x = Math.floor(x);
y = Math.floor(y);
+ var ctx = this._pInst || this;
if (imgOrCol instanceof p5.Image) {
this.drawingContext.save();
this.drawingContext.setTransform(1, 0, 0, 1, 0, 0);
- this.drawingContext.scale(this._pInst._pixelDensity,
- this._pInst._pixelDensity);
+ this.drawingContext.scale(ctx._pixelDensity, ctx._pixelDensity);
this.drawingContext.drawImage(imgOrCol.canvas, x, y);
- this.loadPixels.call(this._pInst);
this.drawingContext.restore();
+ ctx._pixelsDirty = true;
} else {
- var ctx = this._pInst || this;
- var r = 0, g = 0, b = 0, a = 0;
- var idx = 4*((y * ctx._pixelDensity) *
- (this.width * ctx._pixelDensity) + (x * ctx._pixelDensity));
- if (!ctx.imageData) {
+ var r = 0,
+ g = 0,
+ b = 0,
+ a = 0;
+ var idx =
+ 4 *
+ (y * ctx._pixelDensity * (this.width * ctx._pixelDensity) +
+ x * ctx._pixelDensity);
+ if (!ctx.imageData || ctx._pixelsDirty) {
ctx.loadPixels.call(ctx);
}
if (typeof imgOrCol === 'number') {
@@ -48507,8 +51136,7 @@ p5.Renderer2D.prototype.set = function (x, y, imgOrCol) {
a = 255;
//this.updatePixels.call(this);
}
- }
- else if (imgOrCol instanceof Array) {
+ } else if (imgOrCol instanceof Array) {
if (imgOrCol.length < 4) {
throw new Error('pixel array must be of the form [R, G, B, A]');
}
@@ -48532,23 +51160,28 @@ p5.Renderer2D.prototype.set = function (x, y, imgOrCol) {
for (var i = 0; i < ctx._pixelDensity; i++) {
for (var j = 0; j < ctx._pixelDensity; j++) {
// loop over
- idx = 4*((y * ctx._pixelDensity + j) * this.width *
- ctx._pixelDensity + (x * ctx._pixelDensity + i));
+ idx =
+ 4 *
+ ((y * ctx._pixelDensity + j) * this.width * ctx._pixelDensity +
+ (x * ctx._pixelDensity + i));
ctx.pixels[idx] = r;
- ctx.pixels[idx+1] = g;
- ctx.pixels[idx+2] = b;
- ctx.pixels[idx+3] = a;
+ ctx.pixels[idx + 1] = g;
+ ctx.pixels[idx + 2] = b;
+ ctx.pixels[idx + 3] = a;
}
}
}
};
-p5.Renderer2D.prototype.updatePixels = function (x, y, w, h) {
- var pd = this._pixelDensity || this._pInst._pixelDensity;
- if (x === undefined &&
- y === undefined &&
- w === undefined &&
- h === undefined) {
+p5.Renderer2D.prototype.updatePixels = function(x, y, w, h) {
+ var ctx = this._pInst || this;
+ var pd = ctx._pixelDensity;
+ if (
+ x === undefined &&
+ y === undefined &&
+ w === undefined &&
+ h === undefined
+ ) {
x = 0;
y = 0;
w = this.width;
@@ -48557,10 +51190,10 @@ p5.Renderer2D.prototype.updatePixels = function (x, y, w, h) {
w *= pd;
h *= pd;
- if (this._pInst) {
- this.drawingContext.putImageData(this._pInst.imageData, x, y, 0, 0, w, h);
- } else {
- this.drawingContext.putImageData(this.imageData, x, y, 0, 0, w, h);
+ this.drawingContext.putImageData(ctx.imageData, x, y, 0, 0, w, h);
+
+ if (x !== 0 || y !== 0 || w !== this.width || h !== this.height) {
+ ctx._pixelsDirty = true;
}
};
@@ -48575,14 +51208,16 @@ p5.Renderer2D.prototype.updatePixels = function (x, y, w, h) {
*
* See www.joecridge.me/bezier.pdf for an explanation of the method.
*/
-p5.Renderer2D.prototype._acuteArcToBezier =
- function _acuteArcToBezier(start, size) {
+p5.Renderer2D.prototype._acuteArcToBezier = function _acuteArcToBezier(
+ start,
+ size
+) {
// Evauate constants.
var alpha = size / 2.0,
cos_alpha = Math.cos(alpha),
sin_alpha = Math.sin(alpha),
cot_alpha = 1.0 / Math.tan(alpha),
- phi = start + alpha, // This is how far the arc needs to be rotated.
+ phi = start + alpha, // This is how far the arc needs to be rotated.
cos_phi = Math.cos(phi),
sin_phi = Math.sin(phi),
lambda = (4.0 - cos_alpha) / 3.0,
@@ -48601,18 +51236,19 @@ p5.Renderer2D.prototype._acuteArcToBezier =
};
};
-p5.Renderer2D.prototype.arc =
- function(x, y, w, h, start, stop, mode) {
+p5.Renderer2D.prototype.arc = function(x, y, w, h, start, stop, mode) {
var ctx = this.drawingContext;
- var vals = canvas.arcModeAdjust(x, y, w, h, this._ellipseMode);
- var rx = vals.w / 2.0;
- var ry = vals.h / 2.0;
- var epsilon = 0.00001; // Smallest visible angle on displays up to 4K.
+ var rx = w / 2.0;
+ var ry = h / 2.0;
+ var epsilon = 0.00001; // Smallest visible angle on displays up to 4K.
var arcToDraw = 0;
var curves = [];
+ x += rx;
+ y += ry;
+
// Create curves
- while(stop - start > epsilon) {
+ while (stop - start > epsilon) {
arcToDraw = Math.min(stop - start, constants.HALF_PI);
curves.push(this._acuteArcToBezier(start, arcToDraw));
start += arcToDraw;
@@ -48621,16 +51257,17 @@ p5.Renderer2D.prototype.arc =
// Fill curves
if (this._doFill) {
ctx.beginPath();
- curves.forEach(function (curve, index) {
+ curves.forEach(function(curve, index) {
if (index === 0) {
- ctx.moveTo(vals.x + curve.ax * rx, vals.y + curve.ay * ry);
+ ctx.moveTo(x + curve.ax * rx, y + curve.ay * ry);
}
- ctx.bezierCurveTo(vals.x + curve.bx * rx, vals.y + curve.by * ry,
- vals.x + curve.cx * rx, vals.y + curve.cy * ry,
- vals.x + curve.dx * rx, vals.y + curve.dy * ry);
+ // prettier-ignore
+ ctx.bezierCurveTo(x + curve.bx * rx, y + curve.by * ry,
+ x + curve.cx * rx, y + curve.cy * ry,
+ x + curve.dx * rx, y + curve.dy * ry);
});
if (mode === constants.PIE || mode == null) {
- ctx.lineTo(vals.x, vals.y);
+ ctx.lineTo(x, y);
}
ctx.closePath();
ctx.fill();
@@ -48639,16 +51276,17 @@ p5.Renderer2D.prototype.arc =
// Stroke curves
if (this._doStroke) {
ctx.beginPath();
- curves.forEach(function (curve, index) {
+ curves.forEach(function(curve, index) {
if (index === 0) {
- ctx.moveTo(vals.x + curve.ax * rx, vals.y + curve.ay * ry);
+ ctx.moveTo(x + curve.ax * rx, y + curve.ay * ry);
}
- ctx.bezierCurveTo(vals.x + curve.bx * rx, vals.y + curve.by * ry,
- vals.x + curve.cx * rx, vals.y + curve.cy * ry,
- vals.x + curve.dx * rx, vals.y + curve.dy * ry);
+ // prettier-ignore
+ ctx.bezierCurveTo(x + curve.bx * rx, y + curve.by * ry,
+ x + curve.cx * rx, y + curve.cy * ry,
+ x + curve.dx * rx, y + curve.dy * ry);
});
if (mode === constants.PIE) {
- ctx.lineTo(vals.x, vals.y);
+ ctx.lineTo(x, y);
ctx.closePath();
} else if (mode === constants.CHORD) {
ctx.closePath();
@@ -48660,27 +51298,28 @@ p5.Renderer2D.prototype.arc =
p5.Renderer2D.prototype.ellipse = function(args) {
var ctx = this.drawingContext;
- var doFill = this._doFill, doStroke = this._doStroke;
+ var doFill = this._doFill,
+ doStroke = this._doStroke;
var x = args[0],
y = args[1],
w = args[2],
h = args[3];
if (doFill && !doStroke) {
- if(this._getFill() === styleEmpty) {
+ if (this._getFill() === styleEmpty) {
return this;
}
} else if (!doFill && doStroke) {
- if(this._getStroke() === styleEmpty) {
+ if (this._getStroke() === styleEmpty) {
return this;
}
}
var kappa = 0.5522847498,
- ox = (w / 2) * kappa, // control point offset horizontal
- oy = (h / 2) * kappa, // control point offset vertical
- xe = x + w, // x-end
- ye = y + h, // y-end
- xm = x + w / 2, // x-middle
- ym = y + h / 2; // y-middle
+ ox = w / 2 * kappa, // control point offset horizontal
+ oy = h / 2 * kappa, // control point offset vertical
+ xe = x + w, // x-end
+ ye = y + h, // y-end
+ xm = x + w / 2, // x-middle
+ ym = y + h / 2; // y-middle
ctx.beginPath();
ctx.moveTo(x, ym);
ctx.bezierCurveTo(x, ym - oy, xm - ox, y, xm, y);
@@ -48700,7 +51339,7 @@ p5.Renderer2D.prototype.line = function(x1, y1, x2, y2) {
var ctx = this.drawingContext;
if (!this._doStroke) {
return this;
- } else if(this._getStroke() === styleEmpty){
+ } else if (this._getStroke() === styleEmpty) {
return this;
}
// Translate the line by (0.5, 0.5) to draw it crisp
@@ -48721,7 +51360,7 @@ p5.Renderer2D.prototype.point = function(x, y) {
var ctx = this.drawingContext;
if (!this._doStroke) {
return this;
- } else if(this._getStroke() === styleEmpty){
+ } else if (this._getStroke() === styleEmpty) {
return this;
}
var s = this._getStroke();
@@ -48732,14 +51371,7 @@ p5.Renderer2D.prototype.point = function(x, y) {
this._setFill(s);
if (ctx.lineWidth > 1) {
ctx.beginPath();
- ctx.arc(
- x,
- y,
- ctx.lineWidth / 2,
- 0,
- constants.TWO_PI,
- false
- );
+ ctx.arc(x, y, ctx.lineWidth / 2, 0, constants.TWO_PI, false);
ctx.fill();
} else {
ctx.fillRect(x, y, 1, 1);
@@ -48747,16 +51379,16 @@ p5.Renderer2D.prototype.point = function(x, y) {
this._setFill(f);
};
-p5.Renderer2D.prototype.quad =
- function(x1, y1, x2, y2, x3, y3, x4, y4) {
+p5.Renderer2D.prototype.quad = function(x1, y1, x2, y2, x3, y3, x4, y4) {
var ctx = this.drawingContext;
- var doFill = this._doFill, doStroke = this._doStroke;
+ var doFill = this._doFill,
+ doStroke = this._doStroke;
if (doFill && !doStroke) {
- if(this._getFill() === styleEmpty) {
+ if (this._getFill() === styleEmpty) {
return this;
}
} else if (!doFill && doStroke) {
- if(this._getStroke() === styleEmpty) {
+ if (this._getStroke() === styleEmpty) {
return this;
}
}
@@ -48785,13 +51417,14 @@ p5.Renderer2D.prototype.rect = function(args) {
br = args[6],
bl = args[7];
var ctx = this.drawingContext;
- var doFill = this._doFill, doStroke = this._doStroke;
+ var doFill = this._doFill,
+ doStroke = this._doStroke;
if (doFill && !doStroke) {
- if(this._getFill() === styleEmpty) {
+ if (this._getFill() === styleEmpty) {
return this;
}
} else if (!doFill && doStroke) {
- if(this._getStroke() === styleEmpty) {
+ if (this._getStroke() === styleEmpty) {
return this;
}
}
@@ -48807,22 +51440,44 @@ p5.Renderer2D.prototype.rect = function(args) {
} else {
// At least one rounded corner
// Set defaults when not specified
- if (typeof tr === 'undefined') { tr = tl; }
- if (typeof br === 'undefined') { br = tr; }
- if (typeof bl === 'undefined') { bl = br; }
+ if (typeof tr === 'undefined') {
+ tr = tl;
+ }
+ if (typeof br === 'undefined') {
+ br = tr;
+ }
+ if (typeof bl === 'undefined') {
+ bl = br;
+ }
var hw = w / 2;
var hh = h / 2;
// Clip radii
- if (w < 2 * tl) { tl = hw; }
- if (h < 2 * tl) { tl = hh; }
- if (w < 2 * tr) { tr = hw; }
- if (h < 2 * tr) { tr = hh; }
- if (w < 2 * br) { br = hw; }
- if (h < 2 * br) { br = hh; }
- if (w < 2 * bl) { bl = hw; }
- if (h < 2 * bl) { bl = hh; }
+ if (w < 2 * tl) {
+ tl = hw;
+ }
+ if (h < 2 * tl) {
+ tl = hh;
+ }
+ if (w < 2 * tr) {
+ tr = hw;
+ }
+ if (h < 2 * tr) {
+ tr = hh;
+ }
+ if (w < 2 * br) {
+ br = hw;
+ }
+ if (h < 2 * br) {
+ br = hh;
+ }
+ if (w < 2 * bl) {
+ bl = hw;
+ }
+ if (h < 2 * bl) {
+ bl = hh;
+ }
// Draw shape
ctx.beginPath();
@@ -48847,16 +51502,20 @@ p5.Renderer2D.prototype.rect = function(args) {
p5.Renderer2D.prototype.triangle = function(args) {
var ctx = this.drawingContext;
- var doFill = this._doFill, doStroke = this._doStroke;
- var x1=args[0], y1=args[1];
- var x2=args[2], y2=args[3];
- var x3=args[4], y3=args[5];
+ var doFill = this._doFill,
+ doStroke = this._doStroke;
+ var x1 = args[0],
+ y1 = args[1];
+ var x2 = args[2],
+ y2 = args[3];
+ var x3 = args[4],
+ y3 = args[5];
if (doFill && !doStroke) {
- if(this._getFill() === styleEmpty) {
+ if (this._getFill() === styleEmpty) {
return this;
}
} else if (!doFill && doStroke) {
- if(this._getStroke() === styleEmpty) {
+ if (this._getStroke() === styleEmpty) {
return this;
}
}
@@ -48873,9 +51532,15 @@ p5.Renderer2D.prototype.triangle = function(args) {
}
};
-p5.Renderer2D.prototype.endShape =
-function (mode, vertices, isCurve, isBezier,
- isQuadratic, isContour, shapeKind) {
+p5.Renderer2D.prototype.endShape = function(
+ mode,
+ vertices,
+ isCurve,
+ isBezier,
+ isQuadratic,
+ isContour,
+ shapeKind
+) {
if (vertices.length === 0) {
return this;
}
@@ -48891,37 +51556,41 @@ function (mode, vertices, isCurve, isBezier,
var numVerts = vertices.length;
if (isCurve && (shapeKind === constants.POLYGON || shapeKind === null)) {
if (numVerts > 3) {
- var b = [], s = 1 - this._curveTightness;
+ var b = [],
+ s = 1 - this._curveTightness;
this.drawingContext.beginPath();
this.drawingContext.moveTo(vertices[1][0], vertices[1][1]);
for (i = 1; i + 2 < numVerts; i++) {
v = vertices[i];
- b[0] = [
- v[0],
- v[1]
- ];
+ b[0] = [v[0], v[1]];
b[1] = [
v[0] + (s * vertices[i + 1][0] - s * vertices[i - 1][0]) / 6,
v[1] + (s * vertices[i + 1][1] - s * vertices[i - 1][1]) / 6
];
b[2] = [
vertices[i + 1][0] +
- (s * vertices[i][0]-s * vertices[i + 2][0]) / 6,
- vertices[i + 1][1]+(s * vertices[i][1] - s*vertices[i + 2][1]) / 6
+ (s * vertices[i][0] - s * vertices[i + 2][0]) / 6,
+ vertices[i + 1][1] + (s * vertices[i][1] - s * vertices[i + 2][1]) / 6
];
- b[3] = [
- vertices[i + 1][0],
- vertices[i + 1][1]
- ];
- this.drawingContext.bezierCurveTo(b[1][0],b[1][1],
- b[2][0],b[2][1],b[3][0],b[3][1]);
+ b[3] = [vertices[i + 1][0], vertices[i + 1][1]];
+ this.drawingContext.bezierCurveTo(
+ b[1][0],
+ b[1][1],
+ b[2][0],
+ b[2][1],
+ b[3][0],
+ b[3][1]
+ );
}
if (closeShape) {
this.drawingContext.lineTo(vertices[i + 1][0], vertices[i + 1][1]);
}
this._doFillStrokeClose();
}
- } else if (isBezier&&(shapeKind===constants.POLYGON ||shapeKind === null)) {
+ } else if (
+ isBezier &&
+ (shapeKind === constants.POLYGON || shapeKind === null)
+ ) {
this.drawingContext.beginPath();
for (i = 0; i < numVerts; i++) {
if (vertices[i].isVert) {
@@ -48931,13 +51600,21 @@ function (mode, vertices, isCurve, isBezier,
this.drawingContext.lineTo(vertices[i][0], vertices[i][1]);
}
} else {
- this.drawingContext.bezierCurveTo(vertices[i][0], vertices[i][1],
- vertices[i][2], vertices[i][3], vertices[i][4], vertices[i][5]);
+ this.drawingContext.bezierCurveTo(
+ vertices[i][0],
+ vertices[i][1],
+ vertices[i][2],
+ vertices[i][3],
+ vertices[i][4],
+ vertices[i][5]
+ );
}
}
this._doFillStrokeClose();
- } else if (isQuadratic &&
- (shapeKind === constants.POLYGON || shapeKind === null)) {
+ } else if (
+ isQuadratic &&
+ (shapeKind === constants.POLYGON || shapeKind === null)
+ ) {
this.drawingContext.beginPath();
for (i = 0; i < numVerts; i++) {
if (vertices[i].isVert) {
@@ -48947,8 +51624,12 @@ function (mode, vertices, isCurve, isBezier,
this.drawingContext.lineTo(vertices[i][0], vertices[i][1]);
}
} else {
- this.drawingContext.quadraticCurveTo(vertices[i][0], vertices[i][1],
- vertices[i][2], vertices[i][3]);
+ this.drawingContext.quadraticCurveTo(
+ vertices[i][0],
+ vertices[i][1],
+ vertices[i][2],
+ vertices[i][3]
+ );
}
}
this._doFillStrokeClose();
@@ -48976,7 +51657,7 @@ function (mode, vertices, isCurve, isBezier,
this.drawingContext.moveTo(v[0], v[1]);
this.drawingContext.lineTo(vertices[i + 1][0], vertices[i + 1][1]);
this.drawingContext.lineTo(vertices[i + 2][0], vertices[i + 2][1]);
- this.drawingContext.lineTo(v[0], v[1]);
+ this.drawingContext.closePath();
if (this._doFill) {
this._pInst.fill(vertices[i + 2][5]);
this.drawingContext.fill();
@@ -48985,7 +51666,6 @@ function (mode, vertices, isCurve, isBezier,
this._pInst.stroke(vertices[i + 2][6]);
this.drawingContext.stroke();
}
- this.drawingContext.closePath();
}
} else if (shapeKind === constants.TRIANGLE_STRIP) {
for (i = 0; i + 1 < numVerts; i++) {
@@ -49023,8 +51703,10 @@ function (mode, vertices, isCurve, isBezier,
this.drawingContext.lineTo(vertices[0][0], vertices[0][1]);
// If the next colour is going to be different, stroke / fill now
if (i < numVerts - 1) {
- if ( (this._doFill && v[5] !== vertices[i + 1][5]) ||
- (this._doStroke && v[6] !== vertices[i + 1][6])) {
+ if (
+ (this._doFill && v[5] !== vertices[i + 1][5]) ||
+ (this._doStroke && v[6] !== vertices[i + 1][6])
+ ) {
if (this._doFill) {
this._pInst.fill(v[5]);
this.drawingContext.fill();
@@ -49065,10 +51747,10 @@ function (mode, vertices, isCurve, isBezier,
v = vertices[i];
this.drawingContext.beginPath();
if (i + 3 < numVerts) {
- this.drawingContext.moveTo(vertices[i + 2][0], vertices[i+2][1]);
+ this.drawingContext.moveTo(vertices[i + 2][0], vertices[i + 2][1]);
this.drawingContext.lineTo(v[0], v[1]);
- this.drawingContext.lineTo(vertices[i + 1][0], vertices[i+1][1]);
- this.drawingContext.lineTo(vertices[i + 3][0], vertices[i+3][1]);
+ this.drawingContext.lineTo(vertices[i + 1][0], vertices[i + 1][1]);
+ this.drawingContext.lineTo(vertices[i + 3][0], vertices[i + 3][1]);
if (this._doFill) {
this._pInst.fill(vertices[i + 3][5]);
}
@@ -49077,7 +51759,7 @@ function (mode, vertices, isCurve, isBezier,
}
} else {
this.drawingContext.moveTo(v[0], v[1]);
- this.drawingContext.lineTo(vertices[i + 1][0], vertices[i+1][1]);
+ this.drawingContext.lineTo(vertices[i + 1][0], vertices[i + 1][1]);
}
this._doFillStrokeClose();
}
@@ -49098,794 +51780,2959 @@ function (mode, vertices, isCurve, isBezier,
this._doFillStrokeClose();
}
}
- isCurve = false;
- isBezier = false;
- isQuadratic = false;
- isContour = false;
- if (closeShape) {
- vertices.pop();
+ isCurve = false;
+ isBezier = false;
+ isQuadratic = false;
+ isContour = false;
+ if (closeShape) {
+ vertices.pop();
+ }
+
+ this._pInst._pixelsDirty = true;
+ return this;
+};
+//////////////////////////////////////////////
+// SHAPE | Attributes
+//////////////////////////////////////////////
+
+p5.Renderer2D.prototype.noSmooth = function() {
+ if ('imageSmoothingEnabled' in this.drawingContext) {
+ this.drawingContext.imageSmoothingEnabled = false;
+ }
+ return this;
+};
+
+p5.Renderer2D.prototype.smooth = function() {
+ if ('imageSmoothingEnabled' in this.drawingContext) {
+ this.drawingContext.imageSmoothingEnabled = true;
+ }
+ return this;
+};
+
+p5.Renderer2D.prototype.strokeCap = function(cap) {
+ if (
+ cap === constants.ROUND ||
+ cap === constants.SQUARE ||
+ cap === constants.PROJECT
+ ) {
+ this.drawingContext.lineCap = cap;
+ }
+ return this;
+};
+
+p5.Renderer2D.prototype.strokeJoin = function(join) {
+ if (
+ join === constants.ROUND ||
+ join === constants.BEVEL ||
+ join === constants.MITER
+ ) {
+ this.drawingContext.lineJoin = join;
+ }
+ return this;
+};
+
+p5.Renderer2D.prototype.strokeWeight = function(w) {
+ if (typeof w === 'undefined' || w === 0) {
+ // hack because lineWidth 0 doesn't work
+ this.drawingContext.lineWidth = 0.0001;
+ } else {
+ this.drawingContext.lineWidth = w;
+ }
+ return this;
+};
+
+p5.Renderer2D.prototype._getFill = function() {
+ if (!this._cachedFillStyle) {
+ this._cachedFillStyle = this.drawingContext.fillStyle;
+ }
+ return this._cachedFillStyle;
+};
+
+p5.Renderer2D.prototype._setFill = function(fillStyle) {
+ if (fillStyle !== this._cachedFillStyle) {
+ this.drawingContext.fillStyle = fillStyle;
+ this._cachedFillStyle = fillStyle;
+ }
+};
+
+p5.Renderer2D.prototype._getStroke = function() {
+ if (!this._cachedStrokeStyle) {
+ this._cachedStrokeStyle = this.drawingContext.strokeStyle;
+ }
+ return this._cachedStrokeStyle;
+};
+
+p5.Renderer2D.prototype._setStroke = function(strokeStyle) {
+ if (strokeStyle !== this._cachedStrokeStyle) {
+ this.drawingContext.strokeStyle = strokeStyle;
+ this._cachedStrokeStyle = strokeStyle;
+ }
+};
+
+//////////////////////////////////////////////
+// SHAPE | Curves
+//////////////////////////////////////////////
+p5.Renderer2D.prototype.bezier = function(x1, y1, x2, y2, x3, y3, x4, y4) {
+ this._pInst.beginShape();
+ this._pInst.vertex(x1, y1);
+ this._pInst.bezierVertex(x2, y2, x3, y3, x4, y4);
+ this._pInst.endShape();
+ return this;
+};
+
+p5.Renderer2D.prototype.curve = function(x1, y1, x2, y2, x3, y3, x4, y4) {
+ this._pInst.beginShape();
+ this._pInst.curveVertex(x1, y1);
+ this._pInst.curveVertex(x2, y2);
+ this._pInst.curveVertex(x3, y3);
+ this._pInst.curveVertex(x4, y4);
+ this._pInst.endShape();
+ return this;
+};
+
+//////////////////////////////////////////////
+// SHAPE | Vertex
+//////////////////////////////////////////////
+
+p5.Renderer2D.prototype._doFillStrokeClose = function() {
+ if (this._doFill) {
+ this.drawingContext.fill();
+ }
+ if (this._doStroke) {
+ this.drawingContext.stroke();
+ }
+ this.drawingContext.closePath();
+
+ this._pInst._pixelsDirty = true;
+};
+
+//////////////////////////////////////////////
+// TRANSFORM
+//////////////////////////////////////////////
+
+p5.Renderer2D.prototype.applyMatrix = function(a, b, c, d, e, f) {
+ this.drawingContext.transform(a, b, c, d, e, f);
+};
+
+p5.Renderer2D.prototype.resetMatrix = function() {
+ this.drawingContext.setTransform(1, 0, 0, 1, 0, 0);
+ this.drawingContext.scale(
+ this._pInst._pixelDensity,
+ this._pInst._pixelDensity
+ );
+ return this;
+};
+
+p5.Renderer2D.prototype.rotate = function(rad) {
+ this.drawingContext.rotate(rad);
+};
+
+p5.Renderer2D.prototype.scale = function(x, y) {
+ this.drawingContext.scale(x, y);
+ return this;
+};
+
+p5.Renderer2D.prototype.shearX = function(rad) {
+ this.drawingContext.transform(1, 0, Math.tan(rad), 1, 0, 0);
+ return this;
+};
+
+p5.Renderer2D.prototype.shearY = function(rad) {
+ this.drawingContext.transform(1, Math.tan(rad), 0, 1, 0, 0);
+ return this;
+};
+
+p5.Renderer2D.prototype.translate = function(x, y) {
+ // support passing a vector as the 1st parameter
+ if (x instanceof p5.Vector) {
+ y = x.y;
+ x = x.x;
+ }
+ this.drawingContext.translate(x, y);
+ return this;
+};
+
+//////////////////////////////////////////////
+// TYPOGRAPHY
+//
+//////////////////////////////////////////////
+
+p5.Renderer2D.prototype.text = function(str, x, y, maxWidth, maxHeight) {
+ var baselineHacked;
+
+ // baselineHacked: (HACK)
+ // A temporary fix to conform to Processing's implementation
+ // of BASELINE vertical alignment in a bounding box
+
+ if (typeof maxWidth !== 'undefined' && typeof maxHeight !== 'undefined') {
+ if (this.drawingContext.textBaseline === constants.BASELINE) {
+ baselineHacked = true;
+ this.drawingContext.textBaseline = constants.TOP;
+ }
+ }
+
+ var p = p5.Renderer.prototype.text.apply(this, arguments);
+
+ if (baselineHacked) {
+ this.drawingContext.textBaseline = constants.BASELINE;
+ }
+
+ return p;
+};
+
+p5.Renderer2D.prototype._renderText = function(p, line, x, y, maxY) {
+ if (y >= maxY) {
+ return; // don't render lines beyond our maxY position
+ }
+
+ p.push(); // fix to #803
+
+ if (!this._isOpenType()) {
+ // a system/browser font
+
+ // no stroke unless specified by user
+ if (this._doStroke && this._strokeSet) {
+ this.drawingContext.strokeText(line, x, y);
+ }
+
+ if (this._doFill) {
+ // if fill hasn't been set by user, use default text fill
+ if (!this._fillSet) {
+ this._setFill(constants._DEFAULT_TEXT_FILL);
+ }
+
+ this.drawingContext.fillText(line, x, y);
+ }
+ } else {
+ // an opentype font, let it handle the rendering
+
+ this._textFont._renderPath(line, x, y, { renderer: this });
+ }
+
+ p.pop();
+
+ this._pInst._pixelsDirty = true;
+ return p;
+};
+
+p5.Renderer2D.prototype.textWidth = function(s) {
+ if (this._isOpenType()) {
+ return this._textFont._textWidth(s, this._textSize);
+ }
+
+ return this.drawingContext.measureText(s).width;
+};
+
+p5.Renderer2D.prototype._applyTextProperties = function() {
+ var font,
+ p = this._pInst;
+
+ this._setProperty('_textAscent', null);
+ this._setProperty('_textDescent', null);
+
+ font = this._textFont;
+
+ if (this._isOpenType()) {
+ font = this._textFont.font.familyName;
+ this._setProperty('_textStyle', this._textFont.font.styleName);
+ }
+
+ this.drawingContext.font =
+ (this._textStyle || 'normal') +
+ ' ' +
+ (this._textSize || 12) +
+ 'px ' +
+ (font || 'sans-serif');
+
+ this.drawingContext.textAlign = this._textAlign;
+ if (this._textBaseline === constants.CENTER) {
+ this.drawingContext.textBaseline = constants._CTX_MIDDLE;
+ } else {
+ this.drawingContext.textBaseline = this._textBaseline;
+ }
+
+ return p;
+};
+
+//////////////////////////////////////////////
+// STRUCTURE
+//////////////////////////////////////////////
+
+// a push() operation is in progress.
+// the renderer should return a 'style' object that it wishes to
+// store on the push stack.
+// derived renderers should call the base class' push() method
+// to fetch the base style object.
+p5.Renderer2D.prototype.push = function() {
+ this.drawingContext.save();
+
+ // get the base renderer style
+ return p5.Renderer.prototype.push.apply(this);
+};
+
+// a pop() operation is in progress
+// the renderer is passed the 'style' object that it returned
+// from its push() method.
+// derived renderers should pass this object to their base
+// class' pop method
+p5.Renderer2D.prototype.pop = function(style) {
+ this.drawingContext.restore();
+ // Re-cache the fill / stroke state
+ this._cachedFillStyle = this.drawingContext.fillStyle;
+ this._cachedStrokeStyle = this.drawingContext.strokeStyle;
+
+ p5.Renderer.prototype.pop.call(this, style);
+};
+
+module.exports = p5.Renderer2D;
+
+},{"../image/filters":43,"./constants":19,"./main":25,"./p5.Renderer":28}],30:[function(_dereq_,module,exports){
+/**
+ * @module Rendering
+ * @submodule Rendering
+ * @for p5
+ */
+
+'use strict';
+
+var p5 = _dereq_('./main');
+var constants = _dereq_('./constants');
+_dereq_('./p5.Graphics');
+_dereq_('./p5.Renderer2D');
+_dereq_('../webgl/p5.RendererGL');
+var defaultId = 'defaultCanvas0'; // this gets set again in createCanvas
+var defaultClass = 'p5Canvas';
+
+/**
+ * Creates a canvas element in the document, and sets the dimensions of it
+ * in pixels. This method should be called only once at the start of setup.
+ * Calling createCanvas more than once in a sketch will result in very
+ * unpredictable behavior. If you want more than one drawing canvas
+ * you could use createGraphics (hidden by default but it can be shown).
+ *
+ * The system variables width and height are set by the parameters passed
+ * to this function. If createCanvas() is not used, the window will be
+ * given a default size of 100x100 pixels.
+ *
+ * For more ways to position the canvas, see the
+ *
+ * positioning the canvas wiki page.
+ *
+ * @method createCanvas
+ * @param {Number} w width of the canvas
+ * @param {Number} h height of the canvas
+ * @param {Constant} [renderer] either P2D or WEBGL
+ * @return {p5.Renderer}
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 50);
+ * background(153);
+ * line(0, 0, width, height);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Black line extending from top-left of canvas to bottom right.
+ *
+ */
+
+p5.prototype.createCanvas = function(w, h, renderer) {
+ p5._validateParameters('createCanvas', arguments);
+ //optional: renderer, otherwise defaults to p2d
+ var r = renderer || constants.P2D;
+ var c;
+
+ if (r === constants.WEBGL) {
+ c = document.getElementById(defaultId);
+ if (c) {
+ //if defaultCanvas already exists
+ c.parentNode.removeChild(c); //replace the existing defaultCanvas
+ var thisRenderer = this._renderer;
+ this._elements = this._elements.filter(function(e) {
+ return e !== thisRenderer;
+ });
+ }
+ c = document.createElement('canvas');
+ c.id = defaultId;
+ c.classList.add(defaultClass);
+ } else {
+ if (!this._defaultGraphicsCreated) {
+ c = document.createElement('canvas');
+ var i = 0;
+ while (document.getElementById('defaultCanvas' + i)) {
+ i++;
+ }
+ defaultId = 'defaultCanvas' + i;
+ c.id = defaultId;
+ c.classList.add(defaultClass);
+ } else {
+ // resize the default canvas if new one is created
+ c = this.canvas;
+ }
+ }
+
+ // set to invisible if still in setup (to prevent flashing with manipulate)
+ if (!this._setupDone) {
+ c.dataset.hidden = true; // tag to show later
+ c.style.visibility = 'hidden';
+ }
+
+ if (this._userNode) {
+ // user input node case
+ this._userNode.appendChild(c);
+ } else {
+ document.body.appendChild(c);
+ }
+
+ // Init our graphics renderer
+ //webgl mode
+ if (r === constants.WEBGL) {
+ this._setProperty('_renderer', new p5.RendererGL(c, this, true));
+ this._elements.push(this._renderer);
+ } else {
+ //P2D mode
+ if (!this._defaultGraphicsCreated) {
+ this._setProperty('_renderer', new p5.Renderer2D(c, this, true));
+ this._defaultGraphicsCreated = true;
+ this._elements.push(this._renderer);
+ }
+ }
+ this._renderer.resize(w, h);
+ this._renderer._applyDefaults();
+ return this._renderer;
+};
+
+/**
+ * Resizes the canvas to given width and height. The canvas will be cleared
+ * and draw will be called immediately, allowing the sketch to re-render itself
+ * in the resized canvas.
+ * @method resizeCanvas
+ * @param {Number} w width of the canvas
+ * @param {Number} h height of the canvas
+ * @param {Boolean} [noRedraw] don't redraw the canvas immediately
+ * @example
+ *
+ * function setup() {
+ * createCanvas(windowWidth, windowHeight);
+ * }
+ *
+ * function draw() {
+ * background(0, 100, 200);
+ * }
+ *
+ * function windowResized() {
+ * resizeCanvas(windowWidth, windowHeight);
+ * }
+ *
+ *
+ * @alt
+ * No image displayed.
+ *
+ */
+p5.prototype.resizeCanvas = function(w, h, noRedraw) {
+ p5._validateParameters('resizeCanvas', arguments);
+ if (this._renderer) {
+ // save canvas properties
+ var props = {};
+ for (var key in this.drawingContext) {
+ var val = this.drawingContext[key];
+ if (typeof val !== 'object' && typeof val !== 'function') {
+ props[key] = val;
+ }
+ }
+ this._renderer.resize(w, h);
+ this.width = w;
+ this.height = h;
+ // reset canvas properties
+ for (var savedKey in props) {
+ try {
+ this.drawingContext[savedKey] = props[savedKey];
+ } catch (err) {
+ // ignore read-only property errors
+ }
+ }
+ if (!noRedraw) {
+ this.redraw();
+ }
+ }
+};
+
+/**
+ * Removes the default canvas for a p5 sketch that doesn't
+ * require a canvas
+ * @method noCanvas
+ * @example
+ *
+ *
+ * function setup() {
+ * noCanvas();
+ * }
+ *
+ *
+ *
+ * @alt
+ * no image displayed
+ *
+ */
+p5.prototype.noCanvas = function() {
+ if (this.canvas) {
+ this.canvas.parentNode.removeChild(this.canvas);
+ }
+};
+
+/**
+ * Creates and returns a new p5.Renderer object. Use this class if you need
+ * to draw into an off-screen graphics buffer. The two parameters define the
+ * width and height in pixels.
+ *
+ * @method createGraphics
+ * @param {Number} w width of the offscreen graphics buffer
+ * @param {Number} h height of the offscreen graphics buffer
+ * @param {Constant} [renderer] either P2D or WEBGL
+ * undefined defaults to p2d
+ * @return {p5.Graphics} offscreen graphics buffer
+ * @example
+ *
+ *
+ * var pg;
+ * function setup() {
+ * createCanvas(100, 100);
+ * pg = createGraphics(100, 100);
+ * }
+ * function draw() {
+ * background(200);
+ * pg.background(100);
+ * pg.noStroke();
+ * pg.ellipse(pg.width / 2, pg.height / 2, 50, 50);
+ * image(pg, 50, 50);
+ * image(pg, 0, 0, 50, 50);
+ * }
+ *
+ *
+ *
+ * @alt
+ * 4 grey squares alternating light and dark grey. White quarter circle mid-left.
+ *
+ */
+p5.prototype.createGraphics = function(w, h, renderer) {
+ p5._validateParameters('createGraphics', arguments);
+ return new p5.Graphics(w, h, renderer, this);
+};
+
+/**
+ * Blends the pixels in the display window according to the defined mode.
+ * There is a choice of the following modes to blend the source pixels (A)
+ * with the ones of pixels already in the display window (B):
+ *
+ * BLEND - linear interpolation of colours: C =
+ * A\*factor + B. This is the default blending mode.ADD - sum of A and BDARKEST - only the darkest colour succeeds: C =
+ * min(A\*factor, B).LIGHTEST - only the lightest colour succeeds: C =
+ * max(A\*factor, B).DIFFERENCE - subtract colors from underlying image.EXCLUSION - similar to DIFFERENCE, but less
+ * extreme.MULTIPLY - multiply the colors, result will always be
+ * darker.SCREEN - opposite multiply, uses inverse values of the
+ * colors.REPLACE - the pixels entirely replace the others and
+ * don't utilize alpha (transparency) values.OVERLAY - mix of MULTIPLY and SCREEN
+ * . Multiplies dark values, and screens light values.HARD_LIGHT - SCREEN when greater than 50%
+ * gray, MULTIPLY when lower.SOFT_LIGHT - mix of DARKEST and
+ * LIGHTEST. Works like OVERLAY, but not as harsh.
+ * DODGE - lightens light tones and increases contrast,
+ * ignores darks.BURN - darker areas are applied, increasing contrast,
+ * ignores lights.
+ *
+ * @method blendMode
+ * @param {Constant} mode blend mode to set for canvas.
+ * either BLEND, DARKEST, LIGHTEST, DIFFERENCE, MULTIPLY,
+ * EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,
+ * SOFT_LIGHT, DODGE, BURN, ADD or NORMAL
+ * @example
+ *
+ *
+ * blendMode(LIGHTEST);
+ * strokeWeight(30);
+ * stroke(80, 150, 255);
+ * line(25, 25, 75, 75);
+ * stroke(255, 50, 50);
+ * line(75, 25, 25, 75);
+ *
+ *
+ *
+ *
+ * blendMode(MULTIPLY);
+ * strokeWeight(30);
+ * stroke(80, 150, 255);
+ * line(25, 25, 75, 75);
+ * stroke(255, 50, 50);
+ * line(75, 25, 25, 75);
+ *
+ *
+ * @alt
+ * translucent image thick red & blue diagonal rounded lines intersecting center
+ * Thick red & blue diagonal rounded lines intersecting center. dark at overlap
+ *
+ */
+p5.prototype.blendMode = function(mode) {
+ p5._validateParameters('blendMode', arguments);
+ if (
+ mode === constants.BLEND ||
+ mode === constants.DARKEST ||
+ mode === constants.LIGHTEST ||
+ mode === constants.DIFFERENCE ||
+ mode === constants.MULTIPLY ||
+ mode === constants.EXCLUSION ||
+ mode === constants.SCREEN ||
+ mode === constants.REPLACE ||
+ mode === constants.OVERLAY ||
+ mode === constants.HARD_LIGHT ||
+ mode === constants.SOFT_LIGHT ||
+ mode === constants.DODGE ||
+ mode === constants.BURN ||
+ mode === constants.ADD ||
+ mode === constants.NORMAL
+ ) {
+ this._renderer.blendMode(mode);
+ } else {
+ throw new Error('Mode ' + mode + ' not recognized.');
+ }
+};
+
+module.exports = p5;
+
+},{"../webgl/p5.RendererGL":75,"./constants":19,"./main":25,"./p5.Graphics":27,"./p5.Renderer2D":29}],31:[function(_dereq_,module,exports){
+/**
+ * @module Shape
+ * @submodule 2D Primitives
+ * @for p5
+ * @requires core
+ * @requires constants
+ */
+
+'use strict';
+
+var p5 = _dereq_('../main');
+var constants = _dereq_('../constants');
+var canvas = _dereq_('../helpers');
+_dereq_('../error_helpers');
+
+/**
+ * Draw an arc to the screen. If called with only x, y, w, h, start, and
+ * stop, the arc will be drawn and filled as an open pie segment. If a mode parameter is provided, the arc
+ * will be filled like an open semi-circle (OPEN) , a closed semi-circle (CHORD), or as a closed pie segment (PIE). The
+ * origin may be changed with the ellipseMode() function.
+ * Note that drawing a full circle (ex: 0 to TWO_PI) will appear blank
+ * because 0 and TWO_PI are the same position on the unit circle. The
+ * best way to handle this is by using the ellipse() function instead
+ * to create a closed ellipse, and to use the arc() function
+ * only to draw parts of an ellipse.
+ *
+ * @method arc
+ * @param {Number} x x-coordinate of the arc's ellipse
+ * @param {Number} y y-coordinate of the arc's ellipse
+ * @param {Number} w width of the arc's ellipse by default
+ * @param {Number} h height of the arc's ellipse by default
+ * @param {Number} start angle to start the arc, specified in radians
+ * @param {Number} stop angle to stop the arc, specified in radians
+ * @param {Constant} [mode] optional parameter to determine the way of drawing
+ * the arc. either CHORD, PIE or OPEN
+ * @param {Number} [detail] optional parameter for WebGL mode only. This is to
+ * specify the number of vertices that makes up the
+ * perimeter of the arc. Default value is 25.
+ *
+ * @chainable
+ * @example
+ *
+ *
+ * arc(50, 55, 50, 50, 0, HALF_PI);
+ * noFill();
+ * arc(50, 55, 60, 60, HALF_PI, PI);
+ * arc(50, 55, 70, 70, PI, PI + QUARTER_PI);
+ * arc(50, 55, 80, 80, PI + QUARTER_PI, TWO_PI);
+ *
+ *
+ *
+ *
+ *
+ * arc(50, 50, 80, 80, 0, PI + QUARTER_PI);
+ *
+ *
+ *
+ *
+ *
+ * arc(50, 50, 80, 80, 0, PI + QUARTER_PI, OPEN);
+ *
+ *
+ *
+ *
+ *
+ * arc(50, 50, 80, 80, 0, PI + QUARTER_PI, CHORD);
+ *
+ *
+ *
+ *
+ *
+ * arc(50, 50, 80, 80, 0, PI + QUARTER_PI, PIE);
+ *
+ *
+ *
+ * @alt
+ *shattered outline of an ellipse with a quarter of a white circle bottom-right.
+ *white ellipse with top right quarter missing.
+ *white ellipse with black outline with top right missing.
+ *white ellipse with top right missing with black outline around shape.
+ *white ellipse with top right quarter missing with black outline around the shape.
+ *
+ */
+p5.prototype.arc = function(x, y, w, h, start, stop, mode, detail) {
+ p5._validateParameters('arc', arguments);
+
+ // if the current stroke and fill settings wouldn't result in something
+ // visible, exit immediately
+ if (!this._renderer._doStroke && !this._renderer._doFill) {
+ return this;
+ }
+
+ start = this._toRadians(start);
+ stop = this._toRadians(stop);
+
+ // Make all angles positive...
+ while (start < 0) {
+ start += constants.TWO_PI;
+ }
+ while (stop < 0) {
+ stop += constants.TWO_PI;
+ }
+
+ if (typeof start !== 'undefined' && typeof stop !== 'undefined') {
+ // don't display anything if the angles are same or they have a difference of 0 - TWO_PI
+ if (
+ stop.toFixed(10) === start.toFixed(10) ||
+ Math.abs(stop - start) === constants.TWO_PI
+ ) {
+ start %= constants.TWO_PI;
+ stop %= constants.TWO_PI;
+ start += constants.TWO_PI;
+ } else if (Math.abs(stop - start) > constants.TWO_PI) {
+ // display a full circle if the difference between them is greater than 0 - TWO_PI
+ start %= constants.TWO_PI;
+ stop %= constants.TWO_PI;
+ stop += constants.TWO_PI;
+ }
+ }
+
+ //Adjust angles to counter linear scaling.
+ if (start <= constants.HALF_PI) {
+ start = Math.atan(w / h * Math.tan(start));
+ } else if (start > constants.HALF_PI && start <= 3 * constants.HALF_PI) {
+ start = Math.atan(w / h * Math.tan(start)) + constants.PI;
+ }
+ if (stop <= constants.HALF_PI) {
+ stop = Math.atan(w / h * Math.tan(stop));
+ } else if (stop > constants.HALF_PI && stop <= 3 * constants.HALF_PI) {
+ stop = Math.atan(w / h * Math.tan(stop)) + constants.PI;
}
- return this;
-};
-//////////////////////////////////////////////
-// SHAPE | Attributes
-//////////////////////////////////////////////
-p5.Renderer2D.prototype.noSmooth = function() {
- if ('imageSmoothingEnabled' in this.drawingContext) {
- this.drawingContext.imageSmoothingEnabled = false;
+ // Exceed the interval if necessary in order to preserve the size and
+ // orientation of the arc.
+ if (start > stop) {
+ stop += constants.TWO_PI;
}
+
+ // p5 supports negative width and heights for ellipses
+ w = Math.abs(w);
+ h = Math.abs(h);
+
+ var vals = canvas.modeAdjust(x, y, w, h, this._renderer._ellipseMode);
+ this._renderer.arc(vals.x, vals.y, vals.w, vals.h, start, stop, mode, detail);
+
return this;
};
-p5.Renderer2D.prototype.smooth = function() {
- if ('imageSmoothingEnabled' in this.drawingContext) {
- this.drawingContext.imageSmoothingEnabled = true;
+/**
+ * Draws an ellipse (oval) to the screen. An ellipse with equal width and
+ * height is a circle. By default, the first two parameters set the location,
+ * and the third and fourth parameters set the shape's width and height. If
+ * no height is specified, the value of width is used for both the width and
+ * height. If a negative height or width is specified, the absolute value is taken.
+ * The origin may be changed with the ellipseMode() function.
+ *
+ * @method ellipse
+ * @param {Number} x x-coordinate of the ellipse.
+ * @param {Number} y y-coordinate of the ellipse.
+ * @param {Number} w width of the ellipse.
+ * @param {Number} [h] height of the ellipse.
+ * @chainable
+ * @example
+ *
+ *
+ * ellipse(56, 46, 55, 55);
+ *
+ *
+ *
+ * @alt
+ *white ellipse with black outline in middle-right of canvas that is 55x55.
+ *
+ */
+/**
+ * @method ellipse
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} w
+ * @param {Number} h
+ * @param {Integer} detail number of radial sectors to draw
+ */
+p5.prototype.ellipse = function(x, y, w, h, detailX) {
+ p5._validateParameters('ellipse', arguments);
+
+ // if the current stroke and fill settings wouldn't result in something
+ // visible, exit immediately
+ if (!this._renderer._doStroke && !this._renderer._doFill) {
+ return this;
}
- return this;
-};
-p5.Renderer2D.prototype.strokeCap = function(cap) {
- if (cap === constants.ROUND ||
- cap === constants.SQUARE ||
- cap === constants.PROJECT) {
- this.drawingContext.lineCap = cap;
+ // p5 supports negative width and heights for rects
+ if (w < 0) {
+ w = Math.abs(w);
}
- return this;
-};
-p5.Renderer2D.prototype.strokeJoin = function(join) {
- if (join === constants.ROUND ||
- join === constants.BEVEL ||
- join === constants.MITER) {
- this.drawingContext.lineJoin = join;
+ if (typeof h === 'undefined') {
+ // Duplicate 3rd argument if only 3 given.
+ h = w;
+ } else if (h < 0) {
+ h = Math.abs(h);
}
+
+ var vals = canvas.modeAdjust(x, y, w, h, this._renderer._ellipseMode);
+ this._renderer.ellipse([vals.x, vals.y, vals.w, vals.h, detailX]);
+
return this;
};
+/**
+ * Draws a line (a direct path between two points) to the screen. The version
+ * of line() with four parameters draws the line in 2D. To color a line, use
+ * the stroke() function. A line cannot be filled, therefore the fill()
+ * function will not affect the color of a line. 2D lines are drawn with a
+ * width of one pixel by default, but this can be changed with the
+ * strokeWeight() function.
+ *
+ * @method line
+ * @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
+ * @chainable
+ * @example
+ *
+ *
+ * line(30, 20, 85, 75);
+ *
+ *
+ *
+ *
+ *
+ * line(30, 20, 85, 20);
+ * stroke(126);
+ * line(85, 20, 85, 75);
+ * stroke(255);
+ * line(85, 75, 30, 75);
+ *
+ *
+ *
+ * @alt
+ *line 78 pixels long running from mid-top to bottom-right of canvas.
+ *3 lines of various stroke sizes. Form top, bottom and right sides of a square.
+ *
+ */
+/**
+ * @method line
+ * @param {Number} x1
+ * @param {Number} y1
+ * @param {Number} z1 the z-coordinate of the first point
+ * @param {Number} x2
+ * @param {Number} y2
+ * @param {Number} z2 the z-coordinate of the second point
+ * @chainable
+ */
+p5.prototype.line = function() {
+ p5._validateParameters('line', arguments);
-p5.Renderer2D.prototype.strokeWeight = function(w) {
- if (typeof w === 'undefined' || w === 0) {
- // hack because lineWidth 0 doesn't work
- this.drawingContext.lineWidth = 0.0001;
- } else {
- this.drawingContext.lineWidth = w;
+ if (this._renderer._doStroke) {
+ this._renderer.line.apply(this._renderer, arguments);
}
+
return this;
};
-p5.Renderer2D.prototype._getFill = function(){
- if (!this._cachedFillStyle) {
- this._cachedFillStyle = this.drawingContext.fillStyle;
+/**
+ * Draws a point, a coordinate in space at the dimension of one pixel.
+ * The first parameter is the horizontal value for the point, the second
+ * value is the vertical value for the point. The color of the point is
+ * determined by the current stroke.
+ *
+ * @method point
+ * @param {Number} x the x-coordinate
+ * @param {Number} y the y-coordinate
+ * @param {Number} [z] the z-coordinate (for WEBGL mode)
+ * @chainable
+ * @example
+ *
+ *
+ * point(30, 20);
+ * point(85, 20);
+ * point(85, 75);
+ * point(30, 75);
+ *
+ *
+ *
+ * @alt
+ *4 points centered in the middle-right of the canvas.
+ *
+ */
+p5.prototype.point = function() {
+ p5._validateParameters('point', arguments);
+
+ if (this._renderer._doStroke) {
+ this._renderer.point.apply(this._renderer, arguments);
}
- return this._cachedFillStyle;
+
+ return this;
};
-p5.Renderer2D.prototype._setFill = function(fillStyle){
- if (fillStyle !== this._cachedFillStyle) {
- this.drawingContext.fillStyle = fillStyle;
- this._cachedFillStyle = fillStyle;
+/**
+ * Draw a quad. A quad is a quadrilateral, a four sided polygon. It is
+ * similar to a rectangle, but the angles between its edges are not
+ * constrained to ninety degrees. The first pair of parameters (x1,y1)
+ * sets the first vertex and the subsequent pairs should proceed
+ * clockwise or counter-clockwise around the defined shape.
+ *
+ * @method quad
+ * @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
+ * @param {Number} x3 the x-coordinate of the third point
+ * @param {Number} y3 the y-coordinate of the third point
+ * @param {Number} x4 the x-coordinate of the fourth point
+ * @param {Number} y4 the y-coordinate of the fourth point
+ * @chainable
+ * @example
+ *
+ *
+ * quad(38, 31, 86, 20, 69, 63, 30, 76);
+ *
+ *
+ *
+ * @alt
+ *irregular white quadrilateral shape with black outline mid-right of canvas.
+ *
+ */
+/**
+ * @method quad
+ * @param {Number} x1
+ * @param {Number} y1
+ * @param {Number} z1 the z-coordinate of the first point
+ * @param {Number} x2
+ * @param {Number} y2
+ * @param {Number} z2 the z-coordinate of the second point
+ * @param {Number} x3
+ * @param {Number} y3
+ * @param {Number} z3 the z-coordinate of the third point
+ * @param {Number} x4
+ * @param {Number} y4
+ * @param {Number} z4 the z-coordinate of the fourth point
+ * @chainable
+ */
+p5.prototype.quad = function() {
+ p5._validateParameters('quad', arguments);
+
+ if (this._renderer._doStroke || this._renderer._doFill) {
+ this._renderer.quad.apply(this._renderer, arguments);
}
+
+ return this;
};
-p5.Renderer2D.prototype._getStroke = function(){
- if (!this._cachedStrokeStyle) {
- this._cachedStrokeStyle = this.drawingContext.strokeStyle;
+/**
+ * Draws a rectangle to the screen. A rectangle is a four-sided shape with
+ * every angle at ninety degrees. By default, the first two parameters set
+ * the location of the upper-left corner, the third sets the width, and the
+ * fourth sets the height. The way these parameters are interpreted, however,
+ * may be changed with the rectMode() function.
+ *
+ * The fifth, sixth, seventh and eighth parameters, if specified,
+ * determine corner radius for the top-left, top-right, lower-right and
+ * lower-left corners, respectively. An omitted corner radius parameter is set
+ * to the value of the previously specified radius value in the parameter list.
+ *
+ * @method rect
+ * @param {Number} x x-coordinate of the rectangle.
+ * @param {Number} y y-coordinate of the rectangle.
+ * @param {Number} w width of the rectangle.
+ * @param {Number} h height of the rectangle.
+ * @param {Number} [tl] optional radius of top-left corner.
+ * @param {Number} [tr] optional radius of top-right corner.
+ * @param {Number} [br] optional radius of bottom-right corner.
+ * @param {Number} [bl] optional radius of bottom-left corner.
+ * @chainable
+ * @example
+ *
+ *
+ * // Draw a rectangle at location (30, 20) with a width and height of 55.
+ * rect(30, 20, 55, 55);
+ *
+ *
+ *
+ *
+ *
+ * // Draw a rectangle with rounded corners, each having a radius of 20.
+ * rect(30, 20, 55, 55, 20);
+ *
+ *
+ *
+ *
+ *
+ * // Draw a rectangle with rounded corners having the following radii:
+ * // top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5.
+ * rect(30, 20, 55, 55, 20, 15, 10, 5);
+ *
+ *
+ *
+ * @alt
+ * 55x55 white rect with black outline in mid-right of canvas.
+ * 55x55 white rect with black outline and rounded edges in mid-right of canvas.
+ * 55x55 white rect with black outline and rounded edges of different radii.
+ */
+/**
+ * @method rect
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} w
+ * @param {Number} h
+ * @param {Integer} [detailX] number of segments in the x-direction
+ * @param {Integer} [detailY] number of segments in the y-direction
+ * @chainable
+ */
+p5.prototype.rect = function() {
+ p5._validateParameters('rect', arguments);
+
+ if (this._renderer._doStroke || this._renderer._doFill) {
+ var vals = canvas.modeAdjust(
+ arguments[0],
+ arguments[1],
+ arguments[2],
+ arguments[3],
+ this._renderer._rectMode
+ );
+ var args = [vals.x, vals.y, vals.w, vals.h];
+ // append the additional arguments (either cornder radii, or
+ // segment details) to the argument list
+ for (var i = 4; i < arguments.length; i++) {
+ args[i] = arguments[i];
+ }
+ this._renderer.rect(args);
}
- return this._cachedStrokeStyle;
+
+ return this;
};
-p5.Renderer2D.prototype._setStroke = function(strokeStyle){
- if (strokeStyle !== this._cachedStrokeStyle) {
- this.drawingContext.strokeStyle = strokeStyle;
- this._cachedStrokeStyle = strokeStyle;
+/**
+ * A triangle is a plane created by connecting three points. The first two
+ * arguments specify the first point, the middle two arguments specify the
+ * second point, and the last two arguments specify the third point.
+ *
+ * @method triangle
+ * @param {Number} x1 x-coordinate of the first point
+ * @param {Number} y1 y-coordinate of the first point
+ * @param {Number} x2 x-coordinate of the second point
+ * @param {Number} y2 y-coordinate of the second point
+ * @param {Number} x3 x-coordinate of the third point
+ * @param {Number} y3 y-coordinate of the third point
+ * @chainable
+ * @example
+ *
+ *
+ * triangle(30, 75, 58, 20, 86, 75);
+ *
+ *
+ *
+ *@alt
+ * white triangle with black outline in mid-right of canvas.
+ *
+ */
+p5.prototype.triangle = function() {
+ p5._validateParameters('triangle', arguments);
+
+ if (this._renderer._doStroke || this._renderer._doFill) {
+ this._renderer.triangle(arguments);
}
+
+ return this;
};
+module.exports = p5;
+},{"../constants":19,"../error_helpers":21,"../helpers":22,"../main":25}],32:[function(_dereq_,module,exports){
+/**
+ * @module Shape
+ * @submodule Attributes
+ * @for p5
+ * @requires core
+ * @requires constants
+ */
-//////////////////////////////////////////////
-// SHAPE | Curves
-//////////////////////////////////////////////
-p5.Renderer2D.prototype.bezier = function (x1, y1, x2, y2, x3, y3, x4, y4) {
- this._pInst.beginShape();
- this._pInst.vertex(x1, y1);
- this._pInst.bezierVertex(x2, y2, x3, y3, x4, y4);
- this._pInst.endShape();
+'use strict';
+
+var p5 = _dereq_('../main');
+var constants = _dereq_('../constants');
+
+/**
+ * Modifies the location from which ellipses are drawn by changing the way
+ * in which parameters given to ellipse() are interpreted.
+ *
+ * The default mode is ellipseMode(CENTER), which interprets the first two
+ * parameters of ellipse() as the shape's center point, while the third and
+ * fourth parameters are its width and height.
+ *
+ * ellipseMode(RADIUS) also uses the first two parameters of ellipse() as
+ * the shape's center point, but uses the third and fourth parameters to
+ * specify half of the shapes's width and height.
+ *
+ * ellipseMode(CORNER) interprets the first two parameters of ellipse() as
+ * the upper-left corner of the shape, while the third and fourth parameters
+ * are its width and height.
+ *
+ * ellipseMode(CORNERS) interprets the first two parameters of ellipse() as
+ * the location of one corner of the ellipse's bounding box, and the third
+ * and fourth parameters as the location of the opposite corner.
+ *
+ * The parameter must be written in ALL CAPS because Javascript is a
+ * case-sensitive language.
+ *
+ * @method ellipseMode
+ * @param {Constant} mode either CENTER, RADIUS, CORNER, or CORNERS
+ * @chainable
+ * @example
+ *
+ *
+ * ellipseMode(RADIUS); // Set ellipseMode to RADIUS
+ * fill(255); // Set fill to white
+ * ellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode
+ *
+ * ellipseMode(CENTER); // Set ellipseMode to CENTER
+ * fill(100); // Set fill to gray
+ * ellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode
+ *
+ *
+ *
+ *
+ *
+ * ellipseMode(CORNER); // Set ellipseMode is CORNER
+ * fill(255); // Set fill to white
+ * ellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode
+ *
+ * ellipseMode(CORNERS); // Set ellipseMode to CORNERS
+ * fill(100); // Set fill to gray
+ * ellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode
+ *
+ *
+ *
+ * @alt
+ * 60x60 white ellipse and 30x30 grey ellipse with black outlines at center.
+ * 60x60 white ellipse @center and 30x30 grey ellipse top-right, black outlines.
+ *
+ */
+p5.prototype.ellipseMode = function(m) {
+ p5._validateParameters('ellipseMode', arguments);
+ if (
+ m === constants.CORNER ||
+ m === constants.CORNERS ||
+ m === constants.RADIUS ||
+ m === constants.CENTER
+ ) {
+ this._renderer._ellipseMode = m;
+ }
return this;
};
-p5.Renderer2D.prototype.curve = function (x1, y1, x2, y2, x3, y3, x4, y4) {
- this._pInst.beginShape();
- this._pInst.curveVertex(x1, y1);
- this._pInst.curveVertex(x2, y2);
- this._pInst.curveVertex(x3, y3);
- this._pInst.curveVertex(x4, y4);
- this._pInst.endShape();
+/**
+ * Draws all geometry with jagged (aliased) edges. Note that smooth() is
+ * active by default in 2D mode, so it is necessary to call noSmooth() to disable
+ * smoothing of geometry, images, and fonts. In 3D mode, noSmooth() is enabled
+ * by default, so it is necessary to call smooth() if you would like
+ * smooth (antialiased) edges on your geometry.
+ *
+ * @method noSmooth
+ * @chainable
+ * @example
+ *
+ *
+ * background(0);
+ * noStroke();
+ * smooth();
+ * ellipse(30, 48, 36, 36);
+ * noSmooth();
+ * ellipse(70, 48, 36, 36);
+ *
+ *
+ *
+ * @alt
+ * 2 pixelated 36x36 white ellipses to left & right of center, black background
+ *
+ */
+p5.prototype.noSmooth = function() {
+ this._renderer.noSmooth();
return this;
};
-//////////////////////////////////////////////
-// SHAPE | Vertex
-//////////////////////////////////////////////
-
-p5.Renderer2D.prototype._doFillStrokeClose = function () {
- if (this._doFill) {
- this.drawingContext.fill();
- }
- if (this._doStroke) {
- this.drawingContext.stroke();
+/**
+ * Modifies the location from which rectangles are drawn by changing the way
+ * in which parameters given to rect() are interpreted.
+ *
+ * The default mode is rectMode(CORNER), which interprets the first two
+ * parameters of rect() as the upper-left corner of the shape, while the
+ * third and fourth parameters are its width and height.
+ *
+ * rectMode(CORNERS) interprets the first two parameters of rect() as the
+ * location of one corner, and the third and fourth parameters as the
+ * location of the opposite corner.
+ *
+ * rectMode(CENTER) interprets the first two parameters of rect() as the
+ * shape's center point, while the third and fourth parameters are its
+ * width and height.
+ *
+ * rectMode(RADIUS) also uses the first two parameters of rect() as the
+ * shape's center point, but uses the third and fourth parameters to specify
+ * half of the shapes's width and height.
+ *
+ * The parameter must be written in ALL CAPS because Javascript is a
+ * case-sensitive language.
+ *
+ * @method rectMode
+ * @param {Constant} mode either CORNER, CORNERS, CENTER, or RADIUS
+ * @chainable
+ * @example
+ *
+ *
+ * rectMode(CORNER); // Default rectMode is CORNER
+ * fill(255); // Set fill to white
+ * rect(25, 25, 50, 50); // Draw white rect using CORNER mode
+ *
+ * rectMode(CORNERS); // Set rectMode to CORNERS
+ * fill(100); // Set fill to gray
+ * rect(25, 25, 50, 50); // Draw gray rect using CORNERS mode
+ *
+ *
+ *
+ *
+ *
+ * rectMode(RADIUS); // Set rectMode to RADIUS
+ * fill(255); // Set fill to white
+ * rect(50, 50, 30, 30); // Draw white rect using RADIUS mode
+ *
+ * rectMode(CENTER); // Set rectMode to CENTER
+ * fill(100); // Set fill to gray
+ * rect(50, 50, 30, 30); // Draw gray rect using CENTER mode
+ *
+ *
+ *
+ * @alt
+ * 50x50 white rect at center and 25x25 grey rect in the top left of the other.
+ * 50x50 white rect at center and 25x25 grey rect in the center of the other.
+ *
+ */
+p5.prototype.rectMode = function(m) {
+ p5._validateParameters('rectMode', arguments);
+ if (
+ m === constants.CORNER ||
+ m === constants.CORNERS ||
+ m === constants.RADIUS ||
+ m === constants.CENTER
+ ) {
+ this._renderer._rectMode = m;
}
- this.drawingContext.closePath();
-};
-
-//////////////////////////////////////////////
-// TRANSFORM
-//////////////////////////////////////////////
-
-p5.Renderer2D.prototype.applyMatrix =
-function(a, b, c, d, e, f) {
- this.drawingContext.transform(a, b, c, d, e, f);
-};
-
-p5.Renderer2D.prototype.resetMatrix = function() {
- this.drawingContext.setTransform(1, 0, 0, 1, 0, 0);
- this.drawingContext.scale(this._pInst._pixelDensity,
- this._pInst._pixelDensity);
return this;
};
-p5.Renderer2D.prototype.rotate = function(r) {
- this.drawingContext.rotate(r);
-};
-
-p5.Renderer2D.prototype.scale = function(x,y) {
- this.drawingContext.scale(x, y);
+/**
+ * Draws all geometry with smooth (anti-aliased) edges. smooth() will also
+ * improve image quality of resized images. Note that smooth() is active by
+ * default in 2D mode; noSmooth() can be used to disable smoothing of geometry,
+ * images, and fonts. In 3D mode, noSmooth() is enabled
+ * by default, so it is necessary to call smooth() if you would like
+ * smooth (antialiased) edges on your geometry.
+ *
+ * @method smooth
+ * @chainable
+ * @example
+ *
+ *
+ * background(0);
+ * noStroke();
+ * smooth();
+ * ellipse(30, 48, 36, 36);
+ * noSmooth();
+ * ellipse(70, 48, 36, 36);
+ *
+ *
+ *
+ * @alt
+ * 2 pixelated 36x36 white ellipses one left one right of center. On black.
+ *
+ */
+p5.prototype.smooth = function() {
+ this._renderer.smooth();
return this;
};
-p5.Renderer2D.prototype.shearX = function(angle) {
- if (this._pInst._angleMode === constants.DEGREES) {
- // undoing here, because it gets redone in tan()
- angle = this._pInst.degrees(angle);
+/**
+ * Sets the style for rendering line endings. These ends are either squared,
+ * extended, or rounded, each of which specified with the corresponding
+ * parameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND.
+ *
+ * @method strokeCap
+ * @param {Constant} cap either SQUARE, PROJECT, or ROUND
+ * @chainable
+ * @example
+ *
+ *
+ * strokeWeight(12.0);
+ * strokeCap(ROUND);
+ * line(20, 30, 80, 30);
+ * strokeCap(SQUARE);
+ * line(20, 50, 80, 50);
+ * strokeCap(PROJECT);
+ * line(20, 70, 80, 70);
+ *
+ *
+ *
+ * @alt
+ * 3 lines. Top line: rounded ends, mid: squared, bottom:longer squared ends.
+ *
+ */
+p5.prototype.strokeCap = function(cap) {
+ p5._validateParameters('strokeCap', arguments);
+ if (
+ cap === constants.ROUND ||
+ cap === constants.SQUARE ||
+ cap === constants.PROJECT
+ ) {
+ this._renderer.strokeCap(cap);
}
- this.drawingContext.transform(1, 0, this._pInst.tan(angle), 1, 0, 0);
return this;
};
-p5.Renderer2D.prototype.shearY = function(angle) {
- if (this._pInst._angleMode === constants.DEGREES) {
- // undoing here, because it gets redone in tan()
- angle = this._pInst.degrees(angle);
+/**
+ * Sets the style of the joints which connect line segments. These joints
+ * are either mitered, beveled, or rounded and specified with the
+ * corresponding parameters MITER, BEVEL, and ROUND. The default joint is
+ * MITER.
+ *
+ * @method strokeJoin
+ * @param {Constant} join either MITER, BEVEL, ROUND
+ * @chainable
+ * @example
+ *
+ *
+ * noFill();
+ * strokeWeight(10.0);
+ * strokeJoin(MITER);
+ * beginShape();
+ * vertex(35, 20);
+ * vertex(65, 50);
+ * vertex(35, 80);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * noFill();
+ * strokeWeight(10.0);
+ * strokeJoin(BEVEL);
+ * beginShape();
+ * vertex(35, 20);
+ * vertex(65, 50);
+ * vertex(35, 80);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * noFill();
+ * strokeWeight(10.0);
+ * strokeJoin(ROUND);
+ * beginShape();
+ * vertex(35, 20);
+ * vertex(65, 50);
+ * vertex(35, 80);
+ * endShape();
+ *
+ *
+ *
+ * @alt
+ * Right-facing arrowhead shape with pointed tip in center of canvas.
+ * Right-facing arrowhead shape with flat tip in center of canvas.
+ * Right-facing arrowhead shape with rounded tip in center of canvas.
+ *
+ */
+p5.prototype.strokeJoin = function(join) {
+ p5._validateParameters('strokeJoin', arguments);
+ if (
+ join === constants.ROUND ||
+ join === constants.BEVEL ||
+ join === constants.MITER
+ ) {
+ this._renderer.strokeJoin(join);
}
- this.drawingContext.transform(1, this._pInst.tan(angle), 0, 1, 0, 0);
return this;
};
-p5.Renderer2D.prototype.translate = function(x, y) {
- this.drawingContext.translate(x, y);
+/**
+ * Sets the width of the stroke used for lines, points, and the border
+ * around shapes. All widths are set in units of pixels.
+ *
+ * @method strokeWeight
+ * @param {Number} weight the weight (in pixels) of the stroke
+ * @chainable
+ * @example
+ *
+ *
+ * strokeWeight(1); // Default
+ * line(20, 20, 80, 20);
+ * strokeWeight(4); // Thicker
+ * line(20, 40, 80, 40);
+ * strokeWeight(10); // Beastly
+ * line(20, 70, 80, 70);
+ *
+ *
+ *
+ * @alt
+ * 3 horizontal black lines. Top line: thin, mid: medium, bottom:thick.
+ *
+ */
+p5.prototype.strokeWeight = function(w) {
+ p5._validateParameters('strokeWeight', arguments);
+ this._renderer.strokeWeight(w);
return this;
};
-//////////////////////////////////////////////
-// TYPOGRAPHY
-//
-//////////////////////////////////////////////
-
-p5.Renderer2D.prototype.text = function (str, x, y, maxWidth, maxHeight) {
-
- var p = this._pInst, cars, n, ii, jj, line, testLine,
- testWidth, words, totalHeight, baselineHacked,
- finalMaxHeight = Number.MAX_VALUE;
-
- // baselineHacked: (HACK)
- // A temporary fix to conform to Processing's implementation
- // of BASELINE vertical alignment in a bounding box
-
- if (!(this._doFill || this._doStroke)) {
- return;
- }
-
- if (typeof str !== 'string') {
- str = str.toString();
- }
-
- str = str.replace(/(\t)/g, ' ');
- cars = str.split('\n');
-
- if (typeof maxWidth !== 'undefined') {
-
- totalHeight = 0;
- for (ii = 0; ii < cars.length; ii++) {
- line = '';
- words = cars[ii].split(' ');
- for (n = 0; n < words.length; n++) {
- testLine = line + words[n] + ' ';
- testWidth = this.textWidth(testLine);
- if (testWidth > maxWidth) {
- line = words[n] + ' ';
- totalHeight += p.textLeading();
- } else {
- line = testLine;
- }
- }
- }
-
- if (this._rectMode === constants.CENTER) {
-
- x -= maxWidth / 2;
- y -= maxHeight / 2;
- }
-
- switch (this.drawingContext.textAlign) {
-
- case constants.CENTER:
- x += maxWidth / 2;
- break;
- case constants.RIGHT:
- x += maxWidth;
- break;
- }
-
- if (typeof maxHeight !== 'undefined') {
-
- switch (this.drawingContext.textBaseline) {
- case constants.BOTTOM:
- y += (maxHeight - totalHeight);
- break;
- case constants._CTX_MIDDLE: // CENTER?
- y += (maxHeight - totalHeight) / 2;
- break;
- case constants.BASELINE:
- baselineHacked = true;
- this.drawingContext.textBaseline = constants.TOP;
- break;
- }
-
- // remember the max-allowed y-position for any line (fix to #928)
- finalMaxHeight = (y + maxHeight) - p.textAscent();
- }
+module.exports = p5;
- for (ii = 0; ii < cars.length; ii++) {
+},{"../constants":19,"../main":25}],33:[function(_dereq_,module,exports){
+/**
+ * @module Shape
+ * @submodule Curves
+ * @for p5
+ * @requires core
+ */
- line = '';
- words = cars[ii].split(' ');
- for (n = 0; n < words.length; n++) {
- testLine = line + words[n] + ' ';
- testWidth = this.textWidth(testLine);
- if (testWidth > maxWidth && line.length > 0) {
- this._renderText(p, line, x, y, finalMaxHeight);
- line = words[n] + ' ';
- y += p.textLeading();
- } else {
- line = testLine;
- }
- }
+'use strict';
- this._renderText(p, line, x, y, finalMaxHeight);
- y += p.textLeading();
- }
- }
- else {
- // Offset to account for vertically centering multiple lines of text - no
- // need to adjust anything for vertical align top or baseline
- var offset = 0,
- vAlign = p.textAlign().vertical;
- if (vAlign === constants.CENTER) {
- offset = ((cars.length - 1) * p.textLeading()) / 2;
- } else if (vAlign === constants.BOTTOM) {
- offset = (cars.length - 1) * p.textLeading();
- }
+var p5 = _dereq_('../main');
+_dereq_('../error_helpers');
- for (jj = 0; jj < cars.length; jj++) {
+/**
+ * Draws a cubic Bezier curve on the screen. These curves are defined by a
+ * series of anchor and control points. The first two parameters specify
+ * the first anchor point and the last two parameters specify the other
+ * anchor point, which become the first and last points on the curve. The
+ * middle parameters specify the two control points which define the shape
+ * of the curve. Approximately speaking, control points "pull" the curve
+ * towards them.
Bezier curves were developed by French
+ * automotive engineer Pierre Bezier, and are commonly used in computer
+ * graphics to define gently sloping curves. See also curve().
+ *
+ * @method bezier
+ * @param {Number} x1 x-coordinate for the first anchor point
+ * @param {Number} y1 y-coordinate for the first anchor point
+ * @param {Number} x2 x-coordinate for the first control point
+ * @param {Number} y2 y-coordinate for the first control point
+ * @param {Number} x3 x-coordinate for the second control point
+ * @param {Number} y3 y-coordinate for the second control point
+ * @param {Number} x4 x-coordinate for the second anchor point
+ * @param {Number} y4 y-coordinate for the second anchor point
+ * @chainable
+ * @example
+ *
+ *
+ * noFill();
+ * stroke(255, 102, 0);
+ * line(85, 20, 10, 10);
+ * line(90, 90, 15, 80);
+ * stroke(0, 0, 0);
+ * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+ *
+ *
+ *
+ *
+ *
+ * background(0, 0, 0);
+ * noFill();
+ * stroke(255);
+ * bezier(250, 250, 0, 100, 100, 0, 100, 0, 0, 0, 100, 0);
+ *
+ *
+ *
+ * @alt
+ * stretched black s-shape in center with orange lines extending from end points.
+ * stretched black s-shape with 10 5x5 white ellipses along the shape.
+ * stretched black s-shape with 7 5x5 ellipses and orange lines along the shape.
+ * stretched black s-shape with 17 small orange lines extending from under shape.
+ * horseshoe shape with orange ends facing left and black curved center.
+ * horseshoe shape with orange ends facing left and black curved center.
+ * Line shaped like right-facing arrow,points move with mouse-x and warp shape.
+ * horizontal line that hooks downward on the right and 13 5x5 ellipses along it.
+ * right curving line mid-right of canvas with 7 short lines radiating from it.
+ */
+/**
+ * @method bezier
+ * @param {Number} x1
+ * @param {Number} y1
+ * @param {Number} z1 z-coordinate for the first anchor point
+ * @param {Number} x2
+ * @param {Number} y2
+ * @param {Number} z2 z-coordinate for the first control point
+ * @param {Number} x3
+ * @param {Number} y3
+ * @param {Number} z3 z-coordinate for the second control point
+ * @param {Number} x4
+ * @param {Number} y4
+ * @param {Number} z4 z-coordinate for the second anchor point
+ * @chainable
+ */
+p5.prototype.bezier = function() {
+ p5._validateParameters('bezier', arguments);
- this._renderText(p, cars[jj], x, y-offset, finalMaxHeight);
- y += p.textLeading();
- }
+ // if the current stroke and fill settings wouldn't result in something
+ // visible, exit immediately
+ if (!this._renderer._doStroke && !this._renderer._doFill) {
+ return this;
}
- if (baselineHacked) {
- this.drawingContext.textBaseline = constants.BASELINE;
- }
+ this._renderer.bezier.apply(this._renderer, arguments);
- return p;
+ return this;
};
-p5.Renderer2D.prototype._renderText = function(p, line, x, y, maxY) {
-
- if (y >= maxY) {
- return; // don't render lines beyond our maxY position
- }
-
- p.push(); // fix to #803
-
- if (!this._isOpenType()) { // a system/browser font
+/**
+ * Sets the resolution at which Beziers display.
+ *
+ * The default value is 20.
+ *
+ * This function is only useful when using the WEBGL renderer
+ * as the default canvas renderer does not use this information.
+ *
+ * @method bezierDetail
+ * @param {Number} detail resolution of the curves
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * noFill();
+ *
+ * bezierDetail(5);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ *
+ * // prettier-ignore
+ * bezier(-40, -40, 0,
+ * 90, -40, 0,
+ * -90, 40, 0,
+ * 40, 40, 0);
+ * }
+ *
+ *
+ *
+ * @alt
+ * stretched black s-shape with a low level of bezier detail
+ *
+ */
+p5.prototype.bezierDetail = function(d) {
+ p5._validateParameters('bezierDetail', arguments);
+ this._bezierDetail = d;
+ return this;
+};
- // no stroke unless specified by user
- if (this._doStroke && this._strokeSet) {
+/**
+ * Evaluates the Bezier at position t for points a, b, c, d.
+ * The parameters a and d are the first and last points
+ * on the curve, and b and c are the control points.
+ * The final parameter t varies between 0 and 1.
+ * This can be done once with the x coordinates and a second time
+ * with the y coordinates to get the location of a bezier curve at t.
+ *
+ * @method bezierPoint
+ * @param {Number} a coordinate of first point on the curve
+ * @param {Number} b coordinate of first control point
+ * @param {Number} c coordinate of second control point
+ * @param {Number} d coordinate of second point on the curve
+ * @param {Number} t value between 0 and 1
+ * @return {Number} the value of the Bezier at position t
+ * @example
+ *
+ *
+ * noFill();
+ * var x1 = 85,
+ x2 = 10,
+ x3 = 90,
+ x4 = 15;
+ * var y1 = 20,
+ y2 = 10,
+ y3 = 90,
+ y4 = 80;
+ * bezier(x1, y1, x2, y2, x3, y3, x4, y4);
+ * fill(255);
+ * var steps = 10;
+ * for (var i = 0; i <= steps; i++) {
+ * var t = i / steps;
+ * var x = bezierPoint(x1, x2, x3, x4, t);
+ * var y = bezierPoint(y1, y2, y3, y4, t);
+ * ellipse(x, y, 5, 5);
+ * }
+ *
+ *
+ *
+ * @alt
+ * stretched black s-shape with 17 small orange lines extending from under shape.
+ *
+ */
+p5.prototype.bezierPoint = function(a, b, c, d, t) {
+ p5._validateParameters('bezierPoint', arguments);
- this.drawingContext.strokeText(line, x, y);
- }
+ var adjustedT = 1 - t;
+ return (
+ Math.pow(adjustedT, 3) * a +
+ 3 * Math.pow(adjustedT, 2) * t * b +
+ 3 * adjustedT * Math.pow(t, 2) * c +
+ Math.pow(t, 3) * d
+ );
+};
- if (this._doFill) {
+/**
+ * Evaluates the tangent to the Bezier at position t for points a, b, c, d.
+ * The parameters a and d are the first and last points
+ * on the curve, and b and c are the control points.
+ * The final parameter t varies between 0 and 1.
+ *
+ * @method bezierTangent
+ * @param {Number} a coordinate of first point on the curve
+ * @param {Number} b coordinate of first control point
+ * @param {Number} c coordinate of second control point
+ * @param {Number} d coordinate of second point on the curve
+ * @param {Number} t value between 0 and 1
+ * @return {Number} the tangent at position t
+ * @example
+ *
+ *
+ * noFill();
+ * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+ * var steps = 6;
+ * fill(255);
+ * for (var i = 0; i <= steps; i++) {
+ * var t = i / steps;
+ * // Get the location of the point
+ * var x = bezierPoint(85, 10, 90, 15, t);
+ * var y = bezierPoint(20, 10, 90, 80, t);
+ * // Get the tangent points
+ * var tx = bezierTangent(85, 10, 90, 15, t);
+ * var ty = bezierTangent(20, 10, 90, 80, t);
+ * // Calculate an angle from the tangent points
+ * var a = atan2(ty, tx);
+ * a += PI;
+ * stroke(255, 102, 0);
+ * line(x, y, cos(a) * 30 + x, sin(a) * 30 + y);
+ * // The following line of code makes a line
+ * // inverse of the above line
+ * //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y);
+ * stroke(0);
+ * ellipse(x, y, 5, 5);
+ * }
+ *
+ *
+ *
+ *
+ *
+ * noFill();
+ * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+ * stroke(255, 102, 0);
+ * var steps = 16;
+ * for (var i = 0; i <= steps; i++) {
+ * var t = i / steps;
+ * var x = bezierPoint(85, 10, 90, 15, t);
+ * var y = bezierPoint(20, 10, 90, 80, t);
+ * var tx = bezierTangent(85, 10, 90, 15, t);
+ * var ty = bezierTangent(20, 10, 90, 80, t);
+ * var a = atan2(ty, tx);
+ * a -= HALF_PI;
+ * line(x, y, cos(a) * 8 + x, sin(a) * 8 + y);
+ * }
+ *
+ *
+ *
+ * @alt
+ * s-shaped line with 17 short orange lines extending from underside of shape
+ *
+ */
+p5.prototype.bezierTangent = function(a, b, c, d, t) {
+ p5._validateParameters('bezierTangent', arguments);
- // if fill hasn't been set by user, use default text fill
- if (! this._fillSet) {
- this._setFill(constants._DEFAULT_TEXT_FILL);
- }
+ var adjustedT = 1 - t;
+ return (
+ 3 * d * Math.pow(t, 2) -
+ 3 * c * Math.pow(t, 2) +
+ 6 * c * adjustedT * t -
+ 6 * b * adjustedT * t +
+ 3 * b * Math.pow(adjustedT, 2) -
+ 3 * a * Math.pow(adjustedT, 2)
+ );
+};
- this.drawingContext.fillText(line, x, y);
- }
- }
- else { // an opentype font, let it handle the rendering
+/**
+ * Draws a curved line on the screen between two points, given as the
+ * middle four parameters. The first two parameters are a control point, as
+ * if the curve came from this point even though it's not drawn. The last
+ * two parameters similarly describe the other control point.
+ * Longer curves can be created by putting a series of curve() functions
+ * together or using curveVertex(). An additional function called
+ * curveTightness() provides control for the visual quality of the curve.
+ * The curve() function is an implementation of Catmull-Rom splines.
+ *
+ * @method curve
+ * @param {Number} x1 x-coordinate for the beginning control point
+ * @param {Number} y1 y-coordinate for the beginning control point
+ * @param {Number} x2 x-coordinate for the first point
+ * @param {Number} y2 y-coordinate for the first point
+ * @param {Number} x3 x-coordinate for the second point
+ * @param {Number} y3 y-coordinate for the second point
+ * @param {Number} x4 x-coordinate for the ending control point
+ * @param {Number} y4 y-coordinate for the ending control point
+ * @chainable
+ * @example
+ *
+ *
+ * noFill();
+ * stroke(255, 102, 0);
+ * curve(5, 26, 5, 26, 73, 24, 73, 61);
+ * stroke(0);
+ * curve(5, 26, 73, 24, 73, 61, 15, 65);
+ * stroke(255, 102, 0);
+ * curve(73, 24, 73, 61, 15, 65, 15, 65);
+ *
+ *
+ *
+ *
+ * // Define the curve points as JavaScript objects
+ * var p1 = { x: 5, y: 26 },
+ p2 = { x: 73, y: 24 };
+ * var p3 = { x: 73, y: 61 },
+ p4 = { x: 15, y: 65 };
+ * noFill();
+ * stroke(255, 102, 0);
+ * curve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y);
+ * stroke(0);
+ * curve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y);
+ * stroke(255, 102, 0);
+ * curve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y);
+ *
+ *
+ *
+ *
+ * noFill();
+ * stroke(255, 102, 0);
+ * curve(5, 26, 0, 5, 26, 0, 73, 24, 0, 73, 61, 0);
+ * stroke(0);
+ * curve(5, 26, 0, 73, 24, 0, 73, 61, 0, 15, 65, 0);
+ * stroke(255, 102, 0);
+ * curve(73, 24, 0, 73, 61, 0, 15, 65, 0, 15, 65, 0);
+ *
+ *
+ *
+ * @alt
+ * horseshoe shape with orange ends facing left and black curved center.
+ * horseshoe shape with orange ends facing left and black curved center.
+ * curving black and orange lines.
+ */
+/**
+ * @method curve
+ * @param {Number} x1
+ * @param {Number} y1
+ * @param {Number} z1 z-coordinate for the beginning control point
+ * @param {Number} x2
+ * @param {Number} y2
+ * @param {Number} z2 z-coordinate for the first point
+ * @param {Number} x3
+ * @param {Number} y3
+ * @param {Number} z3 z-coordinate for the second point
+ * @param {Number} x4
+ * @param {Number} y4
+ * @param {Number} z4 z-coordinate for the ending control point
+ * @chainable
+ */
+p5.prototype.curve = function() {
+ p5._validateParameters('curve', arguments);
- this._textFont._renderPath(line, x, y, { renderer: this });
+ if (this._renderer._doStroke) {
+ this._renderer.curve.apply(this._renderer, arguments);
}
- p.pop();
-
- return p;
+ return this;
};
-p5.Renderer2D.prototype.textWidth = function(s) {
-
- if (this._isOpenType()) {
-
- return this._textFont._textWidth(s, this._textSize);
+/**
+ * Sets the resolution at which curves display.
+ *
+ * The default value is 20 while the minimum value is 3.
+ *
+ * This function is only useful when using the WEBGL renderer
+ * as the default canvas renderer does not use this
+ * information.
+ *
+ * @method curveDetail
+ * @param {Number} resolution of the curves
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ *
+ * curveDetail(5);
+ * }
+ * function draw() {
+ * background(200);
+ *
+ * curve(250, 600, 0, -30, 40, 0, 30, 30, 0, -250, 600, 0);
+ * }
+ *
+ *
+ *
+ * @alt
+ * white arch shape with a low level of curve detail.
+ *
+ */
+p5.prototype.curveDetail = function(d) {
+ p5._validateParameters('curveDetail', arguments);
+ if (d < 3) {
+ this._curveDetail = 3;
+ } else {
+ this._curveDetail = d;
}
-
- return this.drawingContext.measureText(s).width;
+ return this;
};
-p5.Renderer2D.prototype.textAlign = function(h, v) {
+/**
+ * Modifies the quality of forms created with curve() and curveVertex().
+ * The parameter tightness determines how the curve fits to the vertex
+ * points. The value 0.0 is the default value for tightness (this value
+ * defines the curves to be Catmull-Rom splines) and the value 1.0 connects
+ * all the points with straight lines. Values within the range -5.0 and 5.0
+ * will deform the curves but will leave them recognizable and as values
+ * increase in magnitude, they will continue to deform.
+ *
+ * @method curveTightness
+ * @param {Number} amount of deformation from the original vertices
+ * @chainable
+ * @example
+ *
+ *
+ * // Move the mouse left and right to see the curve change
+ *
+ * function setup() {
+ * createCanvas(100, 100);
+ * noFill();
+ * }
+ *
+ * function draw() {
+ * background(204);
+ * var t = map(mouseX, 0, width, -5, 5);
+ * curveTightness(t);
+ * beginShape();
+ * curveVertex(10, 26);
+ * curveVertex(10, 26);
+ * curveVertex(83, 24);
+ * curveVertex(83, 61);
+ * curveVertex(25, 65);
+ * curveVertex(25, 65);
+ * endShape();
+ * }
+ *
+ *
+ *
+ * @alt
+ * Line shaped like right-facing arrow,points move with mouse-x and warp shape.
+ */
+p5.prototype.curveTightness = function(t) {
+ p5._validateParameters('curveTightness', arguments);
+ this._renderer._curveTightness = t;
+ return this;
+};
- if (arguments.length) {
+/**
+ * Evaluates the curve at position t for points a, b, c, d.
+ * The parameter t varies between 0 and 1, a and d are control points
+ * of the curve, and b and c are the start and end points of the curve.
+ * This can be done once with the x coordinates and a second time
+ * with the y coordinates to get the location of a curve at t.
+ *
+ * @method curvePoint
+ * @param {Number} a coordinate of first control point of the curve
+ * @param {Number} b coordinate of first point
+ * @param {Number} c coordinate of second point
+ * @param {Number} d coordinate of second control point
+ * @param {Number} t value between 0 and 1
+ * @return {Number} bezier value at position t
+ * @example
+ *
+ *
+ * noFill();
+ * curve(5, 26, 5, 26, 73, 24, 73, 61);
+ * curve(5, 26, 73, 24, 73, 61, 15, 65);
+ * fill(255);
+ * ellipseMode(CENTER);
+ * var steps = 6;
+ * for (var i = 0; i <= steps; i++) {
+ * var t = i / steps;
+ * var x = curvePoint(5, 5, 73, 73, t);
+ * var y = curvePoint(26, 26, 24, 61, t);
+ * ellipse(x, y, 5, 5);
+ * x = curvePoint(5, 73, 73, 15, t);
+ * y = curvePoint(26, 24, 61, 65, t);
+ * ellipse(x, y, 5, 5);
+ * }
+ *
+ *
+ *
+ *line hooking down to right-bottom with 13 5x5 white ellipse points
+ */
+p5.prototype.curvePoint = function(a, b, c, d, t) {
+ p5._validateParameters('curvePoint', arguments);
- if (h === constants.LEFT ||
- h === constants.RIGHT ||
- h === constants.CENTER) {
+ var t3 = t * t * t,
+ t2 = t * t,
+ f1 = -0.5 * t3 + t2 - 0.5 * t,
+ f2 = 1.5 * t3 - 2.5 * t2 + 1.0,
+ f3 = -1.5 * t3 + 2.0 * t2 + 0.5 * t,
+ f4 = 0.5 * t3 - 0.5 * t2;
+ return a * f1 + b * f2 + c * f3 + d * f4;
+};
- this.drawingContext.textAlign = h;
- }
+/**
+ * Evaluates the tangent to the curve at position t for points a, b, c, d.
+ * The parameter t varies between 0 and 1, a and d are points on the curve,
+ * and b and c are the control points.
+ *
+ * @method curveTangent
+ * @param {Number} a coordinate of first point on the curve
+ * @param {Number} b coordinate of first control point
+ * @param {Number} c coordinate of second control point
+ * @param {Number} d coordinate of second point on the curve
+ * @param {Number} t value between 0 and 1
+ * @return {Number} the tangent at position t
+ * @example
+ *
+ *
+ * noFill();
+ * curve(5, 26, 73, 24, 73, 61, 15, 65);
+ * var steps = 6;
+ * for (var i = 0; i <= steps; i++) {
+ * var t = i / steps;
+ * var x = curvePoint(5, 73, 73, 15, t);
+ * var y = curvePoint(26, 24, 61, 65, t);
+ * //ellipse(x, y, 5, 5);
+ * var tx = curveTangent(5, 73, 73, 15, t);
+ * var ty = curveTangent(26, 24, 61, 65, t);
+ * var a = atan2(ty, tx);
+ * a -= PI / 2.0;
+ * line(x, y, cos(a) * 8 + x, sin(a) * 8 + y);
+ * }
+ *
+ *
+ *
+ * @alt
+ *right curving line mid-right of canvas with 7 short lines radiating from it.
+ */
+p5.prototype.curveTangent = function(a, b, c, d, t) {
+ p5._validateParameters('curveTangent', arguments);
- if (v === constants.TOP ||
- v === constants.BOTTOM ||
- v === constants.CENTER ||
- v === constants.BASELINE) {
+ var t2 = t * t,
+ f1 = -3 * t2 / 2 + 2 * t - 0.5,
+ f2 = 9 * t2 / 2 - 5 * t,
+ f3 = -9 * t2 / 2 + 4 * t + 0.5,
+ f4 = 3 * t2 / 2 - t;
+ return a * f1 + b * f2 + c * f3 + d * f4;
+};
- if (v === constants.CENTER) {
- this.drawingContext.textBaseline = constants._CTX_MIDDLE;
- } else {
- this.drawingContext.textBaseline = v;
- }
- }
+module.exports = p5;
- return this._pInst;
+},{"../error_helpers":21,"../main":25}],34:[function(_dereq_,module,exports){
+/**
+ * @module Shape
+ * @submodule Vertex
+ * @for p5
+ * @requires core
+ * @requires constants
+ */
- } else {
+'use strict';
- var valign = this.drawingContext.textBaseline;
+var p5 = _dereq_('../main');
+var constants = _dereq_('../constants');
+var shapeKind = null;
+var vertices = [];
+var contourVertices = [];
+var isBezier = false;
+var isCurve = false;
+var isQuadratic = false;
+var isContour = false;
+var isFirstContour = true;
- if (valign === constants._CTX_MIDDLE) {
+/**
+ * Use the beginContour() and endContour() functions to create negative
+ * shapes within shapes such as the center of the letter 'O'. beginContour()
+ * begins recording vertices for the shape and endContour() stops recording.
+ * The vertices that define a negative shape must "wind" in the opposite
+ * direction from the exterior shape. First draw vertices for the exterior
+ * clockwise order, then for internal shapes, draw vertices
+ * shape in counter-clockwise.
+ *
+ * These functions can only be used within a beginShape()/endShape() pair and
+ * transformations such as translate(), rotate(), and scale() do not work
+ * within a beginContour()/endContour() pair. It is also not possible to use
+ * other shapes, such as ellipse() or rect() within.
+ *
+ * @method beginContour
+ * @chainable
+ * @example
+ *
+ *
+ * translate(50, 50);
+ * stroke(255, 0, 0);
+ * beginShape();
+ * // Exterior part of shape, clockwise winding
+ * vertex(-40, -40);
+ * vertex(40, -40);
+ * vertex(40, 40);
+ * vertex(-40, 40);
+ * // Interior part of shape, counter-clockwise winding
+ * beginContour();
+ * vertex(-20, -20);
+ * vertex(-20, 20);
+ * vertex(20, 20);
+ * vertex(20, -20);
+ * endContour();
+ * endShape(CLOSE);
+ *
+ *
+ *
+ * @alt
+ * white rect and smaller grey rect with red outlines in center of canvas.
+ *
+ */
+p5.prototype.beginContour = function() {
+ contourVertices = [];
+ isContour = true;
+ return this;
+};
- valign = constants.CENTER;
+/**
+ * Using the beginShape() and endShape() functions allow creating more
+ * complex forms. beginShape() begins recording vertices for a shape and
+ * endShape() stops recording. The value of the kind parameter tells it which
+ * types of shapes to create from the provided vertices. With no mode
+ * specified, the shape can be any irregular polygon.
+ *
+ * The parameters available for beginShape() are POINTS, LINES, TRIANGLES,
+ * TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the
+ * beginShape() function, a series of vertex() commands must follow. To stop
+ * drawing the shape, call endShape(). Each shape will be outlined with the
+ * current stroke color and filled with the fill color.
+ *
+ * Transformations such as translate(), rotate(), and scale() do not work
+ * within beginShape(). It is also not possible to use other shapes, such as
+ * ellipse() or rect() within beginShape().
+ *
+ * @method beginShape
+ * @param {Constant} [kind] either POINTS, LINES, TRIANGLES, TRIANGLE_FAN
+ * TRIANGLE_STRIP, QUADS, or QUAD_STRIP
+ * @chainable
+ * @example
+ *
+ *
+ * beginShape();
+ * vertex(30, 20);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * vertex(30, 75);
+ * endShape(CLOSE);
+ *
+ *
+ *
+ *
+ *
+ * beginShape(POINTS);
+ * vertex(30, 20);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * vertex(30, 75);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape(LINES);
+ * vertex(30, 20);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * vertex(30, 75);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * noFill();
+ * beginShape();
+ * vertex(30, 20);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * vertex(30, 75);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * noFill();
+ * beginShape();
+ * vertex(30, 20);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * vertex(30, 75);
+ * endShape(CLOSE);
+ *
+ *
+ *
+ *
+ *
+ * beginShape(TRIANGLES);
+ * vertex(30, 75);
+ * vertex(40, 20);
+ * vertex(50, 75);
+ * vertex(60, 20);
+ * vertex(70, 75);
+ * vertex(80, 20);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape(TRIANGLE_STRIP);
+ * vertex(30, 75);
+ * vertex(40, 20);
+ * vertex(50, 75);
+ * vertex(60, 20);
+ * vertex(70, 75);
+ * vertex(80, 20);
+ * vertex(90, 75);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape(TRIANGLE_FAN);
+ * vertex(57.5, 50);
+ * vertex(57.5, 15);
+ * vertex(92, 50);
+ * vertex(57.5, 85);
+ * vertex(22, 50);
+ * vertex(57.5, 15);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape(QUADS);
+ * vertex(30, 20);
+ * vertex(30, 75);
+ * vertex(50, 75);
+ * vertex(50, 20);
+ * vertex(65, 20);
+ * vertex(65, 75);
+ * vertex(85, 75);
+ * vertex(85, 20);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape(QUAD_STRIP);
+ * vertex(30, 20);
+ * vertex(30, 75);
+ * vertex(50, 20);
+ * vertex(50, 75);
+ * vertex(65, 20);
+ * vertex(65, 75);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape();
+ * vertex(20, 20);
+ * vertex(40, 20);
+ * vertex(40, 40);
+ * vertex(60, 40);
+ * vertex(60, 60);
+ * vertex(20, 60);
+ * endShape(CLOSE);
+ *
+ *
+ * @alt
+ * white square-shape with black outline in middle-right of canvas.
+ * 4 black points in a square shape in middle-right of canvas.
+ * 2 horizontal black lines. In the top-right and bottom-right of canvas.
+ * 3 line shape with horizontal on top, vertical in middle and horizontal bottom.
+ * square line shape in middle-right of canvas.
+ * 2 white triangle shapes mid-right canvas. left one pointing up and right down.
+ * 5 horizontal interlocking and alternating white triangles in mid-right canvas.
+ * 4 interlocking white triangles in 45 degree rotated square-shape.
+ * 2 white rectangle shapes in mid-right canvas. Both 20x55.
+ * 3 side-by-side white rectangles center rect is smaller in mid-right canvas.
+ * Thick white l-shape with black outline mid-top-left of canvas.
+ *
+ */
+p5.prototype.beginShape = function(kind) {
+ p5._validateParameters('beginShape', arguments);
+ if (this._renderer.isP3D) {
+ this._renderer.beginShape.apply(this._renderer, arguments);
+ } else {
+ if (
+ kind === constants.POINTS ||
+ kind === constants.LINES ||
+ kind === constants.TRIANGLES ||
+ kind === constants.TRIANGLE_FAN ||
+ kind === constants.TRIANGLE_STRIP ||
+ kind === constants.QUADS ||
+ kind === constants.QUAD_STRIP
+ ) {
+ shapeKind = kind;
+ } else {
+ shapeKind = null;
}
- return {
-
- horizontal: this.drawingContext.textAlign,
- vertical: valign
- };
+ vertices = [];
+ contourVertices = [];
}
+ return this;
};
-p5.Renderer2D.prototype._applyTextProperties = function() {
-
- var font, p = this._pInst;
-
- this._setProperty('_textAscent', null);
- this._setProperty('_textDescent', null);
-
- font = this._textFont;
-
- if (this._isOpenType()) {
+/**
+ * Specifies vertex coordinates for Bezier curves. Each call to
+ * bezierVertex() defines the position of two control points and
+ * one anchor point of a Bezier curve, adding a new segment to a
+ * line or shape. For WebGL mode bezierVertex() can be used in 2D
+ * as well as 3D mode. 2D mode expects 6 parameters, while 3D mode
+ * expects 9 parameters (including z coordinates).
+ *
+ * The first time bezierVertex() is used within a beginShape()
+ * call, it must be prefaced with a call to vertex() to set the first anchor
+ * point. This function must be used between beginShape() and endShape()
+ * and only when there is no MODE or POINTS parameter specified to
+ * beginShape().
+ *
+ * @method bezierVertex
+ * @param {Number} x2 x-coordinate for the first control point
+ * @param {Number} y2 y-coordinate for the first control point
+ * @param {Number} x3 x-coordinate for the second control point
+ * @param {Number} y3 y-coordinate for the second control point
+ * @param {Number} x4 x-coordinate for the anchor point
+ * @param {Number} y4 y-coordinate for the anchor point
+ * @chainable
+ * @example
+ *
+ *
+ * noFill();
+ * beginShape();
+ * vertex(30, 20);
+ * bezierVertex(80, 0, 80, 75, 30, 75);
+ * endShape();
+ *
+ *
+ *
+ *
+ *
+ * beginShape();
+ * vertex(30, 20);
+ * bezierVertex(80, 0, 80, 75, 30, 75);
+ * bezierVertex(50, 80, 60, 25, 30, 20);
+ * endShape();
+ *
+ *
+ *
+ * @alt
+ * crescent-shaped line in middle of canvas. Points facing left.
+ * white crescent shape in middle of canvas. Points facing left.
+ */
+/**
+ * @method bezierVertex
+ * @param {Number} x2
+ * @param {Number} y2
+ * @param {Number} [z2] z-coordinate for the first control point (for WebGL mode)
+ * @param {Number} x3
+ * @param {Number} y3
+ * @param {Number} [z3] z-coordinate for the second control point (for WebGL mode)
+ * @param {Number} x4
+ * @param {Number} y4
+ * @param {Number} [z4] z-coordinate for the anchor point (for WebGL mode)
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * setAttributes('antialias', true);
+ * }
+ * function draw() {
+ * orbitControl();
+ * background(50);
+ * strokeWeight(4);
+ * stroke(255);
+ * point(-25, 30);
+ * point(25, 30);
+ * point(25, -30);
+ * point(-25, -30);
+ *
+ * strokeWeight(1);
+ * noFill();
+ *
+ * beginShape();
+ * vertex(-25, 30);
+ * bezierVertex(25, 30, 25, -30, -25, -30);
+ * endShape();
+ *
+ * beginShape();
+ * vertex(-25, 30, 20);
+ * bezierVertex(25, 30, 20, 25, -30, 20, -25, -30, 20);
+ * endShape();
+ * }
+ *
+ *
+ *
+ * @alt
+ * crescent shape in middle of canvas with another crescent shape on positive z-axis.
+ */
- font = this._textFont.font.familyName;
- this._setProperty('_textStyle', this._textFont.font.styleName);
+p5.prototype.bezierVertex = function() {
+ p5._validateParameters('bezierVertex', arguments);
+ if (this._renderer.isP3D) {
+ this._renderer.bezierVertex.apply(this._renderer, arguments);
+ } else {
+ if (vertices.length === 0) {
+ throw 'vertex() must be used once before calling bezierVertex()';
+ } else {
+ isBezier = true;
+ var vert = [];
+ for (var i = 0; i < arguments.length; i++) {
+ vert[i] = arguments[i];
+ }
+ vert.isVert = false;
+ if (isContour) {
+ contourVertices.push(vert);
+ } else {
+ vertices.push(vert);
+ }
+ }
}
-
- this.drawingContext.font = (this._textStyle || 'normal') +
- ' ' + (this._textSize || 12) + 'px ' + (font || 'sans-serif');
-
- return p;
-};
-
-
-//////////////////////////////////////////////
-// STRUCTURE
-//////////////////////////////////////////////
-
-p5.Renderer2D.prototype.push = function() {
- this.drawingContext.save();
-};
-
-p5.Renderer2D.prototype.pop = function() {
- this.drawingContext.restore();
- // Re-cache the fill / stroke state
- this._cachedFillStyle = this.drawingContext.fillStyle;
- this._cachedStrokeStyle = this.drawingContext.strokeStyle;
+ return this;
};
-module.exports = p5.Renderer2D;
-
-},{"../image/filters":74,"./canvas":53,"./constants":54,"./core":55,"./p5.Renderer":62}],64:[function(_dereq_,module,exports){
/**
- * @module Rendering
- * @submodule Rendering
- * @for p5
+ * Specifies vertex coordinates for curves. This function may only
+ * be used between beginShape() and endShape() and only when there
+ * is no MODE parameter specified to beginShape().
+ * For WebGL mode curveVertex() can be used in 2D as well as 3D mode.
+ * 2D mode expects 2 parameters, while 3D mode expects 3 parameters.
+ *
+ * The first and last points in a series of curveVertex() lines will be used to
+ * guide the beginning and end of a the curve. A minimum of four
+ * points is required to draw a tiny curve between the second and
+ * third points. Adding a fifth point with curveVertex() will draw
+ * the curve between the second, third, and fourth points. The
+ * curveVertex() function is an implementation of Catmull-Rom
+ * splines.
+ *
+ * @method curveVertex
+ * @param {Number} x x-coordinate of the vertex
+ * @param {Number} y y-coordinate of the vertex
+ * @chainable
+ * @example
+ *
+ *
+ * strokeWeight(5);
+ * point(84, 91);
+ * point(68, 19);
+ * point(21, 17);
+ * point(32, 91);
+ * strokeWeight(1);
+ *
+ * noFill();
+ * beginShape();
+ * curveVertex(84, 91);
+ * curveVertex(84, 91);
+ * curveVertex(68, 19);
+ * curveVertex(21, 17);
+ * curveVertex(32, 91);
+ * curveVertex(32, 91);
+ * endShape();
+ *
+ *
+ *
+ *
+ * @alt
+ * Upside-down u-shape line, mid canvas. left point extends beyond canvas view.
*/
-
-var p5 = _dereq_('./core');
-var constants = _dereq_('./constants');
-_dereq_('./p5.Graphics');
-_dereq_('./p5.Renderer2D');
-_dereq_('../webgl/p5.RendererGL');
-var defaultId = 'defaultCanvas0'; // this gets set again in createCanvas
-
/**
- * Creates a canvas element in the document, and sets the dimensions of it
- * in pixels. This method should be called only once at the start of setup.
- * Calling createCanvas more than once in a sketch will result in very
- * unpredicable behavior. If you want more than one drawing canvas
- * you could use createGraphics (hidden by default but it can be shown).
- *
- * The system variables width and height are set by the parameters passed
- * to this function. If createCanvas() is not used, the window will be
- * given a default size of 100x100 pixels.
- *
- * For more ways to position the canvas, see the
- *
- * positioning the canvas wiki page.
- *
- * @method createCanvas
- * @param {Number} w width of the canvas
- * @param {Number} h height of the canvas
- * @param {Constant} [renderer] either P2D or WEBGL
- * @return {HTMLCanvasElement} canvas generated
+ * @method curveVertex
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} [z] z-coordinate of the vertex (for WebGL mode)
+ * @chainable
* @example
*
*
* function setup() {
- * createCanvas(100, 50);
- * background(153);
- * line(0, 0, width, height);
+ * createCanvas(100, 100, WEBGL);
+ * setAttributes('antialias', true);
+ * }
+ * function draw() {
+ * orbitControl();
+ * background(50);
+ * strokeWeight(4);
+ * stroke(255);
+ *
+ * point(-25, 25);
+ * point(-25, 25);
+ * point(-25, -25);
+ * point(25, -25);
+ * point(25, 25);
+ * point(25, 25);
+ *
+ * strokeWeight(1);
+ * noFill();
+ *
+ * beginShape();
+ * curveVertex(-25, 25);
+ * curveVertex(-25, 25);
+ * curveVertex(-25, -25);
+ * curveVertex(25, -25);
+ * curveVertex(25, 25);
+ * curveVertex(25, 25);
+ * endShape();
+ *
+ * beginShape();
+ * curveVertex(-25, 25, 20);
+ * curveVertex(-25, 25, 20);
+ * curveVertex(-25, -25, 20);
+ * curveVertex(25, -25, 20);
+ * curveVertex(25, 25, 20);
+ * curveVertex(25, 25, 20);
+ * endShape();
* }
*
*
*
* @alt
- * Black line extending from top-left of canvas to bottom right.
+ * Upside-down u-shape line, mid canvas with the same shape in positive z-axis.
*
*/
-
-p5.prototype.createCanvas = function(w, h, renderer) {
- //optional: renderer, otherwise defaults to p2d
- var r = renderer || constants.P2D;
- var c;
-
- if(r === constants.WEBGL){
- c = document.getElementById(defaultId);
- if(c) { //if defaultCanvas already exists
- c.parentNode.removeChild(c); //replace the existing defaultCanvas
- this._elements = this._elements.filter(function(e) {
- return e !== this._renderer;
- });
- }
- c = document.createElement('canvas');
- c.id = defaultId;
- }
- else {
- if (!this._defaultGraphicsCreated) {
- c = document.createElement('canvas');
- var i = 0;
- while (document.getElementById('defaultCanvas'+i)) {
- i++;
- }
- defaultId = 'defaultCanvas'+i;
- c.id = defaultId;
- } else { // resize the default canvas if new one is created
- c = this.canvas;
- }
- }
-
- // set to invisible if still in setup (to prevent flashing with manipulate)
- if (!this._setupDone) {
- c.dataset.hidden = true; // tag to show later
- c.style.visibility='hidden';
- }
-
- if (this._userNode) { // user input node case
- this._userNode.appendChild(c);
+p5.prototype.curveVertex = function() {
+ p5._validateParameters('curveVertex', arguments);
+ if (this._renderer.isP3D) {
+ this._renderer.curveVertex.apply(this._renderer, arguments);
} else {
- document.body.appendChild(c);
+ isCurve = true;
+ this.vertex(arguments[0], arguments[1]);
}
+ return this;
+};
+/**
+ * Use the beginContour() and endContour() functions to create negative
+ * shapes within shapes such as the center of the letter 'O'. beginContour()
+ * begins recording vertices for the shape and endContour() stops recording.
+ * The vertices that define a negative shape must "wind" in the opposite
+ * direction from the exterior shape. First draw vertices for the exterior
+ * clockwise order, then for internal shapes, draw vertices
+ * shape in counter-clockwise.
+ *
+ * These functions can only be used within a beginShape()/endShape() pair and
+ * transformations such as translate(), rotate(), and scale() do not work
+ * within a beginContour()/endContour() pair. It is also not possible to use
+ * other shapes, such as ellipse() or rect() within.
+ *
+ * @method endContour
+ * @chainable
+ * @example
+ *
+ *
+ * translate(50, 50);
+ * stroke(255, 0, 0);
+ * beginShape();
+ * // Exterior part of shape, clockwise winding
+ * vertex(-40, -40);
+ * vertex(40, -40);
+ * vertex(40, 40);
+ * vertex(-40, 40);
+ * // Interior part of shape, counter-clockwise winding
+ * beginContour();
+ * vertex(-20, -20);
+ * vertex(-20, 20);
+ * vertex(20, 20);
+ * vertex(20, -20);
+ * endContour();
+ * endShape(CLOSE);
+ *
+ *
+ *
+ * @alt
+ * white rect and smaller grey rect with red outlines in center of canvas.
+ *
+ */
+p5.prototype.endContour = function() {
+ var vert = contourVertices[0].slice(); // copy all data
+ vert.isVert = contourVertices[0].isVert;
+ vert.moveTo = false;
+ contourVertices.push(vert);
- // Init our graphics renderer
- //webgl mode
- if (r === constants.WEBGL) {
- this._setProperty('_renderer', new p5.RendererGL(c, this, true));
- this._elements.push(this._renderer);
+ // prevent stray lines with multiple contours
+ if (isFirstContour) {
+ vertices.push(vertices[0]);
+ isFirstContour = false;
}
- //P2D mode
- else {
- if (!this._defaultGraphicsCreated) {
- this._setProperty('_renderer', new p5.Renderer2D(c, this, true));
- this._defaultGraphicsCreated = true;
- this._elements.push(this._renderer);
- }
+
+ for (var i = 0; i < contourVertices.length; i++) {
+ vertices.push(contourVertices[i]);
}
- this._renderer.resize(w, h);
- this._renderer._applyDefaults();
- return this._renderer;
+ return this;
};
/**
- * Resizes the canvas to given width and height. The canvas will be cleared
- * and draw will be called immediately, allowing the sketch to re-render itself
- * in the resized canvas.
- * @method resizeCanvas
- * @param {Number} w width of the canvas
- * @param {Number} h height of the canvas
- * @param {Boolean} [noRedraw] don't redraw the canvas immediately
+ * The endShape() function is the companion to beginShape() and may only be
+ * called after beginShape(). When endshape() is called, all of image data
+ * defined since the previous call to beginShape() is written into the image
+ * buffer. The constant CLOSE as the value for the MODE parameter to close
+ * the shape (to connect the beginning and the end).
+ *
+ * @method endShape
+ * @param {Constant} [mode] use CLOSE to close the shape
+ * @chainable
* @example
- *
- * function setup() {
- * createCanvas(windowWidth, windowHeight);
- * }
+ *
+ *
+ * noFill();
*
- * function draw() {
- * background(0, 100, 200);
- * }
+ * beginShape();
+ * vertex(20, 20);
+ * vertex(45, 20);
+ * vertex(45, 80);
+ * endShape(CLOSE);
*
- * function windowResized() {
- * resizeCanvas(windowWidth, windowHeight);
- * }
- *
+ * beginShape();
+ * vertex(50, 20);
+ * vertex(75, 20);
+ * vertex(75, 80);
+ * endShape();
+ *
+ *
*
* @alt
- * No image displayed.
+ * Triangle line shape with smallest interior angle on bottom and upside-down L.
*
*/
-p5.prototype.resizeCanvas = function (w, h, noRedraw) {
- if (this._renderer) {
-
- // save canvas properties
- var props = {};
- for (var key in this.drawingContext) {
- var val = this.drawingContext[key];
- if (typeof val !== 'object' && typeof val !== 'function') {
- props[key] = val;
- }
+p5.prototype.endShape = function(mode) {
+ p5._validateParameters('endShape', arguments);
+ if (this._renderer.isP3D) {
+ this._renderer.endShape(
+ mode,
+ isCurve,
+ isBezier,
+ isQuadratic,
+ isContour,
+ shapeKind
+ );
+ } else {
+ if (vertices.length === 0) {
+ return this;
}
- this._renderer.resize(w, h);
- // reset canvas properties
- for (var savedKey in props) {
- this.drawingContext[savedKey] = props[savedKey];
+ if (!this._renderer._doStroke && !this._renderer._doFill) {
+ return this;
}
- if (!noRedraw) {
- this.redraw();
+
+ var closeShape = mode === constants.CLOSE;
+
+ // if the shape is closed, the first element is also the last element
+ if (closeShape && !isContour) {
+ vertices.push(vertices[0]);
+ }
+
+ this._renderer.endShape(
+ mode,
+ vertices,
+ isCurve,
+ isBezier,
+ isQuadratic,
+ isContour,
+ shapeKind
+ );
+
+ // Reset some settings
+ isCurve = false;
+ isBezier = false;
+ isQuadratic = false;
+ isContour = false;
+ isFirstContour = true;
+
+ // If the shape is closed, the first element was added as last element.
+ // We must remove it again to prevent the list of vertices from growing
+ // over successive calls to endShape(CLOSE)
+ if (closeShape) {
+ vertices.pop();
}
}
+ return this;
};
-
/**
- * Removes the default canvas for a p5 sketch that doesn't
- * require a canvas
- * @method noCanvas
+ * Specifies vertex coordinates for quadratic Bezier curves. Each call to
+ * quadraticVertex() defines the position of one control points and one
+ * anchor point of a Bezier curve, adding a new segment to a line or shape.
+ * The first time quadraticVertex() is used within a beginShape() call, it
+ * must be prefaced with a call to vertex() to set the first anchor point.
+ * For WebGL mode quadraticVertex() can be used in 2D as well as 3D mode.
+ * 2D mode expects 4 parameters, while 3D mode expects 6 parameters
+ * (including z coordinates).
+ *
+ * This function must be used between beginShape() and endShape()
+ * and only when there is no MODE or POINTS parameter specified to
+ * beginShape().
+ *
+ * @method quadraticVertex
+ * @param {Number} cx x-coordinate for the control point
+ * @param {Number} cy y-coordinate for the control point
+ * @param {Number} x3 x-coordinate for the anchor point
+ * @param {Number} y3 y-coordinate for the anchor point
+ * @chainable
* @example
*
*
- * function setup() {
- * noCanvas();
- * }
+ * strokeWeight(5);
+ * point(20, 20);
+ * point(80, 20);
+ * point(50, 50);
+ *
+ * noFill();
+ * strokeWeight(1);
+ * beginShape();
+ * vertex(20, 20);
+ * quadraticVertex(80, 20, 50, 50);
+ * endShape();
*
*
*
- * @alt
- * no image displayed
+ *
+ *
+ * strokeWeight(5);
+ * point(20, 20);
+ * point(80, 20);
+ * point(50, 50);
+ *
+ * point(20, 80);
+ * point(80, 80);
+ * point(80, 60);
+ *
+ * noFill();
+ * strokeWeight(1);
+ * beginShape();
+ * vertex(20, 20);
+ * quadraticVertex(80, 20, 50, 50);
+ * quadraticVertex(20, 80, 80, 80);
+ * vertex(80, 60);
+ * endShape();
+ *
+ *
*
+ * @alt
+ * arched-shaped black line with 4 pixel thick stroke weight.
+ * backwards s-shaped black line with 4 pixel thick stroke weight.
*/
-p5.prototype.noCanvas = function() {
- if (this.canvas) {
- this.canvas.parentNode.removeChild(this.canvas);
- }
-};
-
/**
- * Creates and returns a new p5.Renderer object. Use this class if you need
- * to draw into an off-screen graphics buffer. The two parameters define the
- * width and height in pixels.
- *
- * @method createGraphics
- * @param {Number} w width of the offscreen graphics buffer
- * @param {Number} h height of the offscreen graphics buffer
- * @param {Constant} [renderer] either P2D or WEBGL
- * undefined defaults to p2d
- * @return {p5.Graphics} offscreen graphics buffer
+ * @method quadraticVertex
+ * @param {Number} cx
+ * @param {Number} cy
+ * @param {Number} [cz] z-coordinate for the control point (for WebGL mode)
+ * @param {Number} x3
+ * @param {Number} y3
+ * @param {Number} [z3] z-coordinate for the anchor point (for WebGL mode)
+ * @chainable
* @example
*
*
- * var pg;
* function setup() {
- * createCanvas(100, 100);
- * pg = createGraphics(100, 100);
+ * createCanvas(100, 100, WEBGL);
+ * setAttributes('antialias', true);
* }
* function draw() {
- * background(200);
- * pg.background(100);
- * pg.noStroke();
- * pg.ellipse(pg.width/2, pg.height/2, 50, 50);
- * image(pg, 50, 50);
- * image(pg, 0, 0, 50, 50);
+ * orbitControl();
+ * background(50);
+ * strokeWeight(4);
+ * stroke(255);
+ *
+ * point(-35, -35);
+ * point(35, -35);
+ * point(0, 0);
+ * point(-35, 35);
+ * point(35, 35);
+ * point(35, 10);
+ *
+ * strokeWeight(1);
+ * noFill();
+ *
+ * beginShape();
+ * vertex(-35, -35);
+ * quadraticVertex(35, -35, 0, 0);
+ * quadraticVertex(-35, 35, 35, 35);
+ * vertex(35, 10);
+ * endShape();
+ *
+ * beginShape();
+ * vertex(-35, -35, 20);
+ * quadraticVertex(35, -35, 20, 0, 0, 20);
+ * quadraticVertex(-35, 35, 20, 35, 35, 20);
+ * vertex(35, 10, 20);
+ * endShape();
* }
*
*
*
* @alt
- * 4 grey squares alternating light and dark grey. White quarter circle mid-left.
- *
+ * backwards s-shaped black line with the same s-shaped line in postive z-axis.
*/
-p5.prototype.createGraphics = function(w, h, renderer){
- return new p5.Graphics(w, h, renderer, this);
+p5.prototype.quadraticVertex = function() {
+ p5._validateParameters('quadraticVertex', arguments);
+ if (this._renderer.isP3D) {
+ this._renderer.quadraticVertex.apply(this._renderer, arguments);
+ } else {
+ //if we're drawing a contour, put the points into an
+ // array for inside drawing
+ if (this._contourInited) {
+ var pt = {};
+ pt.x = arguments[0];
+ pt.y = arguments[1];
+ pt.x3 = arguments[2];
+ pt.y3 = arguments[3];
+ pt.type = constants.QUADRATIC;
+ this._contourVertices.push(pt);
+
+ return this;
+ }
+ if (vertices.length > 0) {
+ isQuadratic = true;
+ var vert = [];
+ for (var i = 0; i < arguments.length; i++) {
+ vert[i] = arguments[i];
+ }
+ vert.isVert = false;
+ if (isContour) {
+ contourVertices.push(vert);
+ } else {
+ vertices.push(vert);
+ }
+ } else {
+ throw new Error(
+ 'vertex() must be used once before calling quadraticVertex()'
+ );
+ }
+ }
+ return this;
};
/**
- * Blends the pixels in the display window according to the defined mode.
- * There is a choice of the following modes to blend the source pixels (A)
- * with the ones of pixels already in the display window (B):
- *
- * BLEND - linear interpolation of colours: C =
- * A*factor + B. This is the default blending mode.ADD - sum of A and BDARKEST - only the darkest colour succeeds: C =
- * min(A*factor, B).LIGHTEST - only the lightest colour succeeds: C =
- * max(A*factor, B).DIFFERENCE - subtract colors from underlying image.EXCLUSION - similar to DIFFERENCE, but less
- * extreme.MULTIPLY - multiply the colors, result will always be
- * darker.SCREEN - opposite multiply, uses inverse values of the
- * colors.REPLACE - the pixels entirely replace the others and
- * don't utilize alpha (transparency) values.OVERLAY - mix of MULTIPLY and SCREEN
- * . Multiplies dark values, and screens light values.HARD_LIGHT - SCREEN when greater than 50%
- * gray, MULTIPLY when lower.SOFT_LIGHT - mix of DARKEST and
- * LIGHTEST. Works like OVERLAY, but not as harsh.
- * DODGE - lightens light tones and increases contrast,
- * ignores darks.BURN - darker areas are applied, increasing contrast,
- * ignores lights.
+ * All shapes are constructed by connecting a series of vertices. vertex()
+ * is used to specify the vertex coordinates for points, lines, triangles,
+ * quads, and polygons. It is used exclusively within the beginShape() and
+ * endShape() functions.
*
- * @method blendMode
- * @param {Constant} mode blend mode to set for canvas.
- * either BLEND, DARKEST, LIGHTEST, DIFFERENCE, MULTIPLY,
- * EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,
- * SOFT_LIGHT, DODGE, BURN, ADD or NORMAL
+ * @method vertex
+ * @param {Number} x x-coordinate of the vertex
+ * @param {Number} y y-coordinate of the vertex
+ * @chainable
* @example
*
*
- * blendMode(LIGHTEST);
- * strokeWeight(30);
- * stroke(80, 150, 255);
- * line(25, 25, 75, 75);
- * stroke(255, 50, 50);
- * line(75, 25, 25, 75);
+ * strokeWeight(3);
+ * beginShape(POINTS);
+ * vertex(30, 20);
+ * vertex(85, 20);
+ * vertex(85, 75);
+ * vertex(30, 75);
+ * endShape();
+ *
+ *
+ *
+ * @alt
+ * 4 black points in a square shape in middle-right of canvas.
+ *
+ *
+ *
+ * createCanvas(100, 100, WEBGL);
+ * background(240, 240, 240);
+ * fill(237, 34, 93);
+ * noStroke();
+ * beginShape();
+ * vertex(0, 35);
+ * vertex(35, 0);
+ * vertex(0, -35);
+ * vertex(-35, 0);
+ * endShape();
*
*
+ *
+ * @alt
+ * 4 points making a diamond shape
+ *
*
*
- * blendMode(MULTIPLY);
- * strokeWeight(30);
- * stroke(80, 150, 255);
- * line(25, 25, 75, 75);
- * stroke(255, 50, 50);
- * line(75, 25, 25, 75);
+ * createCanvas(100, 100, WEBGL);
+ * background(240, 240, 240);
+ * fill(237, 34, 93);
+ * noStroke();
+ * beginShape();
+ * vertex(-10, 10);
+ * vertex(0, 35);
+ * vertex(10, 10);
+ * vertex(35, 0);
+ * vertex(10, -8);
+ * vertex(0, -35);
+ * vertex(-10, -8);
+ * vertex(-35, 0);
+ * endShape();
*
*
+ *
* @alt
- * translucent image thick red & blue diagonal rounded lines intersecting center
- * Thick red & blue diagonal rounded lines intersecting center. dark at overlap
+ * 8 points making a star
+ *
+ *
+ *
+ * strokeWeight(3);
+ * stroke(237, 34, 93);
+ * beginShape(LINES);
+ * vertex(10, 35);
+ * vertex(90, 35);
+ * vertex(10, 65);
+ * vertex(90, 65);
+ * vertex(35, 10);
+ * vertex(35, 90);
+ * vertex(65, 10);
+ * vertex(65, 90);
+ * endShape();
+ *
+ *
+ *
+ * @alt
+ * 8 points making 4 lines
*
*/
-p5.prototype.blendMode = function(mode) {
- if (mode === constants.BLEND || mode === constants.DARKEST ||
- mode === constants.LIGHTEST || mode === constants.DIFFERENCE ||
- mode === constants.MULTIPLY || mode === constants.EXCLUSION ||
- mode === constants.SCREEN || mode === constants.REPLACE ||
- mode === constants.OVERLAY || mode === constants.HARD_LIGHT ||
- mode === constants.SOFT_LIGHT || mode === constants.DODGE ||
- mode === constants.BURN || mode === constants.ADD ||
- mode === constants.NORMAL) {
- this._renderer.blendMode(mode);
+/**
+ * @method vertex
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} z z-coordinate of the vertex
+ * @param {Number} [u] the vertex's texture u-coordinate
+ * @param {Number} [v] the vertex's texture v-coordinate
+ * @chainable
+ */
+p5.prototype.vertex = function(x, y, moveTo, u, v) {
+ if (this._renderer.isP3D) {
+ this._renderer.vertex.apply(this._renderer, arguments);
} else {
- throw new Error('Mode '+mode+' not recognized.');
+ var vert = [];
+ vert.isVert = true;
+ vert[0] = x;
+ vert[1] = y;
+ vert[2] = 0;
+ vert[3] = 0;
+ vert[4] = 0;
+ vert[5] = this._renderer._getFill();
+ vert[6] = this._renderer._getStroke();
+
+ if (moveTo) {
+ vert.moveTo = moveTo;
+ }
+ if (isContour) {
+ if (contourVertices.length === 0) {
+ vert.moveTo = true;
+ }
+ contourVertices.push(vert);
+ } else {
+ vertices.push(vert);
+ }
}
+ return this;
};
module.exports = p5;
-},{"../webgl/p5.RendererGL":106,"./constants":54,"./core":55,"./p5.Graphics":61,"./p5.Renderer2D":63}],65:[function(_dereq_,module,exports){
+},{"../constants":19,"../main":25}],35:[function(_dereq_,module,exports){
+'use strict';
// requestAnim shim layer by Paul Irish
-window.requestAnimationFrame = (function(){
- return window.requestAnimationFrame ||
- window.webkitRequestAnimationFrame ||
- window.mozRequestAnimationFrame ||
- window.oRequestAnimationFrame ||
- window.msRequestAnimationFrame ||
- function(callback, element){
- // should '60' here be framerate?
- window.setTimeout(callback, 1000 / 60);
- };
-})();
-
-// use window.performance() to get max fast and accurate time in milliseconds
-window.performance = window.performance || {};
-window.performance.now = (function(){
- var load_date = Date.now();
- return window.performance.now ||
- window.performance.mozNow ||
- window.performance.msNow ||
- window.performance.oNow ||
- window.performance.webkitNow ||
- function () {
- return Date.now() - load_date;
- };
-})();
-
-/*
// http://paulirish.com/2011/requestanimationframe-for-smart-animating/
// http://my.opera.com/emoller/blog/2011/12/20/
// requestanimationframe-for-smart-er-animating
// requestAnimationFrame polyfill by Erik Möller
// fixes from Paul Irish and Tino Zijdel
-(function() {
- var lastTime = 0;
- var vendors = ['ms', 'moz', 'webkit', 'o'];
- for (var x = 0; x < vendors.length && !window.requestAnimationFrame; ++x) {
- window.requestAnimationFrame =
- window[vendors[x]+'RequestAnimationFrame'];
- window.cancelAnimationFrame =
- window[vendors[x]+'CancelAnimationFrame'] ||
- window[vendors[x]+'CancelRequestAnimationFrame'];
- }
-
- if (!window.requestAnimationFrame) {
- window.requestAnimationFrame = function(callback, element) {
- var currTime = new Date().getTime();
- var timeToCall = Math.max(0, 16 - (currTime - lastTime));
- var id = window.setTimeout(function()
- { callback(currTime + timeToCall); }, timeToCall);
- lastTime = currTime + timeToCall;
- return id;
- };
- }
-
- if (!window.cancelAnimationFrame) {
- window.cancelAnimationFrame = function(id) {
- clearTimeout(id);
- };
- }
-}());
-*/
+window.requestAnimationFrame = (function() {
+ return (
+ window.requestAnimationFrame ||
+ window.webkitRequestAnimationFrame ||
+ window.mozRequestAnimationFrame ||
+ window.oRequestAnimationFrame ||
+ window.msRequestAnimationFrame ||
+ function(callback, element) {
+ // should '60' here be framerate?
+ window.setTimeout(callback, 1000 / 60);
+ }
+ );
+})();
/**
* shim for Uint8ClampedArray.slice
@@ -49894,18 +54741,79 @@ window.performance.now = (function(){
* Enumerable set to false to protect for...in from
* Uint8ClampedArray.prototype pollution.
*/
-(function () {
+(function() {
'use strict';
- if (typeof Uint8ClampedArray !== 'undefined' &&
- !Uint8ClampedArray.prototype.slice) {
+ if (
+ typeof Uint8ClampedArray !== 'undefined' &&
+ !Uint8ClampedArray.prototype.slice
+ ) {
Object.defineProperty(Uint8ClampedArray.prototype, 'slice', {
value: Array.prototype.slice,
- writable: true, configurable: true, enumerable: false
+ writable: true,
+ configurable: true,
+ enumerable: false
+ });
+ }
+})();
+
+/**
+ * this is implementation of Object.assign() which is unavailable in
+ * IE11 and (non-Chrome) Android browsers.
+ * The assign() method is used to copy the values of all enumerable
+ * own properties from one or more source objects to a target object.
+ * It will return the target object.
+ * Modified from https://github.com/ljharb/object.assign
+ */
+(function() {
+ 'use strict';
+ if (!Object.assign) {
+ var keys = Object.keys;
+ var defineProperty = Object.defineProperty;
+ var canBeObject = function(obj) {
+ return typeof obj !== 'undefined' && obj !== null;
+ };
+ var hasSymbols =
+ typeof Symbol === 'function' && typeof Symbol() === 'symbol';
+ var propIsEnumerable = Object.prototype.propertyIsEnumerable;
+ var isEnumerableOn = function(obj) {
+ return function isEnumerable(prop) {
+ return propIsEnumerable.call(obj, prop);
+ };
+ };
+
+ // per ES6 spec, this function has to have a length of 2
+ var assignShim = function assign(target, source1) {
+ if (!canBeObject(target)) {
+ throw new TypeError('target must be an object');
+ }
+ var objTarget = Object(target);
+ var s, source, i, props;
+ for (s = 1; s < arguments.length; ++s) {
+ source = Object(arguments[s]);
+ props = keys(source);
+ if (hasSymbols && Object.getOwnPropertySymbols) {
+ props.push.apply(
+ props,
+ Object.getOwnPropertySymbols(source).filter(isEnumerableOn(source))
+ );
+ }
+ for (i = 0; i < props.length; ++i) {
+ objTarget[props[i]] = source[props[i]];
+ }
+ }
+ return objTarget;
+ };
+
+ defineProperty(Object, 'assign', {
+ value: assignShim,
+ configurable: true,
+ enumerable: false,
+ writable: true
});
}
-}());
+})();
-},{}],66:[function(_dereq_,module,exports){
+},{}],36:[function(_dereq_,module,exports){
/**
* @module Structure
* @submodule Structure
@@ -49915,26 +54823,23 @@ window.performance.now = (function(){
'use strict';
-var p5 = _dereq_('./core');
+var p5 = _dereq_('./main');
-p5.prototype.exit = function() {
- throw 'exit() not implemented, see remove()';
-};
/**
- * Stops p5.js from continuously executing the code within draw().
- * If loop() is called, the code in draw() begins to run continuously again.
- * If using noLoop() in setup(), it should be the last line inside the block.
+ * Stops p5.js from continuously executing the code within draw().
+ * If loop() is called, the code in draw() begins to run continuously again.
+ * If using noLoop() in setup(), it should be the last line inside the block.
*
- * When noLoop() is used, it's not possible to manipulate or access the
- * screen inside event handling functions such as mousePressed() or
- * keyPressed(). Instead, use those functions to call redraw() or loop(),
- * which will run draw(), which can update the screen properly. This means
- * that when noLoop() has been called, no drawing can happen, and functions
- * like saveFrame() or loadPixels() may not be used.
+ * When noLoop() is used, it's not possible to manipulate or access the
+ * screen inside event handling functions such as mousePressed() or
+ * keyPressed(). Instead, use those functions to call redraw() or loop(),
+ * which will run draw(), which can update the screen properly. This means
+ * that when noLoop() has been called, no drawing can happen, and functions
+ * like saveFrame() or loadPixels() may not be used.
*
- * Note that if the sketch is resized, redraw() will be called to update
- * the sketch, even after noLoop() has been specified. Otherwise, the sketch
- * would enter an odd state until loop() was called.
+ * Note that if the sketch is resized, redraw() will be called to update
+ * the sketch, even after noLoop() has been specified. Otherwise, the sketch
+ * would enter an odd state until loop() was called.
*
* @method noLoop
* @example
@@ -49984,8 +54889,8 @@ p5.prototype.noLoop = function() {
};
/**
* By default, p5.js loops through draw() continuously, executing the code
- * within it. However, the draw() loop may be stopped by calling noLoop().
- * In that case, the draw() loop can be resumed with loop().
+ * within it. However, the draw() loop may be stopped by calling noLoop().
+ * In that case, the draw() loop can be resumed with loop().
*
* @method loop
* @example
@@ -50025,53 +54930,53 @@ p5.prototype.loop = function() {
};
/**
- * The push() function saves the current drawing style settings and
- * transformations, while pop() restores these settings. Note that these
+ * The push() function saves the current drawing style settings and
+ * transformations, while pop() restores these settings. Note that these
* functions are always used together. They allow you to change the style
* and transformation settings and later return to what you had. When a new
- * state is started with push(), it builds on the current style and transform
- * information. The push() and pop() functions can be embedded to provide
+ * state is started with push(), it builds on the current style and transform
+ * information. The push() and pop() functions can be embedded to provide
* more control. (See the second example for a demonstration.)
*
- * push() stores information related to the current transformation state
- * and style settings controlled by the following functions: fill(),
- * stroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),
- * imageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),
- * textFont(), textMode(), textSize(), textLeading().
+ * push() stores information related to the current transformation state
+ * and style settings controlled by the following functions: fill(),
+ * stroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),
+ * imageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),
+ * textFont(), textMode(), textSize(), textLeading().
*
* @method push
* @example
*
*
- * ellipse(0, 50, 33, 33); // Left circle
+ * ellipse(0, 50, 33, 33); // Left circle
*
- * push(); // Start a new drawing state
+ * push(); // Start a new drawing state
* strokeWeight(10);
* fill(204, 153, 0);
* translate(50, 0);
- * ellipse(0, 50, 33, 33); // Middle circle
- * pop(); // Restore original state
+ * ellipse(0, 50, 33, 33); // Middle circle
+ * pop(); // Restore original state
*
- * ellipse(100, 50, 33, 33); // Right circle
+ * ellipse(100, 50, 33, 33); // Right circle
*
*
*
*
- * ellipse(0, 50, 33, 33); // Left circle
+ * ellipse(0, 50, 33, 33); // Left circle
*
- * push(); // Start a new drawing state
+ * push(); // Start a new drawing state
* strokeWeight(10);
* fill(204, 153, 0);
- * ellipse(33, 50, 33, 33); // Left-middle circle
+ * ellipse(33, 50, 33, 33); // Left-middle circle
*
- * push(); // Start another new drawing state
+ * push(); // Start another new drawing state
* stroke(0, 102, 153);
- * ellipse(66, 50, 33, 33); // Right-middle circle
- * pop(); // Restore previous state
+ * ellipse(66, 50, 33, 33); // Right-middle circle
+ * pop(); // Restore previous state
*
- * pop(); // Restore original state
+ * pop(); // Restore original state
*
- * ellipse(100, 50, 33, 33); // Right circle
+ * ellipse(100, 50, 33, 33); // Right circle
*
*
*
@@ -50080,73 +54985,63 @@ p5.prototype.loop = function() {
* 2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.
*
*/
-p5.prototype.push = function () {
- this._renderer.push();
+p5.prototype.push = function() {
this._styles.push({
- _doStroke: this._renderer._doStroke,
- _strokeSet: this._renderer._strokeSet,
- _doFill: this._renderer._doFill,
- _fillSet: this._renderer._fillSet,
- _tint: this._renderer._tint,
- _imageMode: this._renderer._imageMode,
- _rectMode: this._renderer._rectMode,
- _ellipseMode: this._renderer._ellipseMode,
- _colorMode: this._renderer._colorMode,
- _textFont: this._renderer._textFont,
- _textLeading: this._renderer._textLeading,
- _textSize: this._renderer._textSize,
- _textStyle: this._renderer._textStyle
+ props: {
+ _colorMode: this._colorMode
+ },
+ renderer: this._renderer.push()
});
};
/**
- * The push() function saves the current drawing style settings and
- * transformations, while pop() restores these settings. Note that these
+ * The push() function saves the current drawing style settings and
+ * transformations, while pop() restores these settings. Note that these
* functions are always used together. They allow you to change the style
* and transformation settings and later return to what you had. When a new
- * state is started with push(), it builds on the current style and transform
- * information. The push() and pop() functions can be embedded to provide
+ * state is started with push(), it builds on the current style and transform
+ * information. The push() and pop() functions can be embedded to provide
* more control. (See the second example for a demonstration.)
*
- * push() stores information related to the current transformation state
- * and style settings controlled by the following functions: fill(),
- * stroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),
- * imageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),
- * textFont(), textMode(), textSize(), textLeading().
+ * push() stores information related to the current transformation state
+ * and style settings controlled by the following functions: fill(),
+ * stroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),
+ * imageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),
+ * textFont(), textMode(), textSize(), textLeading().
*
* @method pop
* @example
*
*
- * ellipse(0, 50, 33, 33); // Left circle
+ * ellipse(0, 50, 33, 33); // Left circle
*
- * push(); // Start a new drawing state
+ * push(); // Start a new drawing state
* translate(50, 0);
* strokeWeight(10);
* fill(204, 153, 0);
- * ellipse(0, 50, 33, 33); // Middle circle
- * pop(); // Restore original state
+ * ellipse(0, 50, 33, 33); // Middle circle
+ * pop(); // Restore original state
*
- * ellipse(100, 50, 33, 33); // Right circle
+ * ellipse(100, 50, 33, 33); // Right circle
*
*
*
*
- * ellipse(0, 50, 33, 33); // Left circle
+ * ellipse(0, 50, 33, 33); // Left circle
*
- * push(); // Start a new drawing state
+ * push(); // Start a new drawing state
* strokeWeight(10);
* fill(204, 153, 0);
- * ellipse(33, 50, 33, 33); // Left-middle circle
+ * ellipse(33, 50, 33, 33); // Left-middle circle
*
- * push(); // Start another new drawing state
+ * push(); // Start another new drawing state
* stroke(0, 102, 153);
- * ellipse(66, 50, 33, 33); // Right-middle circle
- * pop(); // Restore previous state
+ * ellipse(66, 50, 33, 33); // Right-middle circle
+ * pop(); // Restore previous state
*
- * pop(); // Restore original state
+ * pop(); // Restore original state
*
- * ellipse(100, 50, 33, 33); // Right circle
+ * ellipse(100, 50, 33, 33); // Right circle
*
*
*
@@ -50155,35 +55050,29 @@ p5.prototype.push = function () {
* 2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.
*
*/
-p5.prototype.pop = function () {
- this._renderer.pop();
- var lastS = this._styles.pop();
- for(var prop in lastS){
- this._renderer[prop] = lastS[prop];
+p5.prototype.pop = function() {
+ var style = this._styles.pop();
+ if (style) {
+ this._renderer.pop(style.renderer);
+ Object.assign(this, style.props);
+ } else {
+ console.warn('pop() was called without matching push()');
}
};
-p5.prototype.pushStyle = function() {
- throw new Error('pushStyle() not used, see push()');
-};
-
-p5.prototype.popStyle = function() {
- throw new Error('popStyle() not used, see pop()');
-};
-
/**
*
- * Executes the code within draw() one time. This functions allows the
+ * Executes the code within draw() one time. This functions allows the
* program to update the display window only when necessary, for example
- * when an event registered by mousePressed() or keyPressed() occurs.
+ * when an event registered by mousePressed() or keyPressed() occurs.
*
- * In structuring a program, it only makes sense to call redraw() within
- * events such as mousePressed(). This is because redraw() does not run
- * draw() immediately (it only sets a flag that indicates an update is
+ * In structuring a program, it only makes sense to call redraw() within
+ * events such as mousePressed(). This is because redraw() does not run
+ * draw() immediately (it only sets a flag that indicates an update is
* needed).
*
- * The redraw() function does not work properly when called inside draw().
- * To enable/disable animations, use loop() and noLoop().
+ * The redraw() function does not work properly when called inside draw().
+ * To enable/disable animations, use loop() and noLoop().
*
* In addition you can set the number of redraws per method call. Just
* add an integer as single parameter for the number of redraws.
@@ -50234,51 +55123,38 @@ p5.prototype.popStyle = function() {
* black line on far left of canvas
*
*/
-p5.prototype.redraw = function () {
- this.resetMatrix();
- if(this._renderer.isP3D){
- this._renderer._update();
+p5.prototype.redraw = function(n) {
+ var numberOfRedraws = parseInt(n);
+ if (isNaN(numberOfRedraws) || numberOfRedraws < 1) {
+ numberOfRedraws = 1;
}
- var numberOfRedraws = 1;
- if (arguments.length === 1) {
- try {
- if (parseInt(arguments[0]) > 1) {
- numberOfRedraws = parseInt(arguments[0]);
- }
- } catch (error) {
- // Do nothing, because the default value didn't be changed.
- }
- }
- var userSetup = this.setup || window.setup;
- var userDraw = this.draw || window.draw;
+ var context = this._isGlobal ? window : this;
+ var userSetup = context.setup;
+ var userDraw = context.draw;
if (typeof userDraw === 'function') {
if (typeof userSetup === 'undefined') {
- this.scale(this._pixelDensity, this._pixelDensity);
+ context.scale(context._pixelDensity, context._pixelDensity);
}
- var self = this;
- var callMethod = function (f) {
- f.call(self);
+ var callMethod = function(f) {
+ f.call(context);
};
for (var idxRedraw = 0; idxRedraw < numberOfRedraws; idxRedraw++) {
- this._setProperty('frameCount', this.frameCount + 1);
- this._registeredMethods.pre.forEach(callMethod);
+ context.resetMatrix();
+ if (context._renderer.isP3D) {
+ context._renderer._update();
+ }
+ context._setProperty('frameCount', context.frameCount + 1);
+ context._registeredMethods.pre.forEach(callMethod);
userDraw();
- this._registeredMethods.post.forEach(callMethod);
+ context._registeredMethods.post.forEach(callMethod);
}
- }
-};
-
-p5.prototype.size = function() {
- var s = 'size() is not a valid p5 function, to set the size of the ';
- s += 'drawing canvas, please use createCanvas() instead';
- throw s;
+ }
};
-
module.exports = p5;
-},{"./core":55}],67:[function(_dereq_,module,exports){
+},{"./main":25}],37:[function(_dereq_,module,exports){
/**
* @module Transform
* @submodule Transform
@@ -50287,11 +55163,9 @@ module.exports = p5;
* @requires constants
*/
-
'use strict';
-var p5 = _dereq_('./core');
-var constants = _dereq_('./constants');
+var p5 = _dereq_('./main');
/**
* Multiplies the current matrix by the one specified through the parameters.
@@ -50359,7 +55233,7 @@ var constants = _dereq_('./constants');
* }
*
* function draw() {
- * var step = frameCount % 20
+ * var step = frameCount % 20;
* var angle = map(step, 0, 20, 0, TWO_PI);
* var cos_a = cos(angle);
* var sin_a = sin(angle);
@@ -50379,12 +55253,12 @@ var constants = _dereq_('./constants');
* }
*
* function draw() {
- * var step = frameCount % 20
- * var angle = map(step, 0, 20, -PI/4, PI/4);
+ * var step = frameCount % 20;
+ * var angle = map(step, 0, 20, -PI / 4, PI / 4);
* background(200);
* translate(50, 50);
* // equivalent to shearX(angle);
- * var shear_factor = 1 / tan(PI/2 - angle);
+ * var shear_factor = 1 / tan(PI / 2 - angle);
* applyMatrix(1, 0, shear_factor, 1, 0, 0);
* rect(0, 0, 50, 50);
* }
@@ -50443,7 +55317,7 @@ p5.prototype.resetMatrix = function() {
/**
* Rotates a shape the amount specified by the angle parameter. This
- * function accounts for angleMode, so angles can be entered in either
+ * function accounts for angleMode, so angles can be entered in either
* RADIANS or DEGREES.
*
* Objects are always rotated around their relative position to the
@@ -50451,22 +55325,22 @@ p5.prototype.resetMatrix = function() {
* Transformations apply to everything that happens after and subsequent
* calls to the function accumulates the effect. For example, calling
* rotate(HALF_PI) and then rotate(HALF_PI) is the same as rotate(PI).
- * All tranformations are reset when draw() begins again.
+ * All tranformations are reset when draw() begins again.
*
- * Technically, rotate() multiplies the current transformation matrix
+ * Technically, rotate() multiplies the current transformation matrix
* by a rotation matrix. This function can be further controlled by
- * the push() and pop().
+ * the push() and pop().
*
* @method rotate
* @param {Number} angle the angle of rotation, specified in radians
* or degrees, depending on current angleMode
- * @param {p5.Vector|Array} [axis] (in 3d) the axis to rotate around
+ * @param {p5.Vector|Number[]} [axis] (in 3d) the axis to rotate around
* @chainable
* @example
*
*
- * translate(width/2, height/2);
- * rotate(PI/3.0);
+ * translate(width / 2, height / 2);
+ * rotate(PI / 3.0);
* rect(-26, -26, 52, 52);
*
*
@@ -50476,68 +55350,98 @@ p5.prototype.resetMatrix = function() {
*
*/
p5.prototype.rotate = function(angle, axis) {
- var args = new Array(arguments.length);
- var r;
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- if (this._angleMode === constants.DEGREES) {
- r = this.radians(args[0]);
- } else if (this._angleMode === constants.RADIANS){
- r = args[0];
- }
- //in webgl mode
- if(args.length > 1){
- this._renderer.rotate(r, args[1]);
- }
- else {
- this._renderer.rotate(r);
- }
+ p5._validateParameters('rotate', arguments);
+ this._renderer.rotate(this._toRadians(angle), axis);
return this;
};
/**
* Rotates around X axis.
* @method rotateX
- * @param {Number} rad angles in radians
+ * @param {Number} angle the angle of rotation, specified in radians
+ * or degrees, depending on current angleMode
* @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(255);
+ * rotateX(millis() / 1000);
+ * box();
+ * }
+ *
+ *
+ *
+ * @alt
+ * 3d box rotating around the x axis.
*/
-p5.prototype.rotateX = function(rad) {
- if (this._renderer.isP3D) {
- this._renderer.rotateX(rad);
- } else {
- throw 'not supported in p2d. Please use webgl mode';
- }
+p5.prototype.rotateX = function(angle) {
+ this._assert3d('rotateX');
+ p5._validateParameters('rotateX', arguments);
+ this._renderer.rotateX(this._toRadians(angle));
return this;
};
/**
* Rotates around Y axis.
* @method rotateY
- * @param {Number} rad angles in radians
+ * @param {Number} angle the angle of rotation, specified in radians
+ * or degrees, depending on current angleMode
* @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(255);
+ * rotateY(millis() / 1000);
+ * box();
+ * }
+ *
+ *
+ *
+ * @alt
+ * 3d box rotating around the y axis.
*/
-p5.prototype.rotateY = function(rad) {
- if (this._renderer.isP3D) {
- this._renderer.rotateY(rad);
- } else {
- throw 'not supported in p2d. Please use webgl mode';
- }
+p5.prototype.rotateY = function(angle) {
+ this._assert3d('rotateY');
+ p5._validateParameters('rotateY', arguments);
+ this._renderer.rotateY(this._toRadians(angle));
return this;
};
/**
* Rotates around Z axis. Webgl mode only.
* @method rotateZ
- * @param {Number} rad angles in radians
+ * @param {Number} angle the angle of rotation, specified in radians
+ * or degrees, depending on current angleMode
* @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(255);
+ * rotateZ(millis() / 1000);
+ * box();
+ * }
+ *
+ *
+ *
+ * @alt
+ * 3d box rotating around the z axis.
*/
-p5.prototype.rotateZ = function(rad) {
- if (this._renderer.isP3D) {
- this._renderer.rotateZ(rad);
- } else {
- throw 'not supported in p2d. Please use webgl mode';
- }
+p5.prototype.rotateZ = function(angle) {
+ this._assert3d('rotateZ');
+ p5._validateParameters('rotateZ', arguments);
+ this._renderer.rotateZ(this._toRadians(angle));
return this;
};
@@ -50550,14 +55454,14 @@ p5.prototype.rotateZ = function(rad) {
*
* 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.
+ * 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.
*
* Using this function with the z parameter is only available in WEBGL mode.
- * This function can be further controlled with push() and pop().
+ * This function can be further controlled with push() and pop().
*
* @method scale
- * @param {Number|p5.Vector|Array} s
+ * @param {Number|p5.Vector|Number[]} s
* percent to scale the object, or percentage to
* scale the object in the x-axis if multiple arguments
* are given
@@ -50567,9 +55471,9 @@ p5.prototype.rotateZ = function(rad) {
* @example
*
*
- * translate(width/2, height/2);
- * rotate(PI/3.0);
- * rect(-26, -26, 52, 52);
+ * rect(30, 20, 50, 50);
+ * scale(0.5);
+ * rect(30, 20, 50, 50);
*
*
*
@@ -50586,922 +55490,325 @@ p5.prototype.rotateZ = function(rad) {
* 2 white rects with black outline- 1 50x50 at center. other 25x65 bottom left
*
*/
-p5.prototype.scale = function() {
- var x,y,z;
- var args = new Array(arguments.length);
- for(var i = 0; i < args.length; i++) {
- args[i] = arguments[i];
- }
- // Only check for Vector argument type if Vector is available
- if (typeof p5.Vector !== 'undefined' && args[0] instanceof p5.Vector) {
- x = args[0].x;
- y = args[0].y;
- z = args[0].z;
- }
- else if(args[0] instanceof Array){
- x = args[0][0];
- y = args[0][1];
- z = args[0][2] || 1;
- }
- else {
- if(args.length === 1){
- x = y = z = args[0];
- }
- else {
- x = args[0];
- y = args[1];
- z = args[2] || 1;
- }
- }
-
- if(this._renderer.isP3D){
- this._renderer.scale.call(this._renderer, x,y,z);
- }
- else {
- this._renderer.scale.call(this._renderer, x,y);
- }
- return this;
-};
-
-/**
- * Shears a shape around the x-axis the amount specified by the angle
- * parameter. Angles should be specified in the current angleMode.
- * Objects are always sheared around their relative position to the origin
- * and positive numbers shear objects in a clockwise direction.
- *
- * Transformations apply to everything that happens after and subsequent
- * calls to the function accumulates the effect. For example, calling
- * shearX(PI/2) and then shearX(PI/2) is the same as shearX(PI).
- * If shearX() is called within the draw(), the transformation is reset when
- * the loop begins again.
- *
- * Technically, shearX() multiplies the current transformation matrix by a
- * rotation matrix. This function can be further controlled by the
- * push() and pop() functions.
- *
- * @method shearX
- * @param {Number} angle angle of shear specified in radians or degrees,
- * depending on current angleMode
- * @chainable
- * @example
- *
- *
- * translate(width/4, height/4);
- * shearX(PI/4.0);
- * rect(0, 0, 30, 30);
- *
- *
- *
- * @alt
- * white irregular quadrilateral with black outline at top middle.
- *
- */
-p5.prototype.shearX = function(angle) {
- if (this._angleMode === constants.DEGREES) {
- angle = this.radians(angle);
- }
- this._renderer.shearX(angle);
- return this;
-};
-
-/**
- * Shears a shape around the y-axis the amount specified by the angle
- * parameter. Angles should be specified in the current angleMode. Objects
- * are always sheared around their relative position to the origin and
- * positive numbers shear objects in a clockwise direction.
- *
- * Transformations apply to everything that happens after and subsequent
- * calls to the function accumulates the effect. For example, calling
- * shearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If
- * shearY() is called within the draw(), the transformation is reset when
- * the loop begins again.
- *
- * Technically, shearY() multiplies the current transformation matrix by a
- * rotation matrix. This function can be further controlled by the
- * push() and pop() functions.
- *
- * @method shearY
- * @param {Number} angle angle of shear specified in radians or degrees,
- * depending on current angleMode
- * @chainable
- * @example
- *
- *
- * translate(width/4, height/4);
- * shearY(PI/4.0);
- * rect(0, 0, 30, 30);
- *
- *
- *
- * @alt
- * white irregular quadrilateral with black outline at middle bottom.
- *
- */
-p5.prototype.shearY = function(angle) {
- if (this._angleMode === constants.DEGREES) {
- angle = this.radians(angle);
- }
- this._renderer.shearY(angle);
- return this;
-};
-
-/**
- * Specifies an amount to displace objects within the display window.
- * The x parameter specifies left/right translation, the y parameter
- * specifies up/down translation.
- *
- * Transformations are cumulative and 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). If translate() is called within draw(), the
- * transformation is reset when the loop begins again. This function can be
- * further controlled by using push() and pop().
- *
- * @method translate
- * @param {Number} x left/right translation
- * @param {Number} y up/down translation
- * @param {Number} [z] forward/backward translation (webgl only)
- * @chainable
- * @example
- *
- *
- * translate(30, 20);
- * rect(0, 0, 55, 55);
- *
- *
- *
- *
- *
- * rect(0, 0, 55, 55); // Draw rect at original 0,0
- * translate(30, 20);
- * rect(0, 0, 55, 55); // Draw rect at new 0,0
- * translate(14, 14);
- * rect(0, 0, 55, 55); // Draw rect at new 0,0
- *
- *
- *
- * @alt
- * white 55x55 rect with black outline at center right.
- * 3 white 55x55 rects with black outlines at top-l, center-r and bottom-r.
- *
- */
-p5.prototype.translate = function(x, y, z) {
- if (this._renderer.isP3D) {
- this._renderer.translate(x, y, z);
- } else {
- this._renderer.translate(x, y);
- }
- return this;
-};
-
-module.exports = p5;
-
-},{"./constants":54,"./core":55}],68:[function(_dereq_,module,exports){
-/**
- * @module Shape
- * @submodule Vertex
- * @for p5
- * @requires core
- * @requires constants
- */
-
-'use strict';
-
-var p5 = _dereq_('./core');
-var constants = _dereq_('./constants');
-var shapeKind = null;
-var vertices = [];
-var contourVertices = [];
-var isBezier = false;
-var isCurve = false;
-var isQuadratic = false;
-var isContour = false;
-var isFirstContour = true;
-
-/**
- * Use the beginContour() and endContour() functions to create negative
- * shapes within shapes such as the center of the letter 'O'. beginContour()
- * begins recording vertices for the shape and endContour() stops recording.
- * The vertices that define a negative shape must "wind" in the opposite
- * direction from the exterior shape. First draw vertices for the exterior
- * clockwise order, then for internal shapes, draw vertices
- * shape in counter-clockwise.
- *
- * These functions can only be used within a beginShape()/endShape() pair and
- * transformations such as translate(), rotate(), and scale() do not work
- * within a beginContour()/endContour() pair. It is also not possible to use
- * other shapes, such as ellipse() or rect() within.
- *
- * @method beginContour
- * @chainable
- * @example
- *
- *
- * translate(50, 50);
- * stroke(255, 0, 0);
- * beginShape();
- * // Exterior part of shape, clockwise winding
- * vertex(-40, -40);
- * vertex(40, -40);
- * vertex(40, 40);
- * vertex(-40, 40);
- * // Interior part of shape, counter-clockwise winding
- * beginContour();
- * vertex(-20, -20);
- * vertex(-20, 20);
- * vertex(20, 20);
- * vertex(20, -20);
- * endContour();
- * endShape(CLOSE);
- *
- *
- *
- * @alt
- * white rect and smaller grey rect with red outlines in center of canvas.
- *
- */
-p5.prototype.beginContour = function() {
- contourVertices = [];
- isContour = true;
- return this;
-};
-
-/**
- * Using the beginShape() and endShape() functions allow creating more
- * complex forms. beginShape() begins recording vertices for a shape and
- * endShape() stops recording. The value of the kind parameter tells it which
- * types of shapes to create from the provided vertices. With no mode
- * specified, the shape can be any irregular polygon.
- *
- * The parameters available for beginShape() are POINTS, LINES, TRIANGLES,
- * TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the
- * beginShape() function, a series of vertex() commands must follow. To stop
- * drawing the shape, call endShape(). Each shape will be outlined with the
- * current stroke color and filled with the fill color.
- *
- * Transformations such as translate(), rotate(), and scale() do not work
- * within beginShape(). It is also not possible to use other shapes, such as
- * ellipse() or rect() within beginShape().
- *
- * @method beginShape
- * @param {Constant} [kind] either POINTS, LINES, TRIANGLES, TRIANGLE_FAN
- * TRIANGLE_STRIP, QUADS, or QUAD_STRIP
- * @chainable
- * @example
- *
- *
- * beginShape();
- * vertex(30, 20);
- * vertex(85, 20);
- * vertex(85, 75);
- * vertex(30, 75);
- * endShape(CLOSE);
- *
- *
- *
- *
- *
- * // currently not working
- * beginShape(POINTS);
- * vertex(30, 20);
- * vertex(85, 20);
- * vertex(85, 75);
- * vertex(30, 75);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape(LINES);
- * vertex(30, 20);
- * vertex(85, 20);
- * vertex(85, 75);
- * vertex(30, 75);
- * endShape();
- *
- *
- *
- *
- *
- * noFill();
- * beginShape();
- * vertex(30, 20);
- * vertex(85, 20);
- * vertex(85, 75);
- * vertex(30, 75);
- * endShape();
- *
- *
- *
- *
- *
- * noFill();
- * beginShape();
- * vertex(30, 20);
- * vertex(85, 20);
- * vertex(85, 75);
- * vertex(30, 75);
- * endShape(CLOSE);
- *
- *
- *
- *
- *
- * beginShape(TRIANGLES);
- * vertex(30, 75);
- * vertex(40, 20);
- * vertex(50, 75);
- * vertex(60, 20);
- * vertex(70, 75);
- * vertex(80, 20);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape(TRIANGLE_STRIP);
- * vertex(30, 75);
- * vertex(40, 20);
- * vertex(50, 75);
- * vertex(60, 20);
- * vertex(70, 75);
- * vertex(80, 20);
- * vertex(90, 75);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape(TRIANGLE_FAN);
- * vertex(57.5, 50);
- * vertex(57.5, 15);
- * vertex(92, 50);
- * vertex(57.5, 85);
- * vertex(22, 50);
- * vertex(57.5, 15);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape(QUADS);
- * vertex(30, 20);
- * vertex(30, 75);
- * vertex(50, 75);
- * vertex(50, 20);
- * vertex(65, 20);
- * vertex(65, 75);
- * vertex(85, 75);
- * vertex(85, 20);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape(QUAD_STRIP);
- * vertex(30, 20);
- * vertex(30, 75);
- * vertex(50, 20);
- * vertex(50, 75);
- * vertex(65, 20);
- * vertex(65, 75);
- * vertex(85, 20);
- * vertex(85, 75);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape();
- * vertex(20, 20);
- * vertex(40, 20);
- * vertex(40, 40);
- * vertex(60, 40);
- * vertex(60, 60);
- * vertex(20, 60);
- * endShape(CLOSE);
- *
- *
- * @alt
- * white square-shape with black outline in middle-right of canvas.
- * 4 black points in a square shape in middle-right of canvas.
- * 2 horizontal black lines. In the top-right and bottom-right of canvas.
- * 3 line shape with horizontal on top, vertical in middle and horizontal bottom.
- * square line shape in middle-right of canvas.
- * 2 white triangle shapes mid-right canvas. left one pointing up and right down.
- * 5 horizontal interlocking and alternating white triangles in mid-right canvas.
- * 4 interlocking white triangles in 45 degree rotated square-shape.
- * 2 white rectangle shapes in mid-right canvas. Both 20x55.
- * 3 side-by-side white rectangles center rect is smaller in mid-right canvas.
- * Thick white l-shape with black outline mid-top-left of canvas.
- *
- */
-p5.prototype.beginShape = function(kind) {
- if (kind === constants.POINTS ||
- kind === constants.LINES ||
- kind === constants.TRIANGLES ||
- kind === constants.TRIANGLE_FAN ||
- kind === constants.TRIANGLE_STRIP ||
- kind === constants.QUADS ||
- kind === constants.QUAD_STRIP) {
- shapeKind = kind;
- } else {
- shapeKind = null;
- }
- if(this._renderer.isP3D){
- this._renderer.beginShape(kind);
- } else {
- vertices = [];
- contourVertices = [];
- }
- return this;
-};
-
-/**
- * Specifies vertex coordinates for Bezier curves. Each call to
- * bezierVertex() defines the position of two control points and
- * one anchor point of a Bezier curve, adding a new segment to a
- * line or shape.
- *
- * The first time bezierVertex() is used within a
- * beginShape() call, it must be prefaced with a call to vertex()
- * to set the first anchor point. This function must be used between
- * beginShape() and endShape() and only when there is no MODE
- * parameter specified to beginShape().
- *
- * @method bezierVertex
- * @param {Number} x2 x-coordinate for the first control point
- * @param {Number} y2 y-coordinate for the first control point
- * @param {Number} x3 x-coordinate for the second control point
- * @param {Number} y3 y-coordinate for the second control point
- * @param {Number} x4 x-coordinate for the anchor point
- * @param {Number} y4 y-coordinate for the anchor point
- * @chainable
- * @example
- *
- *
- * noFill();
- * beginShape();
- * vertex(30, 20);
- * bezierVertex(80, 0, 80, 75, 30, 75);
- * endShape();
- *
- *
- *
- *
- *
- * beginShape();
- * vertex(30, 20);
- * bezierVertex(80, 0, 80, 75, 30, 75);
- * bezierVertex(50, 80, 60, 25, 30, 20);
- * endShape();
- *
- *
- *
- * @alt
- * crescent-shaped line in middle of canvas. Points facing left.
- * white crescent shape in middle of canvas. Points facing left.
- *
- */
-p5.prototype.bezierVertex = function(x2, y2, x3, y3, x4, y4) {
- if (vertices.length === 0) {
- throw 'vertex() must be used once before calling bezierVertex()';
- } else {
- isBezier = true;
- var vert = [];
- for (var i = 0; i < arguments.length; i++) {
- vert[i] = arguments[i];
- }
- vert.isVert = false;
- if (isContour) {
- contourVertices.push(vert);
- } else {
- vertices.push(vert);
- }
- }
- return this;
-};
-
/**
- * Specifies vertex coordinates for curves. This function may only
- * be used between beginShape() and endShape() and only when there
- * is no MODE parameter specified to beginShape().
- *
- * The first and last points in a series of curveVertex() lines will be used to
- * guide the beginning and end of a the curve. A minimum of four
- * points is required to draw a tiny curve between the second and
- * third points. Adding a fifth point with curveVertex() will draw
- * the curve between the second, third, and fourth points. The
- * curveVertex() function is an implementation of Catmull-Rom
- * splines.
- *
- * @method curveVertex
- * @param {Number} x x-coordinate of the vertex
- * @param {Number} y y-coordinate of the vertex
+ * @method scale
+ * @param {p5.Vector|Number[]} scales per-axis percents to scale the object
* @chainable
- * @example
- *
- *
- * noFill();
- * beginShape();
- * curveVertex(84, 91);
- * curveVertex(84, 91);
- * curveVertex(68, 19);
- * curveVertex(21, 17);
- * curveVertex(32, 100);
- * curveVertex(32, 100);
- * endShape();
- *
- *
- *
- * @alt
- * Upside-down u-shape line, mid canvas. left point extends beyond canvas view.
- *
*/
-p5.prototype.curveVertex = function(x,y) {
- isCurve = true;
- this.vertex(x, y);
+p5.prototype.scale = function(x, y, z) {
+ p5._validateParameters('scale', arguments);
+ // Only check for Vector argument type if Vector is available
+ if (x instanceof p5.Vector) {
+ var v = x;
+ x = v.x;
+ y = v.y;
+ z = v.z;
+ } else if (x instanceof Array) {
+ var rg = x;
+ x = rg[0];
+ y = rg[1];
+ z = rg[2] || 1;
+ }
+ if (isNaN(y)) {
+ y = z = x;
+ } else if (isNaN(z)) {
+ z = 1;
+ }
+
+ this._renderer.scale.call(this._renderer, x, y, z);
+
return this;
};
/**
- * Use the beginContour() and endContour() functions to create negative
- * shapes within shapes such as the center of the letter 'O'. beginContour()
- * begins recording vertices for the shape and endContour() stops recording.
- * The vertices that define a negative shape must "wind" in the opposite
- * direction from the exterior shape. First draw vertices for the exterior
- * clockwise order, then for internal shapes, draw vertices
- * shape in counter-clockwise.
+ * Shears a shape around the x-axis the amount specified by the angle
+ * parameter. Angles should be specified in the current angleMode.
+ * Objects are always sheared around their relative position to the origin
+ * and positive numbers shear objects in a clockwise direction.
+ *
+ * Transformations apply to everything that happens after and subsequent
+ * calls to the function accumulates the effect. For example, calling
+ * shearX(PI/2) and then shearX(PI/2) is the same as shearX(PI).
+ * If shearX() is called within the draw(), the transformation is reset when
+ * the loop begins again.
*
- * These functions can only be used within a beginShape()/endShape() pair and
- * transformations such as translate(), rotate(), and scale() do not work
- * within a beginContour()/endContour() pair. It is also not possible to use
- * other shapes, such as ellipse() or rect() within.
+ * Technically, shearX() multiplies the current transformation matrix by a
+ * rotation matrix. This function can be further controlled by the
+ * push() and pop() functions.
*
- * @method endContour
+ * @method shearX
+ * @param {Number} angle angle of shear specified in radians or degrees,
+ * depending on current angleMode
* @chainable
* @example
*
*
- * translate(50, 50);
- * stroke(255, 0, 0);
- * beginShape();
- * // Exterior part of shape, clockwise winding
- * vertex(-40, -40);
- * vertex(40, -40);
- * vertex(40, 40);
- * vertex(-40, 40);
- * // Interior part of shape, counter-clockwise winding
- * beginContour();
- * vertex(-20, -20);
- * vertex(-20, 20);
- * vertex(20, 20);
- * vertex(20, -20);
- * endContour();
- * endShape(CLOSE);
+ * translate(width / 4, height / 4);
+ * shearX(PI / 4.0);
+ * rect(0, 0, 30, 30);
*
*
*
* @alt
- * white rect and smaller grey rect with red outlines in center of canvas.
+ * white irregular quadrilateral with black outline at top middle.
*
*/
-p5.prototype.endContour = function() {
- var vert = contourVertices[0].slice(); // copy all data
- vert.isVert = contourVertices[0].isVert;
- vert.moveTo = false;
- contourVertices.push(vert);
-
- // prevent stray lines with multiple contours
- if (isFirstContour) {
- vertices.push(vertices[0]);
- isFirstContour = false;
- }
-
- for (var i = 0; i < contourVertices.length; i++) {
- vertices.push(contourVertices[i]);
- }
+p5.prototype.shearX = function(angle) {
+ p5._validateParameters('shearX', arguments);
+ this._renderer.shearX(this._toRadians(angle));
return this;
};
/**
- * The endShape() function is the companion to beginShape() and may only be
- * called after beginShape(). When endshape() is called, all of image data
- * defined since the previous call to beginShape() is written into the image
- * buffer. The constant CLOSE as the value for the MODE parameter to close
- * the shape (to connect the beginning and the end).
+ * Shears a shape around the y-axis the amount specified by the angle
+ * parameter. Angles should be specified in the current angleMode. Objects
+ * are always sheared around their relative position to the origin and
+ * positive numbers shear objects in a clockwise direction.
+ *
+ * Transformations apply to everything that happens after and subsequent
+ * calls to the function accumulates the effect. For example, calling
+ * shearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If
+ * shearY() is called within the draw(), the transformation is reset when
+ * the loop begins again.
+ *
+ * Technically, shearY() multiplies the current transformation matrix by a
+ * rotation matrix. This function can be further controlled by the
+ * push() and pop() functions.
*
- * @method endShape
- * @param {Constant} [mode] use CLOSE to close the shape
+ * @method shearY
+ * @param {Number} angle angle of shear specified in radians or degrees,
+ * depending on current angleMode
* @chainable
* @example
*
*
- * noFill();
- *
- * beginShape();
- * vertex(20, 20);
- * vertex(45, 20);
- * vertex(45, 80);
- * endShape(CLOSE);
- *
- * beginShape();
- * vertex(50, 20);
- * vertex(75, 20);
- * vertex(75, 80);
- * endShape();
+ * translate(width / 4, height / 4);
+ * shearY(PI / 4.0);
+ * rect(0, 0, 30, 30);
*
*
*
* @alt
- * Triangle line shape with smallest interior angle on bottom and upside-down L.
+ * white irregular quadrilateral with black outline at middle bottom.
*
*/
-p5.prototype.endShape = function(mode) {
- if(this._renderer.isP3D){
- this._renderer.endShape(mode, isCurve, isBezier,
- isQuadratic, isContour, shapeKind);
- }else{
- if (vertices.length === 0) { return this; }
- if (!this._renderer._doStroke && !this._renderer._doFill) { return this; }
-
- var closeShape = mode === constants.CLOSE;
-
- // if the shape is closed, the first element is also the last element
- if (closeShape && !isContour) {
- vertices.push(vertices[0]);
- }
-
- this._renderer.endShape(mode, vertices, isCurve, isBezier,
- isQuadratic, isContour, shapeKind);
-
- // Reset some settings
- isCurve = false;
- isBezier = false;
- isQuadratic = false;
- isContour = false;
- isFirstContour = true;
-
- // If the shape is closed, the first element was added as last element.
- // We must remove it again to prevent the list of vertices from growing
- // over successive calls to endShape(CLOSE)
- if (closeShape) {
- vertices.pop();
- }
- }
+p5.prototype.shearY = function(angle) {
+ p5._validateParameters('shearY', arguments);
+ this._renderer.shearY(this._toRadians(angle));
return this;
};
/**
- * Specifies vertex coordinates for quadratic Bezier curves. Each call to
- * quadraticVertex() defines the position of one control points and one
- * anchor point of a Bezier curve, adding a new segment to a line or shape.
- * The first time quadraticVertex() is used within a beginShape() call, it
- * must be prefaced with a call to vertex() to set the first anchor point.
- * This function must be used between beginShape() and endShape() and only
- * when there is no MODE parameter specified to beginShape().
+ * Specifies an amount to displace objects within the display window.
+ * The x parameter specifies left/right translation, the y parameter
+ * specifies up/down translation.
+ *
+ * Transformations are cumulative and 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). If translate() is called within draw(), the
+ * transformation is reset when the loop begins again. This function can be
+ * further controlled by using push() and pop().
*
- * @method quadraticVertex
- * @param {Number} cx x-coordinate for the control point
- * @param {Number} cy y-coordinate for the control point
- * @param {Number} x3 x-coordinate for the anchor point
- * @param {Number} y3 y-coordinate for the anchor point
+ * @method translate
+ * @param {Number} x left/right translation
+ * @param {Number} y up/down translation
+ * @param {Number} [z] forward/backward translation (webgl only)
* @chainable
* @example
*
*
- * noFill();
- * strokeWeight(4);
- * beginShape();
- * vertex(20, 20);
- * quadraticVertex(80, 20, 50, 50);
- * endShape();
+ * translate(30, 20);
+ * rect(0, 0, 55, 55);
*
*
*
*
*
- * noFill();
- * strokeWeight(4);
- * beginShape();
- * vertex(20, 20);
- * quadraticVertex(80, 20, 50, 50);
- * quadraticVertex(20, 80, 80, 80);
- * vertex(80, 60);
- * endShape();
+ * rect(0, 0, 55, 55); // Draw rect at original 0,0
+ * translate(30, 20);
+ * rect(0, 0, 55, 55); // Draw rect at new 0,0
+ * translate(14, 14);
+ * rect(0, 0, 55, 55); // Draw rect at new 0,0
*
*
*
- * @alt
- * arched-shaped black line with 4 pixel thick stroke weight.
- * backwards s-shaped black line with 4 pixel thick stroke weight.
- *
- */
-p5.prototype.quadraticVertex = function(cx, cy, x3, y3) {
- //if we're drawing a contour, put the points into an
- // array for inside drawing
- if(this._contourInited) {
- var pt = {};
- pt.x = cx;
- pt.y = cy;
- pt.x3 = x3;
- pt.y3 = y3;
- pt.type = constants.QUADRATIC;
- this._contourVertices.push(pt);
-
- return this;
- }
- if (vertices.length > 0) {
- isQuadratic = true;
- var vert = [];
- for (var i = 0; i < arguments.length; i++) {
- vert[i] = arguments[i];
- }
- vert.isVert = false;
- if (isContour) {
- contourVertices.push(vert);
- } else {
- vertices.push(vert);
- }
- } else {
- throw 'vertex() must be used once before calling quadraticVertex()';
- }
- return this;
-};
-/**
- * All shapes are constructed by connecting a series of vertices. vertex()
- * is used to specify the vertex coordinates for points, lines, triangles,
- * quads, and polygons. It is used exclusively within the beginShape() and
- * endShape() functions.
- *
- * @method vertex
- * @param {Number} x x-coordinate of the vertex
- * @param {Number} y y-coordinate of the vertex
- * @param {Number|Boolean} [z] z-coordinate of the vertex
- * @chainable
- * @example
*
*
- * beginShape(POINTS);
- * vertex(30, 20);
- * vertex(85, 20);
- * vertex(85, 75);
- * vertex(30, 75);
- * endShape();
+ * function draw() {
+ * background(200);
+ * rectMode(CENTER);
+ * translate(width / 2, height / 2);
+ * translate(p5.Vector.fromAngle(millis() / 1000, 40));
+ * rect(0, 0, 20, 20);
+ * }
*
*
*
* @alt
- * 4 black points in a square shape in middle-right of canvas.
+ * white 55x55 rect with black outline at center right.
+ * 3 white 55x55 rects with black outlines at top-l, center-r and bottom-r.
+ * a 20x20 white rect moving in a circle around the canvas
*
*/
-p5.prototype.vertex = function(x, y, moveTo, u, v) {
- if(this._renderer.isP3D){
- this._renderer.vertex.apply(this._renderer, arguments);
- }else{
- var vert = [];
- vert.isVert = true;
- vert[0] = x;
- vert[1] = y;
- vert[2] = 0;
- vert[3] = 0;
- vert[4] = 0;
- vert[5] = this._renderer._getFill();
- vert[6] = this._renderer._getStroke();
-
- if (moveTo) {
- vert.moveTo = moveTo;
- }
- if (isContour) {
- if (contourVertices.length === 0) {
- vert.moveTo = true;
- }
- contourVertices.push(vert);
- } else {
- vertices.push(vert);
- }
+/**
+ * @method translate
+ * @param {p5.Vector} vector the vector to translate by
+ * @chainable
+ */
+p5.prototype.translate = function(x, y, z) {
+ p5._validateParameters('translate', arguments);
+ if (this._renderer.isP3D) {
+ this._renderer.translate(x, y, z);
+ } else {
+ this._renderer.translate(x, y);
}
return this;
};
module.exports = p5;
-},{"./constants":54,"./core":55}],69:[function(_dereq_,module,exports){
+},{"./main":25}],38:[function(_dereq_,module,exports){
/**
* @module Data
* @submodule Dictionary
* @for p5.TypedDict
* @requires core
*
- * This module defines the p5 methods for the p5 Dictionary classes
- * these classes StringDict and NumberDict are for storing and working
- * with key, value pairs
+ * This module defines the p5 methods for the p5 Dictionary classes.
+ * The classes StringDict and NumberDict are for storing and working
+ * with key-value pairs.
*/
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
*
- * Creates a new instance of p5.StringDict using the key, value pair
- * or object you provide.
+ * Creates a new instance of p5.StringDict using the key-value pair
+ * or the object you provide.
*
* @method createStringDict
- * @param {String|Object} key or object
+ * @for p5
+ * @param {String} key
* @param {String} value
* @return {p5.StringDict}
*
+ * @example
+ *
+ *
+ * function setup() {
+ * var myDictionary = createStringDict('p5', 'js');
+ * print(myDictionary.hasKey('p5')); // logs true to console
+ *
+ * var anotherDictionary = createStringDict({ happy: 'coding' });
+ * print(anotherDictionary.hasKey('happy')); // logs true to console
+ * }
+ *
+ */
+/**
+ * @method createStringDict
+ * @param {Object} object object
+ * @return {p5.StringDict}
*/
-p5.prototype.createStringDict = function() {
- return new p5.StringDict(arguments[0], arguments[1]);
+p5.prototype.createStringDict = function(key, value) {
+ p5._validateParameters('createStringDict', arguments);
+ return new p5.StringDict(key, value);
};
/**
*
- * Creates a new instance of p5.NumberDict using the key, value pair
+ * Creates a new instance of p5.NumberDict using the key-value pair
* or object you provide.
*
* @method createNumberDict
- * @param {Number|Object} key or object
+ * @for p5
+ * @param {Number} key
* @param {Number} value
* @return {p5.NumberDict}
*
+ * @example
+ *
+ *
+ * function setup() {
+ * var myDictionary = createNumberDict(100, 42);
+ * print(myDictionary.hasKey(100)); // logs true to console
+ *
+ * var anotherDictionary = createNumberDict({ 200: 84 });
+ * print(anotherDictionary.hasKey(200)); // logs true to console
+ * }
+ *
+ */
+/**
+ * @method createNumberDict
+ * @param {Object} object object
+ * @return {p5.NumberDict}
*/
-p5.prototype.createNumberDict = function() {
- return new p5.NumberDict(arguments[0], arguments[1]);
+p5.prototype.createNumberDict = function(key, value) {
+ p5._validateParameters('createNumberDict', arguments);
+ return new p5.NumberDict(key, value);
};
/**
*
- * Base class for all p5.Dictionary types. More specifically
- * typed Dictionary objects inherit from this
+ * Base class for all p5.Dictionary types. Specifically
+ * typed Dictionary classes inherit from this class.
*
* @class p5.TypedDict
- * @constructor
*
*/
-p5.TypedDict = function() {
- this.data = {};
- if(arguments[0][0] instanceof Object) {
- this.data = arguments[0][0];
+p5.TypedDict = function(key, value) {
+ if (key instanceof Object) {
+ this.data = key;
} else {
- this.data[arguments[0][0]] = arguments[0][1];
+ this.data = {};
+ this.data[key] = value;
}
return this;
};
/**
- * Returns the number of key-value pairs currently in Dictionary object
+ * Returns the number of key-value pairs currently stored in the Dictionary.
*
* @method size
- * @return {Number} the number of key-value pairs in Dictionary object
+ * @return {Integer} the number of key-value pairs in the Dictionary
*
* @example
*
*
- *
* function setup() {
* var myDictionary = createNumberDict(1, 10);
* myDictionary.create(2, 20);
* myDictionary.create(3, 30);
- * var amt = myDictionary.size(); // value of amt is 3
+ * print(myDictionary.size()); // logs 3 to the console
* }
- *
*
*
*/
-p5.TypedDict.prototype.size = function(){
+p5.TypedDict.prototype.size = function() {
return Object.keys(this.data).length;
};
/**
- * Returns true if key exists in Dictionary
- * otherwise returns false
+ * Returns true if the given key exists in the Dictionary,
+ * otherwise returns false.
*
* @method hasKey
- * @param {Number|String} key that you want to access
+ * @param {Number|String} key that you want to look up
* @return {Boolean} whether that key exists in Dictionary
*
* @example
*
*
- *
* function setup() {
* var myDictionary = createStringDict('p5', 'js');
* print(myDictionary.hasKey('p5')); // logs true to console
* }
- *
*
*
*/
@@ -51511,37 +55818,35 @@ p5.TypedDict.prototype.hasKey = function(key) {
};
/**
- * Returns value stored at supplied key.
+ * Returns the value stored at the given key.
*
* @method get
- * @param {Number|String} key that you want to access
+ * @param {Number|String} the key you want to access
* @return {Number|String} the value stored at that key
*
* @example
*
*
- *
* function setup() {
* var myDictionary = createStringDict('p5', 'js');
* var myValue = myDictionary.get('p5');
* print(myValue === 'js'); // logs true to console
* }
- *
*
*
*/
p5.TypedDict.prototype.get = function(key) {
- if(this.data.hasOwnProperty(key)){
+ if (this.data.hasOwnProperty(key)) {
return this.data[key];
- }else{
+ } else {
console.log(key + ' does not exist in this Dictionary');
}
};
/**
- * Changes the value of key if in it already exists in
- * in the Dictionary otherwise makes a new key-value pair
+ * Updates the value associated with the given key in case it already exists
+ * in the Dictionary. Otherwise a new key-value pair is added.
*
* @method set
* @param {Number|String} key
@@ -51550,96 +55855,93 @@ p5.TypedDict.prototype.get = function(key) {
* @example
*
*
- *
* function setup() {
* var myDictionary = createStringDict('p5', 'js');
* myDictionary.set('p5', 'JS');
- * myDictionary.print()
- * // above logs "key: p5 - value: JS" to console
+ * myDictionary.print(); // logs "key: p5 - value: JS" to console
* }
- *
*
*
*/
p5.TypedDict.prototype.set = function(key, value) {
- if (arguments.length === 2) {
- if(!this.data.hasOwnProperty(key)){
- this.create(key, value);
- } else {
- this.data[key] = value;
- }
+ if (this._validate(value)) {
+ this.data[key] = value;
+ } else {
+ console.log('Those values dont work for this dictionary type.');
}
};
/**
- * private helper function to handle the user passing objects in
+ * private helper function to handle the user passing in objects
* during construction or calls to create()
*/
p5.TypedDict.prototype._addObj = function(obj) {
for (var key in obj) {
- if(this._validate(obj[key])) {
- this.data[key] = obj[key];
- } else {
- console.log('Those values dont work for this dictionary type.');
- }
+ this.set(key, obj[key]);
}
};
/**
- * Removes a key-value pair in the Dictionary
+ * Creates a new key-value pair in the Dictionary.
*
* @method create
* @param {Number|String} key
* @param {Number|String} value
- */
-/**
- * @method create
- * @param {Object} obj key/value pair
*
* @example
*
*
- *
* function setup() {
* var myDictionary = createStringDict('p5', 'js');
* myDictionary.create('happy', 'coding');
- * myDictionary.print()
+ * myDictionary.print();
* // above logs "key: p5 - value: js, key: happy - value: coding" to console
* }
- *
*
- *
+ */
+/**
+ * @method create
+ * @param {Object} obj key/value pair
*/
-p5.TypedDict.prototype.create = function() {
- if(arguments.length === 1 && arguments[0] instanceof Object) {
- this._addObj(arguments[0]);
- }
- else if(arguments.length === 2) {
- var obj = {};
- obj[arguments[0]] = arguments[1];
- this._addObj(obj);
+p5.TypedDict.prototype.create = function(key, value) {
+ if (key instanceof Object && typeof value === 'undefined') {
+ this._addObj(key);
+ } else if (typeof key !== 'undefined') {
+ this.set(key, value);
} else {
- console.log('In order to create a new Dictionary entry you must pass ' +
- 'an object or a key, value pair');
+ console.log(
+ 'In order to create a new Dictionary entry you must pass ' +
+ 'an object or a key, value pair'
+ );
}
};
/**
- * Empties Dictionary of all key-value pairs
- * @method clear
- *
+ * Removes all previously stored key-value pairs from the Dictionary.
*
+ * @method clear
+ * @example
+ *
+ *
+ * function setup() {
+ * var myDictionary = createStringDict('p5', 'js');
+ * print(myDictionary.hasKey('p5')); // prints 'true'
+ * myDictionary.clear();
+ * print(myDictionary.hasKey('p5')); // prints 'false'
+ * }
+ *
+ *
*/
-p5.TypedDict.prototype.clear = function(){
+p5.TypedDict.prototype.clear = function() {
this.data = {};
};
/**
- * Removes a key-value pair in the Dictionary
+ * Removes the key-value pair stored at the given key from the Dictionary.
*
* @method remove
* @param {Number|String} key for the pair to remove
@@ -51647,33 +55949,43 @@ p5.TypedDict.prototype.clear = function(){
* @example
*
*
- *
* function setup() {
* var myDictionary = createStringDict('p5', 'js');
* myDictionary.create('happy', 'coding');
- * myDictionary.print()
+ * myDictionary.print();
* // above logs "key: p5 - value: js, key: happy - value: coding" to console
* myDictionary.remove('p5');
* myDictionary.print();
* // above logs "key: happy value: coding" to console
* }
- *
*
*
*/
p5.TypedDict.prototype.remove = function(key) {
- if(this.data.hasOwnProperty(key)) {
+ if (this.data.hasOwnProperty(key)) {
delete this.data[key];
} else {
- throw key + ' does not exist in this Dictionary';
+ throw new Error(key + ' does not exist in this Dictionary');
}
};
/**
- * Logs the list of items currently in the Dictionary to the console
+ * Logs the set of items currently stored in the Dictionary to the console.
*
* @method print
+ *
+ * @example
+ *
+ *
+ * function setup() {
+ * var myDictionary = createStringDict('p5', 'js');
+ * myDictionary.create('happy', 'coding');
+ * myDictionary.print();
+ * // above logs "key: p5 - value: js, key: happy - value: coding" to console
+ * }
+ *
+ *
*/
p5.TypedDict.prototype.print = function() {
@@ -51683,31 +55995,56 @@ p5.TypedDict.prototype.print = function() {
};
/**
- * Converts the Dictionary into a CSV file for local
- * storage.
+ * Converts the Dictionary into a CSV file for local download.
*
* @method saveTable
+ * @example
+ *
+ *
+ * createButton('save')
+ * .position(10, 10)
+ * .mousePressed(function() {
+ * createStringDict({
+ * john: 1940,
+ * paul: 1942,
+ * george: 1943,
+ * ringo: 1940
+ * }).saveTable('beatles');
+ * });
+ *
+ *
*/
-p5.TypedDict.prototype.saveTable = function() {
+p5.TypedDict.prototype.saveTable = function(filename) {
var output = '';
for (var key in this.data) {
output += key + ',' + this.data[key] + '\n';
}
- var filename = arguments[0] || 'mycsv';
- var file = new Blob([output], {type: 'text/csv'});
- var href = window.URL.createObjectURL(file);
-
- p5.prototype.downloadFile(href, filename, 'csv');
+ var blob = new Blob([output], { type: 'text/csv' });
+ p5.prototype.downloadFile(blob, filename || 'mycsv', 'csv');
};
/**
- * Converts the Dictionary into a JSON file for local
- * storage.
+ * Converts the Dictionary into a JSON file for local download.
*
* @method saveJSON
+ * @example
+ *
+ *
+ * createButton('save')
+ * .position(10, 10)
+ * .mousePressed(function() {
+ * createStringDict({
+ * john: 1940,
+ * paul: 1942,
+ * george: 1943,
+ * ringo: 1940
+ * }).saveJSON('beatles');
+ * });
+ *
+ *
*/
p5.TypedDict.prototype.saveJSON = function(filename, opt) {
@@ -51719,44 +56056,40 @@ p5.TypedDict.prototype.saveJSON = function(filename, opt) {
* values for the Dictionary type
*/
-p5.TypedDict.prototype._validate = function(key, value) {
+p5.TypedDict.prototype._validate = function(value) {
return true;
};
/**
*
- * A Dictionary class for Strings.
- *
+ * A simple Dictionary class for Strings.
*
* @class p5.StringDict
- * @constructor
* @extends p5.TypedDict
*
*/
p5.StringDict = function() {
- p5.TypedDict.call(this, arguments);
+ p5.TypedDict.apply(this, arguments);
};
p5.StringDict.prototype = Object.create(p5.TypedDict.prototype);
p5.StringDict.prototype._validate = function(value) {
- return (typeof value === 'string');
+ return typeof value === 'string';
};
/**
*
* A simple Dictionary class for Numbers.
*
- *
* @class p5.NumberDict
- * @constructor
* @extends p5.TypedDict
*
*/
p5.NumberDict = function() {
- p5.TypedDict.call(this, arguments);
+ p5.TypedDict.apply(this, arguments);
};
p5.NumberDict.prototype = Object.create(p5.TypedDict.prototype);
@@ -51767,23 +56100,23 @@ p5.NumberDict.prototype = Object.create(p5.TypedDict.prototype);
*/
p5.NumberDict.prototype._validate = function(value) {
- return (typeof value === 'number');
+ return typeof value === 'number';
};
/**
- * Add to a value stored at a certain key
- * The sum is stored in that location in the Dictionary.
+ * Add the given number to the value currently stored at the given key.
+ * The sum then replaces the value previously stored in the Dictionary.
*
* @method add
- * @param {Number} Key for value you wish to add to
- * @param {Number} Amount to add to the value
+ * @param {Number} Key for the value you wish to add to
+ * @param {Number} Number to add to the value
* @example
*
*
* function setup() {
* var myDictionary = createNumberDict(2, 5);
* myDictionary.add(2, 2);
- * console.log(myDictionary.get(2)); // logs 7 to console.
+ * print(myDictionary.get(2)); // logs 7 to console.
* }
*
*
@@ -51791,7 +56124,7 @@ p5.NumberDict.prototype._validate = function(value) {
*/
p5.NumberDict.prototype.add = function(key, amount) {
- if(this.data.hasOwnProperty(key)){
+ if (this.data.hasOwnProperty(key)) {
this.data[key] += amount;
} else {
console.log('The key - ' + key + ' does not exist in this dictionary.');
@@ -51799,19 +56132,19 @@ p5.NumberDict.prototype.add = function(key, amount) {
};
/**
- * Subtract from a value stored at a certain key
- * The difference is stored in that location in the Dictionary.
+ * Subtract the given number from the value currently stored at the given key.
+ * The difference then replaces the value previously stored in the Dictionary.
*
* @method sub
- * @param {Number} Key for value you wish to subtract from
- * @param {Number} Amount to subtract from the value
+ * @param {Number} Key for the value you wish to subtract from
+ * @param {Number} Number to subtract from the value
* @example
*
*
* function setup() {
* var myDictionary = createNumberDict(2, 5);
* myDictionary.sub(2, 2);
- * console.log(myDictionary.get(2)); // logs 3 to console.
+ * print(myDictionary.get(2)); // logs 3 to console.
* }
*
*
@@ -51823,8 +56156,8 @@ p5.NumberDict.prototype.sub = function(key, amount) {
};
/**
- * Multiply a value stored at a certain key
- * The product is stored in that location in the Dictionary.
+ * Multiply the given number with the value currently stored at the given key.
+ * The product then replaces the value previously stored in the Dictionary.
*
* @method mult
* @param {Number} Key for value you wish to multiply
@@ -51835,7 +56168,7 @@ p5.NumberDict.prototype.sub = function(key, amount) {
* function setup() {
* var myDictionary = createNumberDict(2, 4);
* myDictionary.mult(2, 2);
- * console.log(myDictionary.get(2)); // logs 8 to console.
+ * print(myDictionary.get(2)); // logs 8 to console.
* }
*
*
@@ -51843,7 +56176,7 @@ p5.NumberDict.prototype.sub = function(key, amount) {
*/
p5.NumberDict.prototype.mult = function(key, amount) {
- if(this.data.hasOwnProperty(key)){
+ if (this.data.hasOwnProperty(key)) {
this.data[key] *= amount;
} else {
console.log('The key - ' + key + ' does not exist in this dictionary.');
@@ -51851,8 +56184,8 @@ p5.NumberDict.prototype.mult = function(key, amount) {
};
/**
- * Divide a value stored at a certain key
- * The quotient is stored in that location in the Dictionary.
+ * Divide the given number with the value currently stored at the given key.
+ * The quotient then replaces the value previously stored in the Dictionary.
*
* @method div
* @param {Number} Key for value you wish to divide
@@ -51863,7 +56196,7 @@ p5.NumberDict.prototype.mult = function(key, amount) {
* function setup() {
* var myDictionary = createNumberDict(2, 8);
* myDictionary.div(2, 2);
- * console.log(myDictionary.get(2)); // logs 4 to console.
+ * print(myDictionary.get(2)); // logs 4 to console.
* }
*
*
@@ -51871,7 +56204,7 @@ p5.NumberDict.prototype.mult = function(key, amount) {
*/
p5.NumberDict.prototype.div = function(key, amount) {
- if(this.data.hasOwnProperty(key)){
+ if (this.data.hasOwnProperty(key)) {
this.data[key] /= amount;
} else {
console.log('The key - ' + key + ' does not exist in this dictionary.');
@@ -51886,14 +56219,16 @@ p5.NumberDict.prototype.div = function(key, amount) {
*/
p5.NumberDict.prototype._valueTest = function(flip) {
- if(Object.keys(this.data).length === 0) {
- throw 'Unable to search for a minimum or maximum value on an empty NumberDict';
- } else if(Object.keys(this.data).length === 1) {
+ if (Object.keys(this.data).length === 0) {
+ throw new Error(
+ 'Unable to search for a minimum or maximum value on an empty NumberDict'
+ );
+ } else if (Object.keys(this.data).length === 1) {
return this.data[Object.keys(this.data)[0]];
} else {
var result = this.data[Object.keys(this.data)[0]];
- for(var key in this.data) {
- if(this.data[key] * flip < result * flip) {
+ for (var key in this.data) {
+ if (this.data[key] * flip < result * flip) {
result = this.data[key];
}
}
@@ -51902,7 +56237,7 @@ p5.NumberDict.prototype._valueTest = function(flip) {
};
/**
- * Return the lowest value.
+ * Return the lowest number currently stored in the Dictionary.
*
* @method minValue
* @return {Number}
@@ -51910,8 +56245,9 @@ p5.NumberDict.prototype._valueTest = function(flip) {
*
*
* function setup() {
- * var myDictionary = createNumberDict({2 : -10, 4 : 0.65, 1.2 : 3});
+ * var myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 });
* var lowestValue = myDictionary.minValue(); // value is -10
+ * print(lowestValue);
* }
*
*
@@ -51922,7 +56258,7 @@ p5.NumberDict.prototype.minValue = function() {
};
/**
- * Return the highest value.
+ * Return the highest number currently stored in the Dictionary.
*
* @method maxValue
* @return {Number}
@@ -51930,8 +56266,9 @@ p5.NumberDict.prototype.minValue = function() {
*
*
* function setup() {
- * var myDictionary = createNumberDict({2 : -10, 4 : 0.65, 1.2 : 3});
+ * var myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 });
* var highestValue = myDictionary.maxValue(); // value is 3
+ * print(highestValue);
* }
*
*
@@ -51949,14 +56286,14 @@ p5.NumberDict.prototype.maxValue = function() {
*/
p5.NumberDict.prototype._keyTest = function(flip) {
- if(Object.keys(this.data).length === 0) {
- throw 'Unable to use minValue on an empty NumberDict';
- } else if(Object.keys(this.data).length === 1) {
+ if (Object.keys(this.data).length === 0) {
+ throw new Error('Unable to use minValue on an empty NumberDict');
+ } else if (Object.keys(this.data).length === 1) {
return Object.keys(this.data)[0];
} else {
var result = Object.keys(this.data)[0];
- for(var i=1; i
*
* function setup() {
- * var myDictionary = createNumberDict({2 : 4, 4 : 6, 1.2 : 3});
+ * var myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 });
* var lowestKey = myDictionary.minKey(); // value is 1.2
+ * print(lowestKey);
* }
*
*
@@ -51985,7 +56323,7 @@ p5.NumberDict.prototype.minKey = function() {
};
/**
- * Return the highest key.
+ * Return the highest key currently used in the Dictionary.
*
* @method maxKey
* @return {Number}
@@ -51993,8 +56331,9 @@ p5.NumberDict.prototype.minKey = function() {
*
*
* function setup() {
- * var myDictionary = createNumberDict({ 2 : 4, 4 : 6, 1.2 : 3});
+ * var myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 });
* var highestKey = myDictionary.maxKey(); // value is 4
+ * print(highestKey);
* }
*
*
@@ -52005,7 +56344,8 @@ p5.NumberDict.prototype.maxKey = function() {
};
module.exports = p5.TypedDict;
-},{"../core/core":55}],70:[function(_dereq_,module,exports){
+
+},{"../core/main":25}],39:[function(_dereq_,module,exports){
/**
* @module Events
* @submodule Acceleration
@@ -52015,7 +56355,7 @@ module.exports = p5.TypedDict;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* The system variable deviceOrientation always contains the orientation of
@@ -52090,7 +56430,7 @@ p5.prototype.pAccelerationZ = 0;
*
* @private
*/
-p5.prototype._updatePAccelerations = function(){
+p5.prototype._updatePAccelerations = function() {
this._setProperty('pAccelerationX', this.accelerationX);
this._setProperty('pAccelerationY', this.accelerationY);
this._setProperty('pAccelerationZ', this.accelerationZ);
@@ -52107,11 +56447,11 @@ p5.prototype._updatePAccelerations = function(){
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
* }
*
- * function draw(){
+ * function draw() {
* background(200);
* //rotateZ(radians(rotationZ));
* rotateX(radians(rotationX));
@@ -52141,11 +56481,11 @@ p5.prototype.rotationX = 0;
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
* }
*
- * function draw(){
+ * function draw() {
* background(200);
* //rotateZ(radians(rotationZ));
* //rotateX(radians(rotationX));
@@ -52177,11 +56517,11 @@ p5.prototype.rotationY = 0;
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
* }
*
- * function draw(){
+ * function draw() {
* background(200);
* rotateZ(radians(rotationZ));
* //rotateX(radians(rotationX));
@@ -52219,17 +56559,19 @@ p5.prototype.rotationZ = 0;
* var rotateDirection = 'clockwise';
*
* // Simple range conversion to make things simpler.
- * // This is not absolutely neccessary but the logic
+ * // This is not absolutely necessary but the logic
* // will be different in that case.
*
* var rX = rotationX + 180;
* var pRX = pRotationX + 180;
*
- * if ((rX - pRX > 0 && rX - pRX < 270)|| rX - pRX < -270){
+ * if ((rX - pRX > 0 && rX - pRX < 270) || rX - pRX < -270) {
* rotateDirection = 'clockwise';
- * } else if (rX - pRX < 0 || rX - pRX > 270){
+ * } else if (rX - pRX < 0 || rX - pRX > 270) {
* rotateDirection = 'counter-clockwise';
* }
+ *
+ * print(rotateDirection);
*
*
*
@@ -52262,17 +56604,18 @@ p5.prototype.pRotationX = 0;
* var rotateDirection = 'clockwise';
*
* // Simple range conversion to make things simpler.
- * // This is not absolutely neccessary but the logic
+ * // This is not absolutely necessary but the logic
* // will be different in that case.
*
* var rY = rotationY + 180;
* var pRY = pRotationY + 180;
*
- * if ((rY - pRY > 0 && rY - pRY < 270)|| rY - pRY < -270){
+ * if ((rY - pRY > 0 && rY - pRY < 270) || rY - pRY < -270) {
* rotateDirection = 'clockwise';
- * } else if (rY - pRY < 0 || rY - pRY > 270){
+ * } else if (rY - pRY < 0 || rY - pRY > 270) {
* rotateDirection = 'counter-clockwise';
* }
+ * print(rotateDirection);
*
*
*
@@ -52304,18 +56647,15 @@ p5.prototype.pRotationY = 0;
* // the angles wrap around.
* var rotateDirection = 'clockwise';
*
- * if ((rotationZ - pRotationZ > 0 &&
- * rotationZ - pRotationZ < 270)||
- * rotationZ - pRotationZ < -270){
- *
+ * if (
+ * (rotationZ - pRotationZ > 0 && rotationZ - pRotationZ < 270) ||
+ * rotationZ - pRotationZ < -270
+ * ) {
* rotateDirection = 'clockwise';
- *
- * } else if (rotationZ - pRotationZ < 0 ||
- * rotationZ - pRotationZ > 270){
- *
+ * } else if (rotationZ - pRotationZ < 0 || rotationZ - pRotationZ > 270) {
* rotateDirection = 'counter-clockwise';
- *
* }
+ * print(rotateDirection);
*
*
*
@@ -52340,45 +56680,110 @@ var pRotateDirectionX;
var pRotateDirectionY;
var pRotateDirectionZ;
-p5.prototype._updatePRotations = function(){
+p5.prototype._updatePRotations = function() {
this._setProperty('pRotationX', this.rotationX);
this._setProperty('pRotationY', this.rotationY);
this._setProperty('pRotationZ', this.rotationZ);
};
+/**
+ * @property {String} turnAxis
+ * @readOnly
+ */
p5.prototype.turnAxis = undefined;
var move_threshold = 0.5;
var shake_threshold = 30;
/**
- * The setMoveThreshold() function is used to set the movement threshold for
- * the deviceMoved() function. The default threshold is set to 0.5.
+ * The setMoveThreshold() function is used to set the movement threshold for
+ * the deviceMoved() function. The default threshold is set to 0.5.
*
* @method setMoveThreshold
* @param {number} value The threshold value
+ * @example
+ *
+ *
+ * // Run this example on a mobile device
+ * // You will need to move the device incrementally further
+ * // the closer the square's color gets to white in order to change the value.
+ *
+ * var value = 0;
+ * var threshold = 0.5;
+ * function setup() {
+ * setMoveThreshold(threshold);
+ * }
+ * function draw() {
+ * fill(value);
+ * rect(25, 25, 50, 50);
+ * }
+ * function deviceMoved() {
+ * value = value + 5;
+ * threshold = threshold + 0.1;
+ * if (value > 255) {
+ * value = 0;
+ * threshold = 30;
+ * }
+ * setMoveThreshold(threshold);
+ * }
+ *
+ *
+ *
+ * @alt
+ * 50x50 black rect in center of canvas. turns white on mobile when device moves
*/
-p5.prototype.setMoveThreshold = function(val){
- if(typeof val === 'number'){
- move_threshold = val;
- }
+
+p5.prototype.setMoveThreshold = function(val) {
+ p5._validateParameters('setMoveThreshold', arguments);
+ move_threshold = val;
};
/**
- * The setShakeThreshold() function is used to set the movement threshold for
- * the deviceShaken() function. The default threshold is set to 30.
+ * The setShakeThreshold() function is used to set the movement threshold for
+ * the deviceShaken() function. The default threshold is set to 30.
*
* @method setShakeThreshold
* @param {number} value The threshold value
+ * @example
+ *
+ *
+ * // Run this example on a mobile device
+ * // You will need to shake the device more firmly
+ * // the closer the box's fill gets to white in order to change the value.
+ *
+ * var value = 0;
+ * var threshold = 30;
+ * function setup() {
+ * setShakeThreshold(threshold);
+ * }
+ * function draw() {
+ * fill(value);
+ * rect(25, 25, 50, 50);
+ * }
+ * function deviceMoved() {
+ * value = value + 5;
+ * threshold = threshold + 5;
+ * if (value > 255) {
+ * value = 0;
+ * threshold = 30;
+ * }
+ * setShakeThreshold(threshold);
+ * }
+ *
+ *
+ *
+ * @alt
+ * 50x50 black rect in center of canvas. turns white on mobile when device
+ * is being shaked
*/
-p5.prototype.setShakeThreshold = function(val){
- if(typeof val === 'number'){
- shake_threshold = val;
- }
+
+p5.prototype.setShakeThreshold = function(val) {
+ p5._validateParameters('setShakeThreshold', arguments);
+ shake_threshold = val;
};
/**
- * The deviceMoved() function is called when the device is moved by more than
+ * The deviceMoved() function is called when the device is moved by more than
* the threshold value along X, Y or Z axis. The default threshold is set to
* 0.5.
* @method deviceMoved
@@ -52409,11 +56814,11 @@ p5.prototype.setShakeThreshold = function(val){
*/
/**
- * The deviceTurned() function is called when the device rotates by
+ * The deviceTurned() function is called when the device rotates by
* more than 90 degrees continuously.
*
- * The axis that triggers the deviceTurned() method is stored in the turnAxis
- * variable. The deviceTurned() method can be locked to trigger on any axis:
+ * The axis that triggers the deviceTurned() method is stored in the turnAxis
+ * variable. The deviceTurned() method can be locked to trigger on any axis:
* X, Y or Z by comparing the turnAxis variable to 'X', 'Y' or 'Z'.
*
* @method deviceTurned
@@ -52430,9 +56835,9 @@ p5.prototype.setShakeThreshold = function(val){
* rect(25, 25, 50, 50);
* }
* function deviceTurned() {
- * if (value == 0){
- * value = 255
- * } else if (value == 255) {
+ * if (value === 0) {
+ * value = 255;
+ * } else if (value === 255) {
* value = 0;
* }
* }
@@ -52450,10 +56855,10 @@ p5.prototype.setShakeThreshold = function(val){
* rect(25, 25, 50, 50);
* }
* function deviceTurned() {
- * if (turnAxis == 'X'){
- * if (value == 0){
- * value = 255
- * } else if (value == 255) {
+ * if (turnAxis === 'X') {
+ * if (value === 0) {
+ * value = 255;
+ * } else if (value === 255) {
* value = 0;
* }
* }
@@ -52468,7 +56873,7 @@ p5.prototype.setShakeThreshold = function(val){
*/
/**
- * The deviceShaken() function is called when the device total acceleration
+ * The deviceShaken() function is called when the device total acceleration
* changes of accelerationX and accelerationY values is more than
* the threshold value. The default threshold is set to 30.
* @method deviceShaken
@@ -52497,14 +56902,14 @@ p5.prototype.setShakeThreshold = function(val){
*
*/
-p5.prototype._ondeviceorientation = function (e) {
+p5.prototype._ondeviceorientation = function(e) {
this._updatePRotations();
this._setProperty('rotationX', e.beta);
this._setProperty('rotationY', e.gamma);
this._setProperty('rotationZ', e.alpha);
this._handleMotion();
};
-p5.prototype._ondevicemotion = function (e) {
+p5.prototype._ondevicemotion = function(e) {
this._updatePAccelerations();
this._setProperty('accelerationX', e.acceleration.x * 2);
this._setProperty('accelerationY', e.acceleration.y * 2);
@@ -52521,9 +56926,11 @@ p5.prototype._handleMotion = function() {
}
var deviceMoved = this.deviceMoved || window.deviceMoved;
if (typeof deviceMoved === 'function') {
- if (Math.abs(this.accelerationX - this.pAccelerationX) > move_threshold ||
+ if (
+ Math.abs(this.accelerationX - this.pAccelerationX) > move_threshold ||
Math.abs(this.accelerationY - this.pAccelerationY) > move_threshold ||
- Math.abs(this.accelerationZ - this.pAccelerationZ) > move_threshold) {
+ Math.abs(this.accelerationZ - this.pAccelerationZ) > move_threshold
+ ) {
deviceMoved();
}
}
@@ -52536,15 +56943,15 @@ p5.prototype._handleMotion = function() {
var wRX = this.rotationX + 180;
var wPRX = this.pRotationX + 180;
var wSAX = startAngleX + 180;
- if ((wRX - wPRX > 0 && wRX - wPRX < 270)|| wRX - wPRX < -270){
+ if ((wRX - wPRX > 0 && wRX - wPRX < 270) || wRX - wPRX < -270) {
rotateDirectionX = 'clockwise';
- } else if (wRX - wPRX < 0 || wRX - wPRX > 270){
+ } else if (wRX - wPRX < 0 || wRX - wPRX > 270) {
rotateDirectionX = 'counter-clockwise';
}
- if (rotateDirectionX !== pRotateDirectionX){
+ if (rotateDirectionX !== pRotateDirectionX) {
wSAX = wRX;
}
- if (Math.abs(wRX - wSAX) > 90 && Math.abs(wRX - wSAX) < 270){
+ if (Math.abs(wRX - wSAX) > 90 && Math.abs(wRX - wSAX) < 270) {
wSAX = wRX;
this._setProperty('turnAxis', 'X');
deviceTurned();
@@ -52556,15 +56963,15 @@ p5.prototype._handleMotion = function() {
var wRY = this.rotationY + 180;
var wPRY = this.pRotationY + 180;
var wSAY = startAngleY + 180;
- if ((wRY - wPRY > 0 && wRY - wPRY < 270)|| wRY - wPRY < -270){
+ if ((wRY - wPRY > 0 && wRY - wPRY < 270) || wRY - wPRY < -270) {
rotateDirectionY = 'clockwise';
- } else if (wRY - wPRY < 0 || wRY - this.pRotationY > 270){
+ } else if (wRY - wPRY < 0 || wRY - this.pRotationY > 270) {
rotateDirectionY = 'counter-clockwise';
}
- if (rotateDirectionY !== pRotateDirectionY){
+ if (rotateDirectionY !== pRotateDirectionY) {
wSAY = wRY;
}
- if (Math.abs(wRY - wSAY) > 90 && Math.abs(wRY - wSAY) < 270){
+ if (Math.abs(wRY - wSAY) > 90 && Math.abs(wRY - wSAY) < 270) {
wSAY = wRY;
this._setProperty('turnAxis', 'Y');
deviceTurned();
@@ -52574,19 +56981,25 @@ p5.prototype._handleMotion = function() {
// Z-axis is already in the range 0 to 360
// so no conversion is needed.
- if ((this.rotationZ - this.pRotationZ > 0 &&
- this.rotationZ - this.pRotationZ < 270)||
- this.rotationZ - this.pRotationZ < -270){
+ if (
+ (this.rotationZ - this.pRotationZ > 0 &&
+ this.rotationZ - this.pRotationZ < 270) ||
+ this.rotationZ - this.pRotationZ < -270
+ ) {
rotateDirectionZ = 'clockwise';
- } else if (this.rotationZ - this.pRotationZ < 0 ||
- this.rotationZ - this.pRotationZ > 270){
+ } else if (
+ this.rotationZ - this.pRotationZ < 0 ||
+ this.rotationZ - this.pRotationZ > 270
+ ) {
rotateDirectionZ = 'counter-clockwise';
}
- if (rotateDirectionZ !== pRotateDirectionZ){
+ if (rotateDirectionZ !== pRotateDirectionZ) {
startAngleZ = this.rotationZ;
}
- if (Math.abs(this.rotationZ - startAngleZ) > 90 &&
- Math.abs(this.rotationZ - startAngleZ) < 270){
+ if (
+ Math.abs(this.rotationZ - startAngleZ) > 90 &&
+ Math.abs(this.rotationZ - startAngleZ) < 270
+ ) {
startAngleZ = this.rotationZ;
this._setProperty('turnAxis', 'Z');
deviceTurned();
@@ -52609,10 +57022,9 @@ p5.prototype._handleMotion = function() {
}
};
-
module.exports = p5;
-},{"../core/core":55}],71:[function(_dereq_,module,exports){
+},{"../core/main":25}],40:[function(_dereq_,module,exports){
/**
* @module Events
* @submodule Keyboard
@@ -52622,7 +57034,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* Holds the key codes of currently pressed keys.
@@ -52631,7 +57043,7 @@ var p5 = _dereq_('../core/core');
var downKeys = {};
/**
- * The boolean system variable keyIsPressed is true if any key is pressed
+ * The boolean system variable keyIsPressed is true if any key is pressed
* and false if no keys are pressed.
*
* @property {Boolean} keyIsPressed
@@ -52639,7 +57051,6 @@ var downKeys = {};
* @example
*
*
- * var value = 0;
* function draw() {
* if (keyIsPressed === true) {
* fill(0);
@@ -52661,7 +57072,7 @@ p5.prototype.keyIsPressed = false; // khan
/**
* The system variable key always contains the value of the most recent
* key on the keyboard that was typed. To get the proper capitalization, it
- * is best to use it within keyTyped(). For non-ASCII keys, use the keyCode
+ * is best to use it within keyTyped(). For non-ASCII keys, use the keyCode
* variable.
*
* @property {String} key
@@ -52677,9 +57088,9 @@ p5.prototype.keyIsPressed = false; // khan
*
* function draw() {
* background(200);
- * text(key, 33,65); // Display last key pressed.
+ * text(key, 33, 65); // Display last key pressed.
* }
- *
+ *
*
* @alt
* canvas displays any key value that is pressed in pink font.
@@ -52694,7 +57105,7 @@ p5.prototype.key = '';
* You can also check for custom keys by looking up the keyCode of any key
* on a site like this: keycode.info.
*
- * @property {Number} keyCode
+ * @property {Integer} keyCode
* @readOnly
* @example
*
@@ -52705,9 +57116,9 @@ p5.prototype.key = '';
* }
*
* function keyPressed() {
- * if (keyCode == UP_ARROW) {
+ * if (keyCode === UP_ARROW) {
* fillVal = 255;
- * } else if (keyCode == DOWN_ARROW) {
+ * } else if (keyCode === DOWN_ARROW) {
* fillVal = 0;
* }
* return false; // prevent default
@@ -52721,8 +57132,8 @@ p5.prototype.key = '';
p5.prototype.keyCode = 0;
/**
- * The keyPressed() function is called once every time a key is pressed. The
- * keyCode for the key that was pressed is stored in the keyCode variable.
+ * The keyPressed() function is called once every time a key is pressed. The
+ * keyCode for the key that was pressed is stored in the keyCode variable.
*
* For non-ASCII keys, use the keyCode variable. You can check if the keyCode
* equals BACKSPACE, DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL,
@@ -52730,11 +57141,11 @@ p5.prototype.keyCode = 0;
*
* For ASCII keys that was pressed is stored in the key variable. However, it
* does not distinguish between uppercase and lowercase. For this reason, it
- * is recommended to use keyTyped() to read the key variable, in which the
+ * is recommended to use keyTyped() to read the key variable, in which the
* case of the variable will be distinguished.
*
* Because of how operating systems handle key repeats, holding down a key
- * may cause multiple calls to keyTyped() (and keyReleased() as well). The
+ * may cause multiple calls to keyTyped() (and keyReleased() as well). The
* rate of repeat is set by the operating system and how each computer is
* configured.
* Browsers may have different default
@@ -52777,7 +57188,7 @@ p5.prototype.keyCode = 0;
*
*
*
- * function keyPressed(){
+ * function keyPressed() {
* // Do something
* return false; // prevent any default behaviour
* }
@@ -52789,30 +57200,27 @@ p5.prototype.keyCode = 0;
* black rect center. turns white when left arrow pressed and black when right.
*
*/
-p5.prototype._onkeydown = function (e) {
- if (downKeys[e.which]) { // prevent multiple firings
+p5.prototype._onkeydown = function(e) {
+ if (downKeys[e.which]) {
+ // prevent multiple firings
return;
}
this._setProperty('isKeyPressed', true);
this._setProperty('keyIsPressed', true);
this._setProperty('keyCode', e.which);
downKeys[e.which] = true;
- var key = String.fromCharCode(e.which);
- if (!key) {
- key = e.which;
- }
- this._setProperty('key', key);
+ this._setProperty('key', e.key || String.fromCharCode(e.which) || e.which);
var keyPressed = this.keyPressed || window.keyPressed;
if (typeof keyPressed === 'function' && !e.charCode) {
var executeDefault = keyPressed(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The keyReleased() function is called once every time a key is released.
- * See key and keyCode for more information.
+ * The keyReleased() function is called once every time a key is released.
+ * See key and keyCode for more information.
* Browsers may have different default
* behaviors attached to various key events. To prevent any default
* behavior for this event, add "return false" to the end of the method.
@@ -52841,38 +57249,34 @@ p5.prototype._onkeydown = function (e) {
* black rect center. turns white when key pressed and black when pressed again
*
*/
-p5.prototype._onkeyup = function (e) {
+p5.prototype._onkeyup = function(e) {
var keyReleased = this.keyReleased || window.keyReleased;
downKeys[e.which] = false;
- if(!areDownKeys()) {
+ if (!areDownKeys()) {
this._setProperty('isKeyPressed', false);
this._setProperty('keyIsPressed', false);
}
this._setProperty('_lastKeyCodeTyped', null);
- var key = String.fromCharCode(e.which);
- if (!key) {
- key = e.which;
- }
- this._setProperty('key', key);
+ this._setProperty('key', e.key || String.fromCharCode(e.which) || e.which);
this._setProperty('keyCode', e.which);
if (typeof keyReleased === 'function') {
var executeDefault = keyReleased(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The keyTyped() function is called once every time a key is pressed, but
+ * The keyTyped() function is called once every time a key is pressed, but
* action keys such as Ctrl, Shift, and Alt are ignored. The most recent
* key pressed will be stored in the key variable.
*
* Because of how operating systems handle key repeats, holding down a key
- * will cause multiple calls to keyTyped() (and keyReleased() as well). The
+ * will cause multiple calls to keyTyped() (and keyReleased() as well). The
* rate of repeat is set by the operating system and how each computer is
* configured.
* Browsers may have different default behaviors attached to various key
@@ -52904,8 +57308,9 @@ p5.prototype._onkeyup = function (e) {
* black rect center. turns white when 'a' key typed and black when 'b' pressed
*
*/
-p5.prototype._onkeypress = function (e) {
- if (e.which === this._lastKeyCodeTyped) { // prevent multiple firings
+p5.prototype._onkeypress = function(e) {
+ if (e.which === this._lastKeyCodeTyped) {
+ // prevent multiple firings
return;
}
this._setProperty('keyCode', e.which);
@@ -52914,7 +57319,7 @@ p5.prototype._onkeypress = function (e) {
var keyTyped = this.keyTyped || window.keyTyped;
if (typeof keyTyped === 'function') {
var executeDefault = keyTyped(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
@@ -52925,16 +57330,16 @@ p5.prototype._onkeypress = function (e) {
* not focused on the element we must assume all keys currently down have
* been released.
*/
-p5.prototype._onblur = function (e) {
+p5.prototype._onblur = function(e) {
downKeys = {};
};
/**
- * The keyIsDown() function checks if the key is currently down, i.e. pressed.
+ * The keyIsDown() function checks if the key is currently down, i.e. pressed.
* It can be used if you have an object that moves, and you want several keys
* to be able to affect its behaviour simultaneously, such as moving a
* sprite diagonally. You can put in any number representing the keyCode of
- * the key, or use any of the variable keyCode names listed
+ * the key, or use any of the variable keyCode names listed
* here.
*
* @method keyIsDown
@@ -52950,17 +57355,21 @@ p5.prototype._onblur = function (e) {
* }
*
* function draw() {
- * if (keyIsDown(LEFT_ARROW))
- * x-=5;
+ * if (keyIsDown(LEFT_ARROW)) {
+ * x -= 5;
+ * }
*
- * if (keyIsDown(RIGHT_ARROW))
- * x+=5;
+ * if (keyIsDown(RIGHT_ARROW)) {
+ * x += 5;
+ * }
*
- * if (keyIsDown(UP_ARROW))
- * y-=5;
+ * if (keyIsDown(UP_ARROW)) {
+ * y -= 5;
+ * }
*
- * if (keyIsDown(DOWN_ARROW))
- * y+=5;
+ * if (keyIsDown(DOWN_ARROW)) {
+ * y += 5;
+ * }
*
* clear();
* fill(255, 0, 0);
@@ -52968,11 +57377,37 @@ p5.prototype._onblur = function (e) {
* }
*
*
+ *
+ * var diameter = 50;
+ *
+ * function setup() {
+ * createCanvas(512, 512);
+ * }
+ *
+ * function draw() {
+ * // 107 and 187 are keyCodes for "+"
+ * if (keyIsDown(107) || keyIsDown(187)) {
+ * diameter += 1;
+ * }
+ *
+ * // 109 and 189 are keyCodes for "-"
+ * if (keyIsDown(109) || keyIsDown(189)) {
+ * diameter -= 1;
+ * }
+ *
+ * clear();
+ * fill(255, 0, 0);
+ * ellipse(50, 50, diameter, diameter);
+ * }
+ *
+ *
* @alt
* 50x50 red ellipse moves left, right, up and down with arrow presses.
+ * 50x50 red ellipse gets bigger or smaller when + or - are pressed.
*
*/
p5.prototype.keyIsDown = function(code) {
+ p5._validateParameters('keyIsDown', arguments);
return downKeys[code];
};
@@ -52996,7 +57431,7 @@ function areDownKeys() {
module.exports = p5;
-},{"../core/core":55}],72:[function(_dereq_,module,exports){
+},{"../core/main":25}],41:[function(_dereq_,module,exports){
/**
* @module Events
* @submodule Mouse
@@ -53005,10 +57440,9 @@ module.exports = p5;
* @requires constants
*/
-
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
/*
@@ -53061,7 +57495,7 @@ p5.prototype.mouseX = 0;
* function draw() {
* background(244, 248, 252);
* line(0, mouseY, 100, mouseY);
- *}
+ * }
*
*
*
@@ -53074,7 +57508,8 @@ p5.prototype.mouseY = 0;
/**
* The system variable pmouseX always contains the horizontal position of
* the mouse or finger in the frame previous to the current frame, relative to
- * (0, 0) of the canvas.
+ * (0, 0) of the canvas. Note: pmouseX will be reset to the current mouseX
+ * value at the start of each touch event.
*
* @property {Number} pmouseX
* @readOnly
@@ -53091,9 +57526,8 @@ p5.prototype.mouseY = 0;
* function draw() {
* background(244, 248, 252);
* line(mouseX, mouseY, pmouseX, pmouseY);
- * print(pmouseX + " -> " + mouseX);
+ * print(pmouseX + ' -> ' + mouseX);
* }
- *
*
*
*
@@ -53106,7 +57540,8 @@ p5.prototype.pmouseX = 0;
/**
* The system variable pmouseY always contains the vertical position of the
* mouse or finger in the frame previous to the current frame, relative to
- * (0, 0) of the canvas.
+ * (0, 0) of the canvas. Note: pmouseY will be reset to the current mouseY
+ * value at the start of each touch event.
*
* @property {Number} pmouseY
* @readOnly
@@ -53118,12 +57553,12 @@ p5.prototype.pmouseX = 0;
* background(237, 34, 93);
* fill(0);
* //draw a square only if the mouse is not moving
- * if(mouseY == pmouseY && mouseX == pmouseX)
- * rect(20,20,60,60);
+ * if (mouseY === pmouseY && mouseX === pmouseX) {
+ * rect(20, 20, 60, 60);
+ * }
*
- * print(pmouseY + " -> " + mouseY);
+ * print(pmouseY + ' -> ' + mouseY);
* }
- *
*
*
*
@@ -53155,13 +57590,12 @@ p5.prototype.pmouseY = 0;
* fill(0);
*
* //move the canvas to the horizontal mouse position
- * //relative to the window
- * myCanvas.position(winMouseX+1, windowHeight/2);
+ * //rela tive to the window
+ * myCanvas.position(winMouseX + 1, windowHeight / 2);
*
- * //the y of the square is relative to the canvas
- * rect(20,mouseY,60,60);
+ * //the y of the square is relative to the canvas
+ * rect(20, mouseY, 60, 60);
* }
- *
*
*
*
@@ -53181,7 +57615,7 @@ p5.prototype.winMouseX = 0;
* @example
*
*
- *var myCanvas;
+ * var myCanvas;
*
* function setup() {
* //use a variable to store a pointer to the canvas
@@ -53193,13 +57627,12 @@ p5.prototype.winMouseX = 0;
* fill(0);
*
* //move the canvas to the vertical mouse position
- * //relative to the window
- * myCanvas.position(windowWidth/2, winMouseY+1);
+ * //rel ative to the window
+ * myCanvas.position(windowWidth / 2, winMouseY + 1);
*
- * //the x of the square is relative to the canvas
- * rect(mouseX,20,60,60);
+ * //the x of the square is relative to the canvas
+ * rect(mouseX, 20, 60, 60);
* }
- *
*
*
*
@@ -53212,7 +57645,8 @@ p5.prototype.winMouseY = 0;
/**
* The system variable pwinMouseX always contains the horizontal position
* of the mouse in the frame previous to the current frame, relative to
- * (0, 0) of the window.
+ * (0, 0) of the window. Note: pwinMouseX will be reset to the current winMouseX
+ * value at the start of each touch event.
*
* @property {Number} pwinMouseX
* @readOnly
@@ -53220,7 +57654,6 @@ p5.prototype.winMouseY = 0;
* @example
*
*
- *
* var myCanvas;
*
* function setup() {
@@ -53228,20 +57661,19 @@ p5.prototype.winMouseY = 0;
* myCanvas = createCanvas(100, 100);
* noStroke();
* fill(237, 34, 93);
- * }
+ * }
*
* function draw() {
* clear();
* //the difference between previous and
* //current x position is the horizontal mouse speed
- * var speed = abs(winMouseX-pwinMouseX);
+ * var speed = abs(winMouseX - pwinMouseX);
* //change the size of the circle
* //according to the horizontal speed
- * ellipse(50, 50, 10+speed*5, 10+speed*5);
+ * ellipse(50, 50, 10 + speed * 5, 10 + speed * 5);
* //move the canvas to the mouse position
- * myCanvas.position( winMouseX+1, winMouseY+1);
+ * myCanvas.position(winMouseX + 1, winMouseY + 1);
* }
- *
*
*
*
@@ -53254,7 +57686,8 @@ p5.prototype.pwinMouseX = 0;
/**
* The system variable pwinMouseY always contains the vertical position of
* the mouse in the frame previous to the current frame, relative to (0, 0)
- * of the window.
+ * of the window. Note: pwinMouseY will be reset to the current winMouseY
+ * value at the start of each touch event.
*
* @property {Number} pwinMouseY
* @readOnly
@@ -53263,7 +57696,6 @@ p5.prototype.pwinMouseX = 0;
* @example
*
*
- *
* var myCanvas;
*
* function setup() {
@@ -53271,20 +57703,19 @@ p5.prototype.pwinMouseX = 0;
* myCanvas = createCanvas(100, 100);
* noStroke();
* fill(237, 34, 93);
- * }
+ * }
*
* function draw() {
* clear();
* //the difference between previous and
* //current y position is the vertical mouse speed
- * var speed = abs(winMouseY-pwinMouseY);
+ * var speed = abs(winMouseY - pwinMouseY);
* //change the size of the circle
* //according to the vertical speed
- * ellipse(50, 50, 10+speed*5, 10+speed*5);
+ * ellipse(50, 50, 10 + speed * 5, 10 + speed * 5);
* //move the canvas to the mouse position
- * myCanvas.position( winMouseX+1, winMouseY+1);
+ * myCanvas.position(winMouseX + 1, winMouseY + 1);
* }
- *
*
*
*
@@ -53304,24 +57735,27 @@ p5.prototype.pwinMouseY = 0;
* @readOnly
*
* @example
- *
- *
- * function draw() {
- * background(237, 34, 93);
- * fill(0);
- *
- * if (mouseIsPressed) {
- * if (mouseButton == LEFT)
- * ellipse(50, 50, 50, 50);
- * if (mouseButton == RIGHT)
- * rect(25, 25, 50, 50);
- * if (mouseButton == CENTER)
- * triangle(23, 75, 50, 20, 78, 75);
- * }
- *
- * print(mouseButton);
- * }
- *
+ *
+ *
+ * function draw() {
+ * background(237, 34, 93);
+ * fill(0);
+ *
+ * if (mouseIsPressed) {
+ * if (mouseButton === LEFT) {
+ * ellipse(50, 50, 50, 50);
+ * }
+ * if (mouseButton === RIGHT) {
+ * rect(25, 25, 50, 50);
+ * }
+ * if (mouseButton === CENTER) {
+ * triangle(23, 75, 50, 20, 78, 75);
+ * }
+ * }
+ *
+ * print(mouseButton);
+ * }
+ *
*
*
* @alt
@@ -53338,22 +57772,23 @@ p5.prototype.mouseButton = 0;
* @readOnly
*
* @example
- *
- *
- * function draw() {
- * background(237, 34, 93);
- * fill(0);
- *
- * if (mouseIsPressed)
- * ellipse(50, 50, 50, 50);
- * else
- * rect(25, 25, 50, 50);
- *
- * print(mouseIsPressed);
- * }
- *
- *
- *
+ *
+ *
+ * function draw() {
+ * background(237, 34, 93);
+ * fill(0);
+ *
+ * if (mouseIsPressed) {
+ * ellipse(50, 50, 50, 50);
+ * } else {
+ * rect(25, 25, 50, 50);
+ * }
+ *
+ * print(mouseIsPressed);
+ * }
+ *
+ *
+ *
* @alt
* black 50x50 rect becomes ellipse with mouse click/press. fuschia background.
*
@@ -53361,8 +57796,13 @@ p5.prototype.mouseButton = 0;
p5.prototype.mouseIsPressed = false;
p5.prototype._updateNextMouseCoords = function(e) {
- if(this._curElement !== null && (!e.touches || e.touches.length>0)) {
- var mousePos = getMousePos(this._curElement.elt, this.width, this.height, e);
+ if (this._curElement !== null && (!e.touches || e.touches.length > 0)) {
+ var mousePos = getMousePos(
+ this._curElement.elt,
+ this.width,
+ this.height,
+ e
+ );
this._setProperty('mouseX', mousePos.x);
this._setProperty('mouseY', mousePos.y);
this._setProperty('winMouseX', mousePos.winX);
@@ -53380,10 +57820,13 @@ p5.prototype._updateMouseCoords = function() {
this._setProperty('pmouseY', this.mouseY);
this._setProperty('pwinMouseX', this.winMouseX);
this._setProperty('pwinMouseY', this.winMouseY);
+
+ this._setProperty('_pmouseWheelDeltaY', this._mouseWheelDeltaY);
};
function getMousePos(canvas, w, h, evt) {
- if (evt && !evt.clientX) { // use touches if touch and not mouse
+ if (evt && !evt.clientX) {
+ // use touches if touch and not mouse
if (evt.touches) {
evt = evt.touches[0];
} else if (evt.changedTouches) {
@@ -53413,7 +57856,7 @@ p5.prototype._setMouseButton = function(e) {
};
/**
- * The mouseMoved() function is called every time the mouse moves and a mouse
+ * The mouseMoved() function is called every time the mouse moves and a mouse
* button is not pressed.
* Browsers may have different default
* behaviors attached to various mouse events. To prevent any default
@@ -53457,9 +57900,9 @@ p5.prototype._setMouseButton = function(e) {
*/
/**
- * The mouseDragged() function is called once every time the mouse moves and
- * a mouse button is pressed. If no mouseDragged() function is defined, the
- * touchMoved() function will be called instead if it is defined.
+ * The mouseDragged() function is called once every time the mouse moves and
+ * a mouse button is pressed. If no mouseDragged() function is defined, the
+ * touchMoved() function will be called instead if it is defined.
* Browsers may have different default
* behaviors attached to various mouse events. To prevent any default
* behavior for this event, add "return false" to the end of the method.
@@ -53500,27 +57943,26 @@ p5.prototype._setMouseButton = function(e) {
* no image displayed
*
*/
-p5.prototype._onmousemove = function(e){
+p5.prototype._onmousemove = function(e) {
var context = this._isGlobal ? window : this;
var executeDefault;
this._updateNextMouseCoords(e);
if (!this.mouseIsPressed) {
if (typeof context.mouseMoved === 'function') {
executeDefault = context.mouseMoved(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
- }
- else {
+ } else {
if (typeof context.mouseDragged === 'function') {
executeDefault = context.mouseDragged(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
} else if (typeof context.touchMoved === 'function') {
executeDefault = context.touchMoved(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
@@ -53528,10 +57970,10 @@ p5.prototype._onmousemove = function(e){
};
/**
- * The mousePressed() function is called once after every time a mouse button
+ * The mousePressed() function is called once after every time a mouse button
* is pressed. The mouseButton variable (see the related reference entry)
* can be used to determine which button has been pressed. If no
- * mousePressed() function is defined, the touchStarted() function will be
+ * mousePressed() function is defined, the touchStarted() function will be
* called instead if it is defined.
* Browsers may have different default
* behaviors attached to various mouse events. To prevent any default
@@ -53550,7 +57992,7 @@ p5.prototype._onmousemove = function(e){
* rect(25, 25, 50, 50);
* }
* function mousePressed() {
- * if (value == 0) {
+ * if (value === 0) {
* value = 255;
* } else {
* value = 0;
@@ -53582,20 +58024,20 @@ p5.prototype._onmousedown = function(e) {
this._updateNextMouseCoords(e);
if (typeof context.mousePressed === 'function') {
executeDefault = context.mousePressed(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
} else if (typeof context.touchStarted === 'function') {
executeDefault = context.touchStarted(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The mouseReleased() function is called every time a mouse button is
- * released. If no mouseReleased() function is defined, the touchEnded()
+ * The mouseReleased() function is called every time a mouse button is
+ * released. If no mouseReleased() function is defined, the touchEnded()
* function will be called instead if it is defined.
* Browsers may have different default
* behaviors attached to various mouse events. To prevent any default
@@ -53616,7 +58058,7 @@ p5.prototype._onmousedown = function(e) {
* rect(25, 25, 50, 50);
* }
* function mouseReleased() {
- * if (value == 0) {
+ * if (value === 0) {
* value = 255;
* } else {
* value = 0;
@@ -53646,12 +58088,12 @@ p5.prototype._onmouseup = function(e) {
this._setProperty('mouseIsPressed', false);
if (typeof context.mouseReleased === 'function') {
executeDefault = context.mouseReleased(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
} else if (typeof context.touchEnded === 'function') {
executeDefault = context.touchEnded(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
@@ -53661,11 +58103,11 @@ p5.prototype._ondragend = p5.prototype._onmouseup;
p5.prototype._ondragover = p5.prototype._onmousemove;
/**
- * The mouseClicked() function is called once after a mouse button has been
+ * The mouseClicked() function is called once after a mouse button has been
* pressed and then released.
* Browsers handle clicks differently, so this function is only guaranteed to be
* run when the left mouse button is clicked. To handle other mouse buttons
- * being pressed or released, see mousePressed() or mouseReleased().
+ * being pressed or released, see mousePressed() or mouseReleased().
* Browsers may have different default
* behaviors attached to various mouse events. To prevent any default
* behavior for this event, add "return false" to the end of the method.
@@ -53685,7 +58127,7 @@ p5.prototype._ondragover = p5.prototype._onmousemove;
* }
*
* function mouseClicked() {
- * if (value == 0) {
+ * if (value === 0) {
* value = 255;
* } else {
* value = 0;
@@ -53713,14 +58155,14 @@ p5.prototype._onclick = function(e) {
var context = this._isGlobal ? window : this;
if (typeof context.mouseClicked === 'function') {
var executeDefault = context.mouseClicked(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The doubleClicked() function is executed every time a event
+ * The doubleClicked() function is executed every time a event
* listener has detected a dblclick event which is a part of the
* DOM L3 specification. The doubleClicked event is fired when a
* pointing device button (usually a mouse's primary button)
@@ -53743,7 +58185,7 @@ p5.prototype._onclick = function(e) {
* }
*
* function doubleClicked() {
- * if (value == 0) {
+ * if (value === 0) {
* value = 255;
* } else {
* value = 0;
@@ -53767,18 +58209,34 @@ p5.prototype._onclick = function(e) {
* no image displayed
*/
-p5.prototype._doubleClicked = function(e) {
+p5.prototype._ondblclick = function(e) {
var context = this._isGlobal ? window : this;
if (typeof context.doubleClicked === 'function') {
- var executeDefault = context.ondblclick(e);
- if(executeDefault === false) {
+ var executeDefault = context.doubleClicked(e);
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The function mouseWheel() is executed every time a vertical mouse wheel
+ * For use with WebGL orbitControl.
+ * @property {Number} _mouseWheelDeltaY
+ * @readOnly
+ * @private
+ */
+p5.prototype._mouseWheelDeltaY = 0;
+
+/**
+ * For use with WebGL orbitControl.
+ * @property {Number} _pmouseWheelDeltaY
+ * @readOnly
+ * @private
+ */
+p5.prototype._pmouseWheelDeltaY = 0;
+
+/**
+ * The function mouseWheel() is executed every time a vertical mouse wheel
* event is detected either triggered by an actual mouse wheel or by a
* touchpad.
* The event.delta property returns the amount the mouse wheel
@@ -53820,10 +58278,11 @@ p5.prototype._doubleClicked = function(e) {
*/
p5.prototype._onwheel = function(e) {
var context = this._isGlobal ? window : this;
+ this._setProperty('_mouseWheelDeltaY', e.deltaY);
if (typeof context.mouseWheel === 'function') {
e.delta = e.deltaY;
var executeDefault = context.mouseWheel(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
@@ -53831,7 +58290,7 @@ p5.prototype._onwheel = function(e) {
module.exports = p5;
-},{"../core/constants":54,"../core/core":55}],73:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/main":25}],42:[function(_dereq_,module,exports){
/**
* @module Events
* @submodule Touch
@@ -53841,7 +58300,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* The system variable touches[] contains an array of the positions of all
@@ -53854,21 +58313,42 @@ var p5 = _dereq_('../core/core');
*
* @property {Object[]} touches
* @readOnly
+ *
+ * @example
+ *
+ *
+ * // On a touchscreen device, touch
+ * // the canvas using one or more fingers
+ * // at the same time
+ * function draw() {
+ * clear();
+ * var display = touches.length + ' touches';
+ * text(display, 5, 10);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Number of touches currently registered are displayed on the canvas
*/
p5.prototype.touches = [];
p5.prototype._updateTouchCoords = function(e) {
if (this._curElement !== null) {
var touches = [];
- for(var i = 0; i < e.touches.length; i++){
- touches[i] = getTouchInfo(this._curElement.elt,
- this.width, this.height, e, i);
+ for (var i = 0; i < e.touches.length; i++) {
+ touches[i] = getTouchInfo(
+ this._curElement.elt,
+ this.width,
+ this.height,
+ e,
+ i
+ );
}
this._setProperty('touches', touches);
}
};
-
function getTouchInfo(canvas, w, h, e, i) {
i = i || 0;
var rect = canvas.getBoundingClientRect();
@@ -53886,7 +58366,7 @@ function getTouchInfo(canvas, w, h, e, i) {
/**
* The touchStarted() function is called once after every time a touch is
- * registered. If no touchStarted() function is defined, the mousePressed()
+ * registered. If no touchStarted() function is defined, the mousePressed()
* function will be called instead if it is defined.
* Browsers may have different default behaviors attached to various touch
* events. To prevent any default behavior for this event, add "return false"
@@ -53905,7 +58385,7 @@ function getTouchInfo(canvas, w, h, e, i) {
* rect(25, 25, 50, 50);
* }
* function touchStarted() {
- * if (value == 0) {
+ * if (value === 0) {
* value = 255;
* } else {
* value = 0;
@@ -53934,22 +58414,23 @@ p5.prototype._ontouchstart = function(e) {
this._setProperty('mouseIsPressed', true);
this._updateTouchCoords(e);
this._updateNextMouseCoords(e);
- if(typeof context.touchStarted === 'function') {
+ this._updateMouseCoords(); // reset pmouseXY at the start of each touch event
+ if (typeof context.touchStarted === 'function') {
executeDefault = context.touchStarted(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
} else if (typeof context.mousePressed === 'function') {
executeDefault = context.mousePressed(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The touchMoved() function is called every time a touch move is registered.
- * If no touchMoved() function is defined, the mouseDragged() function will
+ * The touchMoved() function is called every time a touch move is registered.
+ * If no touchMoved() function is defined, the mouseDragged() function will
* be called instead if it is defined.
* Browsers may have different default behaviors attached to various touch
* events. To prevent any default behavior for this event, add "return false"
@@ -53998,20 +58479,20 @@ p5.prototype._ontouchmove = function(e) {
this._updateNextMouseCoords(e);
if (typeof context.touchMoved === 'function') {
executeDefault = context.touchMoved(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
} else if (typeof context.mouseDragged === 'function') {
executeDefault = context.mouseDragged(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
};
/**
- * The touchEnded() function is called every time a touch ends. If no
- * touchEnded() function is defined, the mouseReleased() function will be
+ * The touchEnded() function is called every time a touch ends. If no
+ * touchEnded() function is defined, the mouseReleased() function will be
* called instead if it is defined.
* Browsers may have different default behaviors attached to various touch
* events. To prevent any default behavior for this event, add "return false"
@@ -54030,7 +58511,7 @@ p5.prototype._ontouchmove = function(e) {
* rect(25, 25, 50, 50);
* }
* function touchEnded() {
- * if (value == 0) {
+ * if (value === 0) {
* value = 255;
* } else {
* value = 0;
@@ -54062,12 +58543,12 @@ p5.prototype._ontouchend = function(e) {
var executeDefault;
if (typeof context.touchEnded === 'function') {
executeDefault = context.touchEnded(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
} else if (typeof context.mouseReleased === 'function') {
executeDefault = context.mouseReleased(e);
- if(executeDefault === false) {
+ if (executeDefault === false) {
e.preventDefault();
}
}
@@ -54075,7 +58556,7 @@ p5.prototype._ontouchend = function(e) {
module.exports = p5;
-},{"../core/core":55}],74:[function(_dereq_,module,exports){
+},{"../core/main":25}],43:[function(_dereq_,module,exports){
/*global ImageData:false */
/**
@@ -54097,12 +58578,10 @@ module.exports = p5;
var Filters = {};
-
/*
* Helper functions
*/
-
/**
* Returns the pixel buffer for a canvas
*
@@ -54113,16 +58592,13 @@ var Filters = {};
* the data in thc RGBA order, with integer
* values between 0 and 255
*/
-Filters._toPixels = function (canvas) {
+Filters._toPixels = function(canvas) {
if (canvas instanceof ImageData) {
return canvas.data;
} else {
- return canvas.getContext('2d').getImageData(
- 0,
- 0,
- canvas.width,
- canvas.height
- ).data;
+ return canvas
+ .getContext('2d')
+ .getImageData(0, 0, canvas.width, canvas.height).data;
}
};
@@ -54137,12 +58613,14 @@ Filters._toPixels = function (canvas) {
* @return {Integer} 32 bit integer value representing
* ARGB value.
*/
-Filters._getARGB = function (data, i) {
+Filters._getARGB = function(data, i) {
var offset = i * 4;
- return (data[offset+3] << 24) & 0xff000000 |
- (data[offset] << 16) & 0x00ff0000 |
- (data[offset+1] << 8) & 0x0000ff00 |
- data[offset+2] & 0x000000ff;
+ return (
+ ((data[offset + 3] << 24) & 0xff000000) |
+ ((data[offset] << 16) & 0x00ff0000) |
+ ((data[offset + 1] << 8) & 0x0000ff00) |
+ (data[offset + 2] & 0x000000ff)
+ );
};
/**
@@ -54154,14 +58632,14 @@ Filters._getARGB = function (data, i) {
* @param {Int32Array} data source 1D array where each value
* represents ARGB values
*/
-Filters._setPixels = function (pixels, data) {
+Filters._setPixels = function(pixels, data) {
var offset = 0;
- for( var i = 0, al = pixels.length; i < al; i++) {
- offset = i*4;
- pixels[offset + 0] = (data[i] & 0x00ff0000)>>>16;
- pixels[offset + 1] = (data[i] & 0x0000ff00)>>>8;
- pixels[offset + 2] = (data[i] & 0x000000ff);
- pixels[offset + 3] = (data[i] & 0xff000000)>>>24;
+ for (var i = 0, al = pixels.length; i < al; i++) {
+ offset = i * 4;
+ pixels[offset + 0] = (data[i] & 0x00ff0000) >>> 16;
+ pixels[offset + 1] = (data[i] & 0x0000ff00) >>> 8;
+ pixels[offset + 2] = data[i] & 0x000000ff;
+ pixels[offset + 3] = (data[i] & 0xff000000) >>> 24;
}
};
@@ -54175,16 +58653,13 @@ Filters._setPixels = function (pixels, data) {
* @return {ImageData} Holder of pixel data (and width and
* height) for a canvas
*/
-Filters._toImageData = function (canvas) {
+Filters._toImageData = function(canvas) {
if (canvas instanceof ImageData) {
return canvas;
} else {
- return canvas.getContext('2d').getImageData(
- 0,
- 0,
- canvas.width,
- canvas.height
- );
+ return canvas
+ .getContext('2d')
+ .getImageData(0, 0, canvas.width, canvas.height);
}
};
@@ -54197,13 +58672,12 @@ Filters._toImageData = function (canvas) {
* @param {Integer} height
* @return {ImageData}
*/
-Filters._createImageData = function (width, height) {
+Filters._createImageData = function(width, height) {
Filters._tmpCanvas = document.createElement('canvas');
Filters._tmpCtx = Filters._tmpCanvas.getContext('2d');
return this._tmpCtx.createImageData(width, height);
};
-
/**
* Applys a filter function to a canvas.
*
@@ -54218,11 +58692,12 @@ Filters._createImageData = function (width, height) {
* use case of creating a filter chain that executes without actually updating
* the canvas in between everystep.
*
+ * @private
* @param {HTMLCanvasElement} canvas [description]
* @param {function(ImageData,Object)} func [description]
* @param {Object} filterParam [description]
*/
-Filters.apply = function (canvas, func, filterParam) {
+Filters.apply = function(canvas, func, filterParam) {
var ctx = canvas.getContext('2d');
var imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
@@ -54236,12 +58711,10 @@ Filters.apply = function (canvas, func, filterParam) {
}
};
-
/*
* Filters
*/
-
/**
* Converts the image to black and white pixels depending if they are above or
* below the threshold defined by the level parameter. The parameter must be
@@ -54249,10 +58722,11 @@ Filters.apply = function (canvas, func, filterParam) {
*
* Borrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/
*
+ * @private
* @param {Canvas} canvas
* @param {Float} level
*/
-Filters.threshold = function (canvas, level) {
+Filters.threshold = function(canvas, level) {
var pixels = Filters._toPixels(canvas);
if (level === undefined) {
@@ -54264,7 +58738,7 @@ Filters.threshold = function (canvas, level) {
var r = pixels[i];
var g = pixels[i + 1];
var b = pixels[i + 2];
- var gray = (0.2126 * r + 0.7152 * g + 0.0722 * b);
+ var gray = 0.2126 * r + 0.7152 * g + 0.0722 * b;
var val;
if (gray >= thresh) {
val = 255;
@@ -54273,19 +58747,18 @@ Filters.threshold = function (canvas, level) {
}
pixels[i] = pixels[i + 1] = pixels[i + 2] = val;
}
-
};
-
/**
* Converts any colors in the image to grayscale equivalents.
* No parameter is used.
*
* Borrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/
*
+ * @private
* @param {Canvas} canvas
*/
-Filters.gray = function (canvas) {
+Filters.gray = function(canvas) {
var pixels = Filters._toPixels(canvas);
for (var i = 0; i < pixels.length; i += 4) {
@@ -54294,7 +58767,7 @@ Filters.gray = function (canvas) {
var b = pixels[i + 2];
// CIE luminance for RGB
- var gray = (0.2126 * r + 0.7152 * g + 0.0722 * b);
+ var gray = 0.2126 * r + 0.7152 * g + 0.0722 * b;
pixels[i] = pixels[i + 1] = pixels[i + 2] = gray;
}
};
@@ -54302,9 +58775,10 @@ Filters.gray = function (canvas) {
/**
* Sets the alpha channel to entirely opaque. No parameter is used.
*
+ * @private
* @param {Canvas} canvas
*/
-Filters.opaque = function (canvas) {
+Filters.opaque = function(canvas) {
var pixels = Filters._toPixels(canvas);
for (var i = 0; i < pixels.length; i += 4) {
@@ -54316,9 +58790,10 @@ Filters.opaque = function (canvas) {
/**
* Sets each pixel to its inverse value. No parameter is used.
+ * @private
* @param {Canvas} canvas
*/
-Filters.invert = function (canvas) {
+Filters.invert = function(canvas) {
var pixels = Filters._toPixels(canvas);
for (var i = 0; i < pixels.length; i += 4) {
@@ -54326,10 +58801,8 @@ Filters.invert = function (canvas) {
pixels[i + 1] = 255 - pixels[i + 1];
pixels[i + 2] = 255 - pixels[i + 2];
}
-
};
-
/**
* Limits each channel of the image to the number of colors specified as
* the parameter. The parameter can be set to values between 2 and 255, but
@@ -54337,46 +58810,49 @@ Filters.invert = function (canvas) {
*
* Adapted from java based processing implementation
*
+ * @private
* @param {Canvas} canvas
* @param {Integer} level
*/
-Filters.posterize = function (canvas, level) {
+Filters.posterize = function(canvas, level) {
var pixels = Filters._toPixels(canvas);
- if ((level < 2) || (level > 255)) {
+ if (level < 2 || level > 255) {
throw new Error(
'Level must be greater than 2 and less than 255 for posterize'
);
}
var levels1 = level - 1;
- for (var i = 0; i < pixels.length; i+=4) {
+ for (var i = 0; i < pixels.length; i += 4) {
var rlevel = pixels[i];
var glevel = pixels[i + 1];
var blevel = pixels[i + 2];
- pixels[i] = (((rlevel * level) >> 8) * 255) / levels1;
- pixels[i + 1] = (((glevel * level) >> 8) * 255) / levels1;
- pixels[i + 2] = (((blevel * level) >> 8) * 255) / levels1;
+ pixels[i] = ((rlevel * level) >> 8) * 255 / levels1;
+ pixels[i + 1] = ((glevel * level) >> 8) * 255 / levels1;
+ pixels[i + 2] = ((blevel * level) >> 8) * 255 / levels1;
}
};
/**
* reduces the bright areas in an image
+ * @private
* @param {Canvas} canvas
*
*/
-Filters.dilate = function (canvas) {
+Filters.dilate = function(canvas) {
var pixels = Filters._toPixels(canvas);
var currIdx = 0;
- var maxIdx = pixels.length ? pixels.length/4 : 0;
+ var maxIdx = pixels.length ? pixels.length / 4 : 0;
var out = new Int32Array(maxIdx);
var currRowIdx, maxRowIdx, colOrig, colOut, currLum;
- var idxRight, idxLeft, idxUp, idxDown,
- colRight, colLeft, colUp, colDown,
- lumRight, lumLeft, lumUp, lumDown;
- while(currIdx < maxIdx) {
+ var idxRight, idxLeft, idxUp, idxDown;
+ var colRight, colLeft, colUp, colDown;
+ var lumRight, lumLeft, lumUp, lumDown;
+
+ while (currIdx < maxIdx) {
currRowIdx = currIdx;
maxRowIdx = currIdx + canvas.width;
while (currIdx < maxRowIdx) {
@@ -54392,7 +58868,7 @@ Filters.dilate = function (canvas) {
if (idxRight >= maxRowIdx) {
idxRight = currIdx;
}
- if (idxUp < 0){
+ if (idxUp < 0) {
idxUp = 0;
}
if (idxDown >= maxIdx) {
@@ -54404,21 +58880,26 @@ Filters.dilate = function (canvas) {
colRight = Filters._getARGB(pixels, idxRight);
//compute luminance
- currLum = 77*(colOrig>>16&0xff) +
- 151*(colOrig>>8&0xff) +
- 28*(colOrig&0xff);
- lumLeft = 77*(colLeft>>16&0xff) +
- 151*(colLeft>>8&0xff) +
- 28*(colLeft&0xff);
- lumRight = 77*(colRight>>16&0xff) +
- 151*(colRight>>8&0xff) +
- 28*(colRight&0xff);
- lumUp = 77*(colUp>>16&0xff) +
- 151*(colUp>>8&0xff) +
- 28*(colUp&0xff);
- lumDown = 77*(colDown>>16&0xff) +
- 151*(colDown>>8&0xff) +
- 28*(colDown&0xff);
+ currLum =
+ 77 * ((colOrig >> 16) & 0xff) +
+ 151 * ((colOrig >> 8) & 0xff) +
+ 28 * (colOrig & 0xff);
+ lumLeft =
+ 77 * ((colLeft >> 16) & 0xff) +
+ 151 * ((colLeft >> 8) & 0xff) +
+ 28 * (colLeft & 0xff);
+ lumRight =
+ 77 * ((colRight >> 16) & 0xff) +
+ 151 * ((colRight >> 8) & 0xff) +
+ 28 * (colRight & 0xff);
+ lumUp =
+ 77 * ((colUp >> 16) & 0xff) +
+ 151 * ((colUp >> 8) & 0xff) +
+ 28 * (colUp & 0xff);
+ lumDown =
+ 77 * ((colDown >> 16) & 0xff) +
+ 151 * ((colDown >> 8) & 0xff) +
+ 28 * (colDown & 0xff);
if (lumLeft > currLum) {
colOut = colLeft;
@@ -54436,7 +58917,7 @@ Filters.dilate = function (canvas) {
colOut = colDown;
currLum = lumDown;
}
- out[currIdx++]=colOut;
+ out[currIdx++] = colOut;
}
}
Filters._setPixels(pixels, out);
@@ -54444,20 +58925,21 @@ Filters.dilate = function (canvas) {
/**
* increases the bright areas in an image
+ * @private
* @param {Canvas} canvas
*
*/
Filters.erode = function(canvas) {
var pixels = Filters._toPixels(canvas);
var currIdx = 0;
- var maxIdx = pixels.length ? pixels.length/4 : 0;
+ var maxIdx = pixels.length ? pixels.length / 4 : 0;
var out = new Int32Array(maxIdx);
var currRowIdx, maxRowIdx, colOrig, colOut, currLum;
- var idxRight, idxLeft, idxUp, idxDown,
- colRight, colLeft, colUp, colDown,
- lumRight, lumLeft, lumUp, lumDown;
+ var idxRight, idxLeft, idxUp, idxDown;
+ var colRight, colLeft, colUp, colDown;
+ var lumRight, lumLeft, lumUp, lumDown;
- while(currIdx < maxIdx) {
+ while (currIdx < maxIdx) {
currRowIdx = currIdx;
maxRowIdx = currIdx + canvas.width;
while (currIdx < maxRowIdx) {
@@ -54485,21 +58967,26 @@ Filters.erode = function(canvas) {
colRight = Filters._getARGB(pixels, idxRight);
//compute luminance
- currLum = 77*(colOrig>>16&0xff) +
- 151*(colOrig>>8&0xff) +
- 28*(colOrig&0xff);
- lumLeft = 77*(colLeft>>16&0xff) +
- 151*(colLeft>>8&0xff) +
- 28*(colLeft&0xff);
- lumRight = 77*(colRight>>16&0xff) +
- 151*(colRight>>8&0xff) +
- 28*(colRight&0xff);
- lumUp = 77*(colUp>>16&0xff) +
- 151*(colUp>>8&0xff) +
- 28*(colUp&0xff);
- lumDown = 77*(colDown>>16&0xff) +
- 151*(colDown>>8&0xff) +
- 28*(colDown&0xff);
+ currLum =
+ 77 * ((colOrig >> 16) & 0xff) +
+ 151 * ((colOrig >> 8) & 0xff) +
+ 28 * (colOrig & 0xff);
+ lumLeft =
+ 77 * ((colLeft >> 16) & 0xff) +
+ 151 * ((colLeft >> 8) & 0xff) +
+ 28 * (colLeft & 0xff);
+ lumRight =
+ 77 * ((colRight >> 16) & 0xff) +
+ 151 * ((colRight >> 8) & 0xff) +
+ 28 * (colRight & 0xff);
+ lumUp =
+ 77 * ((colUp >> 16) & 0xff) +
+ 151 * ((colUp >> 8) & 0xff) +
+ 28 * (colUp & 0xff);
+ lumDown =
+ 77 * ((colDown >> 16) & 0xff) +
+ 151 * ((colDown >> 8) & 0xff) +
+ 28 * (colDown & 0xff);
if (lumLeft < currLum) {
colOut = colLeft;
@@ -54518,7 +59005,7 @@ Filters.erode = function(canvas) {
currLum = lumDown;
}
- out[currIdx++]=colOut;
+ out[currIdx++] = colOut;
}
}
Filters._setPixels(pixels, out);
@@ -54543,37 +59030,36 @@ var blurMult;
* [toxi 050728]
*/
function buildBlurKernel(r) {
- var radius = (r * 3.5)|0;
- radius = (radius < 1) ? 1 : ((radius < 248) ? radius : 248);
+ var radius = (r * 3.5) | 0;
+ radius = radius < 1 ? 1 : radius < 248 ? radius : 248;
if (blurRadius !== radius) {
blurRadius = radius;
- blurKernelSize = 1 + blurRadius<<1;
+ blurKernelSize = (1 + blurRadius) << 1;
blurKernel = new Int32Array(blurKernelSize);
blurMult = new Array(blurKernelSize);
- for(var l = 0; l < blurKernelSize; l++){
+ for (var l = 0; l < blurKernelSize; l++) {
blurMult[l] = new Int32Array(256);
}
- var bk,bki;
- var bm,bmi;
+ var bk, bki;
+ var bm, bmi;
for (var i = 1, radiusi = radius - 1; i < radius; i++) {
- blurKernel[radius+i] = blurKernel[radiusi] = bki = radiusi * radiusi;
- bm = blurMult[radius+i];
+ blurKernel[radius + i] = blurKernel[radiusi] = bki = radiusi * radiusi;
+ bm = blurMult[radius + i];
bmi = blurMult[radiusi--];
- for (var j = 0; j < 256; j++){
+ for (var j = 0; j < 256; j++) {
bm[j] = bmi[j] = bki * j;
}
}
bk = blurKernel[radius] = radius * radius;
bm = blurMult[radius];
- for (var k = 0; k < 256; k++){
+ for (var k = 0; k < 256; k++) {
bm[k] = bk * k;
}
}
-
}
// Port of https://github.com/processing/processing/blob/
@@ -54661,7 +59147,11 @@ function blurARGB(canvas, radius) {
ri++;
read += width;
}
- argb[x + yi] = (ca/sum)<<24 | (cr/sum)<<16 | (cg/sum)<<8 | (cb/sum);
+ argb[x + yi] =
+ ((ca / sum) << 24) |
+ ((cr / sum) << 16) |
+ ((cg / sum) << 8) |
+ (cb / sum);
}
yi += width;
ymi += width;
@@ -54670,14 +59160,13 @@ function blurARGB(canvas, radius) {
Filters._setPixels(pixels, argb);
}
-Filters.blur = function(canvas, radius){
+Filters.blur = function(canvas, radius) {
blurARGB(canvas, radius);
};
-
module.exports = Filters;
-},{}],75:[function(_dereq_,module,exports){
+},{}],44:[function(_dereq_,module,exports){
/**
* @module Image
* @submodule Image
@@ -54686,49 +59175,47 @@ module.exports = Filters;
*/
/**
- * This module defines the p5 methods for the p5.Image class
+ * This module defines the p5 methods for the p5.Image class
* for drawing images to the main display canvas.
*/
'use strict';
-
-var p5 = _dereq_('../core/core');
-
-/* global frames:true */// This is not global, but JSHint is not aware that
+var p5 = _dereq_('../core/main');
+// This is not global, but ESLint is not aware that
// this module is implicitly enclosed with Browserify: this overrides the
// redefined-global error and permits using the name "frames" for the array
// of saved animation frames.
-var frames = [];
+/* global frames:true */ var frames = [];
/**
- * Creates a new p5.Image (the datatype for storing images). This provides a
+ * Creates a new p5.Image (the datatype for storing images). This provides a
* fresh buffer of pixels to play with. Set the size of the buffer with the
* width and height parameters.
*
- * .pixels gives access to an array containing the values for all the pixels
+ * .pixels gives access to an array containing the values for all the pixels
* in the display window.
* These values are numbers. This array is the size (including an appropriate
- * factor for the pixelDensity) of the display window x4,
+ * factor for the pixelDensity) of the display window x4,
* representing the R, G, B, A values in order for each pixel, moving from
- * left to right across each row, then down each column. See .pixels for
- * more info. It may also be simpler to use set() or get().
+ * left to right across each row, then down each column. See .pixels for
+ * more info. It may also be simpler to use set() or get().
*
* Before accessing the pixels of an image, the data must loaded with the
- * loadPixels() function. After the array data has been modified, the
- * updatePixels() function must be run to update the changes.
+ * loadPixels() function. After the array data has been modified, the
+ * updatePixels() function must be run to update the changes.
*
* @method createImage
* @param {Integer} width width in pixels
* @param {Integer} height height in pixels
- * @return {p5.Image} the p5.Image object
+ * @return {p5.Image} the p5.Image object
* @example
*
*
- * img = createImage(66, 66);
+ * var img = createImage(66, 66);
* img.loadPixels();
- * for (i = 0; i < img.width; i++) {
- * for (j = 0; j < img.height; j++) {
+ * for (var i = 0; i < img.width; i++) {
+ * for (var j = 0; j < img.height; j++) {
* img.set(i, j, color(0, 90, 102));
* }
* }
@@ -54739,11 +59226,11 @@ var frames = [];
*
*
*
- * img = createImage(66, 66);
+ * var img = createImage(66, 66);
* img.loadPixels();
- * for (i = 0; i < img.width; i++) {
- * for (j = 0; j < img.height; j++) {
- * img.set(i, j, color(0, 90, 102, i % img.width * 2));
+ * for (var i = 0; i < img.width; i++) {
+ * for (var j = 0; j < img.height; j++) {
+ * img.set(i, j, color(0, 90, 102, (i % img.width) * 2));
* }
* }
* img.updatePixels();
@@ -54755,15 +59242,15 @@ var frames = [];
*
*
* var pink = color(255, 102, 204);
- * img = createImage(66, 66);
+ * var img = createImage(66, 66);
* img.loadPixels();
* var d = pixelDensity();
- * var halfImage = 4 * (width * d) * (height/2 * d);
- * for (var i = 0; i < halfImage; i+=4) {
+ * var halfImage = 4 * (img.width * d) * (img.height / 2 * d);
+ * for (var i = 0; i < halfImage; i += 4) {
* img.pixels[i] = red(pink);
- * img.pixels[i+1] = green(pink);
- * img.pixels[i+2] = blue(pink);
- * img.pixels[i+3] = alpha(pink);
+ * img.pixels[i + 1] = green(pink);
+ * img.pixels[i + 2] = blue(pink);
+ * img.pixels[i + 3] = alpha(pink);
* }
* img.updatePixels();
* image(img, 17, 17);
@@ -54777,13 +59264,12 @@ var frames = [];
*
*/
p5.prototype.createImage = function(width, height) {
+ p5._validateParameters('createImage', arguments);
return new p5.Image(width, height);
};
/**
- * Save the current canvas as an image. In Safari, this will open the
- * image in the window and the user must provide their own
- * filename on save-as. Other browsers will either save the
+ * Save the current canvas as an image. The browser will either save the
* file immediately, or prompt the user with a dialogue window.
*
* @method saveCanvas
@@ -54791,123 +59277,88 @@ p5.prototype.createImage = function(width, height) {
* representing a specific html5 canvas (optional)
* @param {String} [filename]
* @param {String} [extension] 'jpg' or 'png'
-*/
-/**
- * @method saveCanvas
- * @param {String} [filename]
- * @param {String} [extension]
*
* @example
- *
- * function setup() {
- * var c = createCanvas(100, 100);
- * background(255, 0, 0);
- * saveCanvas(c, 'myCanvas', 'jpg');
- * }
- *
- *
- * // note that this example has the same result as above
- * // if no canvas is specified, defaults to main canvas
- * function setup() {
- * createCanvas(100, 100);
- * background(255, 0, 0);
- * saveCanvas('myCanvas', 'jpg');
- * }
- *
- *
- * // all of the following are valid
- * saveCanvas(c, 'myCanvas', 'jpg');
- * saveCanvas(c, 'myCanvas');
- * saveCanvas(c);
- * saveCanvas('myCanvas', 'png');
- * saveCanvas('myCanvas');
- * saveCanvas();
- *
+ *
+ * function setup() {
+ * var c = createCanvas(100, 100);
+ * background(255, 0, 0);
+ * saveCanvas(c, 'myCanvas', 'jpg');
+ * }
+ *
+ *
+ * // note that this example has the same result as above
+ * // if no canvas is specified, defaults to main canvas
+ * function setup() {
+ * var c = createCanvas(100, 100);
+ * background(255, 0, 0);
+ * saveCanvas('myCanvas', 'jpg');
+ *
+ * // all of the following are valid
+ * saveCanvas(c, 'myCanvas', 'jpg');
+ * saveCanvas(c, 'myCanvas.jpg');
+ * saveCanvas(c, 'myCanvas');
+ * saveCanvas(c);
+ * saveCanvas('myCanvas', 'png');
+ * saveCanvas('myCanvas');
+ * saveCanvas();
+ * }
+ *
*
* @alt
* no image displayed
* no image displayed
* no image displayed
- *
+ */
+/**
+ * @method saveCanvas
+ * @param {String} [filename]
+ * @param {String} [extension]
*/
p5.prototype.saveCanvas = function() {
-
- var cnv, filename, extension;
- if (arguments.length === 3) {
- cnv = arguments[0];
- filename = arguments[1];
- extension = arguments[2];
- } else if (arguments.length === 2) {
- if (typeof arguments[0] === 'object') {
- cnv = arguments[0];
- filename = arguments[1];
- } else {
- filename = arguments[0];
- extension = arguments[1];
- }
- } else if (arguments.length === 1) {
- if (typeof arguments[0] === 'object') {
- cnv = arguments[0];
- } else {
- filename = arguments[0];
- }
+ p5._validateParameters('saveCanvas', arguments);
+
+ // copy arguments to array
+ var args = [].slice.call(arguments);
+ var htmlCanvas, filename, extension;
+
+ if (arguments[0] instanceof HTMLCanvasElement) {
+ htmlCanvas = arguments[0];
+ args.shift();
+ } else if (arguments[0] instanceof p5.Element) {
+ htmlCanvas = arguments[0].elt;
+ args.shift();
+ } else {
+ htmlCanvas = this._curElement && this._curElement.elt;
}
- if (cnv instanceof p5.Element) {
- cnv = cnv.elt;
- }
- if (!(cnv instanceof HTMLCanvasElement)) {
- cnv = null;
+ if (args.length >= 1) {
+ filename = args[0];
}
-
- if (!extension) {
- extension = p5.prototype._checkFileExtension(filename, extension)[1];
- if (extension === '') {
- extension = 'png';
- }
+ if (args.length >= 2) {
+ extension = args[1];
}
- if (!cnv) {
- if (this._curElement && this._curElement.elt) {
- cnv = this._curElement.elt;
- }
- }
+ extension =
+ extension ||
+ p5.prototype._checkFileExtension(filename, extension)[1] ||
+ 'png';
- if ( p5.prototype._isSafari() ) {
- var aText = 'Hello, Safari user!\n';
- aText += 'Now capturing a screenshot...\n';
- aText += 'To save this image,\n';
- aText += 'go to File --> Save As.\n';
- alert(aText);
- window.location.href = cnv.toDataURL();
- } else {
- var mimeType;
- if (typeof(extension) === 'undefined') {
- extension = 'png';
+ var mimeType;
+ switch (extension) {
+ default:
+ //case 'png':
mimeType = 'image/png';
- }
- else {
- switch(extension){
- case 'png':
- mimeType = 'image/png';
- break;
- case 'jpeg':
- mimeType = 'image/jpeg';
- break;
- case 'jpg':
- mimeType = 'image/jpeg';
- break;
- default:
- mimeType = 'image/png';
- break;
- }
- }
- var downloadMime = 'image/octet-stream';
- var imageData = cnv.toDataURL(mimeType);
- imageData = imageData.replace(mimeType, downloadMime);
-
- p5.prototype.downloadFile(imageData, filename, extension);
+ break;
+ case 'jpeg':
+ case 'jpg':
+ mimeType = 'image/jpeg';
+ break;
}
+
+ htmlCanvas.toBlob(function(blob) {
+ p5.prototype.downloadFile(blob, filename, extension);
+ }, mimeType);
};
/**
@@ -54920,7 +59371,7 @@ p5.prototype.saveCanvas = function() {
* as an argument to the callback function as an array of objects, with the
* size of array equal to the total number of frames.
*
- * Note that saveFrames() will only save the first 15 frames of an animation.
+ * Note that saveFrames() will only save the first 15 frames of an animation.
* To export longer animations, you might look into a library like
* ccapture.js.
*
@@ -54938,22 +59389,23 @@ p5.prototype.saveCanvas = function() {
image/octet-stream, filename and extension.
* @example
*
- * function draw() {
- * background(mouseX);
- * }
+ * function draw() {
+ * background(mouseX);
+ * }
*
- * function mousePressed() {
- * saveFrames("out", "png", 1, 25, function(data){
- * print(data);
- * });
- * }
- *
+ * function mousePressed() {
+ * saveFrames('out', 'png', 1, 25, function(data) {
+ * print(data);
+ * });
+ * }
+
*
* @alt
* canvas background goes from light to dark with mouse x.
*
*/
p5.prototype.saveFrames = function(fName, ext, _duration, _fps, callback) {
+ p5._validateParameters('saveFrames', arguments);
var duration = _duration || 3;
duration = p5.prototype.constrain(duration, 0, 15);
duration = duration * 1000;
@@ -54963,17 +59415,16 @@ p5.prototype.saveFrames = function(fName, ext, _duration, _fps, callback) {
var makeFrame = p5.prototype._makeFrame;
var cnv = this._curElement.elt;
- var frameFactory = setInterval(function(){
+ var frameFactory = setInterval(function() {
makeFrame(fName + count, ext, cnv);
count++;
- },1000/fps);
+ }, 1000 / fps);
- setTimeout(function(){
+ setTimeout(function() {
clearInterval(frameFactory);
if (callback) {
callback(frames);
- }
- else {
+ } else {
for (var i = 0; i < frames.length; i++) {
var f = frames[i];
p5.prototype.downloadFile(f.imageData, f.filename, f.ext);
@@ -54994,9 +59445,8 @@ p5.prototype._makeFrame = function(filename, extension, _cnv) {
if (!extension) {
extension = 'png';
mimeType = 'image/png';
- }
- else {
- switch(extension.toLowerCase()){
+ } else {
+ switch (extension.toLowerCase()) {
case 'png':
mimeType = 'image/png';
break;
@@ -55024,7 +59474,7 @@ p5.prototype._makeFrame = function(filename, extension, _cnv) {
module.exports = p5;
-},{"../core/core":55}],76:[function(_dereq_,module,exports){
+},{"../core/main":25}],45:[function(_dereq_,module,exports){
/**
* @module Image
* @submodule Loading & Displaying
@@ -55034,19 +59484,19 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var Filters = _dereq_('./filters');
-var canvas = _dereq_('../core/canvas');
+var canvas = _dereq_('../core/helpers');
var constants = _dereq_('../core/constants');
_dereq_('../core/error_helpers');
/**
- * Loads an image from a path and creates a p5.Image from it.
+ * Loads an image from a path and creates a p5.Image from it.
*
* The image may not be immediately available for rendering
* If you want to ensure that the image is ready before doing
- * anything with it, place the loadImage() call in preload().
+ * anything with it, place the loadImage() call in preload().
* You may also supply a callback function to handle the image when it's ready.
*
* The path to the image should be relative to the HTML file
@@ -55058,16 +59508,16 @@ _dereq_('../core/error_helpers');
* @param {String} path Path of the image to be loaded
* @param {function(p5.Image)} [successCallback] Function to be called once
* the image is loaded. Will be passed the
- * p5.Image.
+ * p5.Image.
* @param {function(Event)} [failureCallback] called with event error if
* the image fails to load.
- * @return {p5.Image} the p5.Image object
+ * @return {p5.Image} the p5.Image object
* @example
*
*
* var img;
* function preload() {
- * img = loadImage("assets/laDefense.jpg");
+ * img = loadImage('assets/laDefense.jpg');
* }
* function setup() {
* image(img, 0, 0);
@@ -55078,7 +59528,7 @@ _dereq_('../core/error_helpers');
*
* function setup() {
* // here we use a callback to display the image after loading
- * loadImage("assets/laDefense.jpg", function(img) {
+ * loadImage('assets/laDefense.jpg', function(img) {
* image(img, 0, 0);
* });
* }
@@ -55091,6 +59541,7 @@ _dereq_('../core/error_helpers');
*
*/
p5.prototype.loadImage = function(path, successCallback, failureCallback) {
+ p5._validateParameters('loadImage', arguments);
var img = new Image();
var pImg = new p5.Image(1, 1, this);
@@ -55110,22 +59561,22 @@ p5.prototype.loadImage = function(path, successCallback, failureCallback) {
self._decrementPreload();
};
img.onerror = function(e) {
- p5._friendlyFileLoadError(0,img.src);
+ p5._friendlyFileLoadError(0, img.src);
if (typeof failureCallback === 'function') {
failureCallback(e);
}
};
- //set crossOrigin in case image is served which CORS headers
- //this will let us draw to canvas without tainting it.
- //see https://developer.mozilla.org/en-US/docs/HTML/CORS_Enabled_Image
+ // Set crossOrigin in case image is served with CORS headers.
+ // This will let us draw to the canvas without tainting it.
+ // See https://developer.mozilla.org/en-US/docs/HTML/CORS_Enabled_Image
// When using data-uris the file will be loaded locally
- // so we don't need to worry about crossOrigin with base64 file types
- if(path.indexOf('data:image/') !== 0) {
+ // so we don't need to worry about crossOrigin with base64 file types.
+ if (path.indexOf('data:image/') !== 0) {
img.crossOrigin = 'Anonymous';
}
- //start loading the image
+ // start loading the image
img.src = path;
return pImg;
@@ -55143,8 +59594,7 @@ p5.prototype.loadImage = function(path, successCallback, failureCallback) {
function _sAssign(sVal, iVal) {
if (sVal > 0 && sVal < iVal) {
return sVal;
- }
- else {
+ } else {
return iVal;
}
}
@@ -55167,7 +59617,7 @@ function _sAssign(sVal, iVal) {
* 
*
* @method image
- * @param {p5.Image|p5.Graphics} img the image to display
+ * @param {p5.Image|p5.Element} img the image to display
* @param {Number} x the x-coordinate of the top-left corner of the image
* @param {Number} y the y-coordinate of the top-left corner of the image
* @param {Number} [width] the width to draw the image
@@ -55177,7 +59627,7 @@ function _sAssign(sVal, iVal) {
*
* var img;
* function preload() {
- * img = loadImage("assets/laDefense.jpg");
+ * img = loadImage('assets/laDefense.jpg');
* }
* function setup() {
* // Top-left corner of the img is at (0, 0)
@@ -55190,7 +59640,7 @@ function _sAssign(sVal, iVal) {
*
* var img;
* function preload() {
- * img = loadImage("assets/laDefense.jpg");
+ * img = loadImage('assets/laDefense.jpg');
* }
* function setup() {
* background(50);
@@ -55204,7 +59654,7 @@ function _sAssign(sVal, iVal) {
*
* function setup() {
* // Here, we use a callback to display the image after loading
- * loadImage("assets/laDefense.jpg", function(img) {
+ * loadImage('assets/laDefense.jpg', function(img) {
* image(img, 0, 0);
* });
* }
@@ -55214,21 +59664,21 @@ function _sAssign(sVal, iVal) {
*
* var img;
* function preload() {
- * img = loadImage("assets/gradient.png");
+ * img = loadImage('assets/gradient.png');
* }
* function setup() {
- * // 1. Background image
- * // Top-left corner of the img is at (0, 0)
- * // Width and height are the img's original width and height, 100 x 100
- * image(img, 0, 0);
- * // 2. Top right image
- * // Top-left corner of destination rectangle is at (50, 0)
- * // Destination rectangle width and height are 40 x 20
- * // The next parameters are relative to the source image:
- * // - Starting at position (50, 50) on the source image, capture a 50 x 50
- * // subsection
- * // - Draw this subsection to fill the dimensions of the destination rectangle
- * image(img, 50, 0, 40, 20, 50, 50, 50, 50);
+ * // 1. Background image
+ * // Top-left corner of the img is at (0, 0)
+ * // Width and height are the img's original width and height, 100 x 100
+ * image(img, 0, 0);
+ * // 2. Top right image
+ * // Top-left corner of destination rectangle is at (50, 0)
+ * // Destination rectangle width and height are 40 x 20
+ * // The next parameters are relative to the source image:
+ * // - Starting at position (50, 50) on the source image, capture a 50 x 50
+ * // subsection
+ * // - Draw this subsection to fill the dimensions of the destination rectangle
+ * image(img, 50, 0, 40, 20, 50, 50, 50, 50);
* }
*
*
@@ -55239,7 +59689,7 @@ function _sAssign(sVal, iVal) {
*/
/**
* @method image
- * @param {p5.Image|p5.Graphics} img
+ * @param {p5.Image|p5.Element} img
* @param {Number} dx the x-coordinate of the destination
* rectangle in which to draw the source image
* @param {Number} dy the y-coordinate of the destination
@@ -55256,14 +59706,26 @@ function _sAssign(sVal, iVal) {
* @param {Number} [sHeight] the height of the subsection of the
* source image to draw into the destination rectangle
*/
-p5.prototype.image =
- function(img, dx, dy, dWidth, dHeight, sx, sy, sWidth, sHeight) {
+p5.prototype.image = function(
+ img,
+ dx,
+ dy,
+ dWidth,
+ dHeight,
+ sx,
+ sy,
+ sWidth,
+ sHeight
+) {
// set defaults per spec: https://goo.gl/3ykfOq
+ p5._validateParameters('image', arguments);
+
var defW = img.width;
var defH = img.height;
- if (img.elt && img.elt.videoWidth && !img.canvas) { // video no canvas
+ if (img.elt && img.elt.videoWidth && !img.canvas) {
+ // video no canvas
defW = img.elt.videoWidth;
defH = img.elt.videoHeight;
}
@@ -55280,7 +59742,6 @@ p5.prototype.image =
_sw = _sAssign(_sw, defW);
_sh = _sAssign(_sh, defH);
-
// This part needs cleanup and unit tests
// see issues https://github.com/processing/p5.js/issues/1741
// and https://github.com/processing/p5.js/issues/1673
@@ -55289,11 +59750,10 @@ p5.prototype.image =
if (img.elt && !img.canvas && img.elt.style.width) {
//if img is video and img.elt.size() has been used and
//no width passed to image()
- if(img.elt.videoWidth && !dWidth){
+ if (img.elt.videoWidth && !dWidth) {
pd = img.elt.videoWidth;
- }
- //all other cases
- else {
+ } else {
+ //all other cases
pd = img.elt.width;
}
pd /= parseInt(img.elt.style.width, 10);
@@ -55304,15 +59764,12 @@ p5.prototype.image =
_sh *= pd;
_sw *= pd;
- var vals = canvas.modeAdjust(_dx, _dy, _dw, _dh,
- this._renderer._imageMode);
+ var vals = canvas.modeAdjust(_dx, _dy, _dw, _dh, this._renderer._imageMode);
// tint the image if there is a tint
- this._renderer.image(img, _sx, _sy, _sw, _sh, vals.x, vals.y, vals.w,
- vals.h);
+ this._renderer.image(img, _sx, _sy, _sw, _sh, vals.x, vals.y, vals.w, vals.h);
};
-
/**
* Sets the fill value for displaying images. Images can be tinted to
* specified colors or made transparent by including an alpha value.
@@ -55320,10 +59777,10 @@ p5.prototype.image =
* To apply transparency to an image without affecting its color, use
* white as the tint color and specify an alpha value. For instance,
* tint(255, 128) will make an image 50% transparent (assuming the default
- * alpha range of 0-255, which can be changed with colorMode()).
+ * alpha range of 0-255, which can be changed with colorMode()).
*
* The value for the gray parameter must be less than or equal to the current
- * maximum value as specified by colorMode(). The default maximum value is
+ * maximum value as specified by colorMode(). The default maximum value is
* 255.
*
*
@@ -55335,35 +59792,17 @@ p5.prototype.image =
* @param {Number} v3 blue or brightness value
* relative to the current color range
* @param {Number} [alpha]
- */
-
-/**
- * @method tint
- * @param {String} value a color string
- * @param {Number} [alpha]
- */
-
-/**
- * @method tint
- * @param {Number[]} values an array containing the red,green,blue &
- * and alpha components of the color
- */
-
-/**
- * @method tint
- * @param {p5.Color} color the tint color
- * @param {Number} [alpha]
*
* @example
*
*
* var img;
* function preload() {
- * img = loadImage("assets/laDefense.jpg");
+ * img = loadImage('assets/laDefense.jpg');
* }
* function setup() {
* image(img, 0, 0);
- * tint(0, 153, 204); // Tint blue
+ * tint(0, 153, 204); // Tint blue
* image(img, 50, 0);
* }
*
@@ -55373,11 +59812,11 @@ p5.prototype.image =
*
* var img;
* function preload() {
- * img = loadImage("assets/laDefense.jpg");
+ * img = loadImage('assets/laDefense.jpg');
* }
* function setup() {
* image(img, 0, 0);
- * tint(0, 153, 204, 126); // Tint blue and set transparency
+ * tint(0, 153, 204, 126); // Tint blue and set transparency
* image(img, 50, 0);
* }
*
@@ -55387,11 +59826,11 @@ p5.prototype.image =
*
* var img;
* function preload() {
- * img = loadImage("assets/laDefense.jpg");
+ * img = loadImage('assets/laDefense.jpg');
* }
* function setup() {
* image(img, 0, 0);
- * tint(255, 126); // Apply transparency without changing color
+ * tint(255, 126); // Apply transparency without changing color
* image(img, 50, 0);
* }
*
@@ -55403,7 +59842,30 @@ p5.prototype.image =
* 2 side by side images of umbrella and ceiling, one image translucent
*
*/
-p5.prototype.tint = function () {
+
+/**
+ * @method tint
+ * @param {String} value a color string
+ */
+
+/**
+ * @method tint
+ * @param {Number} gray a gray value
+ * @param {Number} [alpha]
+ */
+
+/**
+ * @method tint
+ * @param {Number[]} values an array containing the red,green,blue &
+ * and alpha components of the color
+ */
+
+/**
+ * @method tint
+ * @param {p5.Color} color the tint color
+ */
+p5.prototype.tint = function() {
+ p5._validateParameters('tint', arguments);
var c = this.color.apply(this, arguments);
this._renderer._tint = c.levels;
};
@@ -55418,12 +59880,12 @@ p5.prototype.tint = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * tint(0, 153, 204); // Tint blue
+ * tint(0, 153, 204); // Tint blue
* image(img, 0, 0);
- * noTint(); // Disable tint
+ * noTint(); // Disable tint
* image(img, 50, 0);
* }
*
@@ -55441,6 +59903,7 @@ p5.prototype.noTint = function() {
* Apply the current tint color to the input image, return the resulting
* canvas.
*
+ * @private
* @param {p5.Image} The image to be tinted
* @return {canvas} The resulting tinted canvas
*
@@ -55457,16 +59920,16 @@ p5.prototype._getTintedImageCanvas = function(img) {
var id = tmpCtx.createImageData(img.canvas.width, img.canvas.height);
var newPixels = id.data;
- for(var i = 0; i < pixels.length; i += 4) {
+ for (var i = 0; i < pixels.length; i += 4) {
var r = pixels[i];
- var g = pixels[i+1];
- var b = pixels[i+2];
- var a = pixels[i+3];
+ var g = pixels[i + 1];
+ var b = pixels[i + 2];
+ var a = pixels[i + 3];
- newPixels[i] = r*this._renderer._tint[0]/255;
- newPixels[i+1] = g*this._renderer._tint[1]/255;
- newPixels[i+2] = b*this._renderer._tint[2]/255;
- newPixels[i+3] = a*this._renderer._tint[3]/255;
+ newPixels[i] = r * this._renderer._tint[0] / 255;
+ newPixels[i + 1] = g * this._renderer._tint[1] / 255;
+ newPixels[i + 2] = b * this._renderer._tint[2] / 255;
+ newPixels[i + 3] = a * this._renderer._tint[3] / 255;
}
tmpCtx.putImageData(id, 0, 0);
@@ -55475,17 +59938,17 @@ p5.prototype._getTintedImageCanvas = function(img) {
/**
* Set image mode. Modifies the location from which images are drawn by
- * changing the way in which parameters given to image() are interpreted.
+ * changing the way in which parameters given to image() are interpreted.
* The default mode is imageMode(CORNER), which interprets the second and
- * third parameters of image() as the upper-left corner of the image. If
+ * third parameters of image() as the upper-left corner of the image. If
* two additional parameters are specified, they are used to set the image's
* width and height.
*
- * imageMode(CORNERS) interprets the second and third parameters of image()
+ * imageMode(CORNERS) interprets the second and third parameters of image()
* as the location of one corner, and the fourth and fifth parameters as the
* opposite corner.
*
- * imageMode(CENTER) interprets the second and third parameters of image()
+ * imageMode(CENTER) interprets the second and third parameters of image()
* as the image's center point. If two additional parameters are specified,
* they are used to set the image's width and height.
*
@@ -55497,7 +59960,7 @@ p5.prototype._getTintedImageCanvas = function(img) {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
* imageMode(CORNER);
@@ -55510,7 +59973,7 @@ p5.prototype._getTintedImageCanvas = function(img) {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
* imageMode(CORNERS);
@@ -55523,7 +59986,7 @@ p5.prototype._getTintedImageCanvas = function(img) {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
* imageMode(CENTER);
@@ -55539,17 +60002,19 @@ p5.prototype._getTintedImageCanvas = function(img) {
*
*/
p5.prototype.imageMode = function(m) {
- if (m === constants.CORNER ||
+ p5._validateParameters('imageMode', arguments);
+ if (
+ m === constants.CORNER ||
m === constants.CORNERS ||
- m === constants.CENTER) {
+ m === constants.CENTER
+ ) {
this._renderer._imageMode = m;
}
};
-
module.exports = p5;
-},{"../core/canvas":53,"../core/constants":54,"../core/core":55,"../core/error_helpers":58,"./filters":74}],77:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/error_helpers":21,"../core/helpers":22,"../core/main":25,"./filters":43}],46:[function(_dereq_,module,exports){
/**
* @module Image
* @submodule Image
@@ -55559,13 +60024,13 @@ module.exports = p5;
*/
/**
- * This module defines the p5.Image class and P5 methods for
+ * This module defines the p5.Image class and P5 methods for
* drawing images to the main display canvas.
*/
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var Filters = _dereq_('./filters');
/*
@@ -55573,27 +60038,72 @@ var Filters = _dereq_('./filters');
*/
/**
- * Creates a new p5.Image. A p5.Image is a canvas backed representation of an
+ * Creates a new p5.Image. A p5.Image is a canvas backed representation of an
* image.
*
* p5 can display .gif, .jpg and .png images. Images may be displayed
* in 2D and 3D space. Before an image is used, it must be loaded with the
- * loadImage() function. The p5.Image class contains fields for the width and
- * height of the image, as well as an array called pixels[] that contains the
+ * loadImage() function. The p5.Image class contains fields for the width and
+ * height of the image, as well as an array called pixels[] that contains the
* values for every pixel in the image.
*
* The methods described below allow easy access to the image's pixels and
* alpha channel and simplify the process of compositing.
*
- * Before using the pixels[] array, be sure to use the loadPixels() method on
+ * Before using the pixels[] array, be sure to use the loadPixels() method on
* the image to make sure that the pixel data is properly loaded.
+ * @example
+ *
+ * function setup() {
+ * var img = createImage(100, 100); // same as new p5.Image(100, 100);
+ * img.loadPixels();
+ * createCanvas(100, 100);
+ * background(0);
+ *
+ * // helper for writing color to array
+ * function writeColor(image, x, y, red, green, blue, alpha) {
+ * var index = (x + y * width) * 4;
+ * image.pixels[index] = red;
+ * image.pixels[index + 1] = green;
+ * image.pixels[index + 2] = blue;
+ * image.pixels[index + 3] = alpha;
+ * }
+ *
+ * var x, y;
+ * // fill with random colors
+ * for (y = 0; y < img.height; y++) {
+ * for (x = 0; x < img.width; x++) {
+ * var red = random(255);
+ * var green = random(255);
+ * var blue = random(255);
+ * var alpha = 255;
+ * writeColor(img, x, y, red, green, blue, alpha);
+ * }
+ * }
+ *
+ * // draw a red line
+ * y = 0;
+ * for (x = 0; x < img.width; x++) {
+ * writeColor(img, x, y, 255, 0, 0, 255);
+ * }
+ *
+ * // draw a green line
+ * y = img.height - 1;
+ * for (x = 0; x < img.width; x++) {
+ * writeColor(img, x, y, 0, 255, 0, 255);
+ * }
+ *
+ * img.updatePixels();
+ * image(img, 0, 0);
+ * }
+ *
+ *
*
* @class p5.Image
- * @constructor
* @param {Number} width
* @param {Number} height
*/
-p5.Image = function(width, height){
+p5.Image = function(width, height) {
/**
* Image width.
* @property {Number} width
@@ -55602,16 +60112,16 @@ p5.Image = function(width, height){
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
* createCanvas(100, 100);
* image(img, 0, 0);
- * for (var i=0; i < img.width; i++) {
- * var c = img.get(i, img.height/2);
+ * for (var i = 0; i < img.width; i++) {
+ * var c = img.get(i, img.height / 2);
* stroke(c);
- * line(i, height/2, i, height);
+ * line(i, height / 2, i, height);
* }
* }
*
@@ -55629,16 +60139,16 @@ p5.Image = function(width, height){
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
* createCanvas(100, 100);
* image(img, 0, 0);
- * for (var i=0; i < img.height; i++) {
- * var c = img.get(img.width/2, i);
+ * for (var i = 0; i < img.height; i++) {
+ * var c = img.get(img.width / 2, i);
* stroke(c);
- * line(0, i, width/2, i);
+ * line(0, i, width / 2, i);
* }
* }
*
@@ -55655,13 +60165,14 @@ p5.Image = function(width, height){
this._pixelDensity = 1;
//used for webgl texturing only
this._modified = false;
+ this._pixelsDirty = true;
/**
* Array containing the values for all the pixels in the display window.
* These values are numbers. This array is the size (include an appropriate
* factor for pixelDensity) of the display window x4,
* representing the R, G, B, A values in order for each pixel, moving from
* left to right across each row, then down each column. Retina and other
- * high denisty displays may have more pixels[] (by a factor of
+ * high denisty displays may have more pixels (by a factor of
* pixelDensity^2).
* For example, if the image is 100x100 pixels, there will be 40,000. With
* pixelDensity = 2, there will be 160,000. The first four values
@@ -55670,7 +60181,7 @@ p5.Image = function(width, height){
* values of the pixel at (1, 0). More generally, to set values for a pixel
* at (x, y):
* ```javascript
- * var d = pixelDensity;
+ * var d = pixelDensity();
* for (var i = 0; i < d; i++) {
* for (var j = 0; j < d; j++) {
* // loop over
@@ -55683,17 +60194,17 @@ p5.Image = function(width, height){
* }
* ```
*
- * Before accessing this array, the data must loaded with the loadPixels()
- * function. After the array data has been modified, the updatePixels()
+ * Before accessing this array, the data must loaded with the loadPixels()
+ * function. After the array data has been modified, the updatePixels()
* function must be run to update the changes.
* @property {Number[]} pixels
* @example
*
*
- * img = createImage(66, 66);
+ * var img = createImage(66, 66);
* img.loadPixels();
- * for (i = 0; i < img.width; i++) {
- * for (j = 0; j < img.height; j++) {
+ * for (var i = 0; i < img.width; i++) {
+ * for (var j = 0; j < img.height; j++) {
* img.set(i, j, color(0, 90, 102));
* }
* }
@@ -55704,13 +60215,13 @@ p5.Image = function(width, height){
*
*
* var pink = color(255, 102, 204);
- * img = createImage(66, 66);
+ * var img = createImage(66, 66);
* img.loadPixels();
- * for (var i = 0; i < 4*(width*height/2); i+=4) {
+ * for (var i = 0; i < 4 * (width * height / 2); i += 4) {
* img.pixels[i] = red(pink);
- * img.pixels[i+1] = green(pink);
- * img.pixels[i+2] = blue(pink);
- * img.pixels[i+3] = alpha(pink);
+ * img.pixels[i + 1] = green(pink);
+ * img.pixels[i + 2] = blue(pink);
+ * img.pixels[i + 3] = alpha(pink);
* }
* img.updatePixels();
* image(img, 17, 17);
@@ -55723,14 +60234,13 @@ p5.Image = function(width, height){
*
*/
this.pixels = [];
- this.name = 'p5.Image'; // for friendly debugger system
};
/**
* Helper fxn for sharing pixel methods
*
*/
-p5.Image.prototype._setProperty = function (prop, value) {
+p5.Image.prototype._setProperty = function(prop, value) {
this[prop] = value;
this.setModified(true);
};
@@ -55745,14 +60255,14 @@ p5.Image.prototype._setProperty = function (prop, value) {
* var halfImage;
*
* function preload() {
- * myImage = loadImage("assets/rockies.jpg");
+ * myImage = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
* myImage.loadPixels();
- * halfImage = 4 * width * height/2;
- * for(var i = 0; i < halfImage; i++){
- * myImage.pixels[i+halfImage] = myImage.pixels[i];
+ * halfImage = 4 * width * height / 2;
+ * for (var i = 0; i < halfImage; i++) {
+ * myImage.pixels[i + halfImage] = myImage.pixels[i];
* }
* myImage.updatePixels();
* }
@@ -55762,11 +60272,11 @@ p5.Image.prototype._setProperty = function (prop, value) {
* }
*
*
- * @alt
- * 2 images of rocky mountains vertically stacked
- *
+ * @alt
+ * 2 images of rocky mountains vertically stacked
+ *
*/
-p5.Image.prototype.loadPixels = function(){
+p5.Image.prototype.loadPixels = function() {
p5.Renderer2D.prototype.loadPixels.call(this);
this.setModified(true);
};
@@ -55784,23 +60294,20 @@ p5.Image.prototype.loadPixels = function(){
* underlying canvas
* @param {Integer} h height of the target update area for the
* underlying canvas
- */
-/**
- * @method updatePixels
* @example
*
* var myImage;
* var halfImage;
*
* function preload() {
- * myImage = loadImage("assets/rockies.jpg");
+ * myImage = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
* myImage.loadPixels();
- * halfImage = 4 * width * height/2;
- * for(var i = 0; i < halfImage; i++){
- * myImage.pixels[i+halfImage] = myImage.pixels[i];
+ * halfImage = 4 * width * height / 2;
+ * for (var i = 0; i < halfImage; i++) {
+ * myImage.pixels[i + halfImage] = myImage.pixels[i];
* }
* myImage.updatePixels();
* }
@@ -55814,7 +60321,10 @@ p5.Image.prototype.loadPixels = function(){
* 2 images of rocky mountains vertically stacked
*
*/
-p5.Image.prototype.updatePixels = function(x, y, w, h){
+/**
+ * @method updatePixels
+ */
+p5.Image.prototype.updatePixels = function(x, y, w, h) {
p5.Renderer2D.prototype.updatePixels.call(this, x, y, w, h);
this.setModified(true);
};
@@ -55824,7 +60334,7 @@ p5.Image.prototype.updatePixels = function(x, y, w, h){
*
* If no params are passed, those whole image is returned,
* if x and y are the only params passed a single pixel is extracted
- * if all params are passed a rectangle region is extracted and a p5.Image
+ * if all params are passed a rectangle region is extracted and a p5.Image
* is returned.
*
* Returns undefined if the region is outside the bounds of the image
@@ -55835,14 +60345,14 @@ p5.Image.prototype.updatePixels = function(x, y, w, h){
* @param {Number} [w] width
* @param {Number} [h] height
* @return {Number[]|Color|p5.Image} color of pixel at x,y in array format
- * [R, G, B, A] or p5.Image
+ * [R, G, B, A] or p5.Image
* @example
*
* var myImage;
* var c;
*
* function preload() {
- * myImage = loadImage("assets/rockies.jpg");
+ * myImage = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
@@ -55860,31 +60370,31 @@ p5.Image.prototype.updatePixels = function(x, y, w, h){
* image of rocky mountains with 50x50 green rect in front
*
*/
-p5.Image.prototype.get = function(x, y, w, h){
+p5.Image.prototype.get = function(x, y, w, h) {
return p5.Renderer2D.prototype.get.call(this, x, y, w, h);
};
/**
* Set the color of a single pixel or write an image into
- * this p5.Image.
+ * this p5.Image.
*
* Note that for a large number of pixels this will
* be slower than directly manipulating the pixels array
- * and then calling updatePixels().
+ * and then calling updatePixels().
*
* @method set
* @param {Number} x x-coordinate of the pixel
* @param {Number} y y-coordinate of the pixel
- * @param {Number|Array|Object} a grayscale value | pixel array |
- * a p5.Color | image to copy
+ * @param {Number|Number[]|Object} a grayscale value | pixel array |
+ * a p5.Color | image to copy
* @example
*
*
- * img = createImage(66, 66);
+ * var img = createImage(66, 66);
* img.loadPixels();
- * for (i = 0; i < img.width; i++) {
- * for (j = 0; j < img.height; j++) {
- * img.set(i, j, color(0, 90, 102, i % img.width * 2));
+ * for (var i = 0; i < img.width; i++) {
+ * for (var j = 0; j < img.height; j++) {
+ * img.set(i, j, color(0, 90, 102, (i % img.width) * 2));
* }
* }
* img.updatePixels();
@@ -55897,7 +60407,7 @@ p5.Image.prototype.get = function(x, y, w, h){
* 2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas
*
*/
-p5.Image.prototype.set = function(x, y, imgOrCol){
+p5.Image.prototype.set = function(x, y, imgOrCol) {
p5.Renderer2D.prototype.set.call(this, x, y, imgOrCol);
this.setModified(true);
};
@@ -55915,8 +60425,8 @@ p5.Image.prototype.set = function(x, y, imgOrCol){
*
* var img;
*
- * function setup() {
- * img = loadImage("assets/rockies.jpg");
+ * function preload() {
+ * img = loadImage('assets/rockies.jpg');
* }
* function draw() {
@@ -55932,8 +60442,7 @@ p5.Image.prototype.set = function(x, y, imgOrCol){
* image of rocky mountains. zoomed in
*
*/
-p5.Image.prototype.resize = function(width, height){
-
+p5.Image.prototype.resize = function(width, height) {
// Copy contents to a temporary canvas, resize the original
// and then copy back.
//
@@ -55960,28 +60469,32 @@ p5.Image.prototype.resize = function(width, height){
var tempCanvas = document.createElement('canvas');
tempCanvas.width = width;
tempCanvas.height = height;
- tempCanvas.getContext('2d').drawImage(this.canvas,
+ // prettier-ignore
+ tempCanvas.getContext('2d').drawImage(
+ this.canvas,
0, 0, this.canvas.width, this.canvas.height,
0, 0, tempCanvas.width, tempCanvas.height
);
-
// Resize the original canvas, which will clear its contents
this.canvas.width = this.width = width;
this.canvas.height = this.height = height;
//Copy the image back
- this.drawingContext.drawImage(tempCanvas,
+ // prettier-ignore
+ this.drawingContext.drawImage(
+ tempCanvas,
0, 0, width, height,
0, 0, width, height
);
- if(this.pixels.length > 0){
+ if (this.pixels.length > 0) {
this.loadPixels();
}
this.setModified(true);
+ this._pixelsDirty = true;
};
/**
@@ -55992,7 +60505,7 @@ p5.Image.prototype.resize = function(width, height){
* target region.
*
* @method copy
- * @param {p5.Image|p5.Graphics|undefined} srcImage source image
+ * @param {p5.Image|p5.Element} srcImage source image
* @param {Integer} sx X coordinate of the source's upper left corner
* @param {Integer} sy Y coordinate of the source's upper left corner
* @param {Integer} sw source image width
@@ -56009,13 +60522,13 @@ p5.Image.prototype.resize = function(width, height){
* var y;
*
* function preload() {
- * photo = loadImage("assets/rockies.jpg");
- * bricks = loadImage("assets/bricks.jpg");
+ * photo = loadImage('assets/rockies.jpg');
+ * bricks = loadImage('assets/bricks.jpg');
* }
*
* function setup() {
- * x = bricks.width/2;
- * y = bricks.height/2;
+ * x = bricks.width / 2;
+ * y = bricks.height / 2;
* photo.copy(bricks, 0, 0, x, y, 0, 0, x, y);
* image(photo, 0, 0);
* }
@@ -56025,8 +60538,44 @@ p5.Image.prototype.resize = function(width, height){
* image of rocky mountains and smaller image on top of bricks at top left
*
*/
-p5.Image.prototype.copy = function () {
- p5.prototype.copy.apply(this, arguments);
+/**
+ * @method copy
+ * @param {Integer} sx
+ * @param {Integer} sy
+ * @param {Integer} sw
+ * @param {Integer} sh
+ * @param {Integer} dx
+ * @param {Integer} dy
+ * @param {Integer} dw
+ * @param {Integer} dh
+ */
+p5.Image.prototype.copy = function() {
+ var srcImage, sx, sy, sw, sh, dx, dy, dw, dh;
+ if (arguments.length === 9) {
+ srcImage = arguments[0];
+ sx = arguments[1];
+ sy = arguments[2];
+ sw = arguments[3];
+ sh = arguments[4];
+ dx = arguments[5];
+ dy = arguments[6];
+ dw = arguments[7];
+ dh = arguments[8];
+ } else if (arguments.length === 8) {
+ srcImage = this;
+ sx = arguments[0];
+ sy = arguments[1];
+ sw = arguments[2];
+ sh = arguments[3];
+ dx = arguments[4];
+ dy = arguments[5];
+ dw = arguments[6];
+ dh = arguments[7];
+ } else {
+ throw new Error('Signature not supported');
+ }
+ p5.Renderer2D._copyHelper(this, srcImage, sx, sy, sw, sh, dx, dy, dw, dh);
+ this._pixelsDirty = true;
};
/**
@@ -56040,8 +60589,8 @@ p5.Image.prototype.copy = function () {
*
* var photo, maskImage;
* function preload() {
- * photo = loadImage("assets/rockies.jpg");
- * maskImage = loadImage("assets/mask2.png");
+ * photo = loadImage('assets/rockies.jpg');
+ * maskImage = loadImage('assets/mask2.png');
* }
*
* function setup() {
@@ -56064,7 +60613,7 @@ p5.Image.prototype.copy = function () {
// moment this method does not match native processings original
// functionality exactly.
p5.Image.prototype.mask = function(p5Image) {
- if(p5Image === undefined){
+ if (p5Image === undefined) {
p5Image = this;
}
var currBlend = this.drawingContext.globalCompositeOperation;
@@ -56078,8 +60627,8 @@ p5.Image.prototype.mask = function(p5Image) {
p5Image,
0,
0,
- scaleFactor*p5Image.width,
- scaleFactor*p5Image.height,
+ scaleFactor * p5Image.width,
+ scaleFactor * p5Image.height,
0,
0,
this.width,
@@ -56093,27 +60642,29 @@ p5.Image.prototype.mask = function(p5Image) {
};
/**
- * Applies an image filter to a p5.Image
+ * Applies an image filter to a p5.Image
*
* @method filter
- * @param {String} operation one of threshold, gray, invert, posterize, opaque
- * erode, dilate and blur. See Filters.js for docs on
- * each available filter
- * @param {Number|undefined} value
+ * @param {Constant} filterType either THRESHOLD, GRAY, OPAQUE, INVERT,
+ * POSTERIZE, BLUR, ERODE, DILATE or BLUR.
+ * See Filters.js for docs on
+ * each available filter
+ * @param {Number} [filterParam] an optional parameter unique
+ * to each filter, see above
* @example
*
* var photo1;
* var photo2;
*
* function preload() {
- * photo1 = loadImage("assets/rockies.jpg");
- * photo2 = loadImage("assets/rockies.jpg");
+ * photo1 = loadImage('assets/rockies.jpg');
+ * photo2 = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
- * photo2.filter("gray");
+ * photo2.filter('gray');
* image(photo1, 0, 0);
- * image(photo2, width/2, 0);
+ * image(photo2, width / 2, 0);
* }
*
*
@@ -56131,7 +60682,7 @@ p5.Image.prototype.filter = function(operation, value) {
* blend mode to do the operation.
*
* @method blend
- * @param {p5.Image|undefined} srcImage source image
+ * @param {p5.Image} srcImage source image
* @param {Integer} sx X coordinate of the source's upper left corner
* @param {Integer} sy Y coordinate of the source's upper left corner
* @param {Integer} sw source image width
@@ -56140,7 +60691,10 @@ p5.Image.prototype.filter = function(operation, value) {
* @param {Integer} dy Y coordinate of the destination's upper left corner
* @param {Integer} dw destination image width
* @param {Integer} dh destination image height
- * @param {Integer} blendMode the blend mode
+ * @param {Constant} blendMode the blend mode. either
+ * BLEND, DARKEST, LIGHTEST, DIFFERENCE,
+ * MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,
+ * SOFT_LIGHT, DODGE, BURN, ADD or NORMAL.
*
* Available blend modes are: normal | multiply | screen | overlay |
* darken | lighten | color-dodge | color-burn | hard-light |
@@ -56155,8 +60709,8 @@ p5.Image.prototype.filter = function(operation, value) {
* var bricks;
*
* function preload() {
- * mountains = loadImage("assets/rockies.jpg");
- * bricks = loadImage("assets/bricks_third.jpg");
+ * mountains = loadImage('assets/rockies.jpg');
+ * bricks = loadImage('assets/bricks_third.jpg');
* }
*
* function setup() {
@@ -56170,8 +60724,8 @@ p5.Image.prototype.filter = function(operation, value) {
* var bricks;
*
* function preload() {
- * mountains = loadImage("assets/rockies.jpg");
- * bricks = loadImage("assets/bricks_third.jpg");
+ * mountains = loadImage('assets/rockies.jpg');
+ * bricks = loadImage('assets/bricks_third.jpg');
* }
*
* function setup() {
@@ -56185,8 +60739,8 @@ p5.Image.prototype.filter = function(operation, value) {
* var bricks;
*
* function preload() {
- * mountains = loadImage("assets/rockies.jpg");
- * bricks = loadImage("assets/bricks_third.jpg");
+ * mountains = loadImage('assets/rockies.jpg');
+ * bricks = loadImage('assets/bricks_third.jpg');
* }
*
* function setup() {
@@ -56202,6 +60756,18 @@ p5.Image.prototype.filter = function(operation, value) {
* image of rockies. Brickwall images on left and right. Right translucent
*
*/
+/**
+ * @method blend
+ * @param {Integer} sx
+ * @param {Integer} sy
+ * @param {Integer} sw
+ * @param {Integer} sh
+ * @param {Integer} dx
+ * @param {Integer} dy
+ * @param {Integer} dw
+ * @param {Integer} dh
+ * @param {Constant} blendMode
+ */
p5.Image.prototype.blend = function() {
p5.prototype.blend.apply(this, arguments);
this.setModified(true);
@@ -56216,7 +60782,7 @@ p5.Image.prototype.blend = function() {
* modified.
* @private
*/
-p5.Image.prototype.setModified = function (val) {
+p5.Image.prototype.setModified = function(val) {
this._modified = val; //enforce boolean?
};
@@ -56229,7 +60795,7 @@ p5.Image.prototype.setModified = function (val) {
* @return {boolean} a boolean indicating whether or not the
* image has been updated or modified since last texture upload.
*/
-p5.Image.prototype.isModified = function () {
+p5.Image.prototype.isModified = function() {
return this._modified;
};
@@ -56246,7 +60812,7 @@ p5.Image.prototype.isModified = function () {
* var photo;
*
* function preload() {
- * photo = loadImage("assets/rockies.jpg");
+ * photo = loadImage('assets/rockies.jpg');
* }
*
* function draw() {
@@ -56254,8 +60820,8 @@ p5.Image.prototype.isModified = function () {
* }
*
* function keyTyped() {
- * if (key == 's') {
- * photo.save("photo", "png");
+ * if (key === 's') {
+ * photo.save('photo', 'png');
* }
* }
*
@@ -56265,38 +60831,12 @@ p5.Image.prototype.isModified = function () {
*
*/
p5.Image.prototype.save = function(filename, extension) {
- var mimeType;
- if (!extension) {
- extension = 'png';
- mimeType = 'image/png';
- }
- else {
- // en.wikipedia.org/wiki/Comparison_of_web_browsers#Image_format_support
- switch(extension.toLowerCase()){
- case 'png':
- mimeType = 'image/png';
- break;
- case 'jpeg':
- mimeType = 'image/jpeg';
- break;
- case 'jpg':
- mimeType = 'image/jpeg';
- break;
- default:
- mimeType = 'image/png';
- break;
- }
- }
- var downloadMime = 'image/octet-stream';
- var imageData = this.canvas.toDataURL(mimeType);
- imageData = imageData.replace(mimeType, downloadMime);
-
- //Make the browser download the file
- p5.prototype.downloadFile(imageData, filename, extension);
+ p5.prototype.saveCanvas(this.canvas, filename, extension);
};
module.exports = p5.Image;
-},{"../core/core":55,"./filters":74}],78:[function(_dereq_,module,exports){
+
+},{"../core/main":25,"./filters":43}],47:[function(_dereq_,module,exports){
/**
* @module Image
* @submodule Pixels
@@ -56306,7 +60846,7 @@ module.exports = p5.Image;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var Filters = _dereq_('./filters');
_dereq_('../color/p5.Color');
@@ -56315,7 +60855,7 @@ _dereq_('../color/p5.Color');
* /Global_Objects/Uint8ClampedArray' target='_blank'>Uint8ClampedArray
* containing the values for all the pixels in the display window.
* These values are numbers. This array is the size (include an appropriate
- * factor for pixelDensity) of the display window x4,
+ * factor for pixelDensity) of the display window x4,
* representing the R, G, B, A values in order for each pixel, moving from
* left to right across each row, then down each column. Retina and other
* high density displays will have more pixels[] (by a factor of
@@ -56341,18 +60881,18 @@ _dereq_('../color/p5.Color');
* }
* ```
* While the above method is complex, it is flexible enough to work with
- * any pixelDensity. Note that set() will automatically take care of
- * setting all the appropriate values in pixels[] for a given (x, y) at
+ * any pixelDensity. Note that set() will automatically take care of
+ * setting all the appropriate values in pixels[] for a given (x, y) at
* any pixelDensity, but the performance may not be as fast when lots of
* modifications are made to the pixel array.
*
- * Before accessing this array, the data must loaded with the loadPixels()
- * function. After the array data has been modified, the updatePixels()
+ * Before accessing this array, the data must loaded with the loadPixels()
+ * function. After the array data has been modified, the updatePixels()
* function must be run to update the changes.
*
* Note that this is not a standard javascript array. This means that
- * standard javascript functions such as slice() or
- * arrayCopy() do not
+ * standard javascript functions such as slice() or
+ * arrayCopy() do not
* work.
*
* @property {Number[]} pixels
@@ -56362,12 +60902,12 @@ _dereq_('../color/p5.Color');
* var pink = color(255, 102, 204);
* loadPixels();
* var d = pixelDensity();
- * var halfImage = 4 * (width * d) * (height/2 * d);
- * for (var i = 0; i < halfImage; i+=4) {
+ * var halfImage = 4 * (width * d) * (height / 2 * d);
+ * for (var i = 0; i < halfImage; i += 4) {
* pixels[i] = red(pink);
- * pixels[i+1] = green(pink);
- * pixels[i+2] = blue(pink);
- * pixels[i+3] = alpha(pink);
+ * pixels[i + 1] = green(pink);
+ * pixels[i + 2] = blue(pink);
+ * pixels[i + 3] = alpha(pink);
* }
* updatePixels();
*
@@ -56381,14 +60921,10 @@ p5.prototype.pixels = [];
/**
* Copies a region of pixels from one image to another, using a specified
- * blend mode to do the operation.
- * Available blend modes are: BLEND | DARKEST | LIGHTEST | DIFFERENCE |
- * MULTIPLY| EXCLUSION | SCREEN | REPLACE | OVERLAY | HARD_LIGHT |
- * SOFT_LIGHT | DODGE | BURN | ADD | NORMAL
- *
+ * blend mode to do the operation.
*
* @method blend
- * @param {p5.Image|undefined} srcImage source image
+ * @param {p5.Image} srcImage source image
* @param {Integer} sx X coordinate of the source's upper left corner
* @param {Integer} sy Y coordinate of the source's upper left corner
* @param {Integer} sw source image width
@@ -56397,7 +60933,10 @@ p5.prototype.pixels = [];
* @param {Integer} dy Y coordinate of the destination's upper left corner
* @param {Integer} dw destination image width
* @param {Integer} dh destination image height
- * @param {Integer} blendMode the blend mode
+ * @param {Constant} blendMode the blend mode. either
+ * BLEND, DARKEST, LIGHTEST, DIFFERENCE,
+ * MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,
+ * SOFT_LIGHT, DODGE, BURN, ADD or NORMAL.
*
* @example
*
@@ -56405,8 +60944,8 @@ p5.prototype.pixels = [];
* var img1;
*
* function preload() {
- * img0 = loadImage("assets/rockies.jpg");
- * img1 = loadImage("assets/bricks_third.jpg");
+ * img0 = loadImage('assets/rockies.jpg');
+ * img1 = loadImage('assets/bricks_third.jpg');
* }
*
* function setup() {
@@ -56420,8 +60959,8 @@ p5.prototype.pixels = [];
* var img1;
*
* function preload() {
- * img0 = loadImage("assets/rockies.jpg");
- * img1 = loadImage("assets/bricks_third.jpg");
+ * img0 = loadImage('assets/rockies.jpg');
+ * img1 = loadImage('assets/bricks_third.jpg');
* }
*
* function setup() {
@@ -56435,8 +60974,8 @@ p5.prototype.pixels = [];
* var img1;
*
* function preload() {
- * img0 = loadImage("assets/rockies.jpg");
- * img1 = loadImage("assets/bricks_third.jpg");
+ * img0 = loadImage('assets/rockies.jpg');
+ * img1 = loadImage('assets/bricks_third.jpg');
* }
*
* function setup() {
@@ -56453,7 +60992,20 @@ p5.prototype.pixels = [];
*
*
*/
+/**
+ * @method blend
+ * @param {Integer} sx
+ * @param {Integer} sy
+ * @param {Integer} sw
+ * @param {Integer} sh
+ * @param {Integer} dx
+ * @param {Integer} dy
+ * @param {Integer} dw
+ * @param {Integer} dh
+ * @param {Constant} blendMode
+ */
p5.prototype.blend = function() {
+ p5._validateParameters('blend', arguments);
if (this._renderer) {
this._renderer.blend.apply(this._renderer, arguments);
} else {
@@ -56470,7 +61022,7 @@ p5.prototype.blend = function() {
* target region.
*
* @method copy
- * @param {p5.Image|undefined} srcImage source image
+ * @param {p5.Image|p5.Element} srcImage source image
* @param {Integer} sx X coordinate of the source's upper left corner
* @param {Integer} sy Y coordinate of the source's upper left corner
* @param {Integer} sw source image width
@@ -56485,7 +61037,7 @@ p5.prototype.blend = function() {
* var img;
*
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
@@ -56504,8 +61056,20 @@ p5.prototype.blend = function() {
* image of rockies. Brickwall images on left and right. Right translucent
*
*/
-p5.prototype.copy = function () {
- p5.Renderer2D._copyHelper.apply(this, arguments);
+/**
+ * @method copy
+ * @param {Integer} sx
+ * @param {Integer} sy
+ * @param {Integer} sw
+ * @param {Integer} sh
+ * @param {Integer} dx
+ * @param {Integer} dy
+ * @param {Integer} dw
+ * @param {Integer} dh
+ */
+p5.prototype.copy = function() {
+ p5._validateParameters('copy', arguments);
+ p5.Renderer2D.prototype.copy.apply(this._renderer, arguments);
};
/**
@@ -56541,9 +61105,9 @@ p5.prototype.copy = function () {
*
*
* BLUR
- * Executes a Guassian blur with the level parameter specifying the extent
+ * Executes a Gaussian blur with the level parameter specifying the extent
* of the blurring. If no parameter is used, the blur is equivalent to
- * Guassian blur of radius 1. Larger values increase the blur.
+ * Gaussian blur of radius 1. Larger values increase the blur.
*
*
* ERODE
@@ -56554,22 +61118,23 @@ p5.prototype.copy = function () {
* Increases the light areas. No parameter is used.
*
* @method filter
- * @param {Constant} filterType either THRESHOLD, GRAY, OPAQUE, INVERT,
- * POSTERIZE, BLUR, ERODE or DILATE
- * @param {Number} filterParam an optional parameter unique
- * to each filter, see above
- *
+ * @param {Constant} filterType either THRESHOLD, GRAY, OPAQUE, INVERT,
+ * POSTERIZE, BLUR, ERODE, DILATE or BLUR.
+ * See Filters.js for docs on
+ * each available filter
+ * @param {Number} [filterParam] an optional parameter unique
+ * to each filter, see above
*
* @example
*
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(THRESHOLD);
+ * image(img, 0, 0);
+ * filter(THRESHOLD);
* }
*
*
@@ -56578,11 +61143,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(GRAY);
+ * image(img, 0, 0);
+ * filter(GRAY);
* }
*
*
@@ -56591,11 +61156,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(OPAQUE);
+ * image(img, 0, 0);
+ * filter(OPAQUE);
* }
*
*
@@ -56604,11 +61169,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(INVERT);
+ * image(img, 0, 0);
+ * filter(INVERT);
* }
*
*
@@ -56617,11 +61182,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(POSTERIZE,3);
+ * image(img, 0, 0);
+ * filter(POSTERIZE, 3);
* }
*
*
@@ -56630,11 +61195,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(DILATE);
+ * image(img, 0, 0);
+ * filter(DILATE);
* }
*
*
@@ -56643,11 +61208,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(BLUR,3);
+ * image(img, 0, 0);
+ * filter(BLUR, 3);
* }
*
*
@@ -56656,11 +61221,11 @@ p5.prototype.copy = function () {
*
* var img;
* function preload() {
- * img = loadImage("assets/bricks.jpg");
+ * img = loadImage('assets/bricks.jpg');
* }
* function setup() {
- * image(img, 0, 0);
- * filter(ERODE);
+ * image(img, 0, 0);
+ * filter(ERODE);
* }
*
*
@@ -56678,10 +61243,10 @@ p5.prototype.copy = function () {
*
*/
p5.prototype.filter = function(operation, value) {
- if(this.canvas !== undefined) {
+ p5._validateParameters('filter', arguments);
+ if (this.canvas !== undefined) {
Filters.apply(this.canvas, Filters[operation.toLowerCase()], value);
- }
- else {
+ } else {
Filters.apply(this.elt, Filters[operation.toLowerCase()], value);
}
};
@@ -56692,23 +61257,31 @@ p5.prototype.filter = function(operation, value) {
* Use the x and y parameters to get the value of one pixel. Get a section of
* the display window by specifying additional w and h parameters. When
* getting an image, the x and y parameters define the coordinates for the
- * upper-left corner of the image, regardless of the current imageMode().
+ * upper-left corner of the image, regardless of the current imageMode().
*
* If the pixel requested is outside of the image window, [0,0,0,255] is
* returned. To get the numbers scaled according to the current color ranges
- * and taking into account colorMode, use getColor instead of get.
+ * and taking into account colorMode, use getColor instead of get.
*
* Getting the color of a single pixel with get(x, y) is easy, but not as fast
- * as grabbing the data directly from pixels[]. The equivalent statement to
- * get(x, y) using pixels[] with pixel density d is
+ * as grabbing the data directly from pixels[]. The equivalent statement to
+ * get(x, y) using pixels[] with pixel density d is
*
+ * var x, y, d; // set these to the coordinates
* var off = (y * width + x) * d * 4;
- * [pixels[off],
- * pixels[off+1],
- * pixels[off+2],
- * pixels[off+3]]
+ * var components = [
+ * pixels[off],
+ * pixels[off + 1],
+ * pixels[off + 2],
+ * pixels[off + 3]
+ * ];
+ * print(components);
+ *
*
- * See the reference for pixels[] for more information.
+ * See the reference for pixels[] for more information.
+ *
+ * If you want to extract an array of colors or a subimage from an p5.Image object,
+ * take a look at p5.Image.get()
*
* @method get
* @param {Number} [x] x-coordinate of the pixel
@@ -56716,18 +61289,18 @@ p5.prototype.filter = function(operation, value) {
* @param {Number} [w] width
* @param {Number} [h] height
* @return {Number[]|p5.Image} values of pixel at x,y in array format
- * [R, G, B, A] or p5.Image
+ * [R, G, B, A] or p5.Image
* @example
*
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
* function setup() {
* image(img, 0, 0);
* var c = get();
- * image(c, width/2, 0);
+ * image(c, width / 2, 0);
* }
*
*
@@ -56736,7 +61309,7 @@ p5.prototype.filter = function(operation, value) {
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
* function setup() {
* image(img, 0, 0);
@@ -56753,14 +61326,14 @@ p5.prototype.filter = function(operation, value) {
* Image of the rocky mountains with 50x50 green rect in center of canvas
*
*/
-p5.prototype.get = function(x, y, w, h){
+p5.prototype.get = function(x, y, w, h) {
return this._renderer.get(x, y, w, h);
};
/**
- * Loads the pixel data for the display window into the pixels[] array. This
- * function must always be called before reading from or writing to pixels[].
- * Note that only changes made with set() or direct manipulation of pixels[]
+ * Loads the pixel data for the display window into the pixels[] array. This
+ * function must always be called before reading from or writing to pixels[].
+ * Note that only changes made with set() or direct manipulation of pixels[]
* will occur.
*
* @method loadPixels
@@ -56769,17 +61342,16 @@ p5.prototype.get = function(x, y, w, h){
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
* image(img, 0, 0);
* var d = pixelDensity();
- * var halfImage = 4 * (img.width * d) *
- (img.height/2 * d);
+ * var halfImage = 4 * (img.width * d) * (img.height * d / 2);
* loadPixels();
* for (var i = 0; i < halfImage; i++) {
- * pixels[i+halfImage] = pixels[i];
+ * pixels[i + halfImage] = pixels[i];
* }
* updatePixels();
* }
@@ -56791,6 +61363,7 @@ p5.prototype.get = function(x, y, w, h){
*
*/
p5.prototype.loadPixels = function() {
+ p5._validateParameters('loadPixels', arguments);
this._renderer.loadPixels();
};
@@ -56798,28 +61371,28 @@ p5.prototype.loadPixels = function() {
* Changes the color of any pixel, or writes an image directly to the
* display window.
* The x and y parameters specify the pixel to change and the c parameter
- * specifies the color value. This can be a p5.Color object, or [R, G, B, A]
+ * specifies the color value. This can be a p5.Color object, or [R, G, B, A]
* pixel array. It can also be a single grayscale value.
* When setting an image, the x and y parameters define the coordinates for
- * the upper-left corner of the image, regardless of the current imageMode().
+ * the upper-left corner of the image, regardless of the current imageMode().
*
*
- * After using set(), you must call updatePixels() for your changes to appear.
+ * After using set(), you must call updatePixels() for your changes to appear.
* This should be called once all pixels have been set, and must be called before
- * calling .get() or drawing the image.
+ * calling .get() or drawing the image.
*
* Setting the color of a single pixel with set(x, y) is easy, but not as
- * fast as putting the data directly into pixels[]. Setting the pixels[]
+ * fast as putting the data directly into pixels[]. Setting the pixels[]
* values directly may be complicated when working with a retina display,
* but will perform better when lots of pixels need to be set directly on
* every loop.
- * See the reference for pixels[] for more information.
+ * See the reference for pixels[] for more information.
*
* @method set
* @param {Number} x x-coordinate of the pixel
* @param {Number} y y-coordinate of the pixel
- * @param {Number|Array|Object} c insert a grayscale value | a pixel array |
- * a p5.Color object | a p5.Image to copy
+ * @param {Number|Number[]|Object} c insert a grayscale value | a pixel array |
+ * a p5.Color object | a p5.Image to copy
* @example
*
*
@@ -56834,9 +61407,9 @@ p5.prototype.loadPixels = function() {
*
*
*
- * for (var i = 30; i < width-15; i++) {
- * for (var j = 20; j < height-25; j++) {
- * var c = color(204-j, 153-i, 0);
+ * for (var i = 30; i < width - 15; i++) {
+ * for (var j = 20; j < height - 25; j++) {
+ * var c = color(204 - j, 153 - i, 0);
* set(i, j, c);
* }
* }
@@ -56848,7 +61421,7 @@ p5.prototype.loadPixels = function() {
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
@@ -56865,16 +61438,16 @@ p5.prototype.loadPixels = function() {
* square with orangey-brown gradient lightening at bottom right.
* image of the rocky mountains. with lines like an 'x' through the center.
*/
-p5.prototype.set = function (x, y, imgOrCol) {
+p5.prototype.set = function(x, y, imgOrCol) {
this._renderer.set(x, y, imgOrCol);
};
/**
- * Updates the display window with the data in the pixels[] array.
- * Use in conjunction with loadPixels(). If you're only reading pixels from
- * the array, there's no need to call updatePixels() — updating is only
- * necessary to apply changes. updatePixels() should be called anytime the
- * pixels array is manipulated or set() is called, and only changes made with
- * set() or direct changes to pixels[] will occur.
+ * Updates the display window with the data in the pixels[] array.
+ * Use in conjunction with loadPixels(). If you're only reading pixels from
+ * the array, there's no need to call updatePixels() — updating is only
+ * necessary to apply changes. updatePixels() should be called anytime the
+ * pixels array is manipulated or set() is called, and only changes made with
+ * set() or direct changes to pixels[] will occur.
*
* @method updatePixels
* @param {Number} [x] x-coordinate of the upper-left corner of region
@@ -56888,16 +61461,16 @@ p5.prototype.set = function (x, y, imgOrCol) {
*
* var img;
* function preload() {
- * img = loadImage("assets/rockies.jpg");
+ * img = loadImage('assets/rockies.jpg');
* }
*
* function setup() {
* image(img, 0, 0);
- * var halfImage = 4 * (img.width * pixelDensity()) *
- * (img.height * pixelDensity()/2);
+ * var d = pixelDensity();
+ * var halfImage = 4 * (img.width * d) * (img.height * d / 2);
* loadPixels();
* for (var i = 0; i < halfImage; i++) {
- * pixels[i+halfImage] = pixels[i];
+ * pixels[i + halfImage] = pixels[i];
* }
* updatePixels();
* }
@@ -56906,7 +61479,8 @@ p5.prototype.set = function (x, y, imgOrCol) {
* @alt
* two images of the rocky mountains. one on top, one on bottom of canvas.
*/
-p5.prototype.updatePixels = function (x, y, w, h) {
+p5.prototype.updatePixels = function(x, y, w, h) {
+ p5._validateParameters('updatePixels', arguments);
// graceful fail - if loadPixels() or set() has not been called, pixel
// array will be empty, ignore call to updatePixels()
if (this.pixels.length === 0) {
@@ -56917,7 +61491,7 @@ p5.prototype.updatePixels = function (x, y, w, h) {
module.exports = p5;
-},{"../color/p5.Color":49,"../core/core":55,"./filters":74}],79:[function(_dereq_,module,exports){
+},{"../color/p5.Color":17,"../core/main":25,"./filters":43}],48:[function(_dereq_,module,exports){
/**
* @module IO
* @submodule Input
@@ -56930,7 +61504,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
_dereq_('whatwg-fetch');
_dereq_('es6-promise').polyfill();
var fetchJsonp = _dereq_('fetch-jsonp');
@@ -56947,12 +61521,13 @@ _dereq_('../core/error_helpers');
* callback following the syntax specified here.
*
+ * This method is suitable for fetching files up to size of 64MB.
* @method loadJSON
* @param {String} path name of the file or url to load
* @param {Object} [jsonpOptions] options object for jsonp related settings
* @param {String} [datatype] "json" or "jsonp"
* @param {function} [callback] function to be executed after
- * loadJSON() completes, data is passed
+ * loadJSON() completes, data is passed
* in as first argument
* @param {function} [errorCallback] function to be executed if
* there is an error, response is passed
@@ -56960,8 +61535,8 @@ _dereq_('../core/error_helpers');
* @return {Object|Array} JSON data
* @example
*
- * Calling loadJSON() inside preload() guarantees to complete the
- * operation before setup() and draw() are called.
+ * Calling loadJSON() inside preload() guarantees to complete the
+ * operation before setup() and draw() are called.
*
*
* // Examples use USGS Earthquake API:
@@ -56969,8 +61544,9 @@ _dereq_('../core/error_helpers');
* var earthquakes;
* function preload() {
* // Get the most recent earthquake in the database
- * var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +
- * 'format=geojson&limit=1&orderby=time';
+ * var url =
+ 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' +
+ * 'summary/all_day.geojson';
* earthquakes = loadJSON(url);
* }
*
@@ -56983,7 +61559,7 @@ _dereq_('../core/error_helpers');
* // Get the magnitude and name of the earthquake out of the loaded JSON
* var earthquakeMag = earthquakes.features[0].properties.mag;
* var earthquakeName = earthquakes.features[0].properties.place;
- * ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);
+ * ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);
* textAlign(CENTER);
* text(earthquakeName, 0, height - 30, width, 30);
* }
@@ -56995,8 +61571,9 @@ _dereq_('../core/error_helpers');
*
* function setup() {
* noLoop();
- * var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +
- * 'format=geojson&limit=1&orderby=time';
+ * var url =
+ 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' +
+ * 'summary/all_day.geojson';
* loadJSON(url, drawEarthquake);
* }
*
@@ -57008,7 +61585,7 @@ _dereq_('../core/error_helpers');
* // Get the magnitude and name of the earthquake out of the loaded JSON
* var earthquakeMag = earthquakes.features[0].properties.mag;
* var earthquakeName = earthquakes.features[0].properties.place;
- * ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);
+ * ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);
* textAlign(CENTER);
* text(earthquakeName, 0, height - 30, width, 30);
* }
@@ -57019,7 +61596,23 @@ _dereq_('../core/error_helpers');
* 50x50 ellipse that changes from black to white depending on the current humidity
*
*/
-p5.prototype.loadJSON = function () {
+/**
+ * @method loadJSON
+ * @param {String} path
+ * @param {String} datatype
+ * @param {function} [callback]
+ * @param {function} [errorCallback]
+ * @return {Object|Array}
+ */
+/**
+ * @method loadJSON
+ * @param {String} path
+ * @param {function} callback
+ * @param {function} [errorCallback]
+ * @return {Object|Array}
+ */
+p5.prototype.loadJSON = function() {
+ p5._validateParameters('loadJSON', arguments);
var path = arguments[0];
var callback;
var errorCallback;
@@ -57036,28 +61629,44 @@ p5.prototype.loadJSON = function () {
t = arg;
}
} else if (typeof arg === 'function') {
- if(!callback){
+ if (!callback) {
callback = arg;
- }else{
+ } else {
errorCallback = arg;
}
- } else if (typeof arg === 'object' && arg.hasOwnProperty('jsonpCallback')){
+ } else if (typeof arg === 'object' && arg.hasOwnProperty('jsonpCallback')) {
t = 'jsonp';
options = arg;
}
}
var self = this;
- this.httpDo(path, 'GET', options, t, function(resp){
- for (var k in resp) {
- ret[k] = resp[k];
- }
- if (typeof callback !== 'undefined') {
- callback(resp);
- }
+ this.httpDo(
+ path,
+ 'GET',
+ options,
+ t,
+ function(resp) {
+ for (var k in resp) {
+ ret[k] = resp[k];
+ }
+ if (typeof callback !== 'undefined') {
+ callback(resp);
+ }
- self._decrementPreload();
- }, errorCallback);
+ self._decrementPreload();
+ },
+ function(err) {
+ // Error handling
+ p5._friendlyFileLoadError(5, path);
+
+ if (errorCallback) {
+ errorCallback(err);
+ } else {
+ throw err;
+ }
+ }
+ );
return ret;
};
@@ -57075,9 +61684,10 @@ p5.prototype.loadJSON = function () {
* This method is asynchronous, meaning it may not finish before the next
* line in your sketch is executed.
*
+ * This method is suitable for fetching files up to size of 64MB.
* @method loadStrings
* @param {String} filename name of the file or url to load
- * @param {function} [callback] function to be executed after loadStrings()
+ * @param {function} [callback] function to be executed after loadStrings()
* completes, Array is passed in as first
* argument
* @param {function} [errorCallback] function to be executed if
@@ -57086,8 +61696,8 @@ p5.prototype.loadJSON = function () {
* @return {String[]} Array of Strings
* @example
*
- * Calling loadStrings() inside preload() guarantees to complete the
- * operation before setup() and draw() are called.
+ * Calling loadStrings() inside preload() guarantees to complete the
+ * operation before setup() and draw() are called.
*
*
* var result;
@@ -57122,40 +61732,60 @@ p5.prototype.loadJSON = function () {
* randomly generated text from a file, for example "i have three feet"
*
*/
-p5.prototype.loadStrings = function () {
+p5.prototype.loadStrings = function() {
+ p5._validateParameters('loadStrings', arguments);
+
var ret = [];
var callback, errorCallback;
- for(var i=1; iReads the contents of a file or URL and creates a p5.Table object with
+ * Reads the contents of a file or URL and creates a p5.Table object with
* its values. If a file is specified, it must be located in the sketch's
* "data" folder. The filename parameter can also be a URL to a file found
* online. By default, the file is assumed to be comma-separated (in CSV
@@ -57174,33 +61804,34 @@ p5.prototype.loadStrings = function () {
* seperated by commas. For example:
*
*
- * loadTable("my_csv_file.csv", "csv", "header")
+ * loadTable('my_csv_file.csv', 'csv', 'header');
*
*
*
* All files loaded and saved use UTF-8 encoding.
*
* This method is asynchronous, meaning it may not finish before the next
- * line in your sketch is executed. Calling loadTable() inside preload()
- * guarantees to complete the operation before setup() and draw() are called.
- *
Outside of preload(), you may supply a callback function to handle the
+ * line in your sketch is executed. Calling loadTable() inside preload()
+ * guarantees to complete the operation before setup() and draw() are called.
+ *
Outside of preload(), you may supply a callback function to handle the
* object:
*
*
+ * This method is suitable for fetching files up to size of 64MB.
* @method loadTable
* @param {String} filename name of the file or URL to load
- * @param {String} [options] "header" "csv" "tsv"
+ * @param {String} options "header" "csv" "tsv"
* @param {function} [callback] function to be executed after
- * loadTable() completes. On success, the
- * Table object is passed in as the
+ * loadTable() completes. On success, the
+ * Table object is passed in as the
* first argument.
* @param {function} [errorCallback] function to be executed if
* there is an error, response is passed
* in as first argument
- * @return {Object} Table object containing data
+ * @return {Object} Table object containing data
*
* @example
- *
+ *
*
* // Given the following CSV file called "mammals.csv"
* // located in the project's "assets" folder:
@@ -57215,7 +61846,7 @@ p5.prototype.loadStrings = function () {
* function preload() {
* //my table is comma separated value "csv"
* //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
* //the file can be remote
* //table = loadTable("http://p5js.org/reference/assets/mammals.csv",
* // "csv", "header");
@@ -57223,10 +61854,10 @@ p5.prototype.loadStrings = function () {
*
* function setup() {
* //count the columns
- * print(table.getRowCount() + " total rows in table");
- * print(table.getColumnCount() + " total columns in table");
+ * print(table.getRowCount() + ' total rows in table');
+ * print(table.getColumnCount() + ' total columns in table');
*
- * print(table.getColumn("name"));
+ * print(table.getColumn('name'));
* //["Goat", "Leopard", "Zebra"]
*
* //cycle through the table
@@ -57243,27 +61874,35 @@ p5.prototype.loadStrings = function () {
* randomly generated text from a file, for example "i have three feet"
*
*/
-p5.prototype.loadTable = function (path) {
+/**
+ * @method loadTable
+ * @param {String} filename
+ * @param {function} [callback]
+ * @param {function} [errorCallback]
+ * @return {Object}
+ */
+p5.prototype.loadTable = function(path) {
var callback;
var errorCallback;
var options = [];
var header = false;
- var ext = path.substring(path.lastIndexOf('.')+1,path.length);
+ var ext = path.substring(path.lastIndexOf('.') + 1, path.length);
var sep = ',';
var separatorSet = false;
- if(ext === 'tsv'){ //Only need to check extension is tsv because csv is default
+ if (ext === 'tsv') {
+ //Only need to check extension is tsv because csv is default
sep = '\t';
}
for (var i = 1; i < arguments.length; i++) {
- if (typeof (arguments[i]) === 'function') {
- if(typeof callback === 'undefined'){
+ if (typeof arguments[i] === 'function') {
+ if (typeof callback === 'undefined') {
callback = arguments[i];
} else if (typeof errorCallback === 'undefined') {
errorCallback = arguments[i];
}
- } else if (typeof (arguments[i]) === 'string') {
+ } else if (typeof arguments[i] === 'string') {
options.push(arguments[i]);
if (arguments[i] === 'header') {
header = true;
@@ -57289,146 +61928,151 @@ p5.prototype.loadTable = function (path) {
var t = new p5.Table();
var self = this;
- this.httpDo(path, 'GET', 'text', function(resp){
- var state = {};
-
- // define constants
- var PRE_TOKEN = 0,
- MID_TOKEN = 1,
- POST_TOKEN = 2,
- POST_RECORD = 4;
-
- var QUOTE = '\"',
- CR = '\r',
- LF = '\n';
-
- var records = [];
- var offset = 0;
- var currentRecord = null;
- var currentChar;
-
- var tokenBegin = function () {
- state.currentState = PRE_TOKEN;
- state.token = '';
- };
+ this.httpDo(
+ path,
+ 'GET',
+ 'table',
+ function(resp) {
+ var state = {};
+
+ // define constants
+ var PRE_TOKEN = 0,
+ MID_TOKEN = 1,
+ POST_TOKEN = 2,
+ POST_RECORD = 4;
+
+ var QUOTE = '"',
+ CR = '\r',
+ LF = '\n';
+
+ var records = [];
+ var offset = 0;
+ var currentRecord = null;
+ var currentChar;
+
+ var tokenBegin = function() {
+ state.currentState = PRE_TOKEN;
+ state.token = '';
+ };
- var tokenEnd = function () {
- currentRecord.push(state.token);
- tokenBegin();
- };
+ var tokenEnd = function() {
+ currentRecord.push(state.token);
+ tokenBegin();
+ };
- var recordBegin = function () {
- state.escaped = false;
- currentRecord = [];
- tokenBegin();
- };
+ var recordBegin = function() {
+ state.escaped = false;
+ currentRecord = [];
+ tokenBegin();
+ };
- var recordEnd = function () {
- state.currentState = POST_RECORD;
- records.push(currentRecord);
- currentRecord = null;
- };
+ var recordEnd = function() {
+ state.currentState = POST_RECORD;
+ records.push(currentRecord);
+ currentRecord = null;
+ };
- while (true) {
- currentChar = resp[offset++];
+ for (;;) {
+ currentChar = resp[offset++];
- // EOF
- if (currentChar == null) {
- if (state.escaped) {
- throw new Error('Unclosed quote in file.');
+ // EOF
+ if (currentChar == null) {
+ if (state.escaped) {
+ throw new Error('Unclosed quote in file.');
+ }
+ if (currentRecord) {
+ tokenEnd();
+ recordEnd();
+ break;
+ }
}
- if (currentRecord) {
- tokenEnd();
- recordEnd();
- break;
+ if (currentRecord === null) {
+ recordBegin();
}
- }
- if (currentRecord === null) {
- recordBegin();
- }
- // Handle opening quote
- if (state.currentState === PRE_TOKEN) {
- if (currentChar === QUOTE) {
- state.escaped = true;
+ // Handle opening quote
+ if (state.currentState === PRE_TOKEN) {
+ if (currentChar === QUOTE) {
+ state.escaped = true;
+ state.currentState = MID_TOKEN;
+ continue;
+ }
state.currentState = MID_TOKEN;
- continue;
}
- state.currentState = MID_TOKEN;
- }
- // mid-token and escaped, look for sequences and end quote
- if (state.currentState === MID_TOKEN && state.escaped) {
- if (currentChar === QUOTE) {
- if (resp[offset] === QUOTE) {
- state.token += QUOTE;
- offset++;
+ // mid-token and escaped, look for sequences and end quote
+ if (state.currentState === MID_TOKEN && state.escaped) {
+ if (currentChar === QUOTE) {
+ if (resp[offset] === QUOTE) {
+ state.token += QUOTE;
+ offset++;
+ } else {
+ state.escaped = false;
+ state.currentState = POST_TOKEN;
+ }
+ } else if (currentChar === CR) {
+ continue;
} else {
- state.escaped = false;
- state.currentState = POST_TOKEN;
+ state.token += currentChar;
}
- } else if(currentChar === CR) {
continue;
- } else {
- state.token += currentChar;
}
- continue;
- }
- // fall-through: mid-token or post-token, not escaped
- if (currentChar === CR) {
- if (resp[offset] === LF) {
- offset++;
+ // fall-through: mid-token or post-token, not escaped
+ if (currentChar === CR) {
+ if (resp[offset] === LF) {
+ offset++;
+ }
+ tokenEnd();
+ recordEnd();
+ } else if (currentChar === LF) {
+ tokenEnd();
+ recordEnd();
+ } else if (currentChar === sep) {
+ tokenEnd();
+ } else if (state.currentState === MID_TOKEN) {
+ state.token += currentChar;
}
- tokenEnd();
- recordEnd();
- } else if (currentChar === LF) {
- tokenEnd();
- recordEnd();
- } else if (currentChar === sep) {
- tokenEnd();
- } else if (state.currentState === MID_TOKEN) {
- state.token += currentChar;
}
- }
- // set up column names
- if (header) {
- t.columns = records.shift();
- } else {
- for (i = 0; i < records[0].length; i++) {
- t.columns[i] = 'null';
+ // set up column names
+ if (header) {
+ t.columns = records.shift();
+ } else {
+ for (i = 0; i < records[0].length; i++) {
+ t.columns[i] = 'null';
+ }
}
- }
- var row;
- for (i = 0; i < records.length; i++) {
- //Handles row of 'undefined' at end of some CSVs
- if (records[i].length === 1) {
- if (records[i][0] === 'undefined' || records[i][0] === '') {
- continue;
+ var row;
+ for (i = 0; i < records.length; i++) {
+ //Handles row of 'undefined' at end of some CSVs
+ if (records[i].length === 1) {
+ if (records[i][0] === 'undefined' || records[i][0] === '') {
+ continue;
+ }
}
+ row = new p5.TableRow();
+ row.arr = records[i];
+ row.obj = makeObject(records[i], t.columns);
+ t.addRow(row);
+ }
+ if (typeof callback === 'function') {
+ callback(t);
}
- row = new p5.TableRow();
- row.arr = records[i];
- row.obj = makeObject(records[i], t.columns);
- t.addRow(row);
- }
- if (typeof callback === 'function') {
- callback(t);
- }
-
- self._decrementPreload();
- }, function(err){
- // Error handling
- p5._friendlyFileLoadError(2, path);
+ self._decrementPreload();
+ },
+ function(err) {
+ // Error handling
+ p5._friendlyFileLoadError(2, path);
- if(errorCallback){
- errorCallback(err);
- }else{
- throw err;
+ if (errorCallback) {
+ errorCallback(err);
+ } else {
+ throw err;
+ }
}
- });
+ );
return t;
};
@@ -57437,7 +62081,7 @@ p5.prototype.loadTable = function (path) {
function makeObject(row, headers) {
var ret = {};
headers = headers || [];
- if (typeof (headers) === 'undefined') {
+ if (typeof headers === 'undefined') {
for (var j = 0; j < row.length; j++) {
headers[j.toString()] = j;
}
@@ -57450,13 +62094,12 @@ function makeObject(row, headers) {
return ret;
}
-/*global parseXML */
-p5.prototype.parseXML = function (two) {
+function parseXML(two) {
var one = new p5.XML();
- var i;
- if (two.children.length) {
- for ( i = 0; i < two.children.length; i++ ) {
- var node = parseXML(two.children[i]);
+ var children = two.childNodes;
+ if (children && children.length) {
+ for (var i = 0; i < children.length; i++) {
+ var node = parseXML(children[i]);
one.addChild(node);
}
one.setName(two.nodeName);
@@ -57466,14 +62109,13 @@ p5.prototype.parseXML = function (two) {
one.children[j].parent = one;
}
return one;
- }
- else {
+ } else {
one.setName(two.nodeName);
one._setCont(two.textContent);
one._setAttributes(two);
return one;
}
-};
+}
/**
* Reads the contents of a file and creates an XML object with its values.
@@ -57486,15 +62128,16 @@ p5.prototype.parseXML = function (two) {
* URL for a file found on a network.
*
* This method is asynchronous, meaning it may not finish before the next
- * line in your sketch is executed. Calling loadXML() inside preload()
- * guarantees to complete the operation before setup() and draw() are called.
+ * line in your sketch is executed. Calling loadXML() inside preload()
+ * guarantees to complete the operation before setup() and draw() are called.
*
- * Outside of preload(), you may supply a callback function to handle the
+ * Outside of preload(), you may supply a callback function to handle the
* object.
*
+ * This method is suitable for fetching files up to size of 64MB.
* @method loadXML
* @param {String} filename name of the file or URL to load
- * @param {function} [callback] function to be executed after loadXML()
+ * @param {function} [callback] function to be executed after loadXML()
* completes, XML object is passed in as
* first argument
* @param {function} [errorCallback] function to be executed if
@@ -57516,17 +62159,17 @@ p5.prototype.parseXML = function (two) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var children = xml.getChildren("animal");
+ * var children = xml.getChildren('animal');
*
* for (var i = 0; i < children.length; i++) {
- * var id = children[i].getNum("id");
- * var coloring = children[i].getString("species");
+ * var id = children[i].getNum('id');
+ * var coloring = children[i].getString('species');
* var name = children[i].getContent();
- * print(id + ", " + coloring + ", " + name);
+ * print(id + ', ' + coloring + ', ' + name);
* }
* }
*
@@ -57535,93 +62178,191 @@ p5.prototype.parseXML = function (two) {
* // 1, Panthera pardus, Leopard
* // 2, Equus zebra, Zebra
*
- *
- * @alt
- * no image displayed
- *
+ *
+ * @alt
+ * no image displayed
+ *
*/
p5.prototype.loadXML = function() {
var ret = {};
var callback, errorCallback;
- for(var i=1; iloadBytes()
+ * completes
+ * @param {function} [errorCallback] function to be executed if there
+ * is an error
+ * @returns {Object} an object whose 'bytes' property will be the loaded buffer
+ *
+ * @example
+ *
+ * var data;
+ *
+ * function preload() {
+ * data = loadBytes('assets/mammals.xml');
+ * }
+ *
+ * function setup() {
+ * for (var i = 0; i < 5; i++) {
+ * console.log(data.bytes[i].toString(16));
+ * }
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
+ *
+ */
+p5.prototype.loadBytes = function(file, callback, errorCallback) {
+ var ret = {};
+
+ var self = this;
+ this.httpDo(
+ file,
+ 'GET',
+ 'arrayBuffer',
+ function(arrayBuffer) {
+ ret.bytes = new Uint8Array(arrayBuffer);
+
+ if (typeof callback === 'function') {
+ callback(ret);
+ }
+
+ self._decrementPreload();
+ },
+ function(err) {
+ // Error handling
+ p5._friendlyFileLoadError(6, file);
+
+ if (errorCallback) {
+ errorCallback(err);
+ } else {
+ throw err;
+ }
+ }
+ );
+ return ret;
+};
/**
* Method for executing an HTTP GET request. If data type is not specified,
* p5 will try to guess based on the URL, defaulting to text. This is equivalent to
- * calling httpDo(path, 'GET').
+ * calling httpDo(path, 'GET'). The 'binary' datatype will return
+ * a Blob object, and the 'arrayBuffer' datatype will return an ArrayBuffer
+ * which can be used to initialize typed arrays (such as Uint8Array).
*
* @method httpGet
* @param {String} path name of the file or url to load
- * @param {String} [datatype] "json", "jsonp", "xml", or "text"
- * @param {Object} [data] param data passed sent with request
+ * @param {String} [datatype] "json", "jsonp", "binary", "arrayBuffer",
+ * "xml", or "text"
+ * @param {Object|Boolean} [data] param data passed sent with request
* @param {function} [callback] function to be executed after
- * httpGet() completes, data is passed in
+ * httpGet() completes, data is passed in
* as first argument
* @param {function} [errorCallback] function to be executed if
* there is an error, response is passed
* in as first argument
+ * @return {Promise} A promise that resolves with the data when the operation
+ * completes successfully or rejects with the error after
+ * one occurs.
* @example
*
-* // Examples use USGS Earthquake API:
-* // https://earthquake.usgs.gov/fdsnws/event/1/#methods
-* var earthquakes;
-* function preload() {
-* // Get the most recent earthquake in the database
-* var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +
-* 'format=geojson&limit=1&orderby=time';
-* httpGet(url, "jsonp", false, function(response) {
-* // when the HTTP request completes, populate the variable that holds the
-* // earthquake data used in the visualization.
-* earthquakes = response;
-* });
-* }
-*
-* function draw() {
-* if (!earthquakes) {
-* // Wait until the earthquake data has loaded before drawing.
-* return
-* }
-* background(200);
-* // Get the magnitude and name of the earthquake out of the loaded JSON
-* var earthquakeMag = earthquakes.features[0].properties.mag;
-* var earthquakeName = earthquakes.features[0].properties.place;
-* ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);
-* textAlign(CENTER);
-* text(earthquakeName, 0, height - 30, width, 30);
-* noLoop();
-* }
+ * // Examples use USGS Earthquake API:
+ * // https://earthquake.usgs.gov/fdsnws/event/1/#methods
+ * var earthquakes;
+ * function preload() {
+ * // Get the most recent earthquake in the database
+ * var url =
+ 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +
+ * 'format=geojson&limit=1&orderby=time';
+ * httpGet(url, 'jsonp', false, function(response) {
+ * // when the HTTP request completes, populate the variable that holds the
+ * // earthquake data used in the visualization.
+ * earthquakes = response;
+ * });
+ * }
+ *
+ * function draw() {
+ * if (!earthquakes) {
+ * // Wait until the earthquake data has loaded before drawing.
+ * return;
+ * }
+ * background(200);
+ * // Get the magnitude and name of the earthquake out of the loaded JSON
+ * var earthquakeMag = earthquakes.features[0].properties.mag;
+ * var earthquakeName = earthquakes.features[0].properties.place;
+ * ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);
+ * textAlign(CENTER);
+ * text(earthquakeName, 0, height - 30, width, 30);
+ * noLoop();
+ * }
*
*/
-p5.prototype.httpGet = function () {
+/**
+ * @method httpGet
+ * @param {String} path
+ * @param {Object|Boolean} data
+ * @param {function} [callback]
+ * @param {function} [errorCallback]
+ * @return {Promise}
+ */
+/**
+ * @method httpGet
+ * @param {String} path
+ * @param {function} callback
+ * @param {function} [errorCallback]
+ * @return {Promise}
+ */
+p5.prototype.httpGet = function() {
+ p5._validateParameters('httpGet', arguments);
+
var args = Array.prototype.slice.call(arguments);
args.splice(1, 0, 'GET');
- p5.prototype.httpDo.apply(this, args);
+ return p5.prototype.httpDo.apply(this, args);
};
/**
@@ -57632,14 +62373,17 @@ p5.prototype.httpGet = function () {
* @method httpPost
* @param {String} path name of the file or url to load
* @param {String} [datatype] "json", "jsonp", "xml", or "text".
- * If omitted, httpPost() will guess.
- * @param {Object} [data] param data passed sent with request
+ * If omitted, httpPost() will guess.
+ * @param {Object|Boolean} [data] param data passed sent with request
* @param {function} [callback] function to be executed after
- * httpPost() completes, data is passed in
+ * httpPost() completes, data is passed in
* as first argument
* @param {function} [errorCallback] function to be executed if
* there is an error, response is passed
* in as first argument
+ * @return {Promise} A promise that resolves with the data when the operation
+ * completes successfully or rejects with the error after
+ * one occurs.
*
* @example
*
@@ -57654,61 +62398,76 @@ p5.prototype.httpGet = function () {
* }
*
* function mousePressed() {
- * // Pick new random color values
- * var r = random(255);
- * var g = random(255);
- * var b = random(255);
- *
- * httpPost(url, 'json',
- * postData,
- * function (result) {
- * strokeWeight(2);
- * stroke(r, g, b);
- * fill(r, g, b, 127);
- * ellipse(mouseX, mouseY, 200, 200);
- * text(result.body, mouseX, mouseY);
- * });
+ * // Pick new random color values
+ * var r = random(255);
+ * var g = random(255);
+ * var b = random(255);
+ *
+ * httpPost(url, 'json', postData, function(result) {
+ * strokeWeight(2);
+ * stroke(r, g, b);
+ * fill(r, g, b, 127);
+ * ellipse(mouseX, mouseY, 200, 200);
+ * text(result.body, mouseX, mouseY);
+ * });
* }
*
*
*
*
*
+ * var url = 'https://invalidURL'; // A bad URL that will cause errors
+ * var postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' };
*
- * var url = 'https://invalidURL'; // A bad URL that will cause errors
- * var postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' };
- *
- * function setup() {
- * createCanvas(800, 800);
- * }
- *
- * function mousePressed() {
- * // Pick new random color values
- * var r = random(255);
- * var g = random(255);
- * var b = random(255);
- *
- * httpPost(url, 'json',
- * postData,
- * function (result) {
- * // ... won't be called
- * },
- * function (error) {
- * strokeWeight(2);
- * stroke(r, g, b);
- * fill(r, g, b, 127);
- * text(error.toString(), mouseX, mouseY);
- * });
- * }
+ * function setup() {
+ * createCanvas(800, 800);
+ * }
*
- *
- *
+ * function mousePressed() {
+ * // Pick new random color values
+ * var r = random(255);
+ * var g = random(255);
+ * var b = random(255);
+ *
+ * httpPost(
+ * url,
+ * 'json',
+ * postData,
+ * function(result) {
+ * // ... won't be called
+ * },
+ * function(error) {
+ * strokeWeight(2);
+ * stroke(r, g, b);
+ * fill(r, g, b, 127);
+ * text(error.toString(), mouseX, mouseY);
+ * }
+ * );
+ * }
+ *
*
*/
-p5.prototype.httpPost = function () {
+/**
+ * @method httpPost
+ * @param {String} path
+ * @param {Object|Boolean} data
+ * @param {function} [callback]
+ * @param {function} [errorCallback]
+ * @return {Promise}
+ */
+/**
+ * @method httpPost
+ * @param {String} path
+ * @param {function} callback
+ * @param {function} [errorCallback]
+ * @return {Promise}
+ */
+p5.prototype.httpPost = function() {
+ p5._validateParameters('httpPost', arguments);
+
var args = Array.prototype.slice.call(arguments);
args.splice(1, 0, 'POST');
- p5.prototype.httpDo.apply(this, args);
+ return p5.prototype.httpDo.apply(this, args);
};
/**
@@ -57717,6 +62476,7 @@ p5.prototype.httpPost = function () {
* For more advanced use, you may also pass in the path as the first argument
* and a object as the second argument, the signature follows the one specified
* in the Fetch API specification.
+ * This method is suitable for fetching files up to size of 64MB when "GET" is used.
*
* @method httpDo
* @param {String} path name of the file or url to load
@@ -57725,12 +62485,14 @@ p5.prototype.httpPost = function () {
* @param {String} [datatype] "json", "jsonp", "xml", or "text"
* @param {Object} [data] param data passed sent with request
* @param {function} [callback] function to be executed after
- * httpGet() completes, data is passed in
+ * httpGet() completes, data is passed in
* as first argument
* @param {function} [errorCallback] function to be executed if
* there is an error, response is passed
* in as first argument
- *
+ * @return {Promise} A promise that resolves with the data when the operation
+ * completes successfully or rejects with the error after
+ * one occurs.
*
* @example
*
@@ -57743,45 +62505,42 @@ p5.prototype.httpPost = function () {
* var eqFeatureIndex = 0;
*
* function preload() {
- * var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';
- * httpDo(url,
- * {
- * method: 'GET',
- * // Other Request options, like special headers for apis
- * headers: { authorization: 'Bearer secretKey' }
- * },
- * function(res) {
- * earthquakes = res;
- * });
+ * var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';
+ * httpDo(
+ * url,
+ * {
+ * method: 'GET',
+ * // Other Request options, like special headers for apis
+ * headers: { authorization: 'Bearer secretKey' }
+ * },
+ * function(res) {
+ * earthquakes = res;
+ * }
+ * );
* }
*
* function draw() {
- * // wait until the data is loaded
- * if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {
- * return;
- * }
- * clear();
- *
- * var feature = earthquakes.features[eqFeatureIndex];
- * var mag = feature.properties.mag;
- * var rad = mag / 11 * ((width + height) / 2);
- * fill(255, 0, 0, 100);
- * ellipse(
- * width / 2 + random(-2, 2),
- * height / 2 + random(-2, 2),
- * rad, rad
- * );
- *
- * if (eqFeatureIndex >= earthquakes.features.length) {
- * eqFeatureIndex = 0;
- * } else {
- * eqFeatureIndex += 1;
- * }
+ * // wait until the data is loaded
+ * if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {
+ * return;
+ * }
+ * clear();
+ *
+ * var feature = earthquakes.features[eqFeatureIndex];
+ * var mag = feature.properties.mag;
+ * var rad = mag / 11 * ((width + height) / 2);
+ * fill(255, 0, 0, 100);
+ * ellipse(width / 2 + random(-2, 2), height / 2 + random(-2, 2), rad, rad);
+ *
+ * if (eqFeatureIndex >= earthquakes.features.length) {
+ * eqFeatureIndex = 0;
+ * } else {
+ * eqFeatureIndex += 1;
+ * }
* }
*
*
*/
-
/**
* @method httpDo
* @param {String} path
@@ -57790,46 +62549,39 @@ p5.prototype.httpPost = function () {
* reference
* @param {function} [callback]
* @param {function} [errorCallback]
+ * @return {Promise}
*/
-p5.prototype.httpDo = function () {
- var type = '';
+p5.prototype.httpDo = function() {
+ var type;
var callback;
var errorCallback;
var request;
+ var promise;
var jsonpOptions = {};
var cbCount = 0;
var contentType = 'text/plain';
// Trim the callbacks off the end to get an idea of how many arguments are passed
- for (var i = arguments.length-1; i > 0; i--){
- if(typeof arguments[i] === 'function'){
+ for (var i = arguments.length - 1; i > 0; i--) {
+ if (typeof arguments[i] === 'function') {
cbCount++;
- }else{
+ } else {
break;
}
}
// The number of arguments minus callbacks
var argsCount = arguments.length - cbCount;
- if(argsCount === 2 &&
- typeof arguments[0] === 'string' &&
- typeof arguments[1] === 'object'){
+ var path = arguments[0];
+ if (
+ argsCount === 2 &&
+ typeof path === 'string' &&
+ typeof arguments[1] === 'object'
+ ) {
// Intended for more advanced use, pass in Request parameters directly
- request = new Request(arguments[0], arguments[1]);
+ request = new Request(path, arguments[1]);
callback = arguments[2];
errorCallback = arguments[3];
-
- // do some sort of smart type checking
- if (type === '') {
- if (request.url.indexOf('json') !== -1) {
- type = 'json';
- } else if (request.url.indexOf('xml') !== -1) {
- type = 'xml';
- } else {
- type = 'text';
- }
- }
} else {
// Provided with arguments
- var path = arguments[0];
var method = 'GET';
var data;
@@ -57838,7 +62590,15 @@ p5.prototype.httpDo = function () {
if (typeof a === 'string') {
if (a === 'GET' || a === 'POST' || a === 'PUT' || a === 'DELETE') {
method = a;
- } else if(a === 'json' || a === 'jsonp' || a === 'xml' || a === 'text') {
+ } else if (
+ a === 'json' ||
+ a === 'jsonp' ||
+ a === 'binary' ||
+ a === 'arrayBuffer' ||
+ a === 'xml' ||
+ a === 'text' ||
+ a === 'table'
+ ) {
type = a;
} else {
data = a;
@@ -57846,11 +62606,11 @@ p5.prototype.httpDo = function () {
} else if (typeof a === 'number') {
data = a.toString();
} else if (typeof a === 'object') {
- if(a.hasOwnProperty('jsonpCallback')){
+ if (a.hasOwnProperty('jsonpCallback')) {
for (var attr in a) {
jsonpOptions[attr] = a[attr];
}
- }else{
+ } else {
data = JSON.stringify(a);
contentType = 'application/json';
}
@@ -57862,16 +62622,6 @@ p5.prototype.httpDo = function () {
}
}
}
- // do some sort of smart type checking
- if (type === '') {
- if (path.indexOf('json') !== -1) {
- type = 'json';
- } else if (path.indexOf('xml') !== -1) {
- type = 'xml';
- } else {
- type = 'text';
- }
- }
request = new Request(path, {
method: method,
@@ -57882,51 +62632,55 @@ p5.prototype.httpDo = function () {
})
});
}
+ // do some sort of smart type checking
+ if (!type) {
+ if (path.indexOf('json') !== -1) {
+ type = 'json';
+ } else if (path.indexOf('xml') !== -1) {
+ type = 'xml';
+ } else {
+ type = 'text';
+ }
+ }
- if(type === 'jsonp'){
- fetchJsonp(arguments[0], jsonpOptions)
- .then(function(res){
- if(res.ok){
- return res.json();
- }
- throw res;
- }).then(function(resp){
- callback(resp);
- }).catch(function(err){
- if (errorCallback) {
- errorCallback(err);
- } else {
- throw err;
- }
- });
- }else{
- fetch(request)
- .then(function(res){
- if(res.ok){
- if(type === 'json'){
- return res.json();
- }else{
- return res.text();
- }
- }
-
- throw res;
- })
- .then(function(resp){
- if (type === 'xml'){
- var parser = new DOMParser();
- resp = parser.parseFromString(resp, 'text/xml');
- resp = parseXML(resp.documentElement);
- }
- callback(resp);
- }).catch(function(err, msg){
- if (errorCallback) {
- errorCallback(err);
- } else {
- throw err;
- }
- });
+ if (type === 'jsonp') {
+ promise = fetchJsonp(path, jsonpOptions);
+ } else {
+ promise = fetch(request);
}
+ promise = promise.then(function(res) {
+ if (!res.ok) {
+ var err = new Error(res.body);
+ err.status = res.status;
+ err.ok = false;
+ throw err;
+ } else {
+ var fileSize = res.headers.get('content-length');
+ if (fileSize && fileSize > 64000000) {
+ p5._friendlyFileLoadError(7, path);
+ }
+ switch (type) {
+ case 'json':
+ case 'jsonp':
+ return res.json();
+ case 'binary':
+ return res.blob();
+ case 'arrayBuffer':
+ return res.arrayBuffer();
+ case 'xml':
+ return res.text().then(function(text) {
+ var parser = new DOMParser();
+ var xml = parser.parseFromString(text, 'text/xml');
+ return parseXML(xml.documentElement);
+ });
+ default:
+ return res.text();
+ }
+ }
+ });
+ promise.then(callback || function() {});
+ promise.catch(errorCallback || console.error);
+ return promise;
};
/**
@@ -57940,8 +62694,28 @@ window.URL = window.URL || window.webkitURL;
// private array of p5.PrintWriter objects
p5.prototype._pWriters = [];
-
-p5.prototype.createWriter = function (name, extension) {
+/**
+ * @method createWriter
+ * @param {String} name name of the file to be created
+ * @param {String} [extension]
+ * @return {p5.PrintWriter}
+ * @example
+ *
+ *
+ * createButton('save')
+ * .position(10, 10)
+ * .mousePressed(function() {
+ * var writer = createWriter('squares.txt');
+ * for (var i = 0; i < 10; i++) {
+ * writer.print(i * i);
+ * }
+ * writer.close();
+ * writer.clear();
+ * });
+ *
+ *
+ */
+p5.prototype.createWriter = function(name, extension) {
var newPW;
// check that it doesn't already exist
for (var i in p5.prototype._pWriters) {
@@ -57949,7 +62723,7 @@ p5.prototype.createWriter = function (name, extension) {
// if a p5.PrintWriter w/ this name already exists...
// return p5.prototype._pWriters[i]; // return it w/ contents intact.
// or, could return a new, empty one with a unique name:
- newPW = new p5.PrintWriter(name + window.millis(), extension);
+ newPW = new p5.PrintWriter(name + this.millis(), extension);
p5.prototype._pWriters.push(newPW);
return newPW;
}
@@ -57959,22 +62733,141 @@ p5.prototype.createWriter = function (name, extension) {
return newPW;
};
-
-p5.PrintWriter = function (filename, extension) {
+/**
+ * @class p5.PrintWriter
+ * @param {String} filename
+ * @param {String} [extension]
+ */
+p5.PrintWriter = function(filename, extension) {
var self = this;
this.name = filename;
this.content = '';
//Changed to write because it was being overloaded by function below.
- this.write = function (data) {
+ /**
+ * Writes data to the PrintWriter stream
+ * @method write
+ * @param {Array} data all data to be written by the PrintWriter
+ * @example
+ *
+ *
+ * // creates a file called 'newFile.txt'
+ * var writer = createWriter('newFile.txt');
+ * // write 'Hello world!'' to the file
+ * writer.write(['Hello world!']);
+ * // close the PrintWriter and save the file
+ * writer.close();
+ *
+ *
+ *
+ *
+ * // creates a file called 'newFile2.txt'
+ * var writer = createWriter('newFile2.txt');
+ * // write 'apples,bananas,123' to the file
+ * writer.write(['apples', 'bananas', 123]);
+ * // close the PrintWriter and save the file
+ * writer.close();
+ *
+ *
+ *
+ *
+ * // creates a file called 'newFile3.txt'
+ * var writer = createWriter('newFile3.txt');
+ * // write 'My name is: Teddy' to the file
+ * writer.write('My name is:');
+ * writer.write(' Teddy');
+ * // close the PrintWriter and save the file
+ * writer.close();
+ *
+ *
+ */
+ this.write = function(data) {
this.content += data;
};
- this.print = function (data) {
+ /**
+ * Writes data to the PrintWriter stream, and adds a new line at the end
+ * @method print
+ * @param {Array} data all data to be printed by the PrintWriter
+ * @example
+ *
+ *
+ * // creates a file called 'newFile.txt'
+ * var writer = createWriter('newFile.txt');
+ * // creates a file containing
+ * // My name is:
+ * // Teddy
+ * writer.print('My name is:');
+ * writer.print('Teddy');
+ * // close the PrintWriter and save the file
+ * writer.close();
+ *
+ *
+ *
+ *
+ * var writer;
+ *
+ * function setup() {
+ * createCanvas(400, 400);
+ * // create a PrintWriter
+ * writer = createWriter('newFile.txt');
+ * }
+ *
+ * function draw() {
+ * // print all mouseX and mouseY coordinates to the stream
+ * writer.print([mouseX, mouseY]);
+ * }
+ *
+ * function mouseClicked() {
+ * // close the PrintWriter and save the file
+ * writer.close();
+ * }
+ *
+ *
+ */
+ this.print = function(data) {
this.content += data + '\n';
};
- this.flush = function () {
+ /**
+ * Clears the data already written to the PrintWriter object
+ * @method clear
+ * @example
+ *
+ * // create writer object
+ * var writer = createWriter('newFile.txt');
+ * writer.write(['clear me']);
+ * // clear writer object here
+ * writer.clear();
+ * // close writer
+ * writer.close();
+ *
+ *
+ */
+ this.clear = function() {
this.content = '';
};
- this.close = function () {
+ /**
+ * Closes the PrintWriter
+ * @method close
+ * @example
+ *
+ *
+ * // create a file called 'newFile.txt'
+ * var writer = createWriter('newFile.txt');
+ * // close the PrintWriter and save the file
+ * writer.close();
+ *
+ *
+ *
+ *
+ * // create a file called 'newFile2.txt'
+ * var writer = createWriter('newFile2.txt');
+ * // write some data to the file
+ * writer.write([100, 101, 102]);
+ * // close the PrintWriter and save the file
+ * writer.close();
+ *
+ *
+ */
+ this.close = function() {
// convert String to Array for the writeFile Blob
var arr = [];
arr.push(this.content);
@@ -57986,57 +62879,80 @@ p5.PrintWriter = function (filename, extension) {
p5.prototype._pWriters.splice(i, 1);
}
}
- self.flush();
+ self.clear();
self = {};
};
};
+/**
+ * @module IO
+ * @submodule Output
+ * @for p5
+ */
+
// object, filename, options --> saveJSON, saveStrings,
// filename, [extension] [canvas] --> saveImage
/**
* Save an image, text, json, csv, wav, or html. Prompts download to
- * the client's computer. Note that it is not recommended to call save()
- * within draw if it's looping, as the save() function will open a new save
+ * the client's computer. Note that it is not recommended to call save()
+ * within draw if it's looping, as the save() function will open a new save
* dialog every frame.
* The default behavior is to save the canvas as an image. You can
* optionally specify a filename.
* For example:
- *
- * save();
- * save('myCanvas.jpg'); // save a specific canvas with a filename
- *
+ *
+ * save();
+ * save('myCanvas.jpg'); // save a specific canvas with a filename
+ *
*
* Alternately, the first parameter can be a pointer to a canvas
- * p5.Element, an Array of Strings,
- * an Array of JSON, a JSON object, a p5.Table, a p5.Image, or a
+ * p5.Element, an Array of Strings,
+ * an Array of JSON, a JSON object, a p5.Table, a p5.Image, or a
* p5.SoundFile (requires p5.sound). The second parameter is a filename
* (including extension). The third parameter is for options specific
* to this type of object. This method will save a file that fits the
* given paramaters. For example:
*
- *
+ *
+ * // Saves canvas as an image
+ * save('myCanvas.jpg');
+ *
+ * // Saves pImage as a png image
+ * var img = createImage(10, 10);
+ * save(img, 'my.png');
+ *
+ * // Saves canvas as an image
+ * var cnv = createCanvas(100, 100);
+ * save(cnv, 'myCanvas.jpg');
+ *
+ * // Saves p5.Renderer object as an image
+ * var gb = createGraphics(100, 100);
+ * save(gb, 'myGraphics.jpg');
+ *
+ * var myTable = new p5.Table();
*
- * save('myCanvas.jpg'); // Saves canvas as an image
+ * // Saves table as html file
+ * save(myTable, 'myTable.html');
*
- * var cnv = createCanvas(100, 100);
- * save(cnv, 'myCanvas.jpg'); // Saves canvas as an image
+ * // Comma Separated Values
+ * save(myTable, 'myTable.csv');
*
- * var gb = createGraphics(100, 100);
- * save(gb, 'myGraphics.jpg'); // Saves p5.Renderer object as an image
+ * // Tab Separated Values
+ * save(myTable, 'myTable.tsv');
*
- * save(myTable, 'myTable.html'); // Saves table as html file
- * save(myTable, 'myTable.csv',); // Comma Separated Values
- * save(myTable, 'myTable.tsv'); // Tab Separated Values
+ * var myJSON = { a: 1, b: true };
*
- * save(myJSON, 'my.json'); // Saves pretty JSON
- * save(myJSON, 'my.json', true); // Optimizes JSON filesize
+ * // Saves pretty JSON
+ * save(myJSON, 'my.json');
*
- * save(img, 'my.png'); // Saves pImage as a png image
+ * // Optimizes JSON filesize
+ * save(myJSON, 'my.json', true);
*
- * save(arrayOfStrings, 'my.txt'); // Saves strings to a text file with line
- * // breaks after each item in the array
- *
+ * // Saves array of strings to a text file with line breaks after each item
+ * var arrayOfStrings = ['a', 'b'];
+ * save(arrayOfStrings, 'my.txt');
+ *
*
* @method save
* @param {Object|String} [objectOrFilename] If filename is provided, will
@@ -58058,7 +62974,7 @@ p5.PrintWriter = function (filename, extension) {
* output will be optimized for filesize,
* rather than readability.
*/
-p5.prototype.save = function (object, _filename, _options) {
+p5.prototype.save = function(object, _filename, _options) {
// parse the arguments and figure out which things we are saving
var args = arguments;
// =================================================
@@ -58069,24 +62985,18 @@ p5.prototype.save = function (object, _filename, _options) {
if (args.length === 0) {
p5.prototype.saveCanvas(cnv);
return;
- }
- // otherwise, parse the arguments
+ } else if (args[0] instanceof p5.Renderer || args[0] instanceof p5.Graphics) {
+ // otherwise, parse the arguments
- // if first param is a p5Graphics, then saveCanvas
- else if (args[0] instanceof p5.Renderer ||
- args[0] instanceof p5.Graphics) {
+ // if first param is a p5Graphics, then saveCanvas
p5.prototype.saveCanvas(args[0].elt, args[1], args[2]);
return;
- }
-
- // if 1st param is String and only one arg, assume it is canvas filename
- else if (args.length === 1 && typeof (args[0]) === 'string') {
+ } else if (args.length === 1 && typeof args[0] === 'string') {
+ // if 1st param is String and only one arg, assume it is canvas filename
p5.prototype.saveCanvas(cnv, args[0]);
- }
-
- // =================================================
- // OPTION 2: extension clarifies saveStrings vs. saveJSON
- else {
+ } else {
+ // =================================================
+ // OPTION 2: extension clarifies saveStrings vs. saveJSON
var extension = _checkFileExtension(args[1], args[2])[1];
switch (extension) {
case 'json':
@@ -58095,13 +63005,13 @@ p5.prototype.save = function (object, _filename, _options) {
case 'txt':
p5.prototype.saveStrings(args[0], args[1], args[2]);
return;
- // =================================================
- // OPTION 3: decide based on object...
+ // =================================================
+ // OPTION 3: decide based on object...
default:
if (args[0] instanceof Array) {
p5.prototype.saveStrings(args[0], args[1], args[2]);
} else if (args[0] instanceof p5.Table) {
- p5.prototype.saveTable(args[0], args[1], args[2], args[3]);
+ p5.prototype.saveTable(args[0], args[1], args[2]);
} else if (args[0] instanceof p5.Image) {
p5.prototype.saveCanvas(args[0].canvas, args[1]);
} else if (args[0] instanceof p5.SoundFile) {
@@ -58124,34 +63034,33 @@ p5.prototype.save = function (object, _filename, _options) {
* file to optimize filesize
* (but not readability).
* @example
- *
- * var json;
- *
- * function setup() {
- *
- * json = {}; // new JSON Object
+ *
+ * var json = {}; // new JSON Object
*
- * json.id = 0;
- * json.species = 'Panthera leo';
- * json.name = 'Lion';
+ * json.id = 0;
+ * json.species = 'Panthera leo';
+ * json.name = 'Lion';
*
- * // To save, un-comment the line below, then click 'run'
- * // saveJSON(json, 'lion.json');
- * }
+ * createButton('save')
+ * .position(10, 10)
+ * .mousePressed(function() {
+ * saveJSON(json, 'lion.json');
+ * });
*
- * // Saves the following to a file called "lion.json":
- * // {
- * // "id": 0,
- * // "species": "Panthera leo",
- * // "name": "Lion"
- * // }
- *
+ * // saves the following to a file called "lion.json":
+ * // {
+ * // "id": 0,
+ * // "species": "Panthera leo",
+ * // "name": "Lion"
+ * // }
+ *
*
* @alt
* no image displayed
*
*/
-p5.prototype.saveJSON = function (json, filename, opt) {
+p5.prototype.saveJSON = function(json, filename, opt) {
+ p5._validateParameters('saveJSON', arguments);
var stringify;
if (opt) {
stringify = JSON.stringify(json);
@@ -58164,38 +63073,42 @@ p5.prototype.saveJSON = function (json, filename, opt) {
p5.prototype.saveJSONObject = p5.prototype.saveJSON;
p5.prototype.saveJSONArray = p5.prototype.saveJSON;
-
/**
* Writes an array of Strings to a text file, one line per String.
* The file saving process and location of the saved file will
* vary between web browsers.
*
* @method saveStrings
- * @param {Array} list string array to be written
+ * @param {String[]} list string array to be written
* @param {String} filename filename for output
+ * @param {String} [extension] the filename's extension
* @example
- *
- * var words = 'apple bear cat dog';
+ *
+ * var words = 'apple bear cat dog';
*
- * // .split() outputs an Array
- * var list = split(words, ' ');
+ * // .split() outputs an Array
+ * var list = split(words, ' ');
*
- * // To save the file, un-comment next line and click 'run'
- * // saveStrings(list, 'nouns.txt');
+ * createButton('save')
+ * .position(10, 10)
+ * .mousePressed(function() {
+ * saveStrings(list, 'nouns.txt');
+ * });
*
- * // Saves the following to a file called 'nouns.txt':
- * //
- * // apple
- * // bear
- * // cat
- * // dog
- *
+ * // Saves the following to a file called 'nouns.txt':
+ * //
+ * // apple
+ * // bear
+ * // cat
+ * // dog
+ *
*
* @alt
* no image displayed
*
*/
-p5.prototype.saveStrings = function (list, filename, extension) {
+p5.prototype.saveStrings = function(list, filename, extension) {
+ p5._validateParameters('saveStrings', arguments);
var ext = extension || 'txt';
var pWriter = this.createWriter(filename, ext);
for (var i = 0; i < list.length; i++) {
@@ -58206,10 +63119,9 @@ p5.prototype.saveStrings = function (list, filename, extension) {
}
}
pWriter.close();
- pWriter.flush();
+ pWriter.clear();
};
-
// =======
// HELPERS
// =======
@@ -58224,50 +63136,51 @@ function escapeHelper(content) {
}
/**
- * Writes the contents of a Table object to a file. Defaults to a
+ * Writes the contents of a Table object to a file. Defaults to a
* text file with comma-separated-values ('csv') but can also
* use tab separation ('tsv'), or generate an HTML table ('html').
* The file saving process and location of the saved file will
* vary between web browsers.
*
* @method saveTable
- * @param {p5.Table} Table the Table object to save to a file
+ * @param {p5.Table} Table the Table object to save to a file
* @param {String} filename the filename to which the Table should be saved
* @param {String} [options] can be one of "tsv", "csv", or "html"
* @example
*
- * var table;
+ * var table;
*
- * function setup() {
- * table = new p5.Table();
+ * function setup() {
+ * table = new p5.Table();
*
- * table.addColumn('id');
- * table.addColumn('species');
- * table.addColumn('name');
+ * table.addColumn('id');
+ * table.addColumn('species');
+ * table.addColumn('name');
*
- * var newRow = table.addRow();
- * newRow.setNum('id', table.getRowCount() - 1);
- * newRow.setString('species', 'Panthera leo');
- * newRow.setString('name', 'Lion');
+ * var newRow = table.addRow();
+ * newRow.setNum('id', table.getRowCount() - 1);
+ * newRow.setString('species', 'Panthera leo');
+ * newRow.setString('name', 'Lion');
*
- * // To save, un-comment next line then click 'run'
- * // saveTable(table, 'new.csv');
- * }
+ * // To save, un-comment next line then click 'run'
+ * // saveTable(table, 'new.csv');
+ * }
*
- * // Saves the following to a file called 'new.csv':
- * // id,species,name
- * // 0,Panthera leo,Lion
- *
+ * // Saves the following to a file called 'new.csv':
+ * // id,species,name
+ * // 0,Panthera leo,Lion
+ *
*
* @alt
* no image displayed
*
*/
-p5.prototype.saveTable = function (table, filename, options) {
+p5.prototype.saveTable = function(table, filename, options) {
+ p5._validateParameters('saveTable', arguments);
var ext;
- if(options === undefined){
- ext = filename.substring(filename.lastIndexOf('.')+1,filename.length);
- }else{
+ if (options === undefined) {
+ ext = filename.substring(filename.lastIndexOf('.') + 1, filename.length);
+ } else {
ext = options;
}
var pWriter = this.createWriter(filename, ext);
@@ -58305,14 +63218,12 @@ p5.prototype.saveTable = function (table, filename, options) {
}
pWriter.write('\n');
}
- }
-
- // otherwise, make HTML
- else {
+ } else {
+ // otherwise, make HTML
pWriter.print('');
pWriter.print('');
- var str = ' ');
@@ -58345,51 +63256,58 @@ p5.prototype.saveTable = function (table, filename, options) {
pWriter.print('');
pWriter.print('');
}
- // close and flush the pWriter
+ // close and clear the pWriter
pWriter.close();
- pWriter.flush();
+ pWriter.clear();
}; // end saveTable()
/**
* Generate a blob of file data as a url to prepare for download.
* Accepts an array of data, a filename, and an extension (optional).
* This is a private function because it does not do any formatting,
- * but it is used by saveStrings, saveJSON, saveTable etc.
+ * but it is used by saveStrings, saveJSON, saveTable etc.
*
* @param {Array} dataToDownload
* @param {String} filename
- * @param {[String]} extension
+ * @param {String} [extension]
* @private
*/
-p5.prototype.writeFile = function (dataToDownload, filename, extension) {
- var type = 'application\/octet-stream';
+p5.prototype.writeFile = function(dataToDownload, filename, extension) {
+ var type = 'application/octet-stream';
if (p5.prototype._isSafari()) {
- type = 'text\/plain';
+ type = 'text/plain';
}
var blob = new Blob(dataToDownload, {
- 'type': type
+ type: type
});
- var href = window.URL.createObjectURL(blob);
- p5.prototype.downloadFile(href, filename, extension);
+ p5.prototype.downloadFile(blob, filename, extension);
};
/**
* Forces download. Accepts a url to filedata/blob, a filename,
* and an extension (optional).
* This is a private function because it does not do any formatting,
- * but it is used by saveStrings, saveJSON, saveTable etc.
+ * but it is used by saveStrings, saveJSON, saveTable etc.
*
- * @param {String} href i.e. an href generated by createObjectURL
- * @param {[String]} filename
- * @param {[String]} extension
+ * @method downloadFile
+ * @private
+ * @param {String|Blob} data either an href generated by createObjectURL,
+ * or a Blob object containing the data
+ * @param {String} [filename]
+ * @param {String} [extension]
*/
-p5.prototype.downloadFile = function (href, fName, extension) {
+p5.prototype.downloadFile = function(data, fName, extension) {
var fx = _checkFileExtension(fName, extension);
var filename = fx[0];
- var ext = fx[1];
+
+ if (data instanceof Blob) {
+ var fileSaver = _dereq_('file-saver');
+ fileSaver.saveAs(data, filename);
+ return;
+ }
var a = document.createElement('a');
- a.href = href;
+ a.href = data;
a.download = filename;
// Firefox requires the link to be added to the DOM before click()
@@ -58406,11 +63324,10 @@ p5.prototype.downloadFile = function (href, fName, extension) {
var aText = 'Hello, Safari user! To download this file...\n';
aText += '1. Go to File --> Save As.\n';
aText += '2. Choose "Page Source" as the Format.\n';
- aText += '3. Name it with this extension: .\"' + ext + '\"';
+ aText += '3. Name it with this extension: ."' + fx[1] + '"';
alert(aText);
}
a.click();
- href = null;
};
/**
@@ -58418,6 +63335,7 @@ p5.prototype.downloadFile = function (href, fName, extension) {
* if the provided parameter has no extension.
*
* @param {String} filename
+ * @param {String} [extension]
* @return {String[]} [fileName, fileExtension]
*
* @private
@@ -58452,7 +63370,7 @@ p5.prototype._checkFileExtension = _checkFileExtension;
* @return {Boolean} [description]
* @private
*/
-p5.prototype._isSafari = function () {
+p5.prototype._isSafari = function() {
var x = Object.prototype.toString.call(window.HTMLElement);
return x.indexOf('Constructor') > 0;
};
@@ -58470,7 +63388,7 @@ function destroyClickedElement(event) {
module.exports = p5;
-},{"../core/core":55,"../core/error_helpers":58,"es6-promise":5,"fetch-jsonp":6,"whatwg-fetch":45}],80:[function(_dereq_,module,exports){
+},{"../core/error_helpers":21,"../core/main":25,"es6-promise":5,"fetch-jsonp":6,"file-saver":7,"whatwg-fetch":13}],49:[function(_dereq_,module,exports){
/**
* @module IO
* @submodule Table
@@ -58479,8 +63397,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
-
+var p5 = _dereq_('../core/main');
/**
* Table Options
@@ -58494,9 +63411,9 @@ var p5 = _dereq_('../core/core');
* File names should end with .csv if they're comma separated.
* A rough "spec" for CSV can be found
* here.
- * To load files, use the loadTable method.
- * To save tables to your computer, use the save method
- * or the saveTable method.
+ * To load files, use the loadTable method.
+ * To save tables to your computer, use the save method
+ * or the saveTable method.
*
* Possible options include:
*
@@ -58507,7 +63424,7 @@ var p5 = _dereq_('../core/core');
*/
/**
- * Table objects store data with multiple rows and columns, much
+ * Table objects store data with multiple rows and columns, much
* like in a traditional spreadsheet. Tables can be generated from
* scratch, dynamically, or using data from an existing file.
*
@@ -58515,7 +63432,7 @@ var p5 = _dereq_('../core/core');
* @constructor
* @param {p5.TableRow[]} [rows] An array of p5.TableRow objects
*/
-p5.Table = function (rows) {
+p5.Table = function(rows) {
/**
* @property columns {String[]}
*/
@@ -58525,55 +63442,55 @@ p5.Table = function (rows) {
* @property rows {p5.TableRow[]}
*/
this.rows = [];
- this.name = 'p5.Table'; // for friendly debugger system
};
/**
- * Use addRow() to add a new row of data to a p5.Table object. By default,
+ * Use addRow() to add a new row of data to a p5.Table object. By default,
* an empty row is created. Typically, you would store a reference to
* the new row in a TableRow object (see newRow in the example above),
- * and then set individual values using set().
+ * and then set individual values using set().
*
- * If a p5.TableRow object is included as a parameter, then that row is
+ * If a p5.TableRow object is included as a parameter, then that row is
* duplicated and added to the table.
*
* @method addRow
* @param {p5.TableRow} [row] row to be added to the table
+ * @return {p5.TableRow} the row that was added
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * //add a row
- * var newRow = table.addRow();
- * newRow.setString("id", table.getRowCount() - 1);
- * newRow.setString("species", "Canis Lupus");
- * newRow.setString("name", "Wolf");
- *
- * //print the results
- * for (var r = 0; r < table.getRowCount(); r++)
- * for (var c = 0; c < table.getColumnCount(); c++)
- * print(table.getString(r, c));
- * }
- *
- *
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //add a row
+ * var newRow = table.addRow();
+ * newRow.setString('id', table.getRowCount() - 1);
+ * newRow.setString('species', 'Canis Lupus');
+ * newRow.setString('name', 'Wolf');
+ *
+ * //print the results
+ * for (var r = 0; r < table.getRowCount(); r++)
+ * for (var c = 0; c < table.getColumnCount(); c++)
+ * print(table.getString(r, c));
+ * }
+ *
+ *
+ *
* @alt
* no image displayed
*
@@ -58582,9 +63499,9 @@ p5.Table.prototype.addRow = function(row) {
// make sure it is a valid TableRow
var r = row || new p5.TableRow();
- if (typeof(r.arr) === 'undefined' || typeof(r.obj) === 'undefined') {
+ if (typeof r.arr === 'undefined' || typeof r.obj === 'undefined') {
//r = new p5.prototype.TableRow(r);
- throw 'invalid TableRow: ' + r;
+ throw new Error('invalid TableRow: ' + r);
}
r.table = this;
this.rows.push(r);
@@ -58595,139 +63512,140 @@ p5.Table.prototype.addRow = function(row) {
* Removes a row from the table object.
*
* @method removeRow
- * @param {Number} id ID number of the row to remove
+ * @param {Integer} id ID number of the row to remove
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * //remove the first row
- * var r = table.removeRow(0);
- *
- * //print the results
- * for (var r = 0; r < table.getRowCount(); r++)
- * for (var c = 0; c < table.getColumnCount(); c++)
- * print(table.getString(r, c));
- * }
- *
- *
- *
- * @alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //remove the first row
+ * table.removeRow(0);
+ *
+ * //print the results
+ * for (var r = 0; r < table.getRowCount(); r++)
+ * for (var c = 0; c < table.getColumnCount(); c++)
+ * print(table.getString(r, c));
+ * }
+ *
+ *
+ *
+ * @alt
+ * no image displayed
+ *
*/
p5.Table.prototype.removeRow = function(id) {
this.rows[id].table = null; // remove reference to table
- var chunk = this.rows.splice(id+1, this.rows.length);
+ var chunk = this.rows.splice(id + 1, this.rows.length);
this.rows.pop();
this.rows = this.rows.concat(chunk);
};
-
/**
- * Returns a reference to the specified p5.TableRow. The reference
+ * Returns a reference to the specified p5.TableRow. The reference
* can then be used to get and set values of the selected row.
*
* @method getRow
- * @param {Number} rowID ID number of the row to get
- * @return {p5.TableRow} p5.TableRow object
+ * @param {Integer} rowID ID number of the row to get
+ * @return {p5.TableRow} p5.TableRow object
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * var row = table.getRow(1);
- * //print it column by column
- * //note: a row is an object, not an array
- * for (var c = 0; c < table.getColumnCount(); c++)
- * print(row.getString(c));
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var row = table.getRow(1);
+ * //print it column by column
+ * //note: a row is an object, not an array
+ * for (var c = 0; c < table.getColumnCount(); c++) {
+ * print(row.getString(c));
+ * }
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.getRow = function(r) {
return this.rows[r];
};
/**
- * Gets all rows from the table. Returns an array of p5.TableRows.
+ * Gets all rows from the table. Returns an array of p5.TableRows.
*
* @method getRows
- * @return {p5.TableRow[]} Array of p5.TableRows
+ * @return {p5.TableRow[]} Array of p5.TableRows
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * var rows = table.getRows();
- *
- * //warning: rows is an array of objects
- * for (var r = 0; r < rows.length; r++)
- * rows[r].set("name", "Unicorn");
- *
- * //print the results
- * for (var r = 0; r < table.getRowCount(); r++)
- * for (var c = 0; c < table.getColumnCount(); c++)
- * print(table.getString(r, c));
- * }
- *
- *
- *
- * @alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var rows = table.getRows();
+ *
+ * //warning: rows is an array of objects
+ * for (var r = 0; r < rows.length; r++) {
+ * rows[r].set('name', 'Unicorn');
+ * }
+ *
+ * //print the results
+ * for (r = 0; r < table.getRowCount(); r++)
+ * for (var c = 0; c < table.getColumnCount(); c++)
+ * print(table.getString(r, c));
+ * }
+ *
+ *
+ *
+ * @alt
+ * no image displayed
+ *
*/
p5.Table.prototype.getRows = function() {
return this.rows;
@@ -58742,54 +63660,53 @@ p5.Table.prototype.getRows = function() {
*
* @method findRow
* @param {String} value The value to match
- * @param {Number|String} column ID number or title of the
+ * @param {Integer|String} column ID number or title of the
* column to search
* @return {p5.TableRow}
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * //find the animal named zebra
- * var row = table.findRow("Zebra", "name");
- * //find the corresponding species
- * print(row.getString("species"));
- * }
- *
- *
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //find the animal named zebra
+ * var row = table.findRow('Zebra', 'name');
+ * //find the corresponding species
+ * print(row.getString('species'));
+ * }
+ *
+ *
+ *
* @alt
* no image displayed
*
*/
p5.Table.prototype.findRow = function(value, column) {
// try the Object
- if (typeof(column) === 'string') {
- for (var i = 0; i < this.rows.length; i++){
+ if (typeof column === 'string') {
+ for (var i = 0; i < this.rows.length; i++) {
if (this.rows[i].obj[column] === value) {
return this.rows[i];
}
}
- }
- // try the Array
- else {
- for (var j = 0; j < this.rows.length; j++){
+ } else {
+ // try the Array
+ for (var j = 0; j < this.rows.length; j++) {
if (this.rows[j].arr[column] === value) {
return this.rows[j];
}
@@ -58808,61 +63725,60 @@ p5.Table.prototype.findRow = function(value, column) {
*
* @method findRows
* @param {String} value The value to match
- * @param {Number|String} column ID number or title of the
+ * @param {Integer|String} column ID number or title of the
* column to search
* @return {p5.TableRow[]} An Array of TableRow objects
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * //add another goat
- * var newRow = table.addRow();
- * newRow.setString("id", table.getRowCount() - 1);
- * newRow.setString("species", "Scape Goat");
- * newRow.setString("name", "Goat");
- *
- * //find the rows containing animals named Goat
- * var rows = table.findRows("Goat", "name");
- * print(rows.length + " Goats found");
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //add another goat
+ * var newRow = table.addRow();
+ * newRow.setString('id', table.getRowCount() - 1);
+ * newRow.setString('species', 'Scape Goat');
+ * newRow.setString('name', 'Goat');
+ *
+ * //find the rows containing animals named Goat
+ * var rows = table.findRows('Goat', 'name');
+ * print(rows.length + ' Goats found');
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.findRows = function(value, column) {
var ret = [];
- if (typeof(column) === 'string') {
- for (var i = 0; i < this.rows.length; i++){
+ if (typeof column === 'string') {
+ for (var i = 0; i < this.rows.length; i++) {
if (this.rows[i].obj[column] === value) {
- ret.push( this.rows[i] );
+ ret.push(this.rows[i]);
}
}
- }
- // try the Array
- else {
- for (var j = 0; j < this.rows.length; j++){
+ } else {
+ // try the Array
+ for (var j = 0; j < this.rows.length; j++) {
if (this.rows[j].arr[column] === value) {
- ret.push( this.rows[j] );
+ ret.push(this.rows[j]);
}
}
}
@@ -58870,30 +63786,57 @@ p5.Table.prototype.findRows = function(value, column) {
};
/**
- * Finds the first row in the Table that matches the regular
- * expression provided, and returns a reference to that row.
- * Even if multiple rows are possible matches, only the first
- * matching row is returned. The column to search may be
- * specified by either its ID or title.
+ * Finds the first row in the Table that matches the regular
+ * expression provided, and returns a reference to that row.
+ * Even if multiple rows are possible matches, only the first
+ * matching row is returned. The column to search may be
+ * specified by either its ID or title.
+ *
+ * @method matchRow
+ * @param {String|RegExp} regexp The regular expression to match
+ * @param {String|Integer} column The column ID (number) or
+ * title (string)
+ * @return {p5.TableRow} TableRow object
+ *
+ * @example
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //Search using specified regex on a given column, return TableRow object
+ * var mammal = table.matchRow(new RegExp('ant'), 1);
+ * print(mammal.getString(1));
+ * //Output "Panthera pardus"
+ * }
+ *
+ *
*
- * @method matchRow
- * @param {String} regexp The regular expression to match
- * @param {String|Number} column The column ID (number) or
- * title (string)
- * @return {p5.TableRow} TableRow object
*/
p5.Table.prototype.matchRow = function(regexp, column) {
- if (typeof(column) === 'number') {
+ if (typeof column === 'number') {
for (var j = 0; j < this.rows.length; j++) {
- if ( this.rows[j].arr[column].match(regexp) ) {
+ if (this.rows[j].arr[column].match(regexp)) {
return this.rows[j];
}
}
- }
-
- else {
+ } else {
for (var i = 0; i < this.rows.length; i++) {
- if ( this.rows[i].obj[column].match(regexp) ) {
+ if (this.rows[i].obj[column].match(regexp)) {
return this.rows[i];
}
}
@@ -58902,72 +63845,72 @@ p5.Table.prototype.matchRow = function(regexp, column) {
};
/**
- * Finds the rows in the Table that match the regular expression provided,
- * and returns references to those rows. Returns an array, so for must be
- * used to iterate through all the rows, as shown in the example. The
- * column to search may be specified by either its ID or title.
+ * Finds the rows in the Table that match the regular expression provided,
+ * and returns references to those rows. Returns an array, so for must be
+ * used to iterate through all the rows, as shown in the example. The
+ * column to search may be specified by either its ID or title.
*
- * @method matchRows
- * @param {String} regexp The regular expression to match
- * @param {String|Number} [column] The column ID (number) or
- * title (string)
- * @return {p5.TableRow[]} An Array of TableRow objects
- * @example
- * var table;
- *
- * function setup() {
+ * @method matchRows
+ * @param {String} regexp The regular expression to match
+ * @param {String|Integer} [column] The column ID (number) or
+ * title (string)
+ * @return {p5.TableRow[]} An Array of TableRow objects
+ * @example
+ *
+ *
+ * var table;
*
- * table = new p5.Table();
+ * function setup() {
+ * table = new p5.Table();
*
- * table.addColumn('name');
- * table.addColumn('type');
+ * table.addColumn('name');
+ * table.addColumn('type');
*
- * var newRow = table.addRow();
- * newRow.setString('name', 'Lion');
- * newRow.setString('type', 'Mammal');
+ * var newRow = table.addRow();
+ * newRow.setString('name', 'Lion');
+ * newRow.setString('type', 'Mammal');
*
- * newRow = table.addRow();
- * newRow.setString('name', 'Snake');
- * newRow.setString('type', 'Reptile');
+ * newRow = table.addRow();
+ * newRow.setString('name', 'Snake');
+ * newRow.setString('type', 'Reptile');
*
- * newRow = table.addRow();
- * newRow.setString('name', 'Mosquito');
- * newRow.setString('type', 'Insect');
+ * newRow = table.addRow();
+ * newRow.setString('name', 'Mosquito');
+ * newRow.setString('type', 'Insect');
*
- * newRow = table.addRow();
- * newRow.setString('name', 'Lizard');
- * newRow.setString('type', 'Reptile');
+ * newRow = table.addRow();
+ * newRow.setString('name', 'Lizard');
+ * newRow.setString('type', 'Reptile');
*
- * var rows = table.matchRows('R.*', 'type');
- * for (var i = 0; i < rows.length; i++) {
- * print(rows[i].getString('name') + ': ' + rows[i].getString('type'));
- * }
- * }
- * // Sketch prints:
- * // Snake: Reptile
- * // Lizard: Reptile
+ * var rows = table.matchRows('R.*', 'type');
+ * for (var i = 0; i < rows.length; i++) {
+ * print(rows[i].getString('name') + ': ' + rows[i].getString('type'));
+ * }
+ * }
+ * // Sketch prints:
+ * // Snake: Reptile
+ * // Lizard: Reptile
+ *
+ *
*/
p5.Table.prototype.matchRows = function(regexp, column) {
var ret = [];
- if (typeof(column) === 'number') {
+ if (typeof column === 'number') {
for (var j = 0; j < this.rows.length; j++) {
- if ( this.rows[j].arr[column].match(regexp) ) {
- ret.push( this.rows[j] );
+ if (this.rows[j].arr[column].match(regexp)) {
+ ret.push(this.rows[j]);
}
}
- }
-
- else {
+ } else {
for (var i = 0; i < this.rows.length; i++) {
- if ( this.rows[i].obj[column].match(regexp) ) {
- ret.push( this.rows[i] );
+ if (this.rows[i].obj[column].match(regexp)) {
+ ret.push(this.rows[i]);
}
}
}
return ret;
};
-
/**
* Retrieves all values in the specified column, and returns them
* as an array. The column may be specified by either its ID or title.
@@ -58977,45 +63920,45 @@ p5.Table.prototype.matchRows = function(regexp, column) {
* @return {Array} Array of column values
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * //getColumn returns an array that can be printed directly
- * print(table.getColumn("species"));
- * //outputs ["Capra hircus", "Panthera pardus", "Equus zebra"]
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //getColumn returns an array that can be printed directly
+ * print(table.getColumn('species'));
+ * //outputs ["Capra hircus", "Panthera pardus", "Equus zebra"]
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.getColumn = function(value) {
var ret = [];
- if (typeof(value) === 'string'){
- for (var i = 0; i < this.rows.length; i++){
- ret.push (this.rows[i].obj[value]);
+ if (typeof value === 'string') {
+ for (var i = 0; i < this.rows.length; i++) {
+ ret.push(this.rows[i].obj[value]);
}
} else {
- for (var j = 0; j < this.rows.length; j++){
- ret.push (this.rows[j].arr[value]);
+ for (var j = 0; j < this.rows.length; j++) {
+ ret.push(this.rows[j].arr[value]);
}
}
return ret;
@@ -59025,38 +63968,38 @@ p5.Table.prototype.getColumn = function(value) {
* Removes all rows from a Table. While all rows are removed,
* columns and column titles are maintained.
*
- * @method clearRows
+ * @method clearRows
+ *
+ * @example
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * table.clearRows();
+ * print(table.getRowCount() + ' total rows in table');
+ * print(table.getColumnCount() + ' total columns in table');
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
*
- * @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * table.clearRows();
- * print(table.getRowCount() + " total rows in table");
- * print(table.getColumnCount() + " total columns in table");
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
*/
p5.Table.prototype.clearRows = function() {
delete this.rows;
@@ -59064,7 +64007,7 @@ p5.Table.prototype.clearRows = function() {
};
/**
- * Use addColumn() to add a new column to a Table object.
+ * Use addColumn() to add a new column to a Table object.
* Typically, you will want to specify a title, so the column
* may be easily referenced later by name. (If no title is
* specified, the new column's title will be null.)
@@ -59073,41 +64016,41 @@ p5.Table.prototype.clearRows = function() {
* @param {String} [title] title of the given column
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * table.addColumn("carnivore");
- * table.set(0, "carnivore", "no");
- * table.set(1, "carnivore", "yes");
- * table.set(2, "carnivore", "no");
- *
- * //print the results
- * for (var r = 0; r < table.getRowCount(); r++)
- * for (var c = 0; c < table.getColumnCount(); c++)
- * print(table.getString(r, c));
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * table.addColumn('carnivore');
+ * table.set(0, 'carnivore', 'no');
+ * table.set(1, 'carnivore', 'yes');
+ * table.set(2, 'carnivore', 'no');
+ *
+ * //print the results
+ * for (var r = 0; r < table.getRowCount(); r++)
+ * for (var c = 0; c < table.getColumnCount(); c++)
+ * print(table.getString(r, c));
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.addColumn = function(title) {
var t = title || null;
@@ -59117,7 +64060,34 @@ p5.Table.prototype.addColumn = function(title) {
/**
* Returns the total number of columns in a Table.
*
- * @return {Number} Number of columns in this table
+ * @method getColumnCount
+ * @return {Integer} Number of columns in this table
+ * @example
+ *
+ *
+ * // given the cvs file "blobs.csv" in /assets directory
+ * // ID, Name, Flavor, Shape, Color
+ * // Blob1, Blobby, Sweet, Blob, Pink
+ * // Blob2, Saddy, Savory, Blob, Blue
+ *
+ * var table;
+ *
+ * function preload() {
+ * table = loadTable('assets/blobs.csv');
+ * }
+ *
+ * function setup() {
+ * createCanvas(200, 100);
+ * textAlign(CENTER);
+ * background(255);
+ * }
+ *
+ * function draw() {
+ * var numOfColumn = table.getColumnCount();
+ * text('There are ' + numOfColumn + ' columns in the table.', 100, 50);
+ * }
+ *
+ *
*/
p5.Table.prototype.getColumnCount = function() {
return this.columns.length;
@@ -59127,8 +64097,33 @@ p5.Table.prototype.getColumnCount = function() {
* Returns the total number of rows in a Table.
*
* @method getRowCount
- * @return {Number} Number of rows in this table
-
+ * @return {Integer} Number of rows in this table
+ * @example
+ *
+ *
+ * // given the cvs file "blobs.csv" in /assets directory
+ * //
+ * // ID, Name, Flavor, Shape, Color
+ * // Blob1, Blobby, Sweet, Blob, Pink
+ * // Blob2, Saddy, Savory, Blob, Blue
+ *
+ * var table;
+ *
+ * function preload() {
+ * table = loadTable('assets/blobs.csv');
+ * }
+ *
+ * function setup() {
+ * createCanvas(200, 100);
+ * textAlign(CENTER);
+ * background(255);
+ * }
+ *
+ * function draw() {
+ * text('There are ' + table.getRowCount() + ' rows in the table.', 100, 50);
+ * }
+ *
+ *
*/
p5.Table.prototype.getRowCount = function() {
return this.rows.length;
@@ -59143,20 +64138,45 @@ p5.Table.prototype.getRowCount = function() {
*
* @method removeTokens
* @param {String} chars String listing characters to be removed
- * @param {String|Number} [column] Column ID (number)
+ * @param {String|Integer} [column] Column ID (number)
* or name (string)
+ *
+ * @example
+ *
+ * function setup() {
+ * var table = new p5.Table();
+ *
+ * table.addColumn('name');
+ * table.addColumn('type');
+ *
+ * var newRow = table.addRow();
+ * newRow.setString('name', ' $Lion ,');
+ * newRow.setString('type', ',,,Mammal');
+ *
+ * newRow = table.addRow();
+ * newRow.setString('name', '$Snake ');
+ * newRow.setString('type', ',,,Reptile');
+ *
+ * table.removeTokens(',$ ');
+ * print(table.getArray());
+ * }
+ *
+ * // prints:
+ * // 0 "Lion" "Mamal"
+ * // 1 "Snake" "Reptile"
+ *
*/
p5.Table.prototype.removeTokens = function(chars, column) {
- var escape= function(s) {
- return s.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
+ var escape = function(s) {
+ return s.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');
};
var charArray = [];
for (var i = 0; i < chars.length; i++) {
- charArray.push( escape( chars.charAt(i) ) );
+ charArray.push(escape(chars.charAt(i)));
}
var regex = new RegExp(charArray.join('|'), 'g');
- if (typeof(column) === 'undefined'){
+ if (typeof column === 'undefined') {
for (var c = 0; c < this.columns.length; c++) {
for (var d = 0; d < this.rows.length; d++) {
var s = this.rows[d].arr[c];
@@ -59165,8 +64185,7 @@ p5.Table.prototype.removeTokens = function(chars, column) {
this.rows[d].obj[this.columns[c]] = s;
}
}
- }
- else if (typeof(column) === 'string'){
+ } else if (typeof column === 'string') {
for (var j = 0; j < this.rows.length; j++) {
var val = this.rows[j].obj[column];
val = val.replace(regex, '');
@@ -59174,8 +64193,7 @@ p5.Table.prototype.removeTokens = function(chars, column) {
var pos = this.columns.indexOf(column);
this.rows[j].arr[pos] = val;
}
- }
- else {
+ } else {
for (var k = 0; k < this.rows.length; k++) {
var str = this.rows[k].arr[column];
str = str.replace(regex, '');
@@ -59192,13 +64210,37 @@ p5.Table.prototype.removeTokens = function(chars, column) {
* may be referenced by either its ID or title.
*
* @method trim
- * @param {String|Number} column Column ID (number)
+ * @param {String|Integer} [column] Column ID (number)
* or name (string)
+ * @example
+ *
+ * function setup() {
+ * var table = new p5.Table();
+ *
+ * table.addColumn('name');
+ * table.addColumn('type');
+ *
+ * var newRow = table.addRow();
+ * newRow.setString('name', ' Lion ,');
+ * newRow.setString('type', ' Mammal ');
+ *
+ * newRow = table.addRow();
+ * newRow.setString('name', ' Snake ');
+ * newRow.setString('type', ' Reptile ');
+ *
+ * table.trim();
+ * print(table.getArray());
+ * }
+ *
+ * // prints:
+ * // 0 "Lion" "Mamal"
+ * // 1 "Snake" "Reptile"
+ *
*/
p5.Table.prototype.trim = function(column) {
- var regex = new RegExp( (' '), 'g');
+ var regex = new RegExp(' ', 'g');
- if (typeof(column) === 'undefined'){
+ if (typeof column === 'undefined') {
for (var c = 0; c < this.columns.length; c++) {
for (var d = 0; d < this.rows.length; d++) {
var s = this.rows[d].arr[c];
@@ -59207,8 +64249,7 @@ p5.Table.prototype.trim = function(column) {
this.rows[d].obj[this.columns[c]] = s;
}
}
- }
- else if (typeof(column) === 'string'){
+ } else if (typeof column === 'string') {
for (var j = 0; j < this.rows.length; j++) {
var val = this.rows[j].obj[column];
val = val.replace(regex, '');
@@ -59216,8 +64257,7 @@ p5.Table.prototype.trim = function(column) {
var pos = this.columns.indexOf(column);
this.rows[j].arr[pos] = val;
}
- }
- else {
+ } else {
for (var k = 0; k < this.rows.length; k++) {
var str = this.rows[k].arr[column];
str = str.replace(regex, '');
@@ -59228,118 +64268,115 @@ p5.Table.prototype.trim = function(column) {
};
/**
- * Use removeColumn() to remove an existing column from a Table
+ * Use removeColumn() to remove an existing column from a Table
* object. The column to be removed may be identified by either
* its title (a String) or its index value (an int).
* removeColumn(0) would remove the first column, removeColumn(1)
* would remove the second column, and so on.
*
* @method removeColumn
- * @param {String|Number} column columnName (string) or ID (number)
+ * @param {String|Integer} column columnName (string) or ID (number)
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * table.removeColumn("id");
- * print(table.getColumnCount());
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * table.removeColumn('id');
+ * print(table.getColumnCount());
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.removeColumn = function(c) {
var cString;
var cNumber;
- if (typeof(c) === 'string') {
+ if (typeof c === 'string') {
// find the position of c in the columns
cString = c;
cNumber = this.columns.indexOf(c);
- console.log('string');
- }
- else{
+ } else {
cNumber = c;
cString = this.columns[c];
}
- var chunk = this.columns.splice(cNumber+1, this.columns.length);
+ var chunk = this.columns.splice(cNumber + 1, this.columns.length);
this.columns.pop();
this.columns = this.columns.concat(chunk);
- for (var i = 0; i < this.rows.length; i++){
+ for (var i = 0; i < this.rows.length; i++) {
var tempR = this.rows[i].arr;
- var chip = tempR.splice(cNumber+1, tempR.length);
+ var chip = tempR.splice(cNumber + 1, tempR.length);
tempR.pop();
this.rows[i].arr = tempR.concat(chip);
delete this.rows[i].obj[cString];
}
-
};
-
/**
* Stores a value in the Table's specified row and column.
* The row is specified by its ID, while the column may be specified
* by either its ID or title.
*
* @method set
- * @param {String|Number} column column ID (Number)
+ * @param {Integer} row row ID
+ * @param {String|Integer} column column ID (Number)
* or title (String)
* @param {String|Number} value value to assign
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * table.set(0, "species", "Canis Lupus");
- * table.set(0, "name", "Wolf");
- *
- * //print the results
- * for (var r = 0; r < table.getRowCount(); r++)
- * for (var c = 0; c < table.getColumnCount(); c++)
- * print(table.getString(r, c));
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * table.set(0, 'species', 'Canis Lupus');
+ * table.set(0, 'name', 'Wolf');
+ *
+ * //print the results
+ * for (var r = 0; r < table.getRowCount(); r++)
+ * for (var c = 0; c < table.getColumnCount(); c++)
+ * print(table.getString(r, c));
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.set = function(row, column, value) {
this.rows[row].set(column, value);
@@ -59351,59 +64388,88 @@ p5.Table.prototype.set = function(row, column, value) {
* by either its ID or title.
*
* @method setNum
- * @param {Number} row row ID
- * @param {String|Number} column column ID (Number)
+ * @param {Integer} row row ID
+ * @param {String|Integer} column column ID (Number)
* or title (String)
* @param {Number} value value to assign
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * table.setNum(1, "id", 1);
- *
- * print(table.getColumn(0));
- * //["0", 1, "2"]
- * }
- *
- *
- *
- *@alt
- * no image displayed
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * table.setNum(1, 'id', 1);
+ *
+ * print(table.getColumn(0));
+ * //["0", 1, "2"]
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
*/
-p5.Table.prototype.setNum = function(row, column, value){
+p5.Table.prototype.setNum = function(row, column, value) {
this.rows[row].setNum(column, value);
};
-
/**
* Stores a String value in the Table's specified row and column.
* The row is specified by its ID, while the column may be specified
* by either its ID or title.
*
* @method setString
- * @param {Number} row row ID
- * @param {String|Number} column column ID (Number)
+ * @param {Integer} row row ID
+ * @param {String|Integer} column column ID (Number)
* or title (String)
* @param {String} value value to assign
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * //add a row
+ * var newRow = table.addRow();
+ * newRow.setString('id', table.getRowCount() - 1);
+ * newRow.setString('species', 'Canis Lupus');
+ * newRow.setString('name', 'Wolf');
+ *
+ * print(table.getArray());
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
-p5.Table.prototype.setString = function(row, column, value){
+p5.Table.prototype.setString = function(row, column, value) {
this.rows[row].setString(column, value);
};
@@ -59413,42 +64479,42 @@ p5.Table.prototype.setString = function(row, column, value){
* either its ID or title.
*
* @method get
- * @param {Number} row row ID
- * @param {String|Number} column columnName (string) or
+ * @param {Integer} row row ID
+ * @param {String|Integer} column columnName (string) or
* ID (number)
* @return {String|Number}
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * print(table.get(0, 1));
- * //Capra hircus
- * print(table.get(0, "species"));
- * //Capra hircus
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * print(table.get(0, 1));
+ * //Capra hircus
+ * print(table.get(0, 'species'));
+ * //Capra hircus
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.get = function(row, column) {
return this.rows[row].get(column);
@@ -59460,40 +64526,40 @@ p5.Table.prototype.get = function(row, column) {
* either its ID or title.
*
* @method getNum
- * @param {Number} row row ID
- * @param {String|Number} column columnName (string) or
+ * @param {Integer} row row ID
+ * @param {String|Integer} column columnName (string) or
* ID (number)
* @return {Number}
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * print(table.getNum(1, 0) + 100);
- * //id 1 + 100 = 101
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * print(table.getNum(1, 0) + 100);
+ * //id 1 + 100 = 101
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
p5.Table.prototype.getNum = function(row, column) {
return this.rows[row].getNum(column);
@@ -59505,44 +64571,49 @@ p5.Table.prototype.getNum = function(row, column) {
* either its ID or title.
*
* @method getString
- * @param {Number} row row ID
- * @param {String|Number} column columnName (string) or
+ * @param {Integer} row row ID
+ * @param {String|Integer} column columnName (string) or
* ID (number)
* @return {String}
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * var tableArray = table.getArray();
- *
- * //output each row as array
- * for (var i = 0; i < tableArray.length; i++)
- * print(tableArray[i]);
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * // table is comma separated value "CSV"
+ * // and has specifiying header for column labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * print(table.getString(0, 0)); // 0
+ * print(table.getString(0, 1)); // Capra hircus
+ * print(table.getString(0, 2)); // Goat
+ * print(table.getString(1, 0)); // 1
+ * print(table.getString(1, 1)); // Panthera pardus
+ * print(table.getString(1, 2)); // Leopard
+ * print(table.getString(2, 0)); // 2
+ * print(table.getString(2, 1)); // Equus zebra
+ * print(table.getString(2, 2)); // Zebra
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
+
p5.Table.prototype.getString = function(row, column) {
return this.rows[row].getString(column);
};
@@ -59553,56 +64624,58 @@ p5.Table.prototype.getString = function(row, column) {
* title.
*
* @method getObject
- * @param {String} headerColumn Name of the column which should be used to
+ * @param {String} [headerColumn] Name of the column which should be used to
* title each row object (optional)
* @return {Object}
*
* @example
- *
- *
- * // Given the CSV file "mammals.csv"
- * // in the project's "assets" folder:
- * //
- * // id,species,name
- * // 0,Capra hircus,Goat
- * // 1,Panthera pardus,Leopard
- * // 2,Equus zebra,Zebra
- *
- * var table;
- *
- * function preload() {
- * //my table is comma separated value "csv"
- * //and has a header specifying the columns labels
- * table = loadTable("assets/mammals.csv", "csv", "header");
- * }
- *
- * function setup() {
- * var tableObject = table.getObject();
- *
- * print(tableObject);
- * //outputs an object
- * }
- *
- *
- *
- *@alt
- * no image displayed
- *
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var tableObject = table.getObject();
+ *
+ * print(tableObject);
+ * //outputs an object
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
-p5.Table.prototype.getObject = function (headerColumn) {
+p5.Table.prototype.getObject = function(headerColumn) {
var tableObject = {};
var obj, cPos, index;
- for(var i = 0; i < this.rows.length; i++) {
+ for (var i = 0; i < this.rows.length; i++) {
obj = this.rows[i].obj;
- if (typeof(headerColumn) === 'string'){
+ if (typeof headerColumn === 'string') {
cPos = this.columns.indexOf(headerColumn); // index of columnID
if (cPos >= 0) {
index = obj[headerColumn];
tableObject[index] = obj;
} else {
- throw 'This table has no column named "' + headerColumn +'"';
+ throw new Error(
+ 'This table has no column named "' + headerColumn + '"'
+ );
}
} else {
tableObject[i] = this.rows[i].obj;
@@ -59616,10 +64689,42 @@ p5.Table.prototype.getObject = function (headerColumn) {
*
* @method getArray
* @return {Array}
+ *
+ * @example
+ *
+ *
+ * // Given the CSV file "mammals.csv"
+ * // in the project's "assets" folder
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leoperd
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * // table is comma separated value "CSV"
+ * // and has specifiying header for column labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var tableArray = table.getArray();
+ * for (var i = 0; i < tableArray.length; i++) {
+ * print(tableArray[i]);
+ * }
+ * }
+ *
+ *
+ *
+ *@alt
+ * no image displayed
+ *
*/
-p5.Table.prototype.getArray = function () {
+p5.Table.prototype.getArray = function() {
var tableArray = [];
- for(var i = 0; i < this.rows.length; i++) {
+ for (var i = 0; i < this.rows.length; i++) {
tableArray.push(this.rows[i].arr);
}
return tableArray;
@@ -59627,7 +64732,7 @@ p5.Table.prototype.getArray = function () {
module.exports = p5;
-},{"../core/core":55}],81:[function(_dereq_,module,exports){
+},{"../core/main":25}],50:[function(_dereq_,module,exports){
/**
* @module IO
* @submodule Table
@@ -59636,7 +64741,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* A TableRow object represents a single row of data values,
@@ -59652,14 +64757,14 @@ var p5 = _dereq_('../core/core');
* separator
* @param {String} [separator] comma separated values (csv) by default
*/
-p5.TableRow = function (str, separator) {
+p5.TableRow = function(str, separator) {
var arr = [];
var obj = {};
- if (str){
+ if (str) {
separator = separator || ',';
arr = str.split(separator);
}
- for (var i = 0; i < arr.length; i++){
+ for (var i = 0; i < arr.length; i++) {
var key = i;
var val = arr[i];
obj[key] = val;
@@ -59667,7 +64772,6 @@ p5.TableRow = function (str, separator) {
this.arr = arr;
this.obj = obj;
this.table = null;
- this.name = 'p5.TableRow'; // for friendly debugger system
};
/**
@@ -59675,64 +64779,150 @@ p5.TableRow = function (str, separator) {
* The column may be specified by either its ID or title.
*
* @method set
- * @param {String|Number} column Column ID (Number)
+ * @param {String|Integer} column Column ID (Number)
* or Title (String)
* @param {String|Number} value The value to be stored
+ *
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var rows = table.getRows();
+ * for (var r = 0; r < rows.length; r++) {
+ * rows[r].set('name', 'Unicorn');
+ * }
+ *
+ * //print the results
+ * print(table.getArray());
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
p5.TableRow.prototype.set = function(column, value) {
// if typeof column is string, use .obj
- if (typeof(column) === 'string'){
+ if (typeof column === 'string') {
var cPos = this.table.columns.indexOf(column); // index of columnID
if (cPos >= 0) {
this.obj[column] = value;
this.arr[cPos] = value;
+ } else {
+ throw new Error('This table has no column named "' + column + '"');
}
- else {
- throw 'This table has no column named "' + column +'"';
- }
- }
-
- // if typeof column is number, use .arr
- else {
+ } else {
+ // if typeof column is number, use .arr
if (column < this.table.columns.length) {
this.arr[column] = value;
var cTitle = this.table.columns[column];
this.obj[cTitle] = value;
- }
- else {
- throw 'Column #' + column + ' is out of the range of this table';
+ } else {
+ throw new Error(
+ 'Column #' + column + ' is out of the range of this table'
+ );
}
}
};
-
/**
* Stores a Float value in the TableRow's specified column.
* The column may be specified by either its ID or title.
*
* @method setNum
- * @param {String|Number} column Column ID (Number)
+ * @param {String|Integer} column Column ID (Number)
* or Title (String)
- * @param {Number} value The value to be stored
+ * @param {Number|String} value The value to be stored
* as a Float
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var rows = table.getRows();
+ * for (var r = 0; r < rows.length; r++) {
+ * rows[r].setNum('id', r + 10);
+ * }
+ *
+ * print(table.getArray());
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
-p5.TableRow.prototype.setNum = function(column, value){
+p5.TableRow.prototype.setNum = function(column, value) {
var floatVal = parseFloat(value);
this.set(column, floatVal);
};
-
/**
* Stores a String value in the TableRow's specified column.
* The column may be specified by either its ID or title.
*
* @method setString
- * @param {String|Number} column Column ID (Number)
+ * @param {String|Integer} column Column ID (Number)
* or Title (String)
- * @param {String} value The value to be stored
+ * @param {String|Number|Boolean|Object} value The value to be stored
* as a String
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var rows = table.getRows();
+ * for (var r = 0; r < rows.length; r++) {
+ * var name = rows[r].getString('name');
+ * rows[r].setString('name', 'A ' + name + ' named George');
+ * }
+ *
+ * print(table.getArray());
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
-p5.TableRow.prototype.setString = function(column, value){
+p5.TableRow.prototype.setString = function(column, value) {
var stringVal = value.toString();
this.set(column, stringVal);
};
@@ -59742,12 +64932,43 @@ p5.TableRow.prototype.setString = function(column, value){
* The column may be specified by either its ID or title.
*
* @method get
- * @param {String|Number} column columnName (string) or
+ * @param {String|Integer} column columnName (string) or
* ID (number)
* @return {String|Number}
+ *
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var names = [];
+ * var rows = table.getRows();
+ * for (var r = 0; r < rows.length; r++) {
+ * names.push(rows[r].get('name'));
+ * }
+ *
+ * print(names);
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
p5.TableRow.prototype.get = function(column) {
- if (typeof(column) === 'string'){
+ if (typeof column === 'string') {
return this.obj[column];
} else {
return this.arr[column];
@@ -59760,20 +64981,52 @@ p5.TableRow.prototype.get = function(column) {
* title.
*
* @method getNum
- * @param {String|Number} column columnName (string) or
+ * @param {String|Integer} column columnName (string) or
* ID (number)
* @return {Number} Float Floating point number
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var rows = table.getRows();
+ * var minId = Infinity;
+ * var maxId = -Infinity;
+ * for (var r = 0; r < rows.length; r++) {
+ * var id = rows[r].getNum('id');
+ * minId = min(minId, id);
+ * maxId = min(maxId, id);
+ * }
+ * print('minimum id = ' + minId + ', maximum id = ' + maxId);
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
p5.TableRow.prototype.getNum = function(column) {
var ret;
- if (typeof(column) === 'string'){
+ if (typeof column === 'string') {
ret = parseFloat(this.obj[column]);
} else {
ret = parseFloat(this.arr[column]);
}
if (ret.toString() === 'NaN') {
- throw 'Error: ' + this.obj[column]+ ' is NaN (Not a Number)';
+ throw 'Error: ' + this.obj[column] + ' is NaN (Not a Number)';
}
return ret;
};
@@ -59784,12 +65037,45 @@ p5.TableRow.prototype.getNum = function(column) {
* title.
*
* @method getString
- * @param {String|Number} column columnName (string) or
+ * @param {String|Integer} column columnName (string) or
* ID (number)
* @return {String} String
+ * @example
+ *
+ * // Given the CSV file "mammals.csv" in the project's "assets" folder:
+ * //
+ * // id,species,name
+ * // 0,Capra hircus,Goat
+ * // 1,Panthera pardus,Leopard
+ * // 2,Equus zebra,Zebra
+ *
+ * var table;
+ *
+ * function preload() {
+ * //my table is comma separated value "csv"
+ * //and has a header specifying the columns labels
+ * table = loadTable('assets/mammals.csv', 'csv', 'header');
+ * }
+ *
+ * function setup() {
+ * var rows = table.getRows();
+ * var longest = '';
+ * for (var r = 0; r < rows.length; r++) {
+ * var species = rows[r].getString('species');
+ * if (longest.length < species.length) {
+ * longest = species;
+ * }
+ * }
+ *
+ * print('longest: ' + longest);
+ * }
+ *
+ *
+ * @alt
+ * no image displayed
*/
p5.TableRow.prototype.getString = function(column) {
- if (typeof(column) === 'string'){
+ if (typeof column === 'string') {
return this.obj[column].toString();
} else {
return this.arr[column].toString();
@@ -59798,7 +65084,7 @@ p5.TableRow.prototype.getString = function(column) {
module.exports = p5;
-},{"../core/core":55}],82:[function(_dereq_,module,exports){
+},{"../core/main":25}],51:[function(_dereq_,module,exports){
/**
* @module IO
* @submodule XML
@@ -59807,11 +65093,11 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* XML is a representation of an XML object, able to parse XML code. Use
- * loadXML() to load external XML files and create XML objects.
+ * loadXML() to load external XML files and create XML objects.
*
* @class p5.XML
* @constructor
@@ -59830,17 +65116,17 @@ var p5 = _dereq_('../core/core');
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var children = xml.getChildren("animal");
+ * var children = xml.getChildren('animal');
*
* for (var i = 0; i < children.length; i++) {
- * var id = children[i].getNum("id");
- * var coloring = children[i].getString("species");
+ * var id = children[i].getNum('id');
+ * var coloring = children[i].getString('species');
* var name = children[i].getContent();
- * print(id + ", " + coloring + ", " + name);
+ * print(id + ', ' + coloring + ', ' + name);
* }
* }
*
@@ -59849,24 +65135,22 @@ var p5 = _dereq_('../core/core');
* // 1, Panthera pardus, Leopard
* // 2, Equus zebra, Zebra
*
- *
- * @alt
- * no image displayed
- *
+ *
+ * @alt
+ * no image displayed
+ *
*/
-p5.XML = function () {
+p5.XML = function() {
this.name = null; //done
this.attributes = {}; //done
this.children = [];
this.parent = null;
this.content = null; //done
- this.name = 'p5.XML'; // for friendly debugger system
};
-
/**
* Gets a copy of the element's parent. Returns the parent as another
- * p5.XML object.
+ * p5.XML object.
*
* @method getParent
* @return {p5.XML} element parent
@@ -59885,11 +65169,11 @@ p5.XML = function () {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var children = xml.getChildren("animal");
+ * var children = xml.getChildren('animal');
* var parent = children[1].getParent();
* print(parent.getName());
* }
@@ -59922,7 +65206,7 @@ p5.XML.prototype.getParent = function() {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
@@ -59957,12 +65241,12 @@ p5.XML.prototype.getName = function() {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
* print(xml.getName());
- * xml.setName("fish");
+ * xml.setName('fish');
* print(xml.getName());
* }
*
@@ -59996,7 +65280,7 @@ p5.XML.prototype.setName = function(name) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
@@ -60013,7 +65297,7 @@ p5.XML.prototype.hasChildren = function() {
/**
* Get the names of all of the element's children, and returns the names as an
- * array of Strings. This is the same as looping through and calling getName()
+ * array of Strings. This is the same as looping through and calling getName()
* on each child element individually.
*
* @method listChildren
@@ -60033,7 +65317,7 @@ p5.XML.prototype.hasChildren = function() {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
@@ -60045,11 +65329,13 @@ p5.XML.prototype.hasChildren = function() {
*
*/
p5.XML.prototype.listChildren = function() {
- return this.children.map(function(c) { return c.name; });
+ return this.children.map(function(c) {
+ return c.name;
+ });
};
/**
- * Returns all of the element's children as an array of p5.XML objects. When
+ * Returns all of the element's children as an array of p5.XML objects. When
* the name parameter is specified, then it will return all children that match
* that name.
*
@@ -60071,11 +65357,11 @@ p5.XML.prototype.listChildren = function() {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var animals = xml.getChildren("animal");
+ * var animals = xml.getChildren('animal');
*
* for (var i = 0; i < animals.length; i++) {
* print(animals[i].getContent());
@@ -60090,9 +65376,10 @@ p5.XML.prototype.listChildren = function() {
*/
p5.XML.prototype.getChildren = function(param) {
if (param) {
- return this.children.filter(function(c) { return c.name === param; });
- }
- else {
+ return this.children.filter(function(c) {
+ return c.name === param;
+ });
+ } else {
return this.children;
}
};
@@ -60103,7 +65390,7 @@ p5.XML.prototype.getChildren = function(param) {
* child is found.
*
* @method getChild
- * @param {String|Number} name element name or index
+ * @param {String|Integer} name element name or index
* @return {p5.XML}
* @example<animal
*
@@ -60120,11 +65407,11 @@ p5.XML.prototype.getChildren = function(param) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
+ * var firstChild = xml.getChild('animal');
* print(firstChild.getContent());
* }
*
@@ -60135,7 +65422,7 @@ p5.XML.prototype.getChildren = function(param) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
@@ -60148,12 +65435,12 @@ p5.XML.prototype.getChildren = function(param) {
*
*/
p5.XML.prototype.getChild = function(param) {
- if(typeof param === 'string') {
- return this.children.find(function(c) {
- return c.name === param;
- });
- }
- else {
+ if (typeof param === 'string') {
+ for (var i = 0; i < this.children.length; i++) {
+ var child = this.children[i];
+ if (child.name === param) return child;
+ }
+ } else {
return this.children[param];
}
};
@@ -60161,11 +65448,45 @@ p5.XML.prototype.getChild = function(param) {
/**
* Appends a new child to the element. The child can be specified with
* either a String, which will be used as the new tag's name, or as a
- * reference to an existing p5.XML object.
- * A reference to the newly created child is returned as an p5.XML object.
+ * reference to an existing p5.XML object.
+ * A reference to the newly created child is returned as an p5.XML object.
*
* @method addChild
- * @param {p5.XML} a p5.XML Object which will be the child to be added
+ * @param {p5.XML} node a p5.XML Object which will be the child to be added
+ * @example
+ *
+ * // The following short XML file called "mammals.xml" is parsed
+ * // in the code below.
+ * //
+ * //
+ * // <mammals>
+ * // <animal id="0" species="Capra hircus">Goat</animal>
+ * // <animal id="1" species="Panthera pardus">Leopard</animal>
+ * // <animal id="2" species="Equus zebra">Zebra</animal>
+ * // </mammals>
+ *
+ * var xml;
+ *
+ * function preload() {
+ * xml = loadXML('assets/mammals.xml');
+ * }
+ *
+ * function setup() {
+ * var child = new p5.XML();
+ * child.setAttribute('id', '3');
+ * child.setAttribute('species', 'Ornithorhynchus anatinus');
+ * child.setContent('Platypus');
+ * xml.addChild(child);
+ *
+ * var animals = xml.getChildren('animal');
+ * print(animals[animals.length - 1].getContent());
+ * }
+ *
+ * // Sketch prints:
+ * // "Goat"
+ * // "Leopard"
+ * // "Zebra"
+ *
*/
p5.XML.prototype.addChild = function(node) {
if (node instanceof p5.XML) {
@@ -60179,7 +65500,7 @@ p5.XML.prototype.addChild = function(node) {
* Removes the element specified by name or index.
*
* @method removeChild
- * @param {String|Number} name element name or index
+ * @param {String|Integer} name element name or index
* @example
*
* // The following short XML file called "mammals.xml" is parsed
@@ -60195,13 +65516,13 @@ p5.XML.prototype.addChild = function(node) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * xml.removeChild("animal");
+ * xml.removeChild('animal');
* var children = xml.getChildren();
- * for (var i=0; i
* // The following short XML file called "mammals.xml" is parsed
@@ -60268,11 +65588,11 @@ p5.XML.prototype.removeChild = function(param) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
+ * var firstChild = xml.getChild('animal');
* print(firstChild.getAttributeCount());
* }
*
@@ -60305,11 +65625,11 @@ p5.XML.prototype.getAttributeCount = function() {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
+ * var firstChild = xml.getChild('animal');
* print(firstChild.listAttributes());
* }
*
@@ -60342,13 +65662,13 @@ p5.XML.prototype.listAttributes = function() {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
- * print(firstChild.hasAttribute("species"));
- * print(firstChild.hasAttribute("color"));
+ * var firstChild = xml.getChild('animal');
+ * print(firstChild.hasAttribute('species'));
+ * print(firstChild.hasAttribute('color'));
* }
*
* // Sketch prints:
@@ -60385,12 +65705,12 @@ p5.XML.prototype.hasAttribute = function(name) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
- * print(firstChild.getNum("id"));
+ * var firstChild = xml.getChild('animal');
+ * print(firstChild.getNum('id'));
* }
*
* // Sketch prints:
@@ -60410,7 +65730,7 @@ p5.XML.prototype.getNum = function(name, defaultValue) {
* @method getString
* @param {String} name the non-null full name of the attribute
* @param {Number} [defaultValue] the default value of the attribute
- * @return {Number}
+ * @return {String}
* @example
*
* // The following short XML file called "mammals.xml" is parsed
@@ -60426,12 +65746,12 @@ p5.XML.prototype.getNum = function(name, defaultValue) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
- * print(firstChild.getString("species"));
+ * var firstChild = xml.getChild('animal');
+ * print(firstChild.getString('species'));
* }
*
* // Sketch prints:
@@ -60448,7 +65768,7 @@ p5.XML.prototype.getString = function(name, defaultValue) {
*
* @method setAttribute
* @param {String} name the full name of the attribute
- * @param {Number} value the value of the attribute
+ * @param {Number|String|Boolean} value the value of the attribute
* @example
*
* // The following short XML file called "mammals.xml" is parsed
@@ -60464,14 +65784,14 @@ p5.XML.prototype.getString = function(name, defaultValue) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
- * print(firstChild.getString("species"));
- * firstChild.setAttribute("species", "Jamides zebra");
- * print(firstChild.getString("species"));
+ * var firstChild = xml.getChild('animal');
+ * print(firstChild.getString('species'));
+ * firstChild.setAttribute('species', 'Jamides zebra');
+ * print(firstChild.getString('species'));
* }
*
* // Sketch prints:
@@ -60507,11 +65827,11 @@ p5.XML.prototype.setAttribute = function(name, value) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
+ * var firstChild = xml.getChild('animal');
* print(firstChild.getContent());
* }
*
@@ -60543,13 +65863,13 @@ p5.XML.prototype.getContent = function(defaultValue) {
* var xml;
*
* function preload() {
- * xml = loadXML("assets/mammals.xml");
+ * xml = loadXML('assets/mammals.xml');
* }
*
* function setup() {
- * var firstChild = xml.getChild("animal");
+ * var firstChild = xml.getChild('animal');
* print(firstChild.getContent());
- * firstChild.setContent("Mountain Goat");
+ * firstChild.setContent('Mountain Goat');
* print(firstChild.getContent());
* }
*
@@ -60558,8 +65878,8 @@ p5.XML.prototype.getContent = function(defaultValue) {
* // "Mountain Goat"
*
*/
-p5.XML.prototype.setContent = function( content ) {
- if(!this.children.length) {
+p5.XML.prototype.setContent = function(content) {
+ if (!this.children.length) {
this.content = content;
}
};
@@ -60585,19 +65905,24 @@ p5.XML.prototype._setCont = function(content) {
/**
* This method is called while the parsing of XML (when loadXML() is
* called). The XML node is passed and its attributes are stored in the
- * p5.XML's attribute Object.
+ * p5.XML's attribute Object.
*
*/
p5.XML.prototype._setAttributes = function(node) {
- var i, att = {};
- for( i = 0; i < node.attributes.length; i++) {
- att[node.attributes[i].nodeName] = node.attributes[i].nodeValue;
+ var att = {};
+ var attributes = node.attributes;
+ if (attributes) {
+ for (var i = 0; i < attributes.length; i++) {
+ var attribute = attributes[i];
+ att[attribute.nodeName] = attribute.nodeValue;
+ }
}
this.attributes = att;
};
module.exports = p5;
-},{"../core/core":55}],83:[function(_dereq_,module,exports){
+
+},{"../core/main":25}],52:[function(_dereq_,module,exports){
/**
* @module Math
* @submodule Calculation
@@ -60607,7 +65932,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* Calculates the absolute value (magnitude) of a number. Maps to Math.abs().
@@ -60640,7 +65965,7 @@ p5.prototype.abs = Math.abs;
*
* @method ceil
* @param {Number} n number to round up
- * @return {Number} rounded up number
+ * @return {Integer} rounded up number
* @example
*
* function draw() {
@@ -60650,7 +65975,7 @@ p5.prototype.abs = Math.abs;
* var ay = 66;
*
* //Get the ceiling of the mapped number.
- * var bx = ceil(map(mouseX, 0, 100, 0,5));
+ * var bx = ceil(map(mouseX, 0, 100, 0, 5));
* var by = 33;
*
* // Multiply the mapped numbers by 20 to more easily
@@ -60662,11 +65987,11 @@ p5.prototype.abs = Math.abs;
*
* // Reformat the float returned by map and draw it.
* noStroke();
- * text(nfc(ax, 2,2), ax, ay - 5);
- * text(nfc(bx,1,1), bx, by - 5);
+ * text(nfc(ax, 2), ax, ay - 5);
+ * text(nfc(bx, 1), bx, by - 5);
* }
*
- *
+ *
* @alt
* 2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals
*
@@ -60703,9 +66028,9 @@ p5.prototype.ceil = Math.ceil;
* // Draw xm and xc as circles.
* noStroke();
* fill(150);
- * ellipse(xm, 33, 9,9); // Not Constrained
+ * ellipse(xm, 33, 9, 9); // Not Constrained
* fill(0);
- * ellipse(xc, 66, 9,9); // Constrained
+ * ellipse(xc, 66, 9, 9); // Constrained
* }
*
*
@@ -60714,6 +66039,7 @@ p5.prototype.ceil = Math.ceil;
*
*/
p5.prototype.constrain = function(n, low, high) {
+ p5._validateParameters('constrain', arguments);
return Math.max(Math.min(n, high), low);
};
@@ -60726,16 +66052,7 @@ p5.prototype.constrain = function(n, low, high) {
* @param {Number} x2 x-coordinate of the second point
* @param {Number} y2 y-coordinate of the second point
* @return {Number} distance between the two points
- */
-/**
- * @method dist
- * @param {Number} x1
- * @param {Number} y1
- * @param {Number} z1 z-coordinate of the first point
- * @param {Number} x2
- * @param {Number} y2
- * @param {Number} z2 z-coordinate of the second point
- * @return {Number} distance between the two points
+ *
* @example
*
* // Move your mouse inside the canvas to see the
@@ -60759,9 +66076,9 @@ p5.prototype.constrain = function(n, low, high) {
*
* // Let's write d along the line we are drawing!
* push();
- * translate( (x1+x2)/2, (y1+y2)/2 );
- * rotate( atan2(y2-y1,x2-x1) );
- * text(nfc(d,1,1), 0, -5);
+ * translate((x1 + x2) / 2, (y1 + y2) / 2);
+ * rotate(atan2(y2 - y1, x2 - x1));
+ * text(nfc(d, 1), 0, -5);
* pop();
* // Fancy!
* }
@@ -60769,15 +66086,29 @@ p5.prototype.constrain = function(n, low, high) {
*
* @alt
* 2 ellipses joined by line. 1 ellipse moves with mouse X&Y. Distance displayed.
- *
+ */
+/**
+ * @method dist
+ * @param {Number} x1
+ * @param {Number} y1
+ * @param {Number} z1 z-coordinate of the first point
+ * @param {Number} x2
+ * @param {Number} y2
+ * @param {Number} z2 z-coordinate of the second point
+ * @return {Number} distance between the two points
*/
p5.prototype.dist = function() {
- if (arguments.length === 4) { //2D
- return hypot(arguments[2]-arguments[0], arguments[3]-arguments[1]);
- } else if (arguments.length === 6) { //3D
- return hypot(arguments[3]-arguments[0],
- arguments[4]-arguments[1],
- arguments[5]-arguments[2]);
+ p5._validateParameters('dist', arguments);
+ if (arguments.length === 4) {
+ //2D
+ return hypot(arguments[2] - arguments[0], arguments[3] - arguments[1]);
+ } else if (arguments.length === 6) {
+ //3D
+ return hypot(
+ arguments[3] - arguments[0],
+ arguments[4] - arguments[1],
+ arguments[5] - arguments[2]
+ );
}
};
@@ -60799,13 +66130,13 @@ p5.prototype.dist = function() {
*
* var y = map(yValue, 0, 8, height, 0);
*
- * var legend = "exp (" + nfc(xValue, 3) +")\n= " + nf(yValue, 1, 4);
+ * var legend = 'exp (' + nfc(xValue, 3) + ')\n= ' + nf(yValue, 1, 4);
* stroke(150);
* line(mouseX, y, mouseX, height);
* fill(0);
* text(legend, 5, 15);
* noStroke();
- * ellipse (mouseX,y, 7, 7);
+ * ellipse(mouseX, y, 7, 7);
*
* // Draw the exp(x) curve,
* // over the domain of x from 0 to 2
@@ -60821,7 +66152,7 @@ p5.prototype.dist = function() {
*
* endShape();
* line(0, 0, 0, height);
- * line(0, height-1, width, height-1);
+ * line(0, height - 1, width, height - 1);
* }
*
*
@@ -60837,7 +66168,7 @@ p5.prototype.exp = Math.exp;
*
* @method floor
* @param {Number} n number to round down
- * @return {Number} rounded down number
+ * @return {Integer} rounded down number
* @example
*
* function draw() {
@@ -60847,7 +66178,7 @@ p5.prototype.exp = Math.exp;
* var ay = 66;
*
* //Get the floor of the mapped number.
- * var bx = floor(map(mouseX, 0, 100, 0,5));
+ * var bx = floor(map(mouseX, 0, 100, 0, 5));
* var by = 33;
*
* // Multiply the mapped numbers by 20 to more easily
@@ -60859,8 +66190,8 @@ p5.prototype.exp = Math.exp;
*
* // Reformat the float returned by map and draw it.
* noStroke();
- * text(nfc(ax, 2,2), ax, ay - 5);
- * text(nfc(bx,1,1), bx, by - 5);
+ * text(nfc(ax, 2), ax, ay - 5);
+ * text(nfc(bx, 1), bx, by - 5);
* }
*
*
@@ -60888,11 +66219,11 @@ p5.prototype.floor = Math.floor;
* background(200);
* var a = 20;
* var b = 80;
- * var c = lerp(a,b, .2);
- * var d = lerp(a,b, .5);
- * var e = lerp(a,b, .8);
+ * var c = lerp(a, b, 0.2);
+ * var d = lerp(a, b, 0.5);
+ * var e = lerp(a, b, 0.8);
*
- * var y = 50
+ * var y = 50;
*
* strokeWeight(5);
* stroke(0); // Draw the original points in black
@@ -60911,7 +66242,8 @@ p5.prototype.floor = Math.floor;
*
*/
p5.prototype.lerp = function(start, stop, amt) {
- return amt*(stop-start)+start;
+ p5._validateParameters('lerp', arguments);
+ return amt * (stop - start) + start;
};
/**
@@ -60931,18 +66263,19 @@ p5.prototype.lerp = function(start, stop, amt) {
*
* // Compute the natural log of a value between 0 and maxX
* var xValue = map(mouseX, 0, width, 0, maxX);
- * if (xValue > 0) { // Cannot take the log of a negative number.
+ * if (xValue > 0) {
+ // Cannot take the log of a negative number.
* var yValue = log(xValue);
* var y = map(yValue, -maxY, maxY, height, 0);
*
* // Display the calculation occurring.
- * var legend = "log(" + nf(xValue, 1, 2) + ")\n= " + nf(yValue, 1, 3);
+ * var legend = 'log(' + nf(xValue, 1, 2) + ')\n= ' + nf(yValue, 1, 3);
* stroke(150);
* line(mouseX, y, mouseX, height);
* fill(0);
- * text (legend, 5, 15);
+ * text(legend, 5, 15);
* noStroke();
- * ellipse (mouseX, y, 7, 7);
+ * ellipse(mouseX, y, 7, 7);
* }
*
* // Draw the log(x) curve,
@@ -60950,15 +66283,15 @@ p5.prototype.lerp = function(start, stop, amt) {
* noFill();
* stroke(0);
* beginShape();
- * for(var x=0; x < width; x++) {
+ * for (var x = 0; x < width; x++) {
* xValue = map(x, 0, width, 0, maxX);
* yValue = log(xValue);
* y = map(yValue, -maxY, maxY, height, 0);
* vertex(x, y);
* }
* endShape();
- * line(0,0,0,height);
- * line(0,height/2,width, height/2);
+ * line(0, 0, 0, height);
+ * line(0, height / 2, width, height / 2);
* }
*
*
@@ -60972,7 +66305,7 @@ p5.prototype.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 the coordinate 0,0 to its x,y value. Therefore, mag() is
+ * the distance from the coordinate 0,0 to its x,y value. Therefore, mag() is
* a shortcut for writing dist(0, 0, x, y).
*
* @method mag
@@ -60988,13 +66321,13 @@ p5.prototype.log = Math.log;
* var y2 = 70;
*
* line(0, 0, x1, y1);
- * print(mag(x1, y1)); // Prints "36.05551275463989"
+ * print(mag(x1, y1)); // Prints "36.05551275463989"
* line(0, 0, x2, y1);
- * print(mag(x2, y1)); // Prints "85.44003745317531"
+ * print(mag(x2, y1)); // Prints "85.44003745317531"
* line(0, 0, x1, y2);
- * print(mag(x1, y2)); // Prints "72.80109889280519"
+ * print(mag(x1, y2)); // Prints "72.80109889280519"
* line(0, 0, x2, y2);
- * print(mag(x2, y2)); // Prints "106.3014581273465"
+ * print(mag(x2, y2)); // Prints "106.3014581273465"
* }
*
*
@@ -61003,6 +66336,7 @@ p5.prototype.log = Math.log;
*
*/
p5.prototype.mag = function(x, y) {
+ p5._validateParameters('mag', arguments);
return hypot(x, y);
};
@@ -61023,34 +66357,35 @@ p5.prototype.mag = function(x, y) {
* @return {Number} remapped number
* @example
*
- * var value = 25;
- * var m = map(value, 0, 100, 0, width);
- * ellipse(m, 50, 10, 10);
- *
+ * var value = 25;
+ * var m = map(value, 0, 100, 0, width);
+ * ellipse(m, 50, 10, 10);
+
*
*
- * function setup() {
- * noStroke();
- * }
+ * function setup() {
+ * noStroke();
+ * }
*
- * function draw() {
- * background(204);
- * var x1 = map(mouseX, 0, width, 25, 75);
- * ellipse(x1, 25, 25, 25);
- * //This ellipse is constrained to the 0-100 range
- * //after setting withinBounds to true
- * var x2 = map(mouseX, 0, width, 0, 100, true);
- * ellipse(x2, 75, 25, 25);
- * }
- *
+ * function draw() {
+ * background(204);
+ * var x1 = map(mouseX, 0, width, 25, 75);
+ * ellipse(x1, 25, 25, 25);
+ * //This ellipse is constrained to the 0-100 range
+ * //after setting withinBounds to true
+ * var x2 = map(mouseX, 0, width, 0, 100, true);
+ * ellipse(x2, 75, 25, 25);
+ * }
+
*
* @alt
* 10 by 10 white ellipse with in mid left canvas
* 2 25 by 25 white ellipses move with mouse x. Bottom has more range from X
*
*/
-p5.prototype.map = function (n, start1, stop1, start2, stop2, withinBounds) {
- var newval = ((n - start1)/(stop1 - start1)) * (stop2 - start2) + start2;
+p5.prototype.map = function(n, start1, stop1, start2, stop2, withinBounds) {
+ p5._validateParameters('map', arguments);
+ var newval = (n - start1) / (stop1 - start1) * (stop2 - start2) + start2;
if (!withinBounds) {
return newval;
}
@@ -61063,29 +66398,30 @@ p5.prototype.map = function (n, start1, stop1, start2, stop2, withinBounds) {
/**
* Determines the largest value in a sequence of numbers, and then returns
- * that value. max() accepts any number of Number parameters, or an Array
+ * that value. max() accepts any number of Number parameters, or an Array
* of any length.
*
* @method max
- * @param {Number|Array} n0 Numbers to compare
- * @return {Number} maximum Number
+ * @param {Number} n0 Number to compare
+ * @param {Number} n1 Number to compare
+ * @return {Number} maximum Number
* @example
*
* function setup() {
* // Change the elements in the array and run the sketch
* // to show how max() works!
- * numArray = new Array(2,1,5,4,8,9);
+ * var numArray = [2, 1, 5, 4, 8, 9];
* fill(0);
* noStroke();
- * text("Array Elements", 0, 10);
+ * text('Array Elements', 0, 10);
* // Draw all numbers in the array
* var spacing = 15;
* var elemsY = 25;
- * for(var i = 0; i < numArray.length; i++) {
+ * for (var i = 0; i < numArray.length; i++) {
* text(numArray[i], i * spacing, elemsY);
* }
- * maxX = 33;
- * maxY = 80;
+ * var maxX = 33;
+ * var maxY = 80;
* // Draw the Maximum value in the array.
* textSize(32);
* text(max(numArray), maxX, maxY);
@@ -61096,39 +66432,46 @@ p5.prototype.map = function (n, start1, stop1, start2, stop2, withinBounds) {
* Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 9
*
*/
+/**
+ * @method max
+ * @param {Number[]} nums Numbers to compare
+ * @return {Number}
+ */
p5.prototype.max = function() {
+ p5._validateParameters('max', arguments);
if (arguments[0] instanceof Array) {
- return Math.max.apply(null,arguments[0]);
+ return Math.max.apply(null, arguments[0]);
} else {
- return Math.max.apply(null,arguments);
+ return Math.max.apply(null, arguments);
}
};
/**
* Determines the smallest value in a sequence of numbers, and then returns
- * that value. min() accepts any number of Number parameters, or an Array
+ * that value. min() accepts any number of Number parameters, or an Array
* of any length.
*
* @method min
- * @param {Number|Array} n0 Numbers to compare
- * @return {Number} minimum Number
+ * @param {Number} n0 Number to compare
+ * @param {Number} n1 Number to compare
+ * @return {Number} minimum Number
* @example
*
* function setup() {
* // Change the elements in the array and run the sketch
* // to show how min() works!
- * numArray = new Array(2,1,5,4,8,9);
+ * var numArray = [2, 1, 5, 4, 8, 9];
* fill(0);
* noStroke();
- * text("Array Elements", 0, 10);
+ * text('Array Elements', 0, 10);
* // Draw all numbers in the array
* var spacing = 15;
* var elemsY = 25;
- * for(var i = 0; i < numArray.length; i++) {
+ * for (var i = 0; i < numArray.length; i++) {
* text(numArray[i], i * spacing, elemsY);
* }
- * maxX = 33;
- * maxY = 80;
+ * var maxX = 33;
+ * var maxY = 80;
* // Draw the Minimum value in the array.
* textSize(32);
* text(min(numArray), maxX, maxY);
@@ -61139,11 +66482,17 @@ p5.prototype.max = function() {
* Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 1
*
*/
+/**
+ * @method min
+ * @param {Number[]} nums Numbers to compare
+ * @return {Number}
+ */
p5.prototype.min = function() {
+ p5._validateParameters('min', arguments);
if (arguments[0] instanceof Array) {
- return Math.min.apply(null,arguments[0]);
+ return Math.min.apply(null, arguments[0]);
} else {
- return Math.min.apply(null,arguments);
+ return Math.min.apply(null, arguments);
}
};
@@ -61163,30 +66512,30 @@ p5.prototype.min = function() {
*
* function draw() {
* background(200);
- * currentNum = mouseX;
- * lowerBound = 0;
- * upperBound = width; //100;
- * normalized = norm(currentNum, lowerBound, upperBound);
- * lineY = 70
+ * var currentNum = mouseX;
+ * var lowerBound = 0;
+ * var upperBound = width; //100;
+ * var normalized = norm(currentNum, lowerBound, upperBound);
+ * var lineY = 70;
* line(0, lineY, width, lineY);
* //Draw an ellipse mapped to the non-normalized value.
* noStroke();
- * fill(50)
+ * fill(50);
* var s = 7; // ellipse size
* ellipse(currentNum, lineY, s, s);
*
* // Draw the guide
- * guideY = lineY + 15;
- * text("0", 0, guideY);
+ * var guideY = lineY + 15;
+ * text('0', 0, guideY);
* textAlign(RIGHT);
- * text("100", width, guideY);
+ * text('100', width, guideY);
*
* // Draw the normalized value
* textAlign(LEFT);
* fill(0);
* textSize(32);
- * normalY = 40;
- * normalX = 20;
+ * var normalY = 40;
+ * var normalX = 20;
* text(normalized, normalX, normalY);
* }
*
@@ -61196,11 +66545,12 @@ p5.prototype.min = function() {
*
*/
p5.prototype.norm = function(n, start, stop) {
+ p5._validateParameters('norm', arguments);
return this.map(n, start, stop, 0, 1);
};
/**
- * Facilitates exponential expressions. The pow() function is an efficient
+ * Facilitates exponential expressions. The pow() function is an efficient
* way of multiplying numbers by themselves (or their reciprocals) 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. Maps to
@@ -61214,16 +66564,16 @@ p5.prototype.norm = function(n, start, stop) {
*
* function setup() {
* //Exponentially increase the size of an ellipse.
- * eSize = 3; // Original Size
- * eLoc = 10; // Original Location
+ * var eSize = 3; // Original Size
+ * var eLoc = 10; // Original Location
*
* ellipse(eLoc, eLoc, eSize, eSize);
*
- * ellipse(eLoc*2, eLoc*2, pow(eSize, 2), pow(eSize, 2));
+ * ellipse(eLoc * 2, eLoc * 2, pow(eSize, 2), pow(eSize, 2));
*
- * ellipse(eLoc*4, eLoc*4, pow(eSize, 3), pow(eSize, 3));
+ * ellipse(eLoc * 4, eLoc * 4, pow(eSize, 3), pow(eSize, 3));
*
- * ellipse(eLoc*8, eLoc*8, pow(eSize, 4), pow(eSize, 4));
+ * ellipse(eLoc * 8, eLoc * 8, pow(eSize, 4), pow(eSize, 4));
* }
*
*
@@ -61239,7 +66589,7 @@ p5.prototype.pow = Math.pow;
*
* @method round
* @param {Number} n number to round
- * @return {Number} rounded number
+ * @return {Integer} rounded number
* @example
*
* function draw() {
@@ -61249,7 +66599,7 @@ p5.prototype.pow = Math.pow;
* var ay = 66;
*
* // Round the mapped number.
- * var bx = round(map(mouseX, 0, 100, 0,5));
+ * var bx = round(map(mouseX, 0, 100, 0, 5));
* var by = 33;
*
* // Multiply the mapped numbers by 20 to more easily
@@ -61261,8 +66611,8 @@ p5.prototype.pow = Math.pow;
*
* // Reformat the float returned by map and draw it.
* noStroke();
- * text(nfc(ax, 2,2), ax, ay - 5);
- * text(nfc(bx,1,1), bx, by - 5);
+ * text(nfc(ax, 2), ax, ay - 5);
+ * text(nfc(bx, 1), bx, by - 5);
* }
*
*
@@ -61284,11 +66634,11 @@ p5.prototype.round = Math.round;
*
* function draw() {
* background(200);
- * eSize = 7;
- * x1 = map(mouseX, 0, width, 0, 10);
- * y1 = 80;
- * x2 = sq(x1);
- * y2 = 20;
+ * var eSize = 7;
+ * var x1 = map(mouseX, 0, width, 0, 10);
+ * var y1 = 80;
+ * var x2 = sq(x1);
+ * var y2 = 20;
*
* // Draw the non-squared.
* line(0, y1, width, y1);
@@ -61299,15 +66649,15 @@ p5.prototype.round = Math.round;
* ellipse(x2, y2, eSize, eSize);
*
* // Draw dividing line.
- * stroke(100)
- * line(0, height/2, width, height/2);
+ * stroke(100);
+ * line(0, height / 2, width, height / 2);
*
* // Draw text.
* var spacing = 15;
* noStroke();
* fill(0);
- * text("x = " + x1, 0, y1 + spacing);
- * text("sq(x) = " + x2, 0, y2 + spacing);
+ * text('x = ' + x1, 0, y1 + spacing);
+ * text('sq(x) = ' + x2, 0, y2 + spacing);
* }
*
*
@@ -61315,7 +66665,9 @@ p5.prototype.round = Math.round;
* horizontal center line squared values displayed on top and regular on bottom.
*
*/
-p5.prototype.sq = function(n) { return n*n; };
+p5.prototype.sq = function(n) {
+ return n * n;
+};
/**
* Calculates the square root of a number. The square root of a number is
@@ -61330,11 +66682,11 @@ p5.prototype.sq = function(n) { return n*n; };
*
* function draw() {
* background(200);
- * eSize = 7;
- * x1 = mouseX;
- * y1 = 80;
- * x2 = sqrt(x1);
- * y2 = 20;
+ * var eSize = 7;
+ * var x1 = mouseX;
+ * var y1 = 80;
+ * var x2 = sqrt(x1);
+ * var y2 = 20;
*
* // Draw the non-squared.
* line(0, y1, width, y1);
@@ -61345,15 +66697,15 @@ p5.prototype.sq = function(n) { return n*n; };
* ellipse(x2, y2, eSize, eSize);
*
* // Draw dividing line.
- * stroke(100)
- * line(0, height/2, width, height/2);
+ * stroke(100);
+ * line(0, height / 2, width, height / 2);
*
* // Draw text.
* noStroke();
* fill(0);
* var spacing = 15;
- * text("x = " + x1, 0, y1 + spacing);
- * text("sqrt(x) = " + x2, 0, y2 + spacing);
+ * text('x = ' + x1, 0, y1 + spacing);
+ * text('sqrt(x) = ' + x2, 0, y2 + spacing);
* }
*
*
@@ -61399,7 +66751,7 @@ function hypot(x, y, z) {
var m = args[j] / max;
var summand = m * m - compensation;
var preliminary = sum + summand;
- compensation = (preliminary - sum) - summand;
+ compensation = preliminary - sum - summand;
sum = preliminary;
}
return Math.sqrt(sum) * max;
@@ -61407,7 +66759,7 @@ function hypot(x, y, z) {
module.exports = p5;
-},{"../core/core":55}],84:[function(_dereq_,module,exports){
+},{"../core/main":25}],53:[function(_dereq_,module,exports){
/**
* @module Math
* @submodule Math
@@ -61417,11 +66769,10 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
-
+var p5 = _dereq_('../core/main');
/**
- * Creates a new p5.Vector (the datatype for storing vectors). This provides a
+ * Creates a new p5.Vector (the datatype for storing vectors). This provides a
* two or three dimensional vector, specifically a Euclidean (also known as
* geometric) vector. A vector is an entity that has both magnitude and
* direction.
@@ -61431,8 +66782,26 @@ var p5 = _dereq_('../core/core');
* @param {Number} [y] y component of the vector
* @param {Number} [z] z component of the vector
* @return {p5.Vector}
+ * @example
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * noStroke();
+ * fill(255, 102, 204);
+ * }
+ *
+ * function draw() {
+ * background(255);
+ * pointLight(color(255), createVector(sin(millis() / 1000) * 20, -40, -10));
+ * scale(0.75);
+ * sphere();
+ * }
+ *
+ *
+ * @alt
+ * a purple sphere lit by a point light oscillating horizontally
*/
-p5.prototype.createVector = function (x, y, z) {
+p5.prototype.createVector = function(x, y, z) {
if (this instanceof p5) {
return new p5.Vector(this, arguments);
} else {
@@ -61442,7 +66811,7 @@ p5.prototype.createVector = function (x, y, z) {
module.exports = p5;
-},{"../core/core":55}],85:[function(_dereq_,module,exports){
+},{"../core/main":25}],54:[function(_dereq_,module,exports){
//////////////////////////////////////////////////////////////
// http://mrl.nyu.edu/~perlin/noise/
@@ -61465,24 +66834,23 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var PERLIN_YWRAPB = 4;
-var PERLIN_YWRAP = 1<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; see
- * the noiseSeed() function). p5.js can compute 1D, 2D and 3D noise,
+ * the noiseSeed() function). p5.js can compute 1D, 2D and 3D noise,
* depending on the number of coordinates given. The resulting value will
* always be between 0.0 and 1.0. The noise value can be animated by moving
* through the noise space as demonstrated in the example above. The 2nd
@@ -61519,11 +66887,12 @@ var perlin; // will be initialized lazily by noise() or noiseSeed()
* coordinates
* @example
*
- * var xoff = 0.0;
+ *
+ * var xoff = 0.0;
*
* function draw() {
* background(204);
- * xoff = xoff + .01;
+ * xoff = xoff + 0.01;
* var n = noise(xoff) * width;
* line(n, 0, n, height);
* }
@@ -61549,7 +66918,7 @@ var perlin; // will be initialized lazily by noise() or noiseSeed()
*
*/
-p5.prototype.noise = function(x,y,z) {
+p5.prototype.noise = function(x, y, z) {
y = y || 0;
z = z || 0;
@@ -61560,59 +66929,75 @@ p5.prototype.noise = function(x,y,z) {
}
}
- if (x<0) { x=-x; }
- if (y<0) { y=-y; }
- if (z<0) { z=-z; }
+ if (x < 0) {
+ x = -x;
+ }
+ if (y < 0) {
+ y = -y;
+ }
+ if (z < 0) {
+ z = -z;
+ }
- var xi=Math.floor(x), yi=Math.floor(y), zi=Math.floor(z);
+ var xi = Math.floor(x),
+ yi = Math.floor(y),
+ zi = Math.floor(z);
var xf = x - xi;
var yf = y - yi;
var zf = z - zi;
var rxf, ryf;
- var r=0;
- var ampl=0.5;
+ var r = 0;
+ var ampl = 0.5;
- var n1,n2,n3;
+ var n1, n2, n3;
- for (var o=0; o=1.0) { xi++; xf--; }
- if (yf>=1.0) { yi++; yf--; }
- if (zf>=1.0) { zi++; zf--; }
+ if (xf >= 1.0) {
+ xi++;
+ xf--;
+ }
+ if (yf >= 1.0) {
+ yi++;
+ yf--;
+ }
+ if (zf >= 1.0) {
+ zi++;
+ zf--;
+ }
}
return r;
};
-
/**
*
* Adjusts the character and level of detail produced by the Perlin noise
@@ -61638,28 +67023,28 @@ p5.prototype.noise = function(x,y,z) {
* @example
*
*
- *
* var noiseVal;
- * var noiseScale=0.02;
+ * var noiseScale = 0.02;
*
* function setup() {
- * createCanvas(100,100);
+ * createCanvas(100, 100);
* }
*
* function draw() {
* background(0);
* for (var y = 0; y < height; y++) {
- * for (var x = 0; x < width/2; x++) {
- * noiseDetail(2,0.2);
- * noiseVal = noise((mouseX+x) * noiseScale,
- * (mouseY+y) * noiseScale);
- * stroke(noiseVal*255);
- * point(x,y);
- * noiseDetail(8,0.65);
- * noiseVal = noise((mouseX + x + width/2) * noiseScale,
- * (mouseY + y) * noiseScale);
- * stroke(noiseVal*255);
- * point(x + width/2, y);
+ * for (var x = 0; x < width / 2; x++) {
+ * noiseDetail(2, 0.2);
+ * noiseVal = noise((mouseX + x) * noiseScale, (mouseY + y) * noiseScale);
+ * stroke(noiseVal * 255);
+ * point(x, y);
+ * noiseDetail(8, 0.65);
+ * noiseVal = noise(
+ * (mouseX + x + width / 2) * noiseScale,
+ * (mouseY + y) * noiseScale
+ * );
+ * stroke(noiseVal * 255);
+ * point(x + width / 2, y);
* }
* }
* }
@@ -61671,8 +67056,12 @@ p5.prototype.noise = function(x,y,z) {
*
*/
p5.prototype.noiseDetail = function(lod, falloff) {
- if (lod>0) { perlin_octaves=lod; }
- if (falloff>0) { perlin_amp_falloff=falloff; }
+ if (lod > 0) {
+ perlin_octaves = lod;
+ }
+ if (falloff > 0) {
+ perlin_amp_falloff = falloff;
+ }
};
/**
@@ -61711,22 +67100,22 @@ p5.prototype.noiseSeed = function(seed) {
// Set to values from http://en.wikipedia.org/wiki/Numerical_Recipes
// m is basically chosen to be large (as it is the max period)
// and for its relationships to a and c
- var m = 4294967296,
+ var m = 4294967296;
// a - 1 should be divisible by m's prime factors
- a = 1664525,
- // c and m should be co-prime
- c = 1013904223,
- seed, z;
+ var a = 1664525;
+ // c and m should be co-prime
+ var c = 1013904223;
+ var seed, z;
return {
- setSeed : function(val) {
+ setSeed: function(val) {
// pick a random seed if val is undefined or null
// the >>> 0 casts the seed to an unsigned 32-bit integer
z = seed = (val == null ? Math.random() * m : val) >>> 0;
},
- getSeed : function() {
+ getSeed: function() {
return seed;
},
- rand : function() {
+ rand: function() {
// define the recurrence relationship
z = (a * z + c) % m;
// return a float in [0, 1)
@@ -61734,7 +67123,7 @@ p5.prototype.noiseSeed = function(seed) {
return z / m;
}
};
- }());
+ })();
lcg.setSeed(seed);
perlin = new Array(PERLIN_SIZE + 1);
@@ -61745,7 +67134,7 @@ p5.prototype.noiseSeed = function(seed) {
module.exports = p5;
-},{"../core/core":55}],86:[function(_dereq_,module,exports){
+},{"../core/main":25}],55:[function(_dereq_,module,exports){
/**
* @module Math
* @submodule Math
@@ -61754,8 +67143,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
-var polarGeometry = _dereq_('./polargeometry');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
/**
@@ -61763,9 +67151,9 @@ var constants = _dereq_('../core/constants');
* a Euclidean (also known as geometric) vector. A vector is an entity
* that has both magnitude and direction. The datatype, however, stores
* the components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude
- * and direction can be accessed via the methods mag() and heading().
+ * and direction can be accessed via the methods mag() and heading().
*
- * In many of the p5.js examples, you will see p5.Vector used to describe a
+ * In many of the p5.js examples, you will see p5.Vector used to describe a
* position, velocity, or acceleration. For example, if you consider a rectangle
* moving across the screen, at any given instant it has a position (a vector
* that points from the origin to its location), a velocity (the rate at which
@@ -61775,10 +67163,9 @@ var constants = _dereq_('../core/constants');
*
* 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 p5.Vector class.
+ * "vector" math, which is made easy by the methods inside the p5.Vector class.
*
* @class p5.Vector
- * @constructor
* @param {Number} [x] x component of the vector
* @param {Number} [y] y component of the vector
* @param {Number} [z] z component of the vector
@@ -61799,16 +67186,16 @@ var constants = _dereq_('../core/constants');
* 2 white ellipses. One center-left the other bottom right and off canvas
*
*/
-p5.Vector = function() {
- var x,y,z;
+p5.Vector = function Vector() {
+ var x, y, z;
// This is how it comes in with createVector()
- if(arguments[0] instanceof p5) {
+ if (arguments[0] instanceof p5) {
// save reference to p5 if passed in
this.p5 = arguments[0];
- x = arguments[1][0] || 0;
- y = arguments[1][1] || 0;
- z = arguments[1][2] || 0;
- // This is what we'll get with new p5.Vector()
+ x = arguments[1][0] || 0;
+ y = arguments[1][1] || 0;
+ z = arguments[1][2] || 0;
+ // This is what we'll get with new p5.Vector()
} else {
x = arguments[0] || 0;
y = arguments[1] || 0;
@@ -61829,7 +67216,6 @@ p5.Vector = function() {
* @property z {Number}
*/
this.z = z;
- this.name = 'p5.Vector'; // for friendly debugger system
};
/**
@@ -61837,43 +67223,116 @@ p5.Vector = function() {
* or v.toString(). This method is useful for logging vectors in the
* console.
* @method toString
+ * @return {String}
* @example
- *
+ *
+ *
* function setup() {
- * var v = createVector(20,30);
+ * var v = createVector(20, 30);
* print(String(v)); // prints "p5.Vector Object : [20, 30, 0]"
* }
- *
+ *
+ *
*
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ * var v1 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v1, 'black');
+ *
+ * noStroke();
+ * text(v1.toString(), 10, 25, 90, 75);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
p5.Vector.prototype.toString = function p5VectorToString() {
- return 'p5.Vector Object : ['+ this.x +', '+ this.y +', '+ this.z + ']';
+ return 'p5.Vector Object : [' + this.x + ', ' + this.y + ', ' + this.z + ']';
};
/**
* Sets the x, y, and z component of the vector using two or three separate
- * variables, the data from a p5.Vector, or the values from a float array.
+ * variables, the data from a p5.Vector, or the values from a float array.
* @method set
- * @param {Number|p5.Vector|Array} [x] the x component of the vector or a
- * p5.Vector or an Array
- * @param {Number} [y] the y component of the vector
- * @param {Number} [z] the z component of the vector
+ * @param {Number} [x] the x component of the vector
+ * @param {Number} [y] the y component of the vector
+ * @param {Number} [z] the z component of the vector
* @chainable
* @example
*
*
* function setup() {
- * var v = createVector(1, 2, 3);
- * v.set(4,5,6); // Sets vector to [4, 5, 6]
+ * var v = createVector(1, 2, 3);
+ * v.set(4, 5, 6); // Sets vector to [4, 5, 6]
+ *
+ * var v1 = createVector(0, 0, 0);
+ * var arr = [1, 2, 3];
+ * v1.set(arr); // Sets vector to [1, 2, 3]
+ * }
+ *
+ *
+ *
+ *
+ *
+ * var v0, v1;
+ * function setup() {
+ * createCanvas(100, 100);
+ *
+ * v0 = createVector(0, 0);
+ * v1 = createVector(50, 50);
+ * }
*
- * var v1 = createVector(0, 0, 0);
- * var arr = [1, 2, 3];
- * v1.set(arr); // Sets vector to [1, 2, 3]
+ * function draw() {
+ * background(240);
+ *
+ * drawArrow(v0, v1, 'black');
+ * v1.set(v1.x + random(-1, 1), v1.y + random(-1, 1));
+ *
+ * noStroke();
+ * text('x: ' + round(v1.x) + ' y: ' + round(v1.y), 20, 90);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
* }
*
*
*/
-p5.Vector.prototype.set = function (x, y, z) {
+/**
+ * @method set
+ * @param {p5.Vector|Number[]} value the vector to set
+ * @chainable
+ */
+p5.Vector.prototype.set = function set(x, y, z) {
if (x instanceof p5.Vector) {
this.x = x.x || 0;
this.y = x.y || 0;
@@ -61893,50 +67352,48 @@ p5.Vector.prototype.set = function (x, y, z) {
};
/**
- * Gets a copy of the vector, returns a p5.Vector object.
+ * Gets a copy of the vector, returns a p5.Vector object.
*
* @method copy
- * @return {p5.Vector} the copy of the p5.Vector object
+ * @return {p5.Vector} the copy of the p5.Vector object
* @example
*
*
* var v1 = createVector(1, 2, 3);
* var v2 = v1.copy();
- * print(v1.x == v2.x && v1.y == v2.y && v1.z == v2.z);
+ * print(v1.x === v2.x && v1.y === v2.y && v1.z === v2.z);
* // Prints "true"
*
*
*/
-p5.Vector.prototype.copy = function () {
+p5.Vector.prototype.copy = function copy() {
if (this.p5) {
- return new p5.Vector(this.p5,[this.x, this.y, this.z]);
+ return new p5.Vector(this.p5, [this.x, this.y, this.z]);
} else {
- return new p5.Vector(this.x,this.y,this.z);
+ return new p5.Vector(this.x, this.y, this.z);
}
};
/**
* Adds x, y, and z components to a vector, adds one vector to another, or
* adds two independent vectors together. The version of the method that adds
- * two vectors together is a static method and returns a p5.Vector, the others
+ * two vectors together is a static method and returns a p5.Vector, the others
* acts directly on the vector. See the examples for more context.
*
* @method add
- * @param {Number|p5.Vector|Array} x the x component of the vector to be
- * added or a p5.Vector or an Array
- * @param {Number} [y] the y component of the vector to be
- * added
- * @param {Number} [z] the z component of the vector to be
- * added
+ * @param {Number} x the x component of the vector to be added
+ * @param {Number} [y] the y component of the vector to be added
+ * @param {Number} [z] the z component of the vector to be added
* @chainable
* @example
*
*
* var v = createVector(1, 2, 3);
- * v.add(4,5,6);
+ * v.add(4, 5, 6);
* // v's components are set to [5, 7, 9]
*
*
+ *
*
*
* // Static method
@@ -61945,10 +67402,50 @@ p5.Vector.prototype.copy = function () {
*
* var v3 = p5.Vector.add(v1, v2);
* // v3 has components [3, 5, 7]
+ * print(v3);
+ *
+ *
+ *
+ *
+ *
+ * // red vector + blue vector = purple vector
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ * var v1 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var v2 = createVector(-30, 20);
+ * drawArrow(v1, v2, 'blue');
+ *
+ * var v3 = p5.Vector.add(v1, v2);
+ * drawArrow(v0, v3, 'purple');
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.add = function (x, y, z) {
+/**
+ * @method add
+ * @param {p5.Vector|Number[]} value the vector to add
+ * @chainable
+ */
+p5.Vector.prototype.add = function add(x, y, z) {
if (x instanceof p5.Vector) {
this.x += x.x || 0;
this.y += x.y || 0;
@@ -61970,14 +67467,13 @@ p5.Vector.prototype.add = function (x, y, z) {
/**
* Subtracts x, y, and z components from a vector, subtracts one vector from
* another, or subtracts two independent vectors. The version of the method
- * that subtracts two vectors is a static method and returns a p5.Vector, the
+ * that subtracts two vectors is a static method and returns a p5.Vector, the
* other acts directly on the vector. See the examples for more context.
*
* @method sub
- * @param {Number|p5.Vector|Array} x the x component of the vector or a
- * p5.Vector or an Array
- * @param {Number} [y] the y component of the vector
- * @param {Number} [z] the z component of the vector
+ * @param {Number} x the x component of the vector to subtract
+ * @param {Number} [y] the y component of the vector to subtract
+ * @param {Number} [z] the z component of the vector to subtract
* @chainable
* @example
*
@@ -61996,10 +67492,50 @@ p5.Vector.prototype.add = function (x, y, z) {
*
* var v3 = p5.Vector.sub(v1, v2);
* // v3 has components [1, 1, 1]
+ * print(v3);
+ *
+ *
+ *
+ *
+ *
+ * // red vector - blue vector = purple vector
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ * var v1 = createVector(70, 50);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var v2 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v2, 'blue');
+ *
+ * var v3 = p5.Vector.sub(v1, v2);
+ * drawArrow(v2, v3, 'purple');
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.sub = function (x, y, z) {
+/**
+ * @method sub
+ * @param {p5.Vector|Number[]} value the vector to subtract
+ * @chainable
+ */
+p5.Vector.prototype.sub = function sub(x, y, z) {
if (x instanceof p5.Vector) {
this.x -= x.x || 0;
this.y -= x.y || 0;
@@ -62020,7 +67556,7 @@ p5.Vector.prototype.sub = function (x, y, z) {
/**
* Multiply the vector by a scalar. The static version of this method
- * creates a new p5.Vector while the non static version acts on the vector
+ * creates a new p5.Vector while the non static version acts on the vector
* directly. See the examples for more context.
*
* @method mult
@@ -62041,19 +67577,61 @@ p5.Vector.prototype.sub = function (x, y, z) {
* var v1 = createVector(1, 2, 3);
* var v2 = p5.Vector.mult(v1, 2);
* // v2 has components [2, 4, 6]
+ * print(v2);
+ *
+ *
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(50, 50);
+ * var v1 = createVector(25, -25);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var num = map(mouseX, 0, width, -2, 2, true);
+ * var v2 = p5.Vector.mult(v1, num);
+ * drawArrow(v0, v2, 'blue');
+ *
+ * noStroke();
+ * text('multiplied by ' + num.toFixed(2), 5, 90);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.mult = function (n) {
- this.x *= n || 0;
- this.y *= n || 0;
- this.z *= n || 0;
+p5.Vector.prototype.mult = function mult(n) {
+ if (!(typeof n === 'number' && isFinite(n))) {
+ console.warn(
+ 'p5.Vector.prototype.mult:',
+ 'n is undefined or not a finite number'
+ );
+ return this;
+ }
+ this.x *= n;
+ this.y *= n;
+ this.z *= n;
return this;
};
/**
* Divide the vector by a scalar. The static version of this method creates a
- * new p5.Vector while the non static version acts on the vector directly.
+ * new p5.Vector while the non static version acts on the vector directly.
* See the examples for more context.
*
* @method div
@@ -62070,13 +67648,59 @@ p5.Vector.prototype.mult = function (n) {
*
*
* // Static method
- * var v1 = createVector(6, 4, 2);
- * var v2 = p5.Vector.div(v, 2);
+ * var v1 = createVector(6, 4, 2);
+ * var v2 = p5.Vector.div(v1, 2);
* // v2 has components [3, 2, 1]
+ * print(v2);
+ *
+ *
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 100);
+ * var v1 = createVector(50, -50);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var num = map(mouseX, 0, width, 10, 0.5, true);
+ * var v2 = p5.Vector.div(v1, num);
+ * drawArrow(v0, v2, 'blue');
+ *
+ * noStroke();
+ * text('divided by ' + num.toFixed(2), 10, 90);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.div = function (n) {
+p5.Vector.prototype.div = function div(n) {
+ if (!(typeof n === 'number' && isFinite(n))) {
+ console.warn(
+ 'p5.Vector.prototype.div:',
+ 'n is undefined or not a finite number'
+ );
+ return this;
+ }
+ if (n === 0) {
+ console.warn('p5.Vector.prototype.div:', 'divide by 0');
+ return this;
+ }
this.x /= n;
this.y /= n;
this.z /= n;
@@ -62090,6 +67714,35 @@ p5.Vector.prototype.div = function (n) {
* @method mag
* @return {Number} magnitude of the vector
* @example
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ * var v1 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v1, 'black');
+ *
+ * noStroke();
+ * text('vector length: ' + v1.mag().toFixed(2), 10, 70, 90, 30);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*
*
* var v = createVector(20.0, 30.0, 40.0);
@@ -62098,7 +67751,7 @@ p5.Vector.prototype.div = function (n) {
*
*
*/
-p5.Vector.prototype.mag = function () {
+p5.Vector.prototype.mag = function mag() {
return Math.sqrt(this.magSq());
};
@@ -62118,10 +67771,42 @@ p5.Vector.prototype.mag = function () {
* print(v1.magSq()); // Prints "56"
*
*
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ * var v1 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v1, 'black');
+ *
+ * noStroke();
+ * text('vector length squared: ' + v1.magSq().toFixed(2), 10, 45, 90, 55);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
-p5.Vector.prototype.magSq = function () {
- var x = this.x, y = this.y, z = this.z;
- return (x * x + y * y + z * z);
+p5.Vector.prototype.magSq = function magSq() {
+ var x = this.x;
+ var y = this.y;
+ var z = this.z;
+ return x * x + y * y + z * z;
};
/**
@@ -62131,10 +67816,10 @@ p5.Vector.prototype.magSq = function () {
*
*
* @method dot
- * @param {Number|p5.Vector} x x component of the vector or a p5.Vector
- * @param {Number} [y] y component of the vector
- * @param {Number} [z] z component of the vector
- * @return {Number} the dot product
+ * @param {Number} x x component of the vector
+ * @param {Number} [y] y component of the vector
+ * @param {Number} [z] z component of the vector
+ * @return {Number} the dot product
*
* @example
*
@@ -62151,27 +67836,30 @@ p5.Vector.prototype.magSq = function () {
* //Static method
* var v1 = createVector(1, 2, 3);
* var v2 = createVector(3, 2, 1);
- * print (p5.Vector.dot(v1, v2)); // Prints "10"
+ * print(p5.Vector.dot(v1, v2)); // Prints "10"
*
*
*/
-p5.Vector.prototype.dot = function (x, y, z) {
+/**
+ * @method dot
+ * @param {p5.Vector} value value component of the vector or a p5.Vector
+ * @return {Number}
+ */
+p5.Vector.prototype.dot = function dot(x, y, z) {
if (x instanceof p5.Vector) {
return this.dot(x.x, x.y, x.z);
}
- return this.x * (x || 0) +
- this.y * (y || 0) +
- this.z * (z || 0);
+ return this.x * (x || 0) + this.y * (y || 0) + this.z * (z || 0);
};
/**
* Calculates and returns a vector composed of the cross product between
- * two vectors. Both the static and non static methods return a new p5.Vector.
+ * two vectors. Both the static and non static methods return a new p5.Vector.
* See the examples for more context.
*
* @method cross
- * @param {p5.Vector} v p5.Vector to be crossed
- * @return {p5.Vector} p5.Vector composed of cross product
+ * @param {p5.Vector} v p5.Vector to be crossed
+ * @return {p5.Vector} p5.Vector composed of cross product
* @example
*
*
@@ -62190,17 +67878,18 @@ p5.Vector.prototype.dot = function (x, y, z) {
*
* var crossProduct = p5.Vector.cross(v1, v2);
* // crossProduct has components [0, 0, 1]
+ * print(crossProduct);
*
*
*/
-p5.Vector.prototype.cross = function (v) {
+p5.Vector.prototype.cross = function cross(v) {
var x = this.y * v.z - this.z * v.y;
var y = this.z * v.x - this.x * v.z;
var z = this.x * v.y - this.y * v.x;
if (this.p5) {
- return new p5.Vector(this.p5,[x,y,z]);
+ return new p5.Vector(this.p5, [x, y, z]);
} else {
- return new p5.Vector(x,y,z);
+ return new p5.Vector(x, y, z);
}
};
@@ -62209,7 +67898,7 @@ p5.Vector.prototype.cross = function (v) {
* point as a vector object).
*
* @method dist
- * @param {p5.Vector} v the x, y, and z coordinates of a p5.Vector
+ * @param {p5.Vector} v the x, y, and z coordinates of a p5.Vector
* @return {Number} the distance
* @example
*
@@ -62218,29 +67907,68 @@ p5.Vector.prototype.cross = function (v) {
* var v2 = createVector(0, 1, 0);
*
* var distance = v1.dist(v2); // distance is 1.4142...
+ * print(distance);
*
*
+ *
*
*
* // Static method
* var v1 = createVector(1, 0, 0);
* var v2 = createVector(0, 1, 0);
*
- * var distance = p5.Vector.dist(v1,v2);
+ * var distance = p5.Vector.dist(v1, v2);
* // distance is 1.4142...
+ * print(distance);
+ *
+ *
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ *
+ * var v1 = createVector(70, 50);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var v2 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v2, 'blue');
+ *
+ * noStroke();
+ * text('distance between vectors: ' + v2.dist(v1).toFixed(2), 5, 50, 95, 50);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.dist = function (v) {
- var d = v.copy().sub(this);
- return d.mag();
+p5.Vector.prototype.dist = function dist(v) {
+ return v
+ .copy()
+ .sub(this)
+ .mag();
};
/**
* Normalize the vector to length 1 (make it a unit vector).
*
* @method normalize
- * @return {p5.Vector} normalized p5.Vector
+ * @return {p5.Vector} normalized p5.Vector
* @example
*
*
@@ -62251,10 +67979,45 @@ p5.Vector.prototype.dist = function (v) {
* // [0.4454354, 0.8908708, 0.089087084]
*
*
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(50, 50);
+ * var v1 = createVector(mouseX - 50, mouseY - 50);
*
+ * drawArrow(v0, v1, 'red');
+ * v1.normalize();
+ * drawArrow(v0, v1.mult(35), 'blue');
+ *
+ * noFill();
+ * ellipse(50, 50, 35 * 2);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
-p5.Vector.prototype.normalize = function () {
- return this.mag() === 0 ? this : this.div(this.mag());
+p5.Vector.prototype.normalize = function normalize() {
+ var len = this.mag();
+ // here we multiply by the reciprocal instead of calling 'div()'
+ // since div duplicates this zero check.
+ if (len !== 0) this.mult(1 / len);
+ return this;
};
/**
@@ -62274,12 +68037,43 @@ p5.Vector.prototype.normalize = function () {
* // [2.2271771, 4.4543543, 0.4454354]
*
*
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(50, 50);
+ * var v1 = createVector(mouseX - 50, mouseY - 50);
+ *
+ * drawArrow(v0, v1, 'red');
+ * drawArrow(v0, v1.limit(35), 'blue');
+ *
+ * noFill();
+ * ellipse(50, 50, 35 * 2);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
-p5.Vector.prototype.limit = function (max) {
+p5.Vector.prototype.limit = function limit(max) {
var mSq = this.magSq();
- if(mSq > max*max) {
- this.div(Math.sqrt(mSq)); //normalize it
- this.mult(max);
+ if (mSq > max * max) {
+ this.div(Math.sqrt(mSq)) //normalize it
+ .mult(max);
}
return this;
};
@@ -62300,8 +68094,43 @@ p5.Vector.prototype.limit = function (max) {
* // v's components are set to [6.0, 8.0, 0.0]
*
*
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(0, 0);
+ * var v1 = createVector(50, 50);
+ *
+ * drawArrow(v0, v1, 'red');
+ *
+ * var length = map(mouseX, 0, width, 0, 141, true);
+ * v1.setMag(length);
+ * drawArrow(v0, v1, 'blue');
+ *
+ * noStroke();
+ * text('magnitude set to: ' + length.toFixed(2), 10, 70, 90, 30);
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
-p5.Vector.prototype.setMag = function (n) {
+p5.Vector.prototype.setMag = function setMag(n) {
return this.normalize().mult(n);
};
@@ -62311,30 +68140,67 @@ p5.Vector.prototype.setMag = function (n) {
* @method heading
* @return {Number} the angle of rotation
* @example
- *
+ *
+ *
* function setup() {
- * var v1 = createVector(30,50);
+ * var v1 = createVector(30, 50);
* print(v1.heading()); // 1.0303768265243125
*
- * var v1 = createVector(40,50);
+ * v1 = createVector(40, 50);
* print(v1.heading()); // 0.8960553845713439
*
- * var v1 = createVector(30,70);
+ * v1 = createVector(30, 70);
* print(v1.heading()); // 1.1659045405098132
* }
- *
+ *
+ *
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(50, 50);
+ * var v1 = createVector(mouseX - 50, mouseY - 50);
+ *
+ * drawArrow(v0, v1, 'black');
+ *
+ * var myHeading = v1.heading();
+ * noStroke();
+ * text(
+ * 'vector heading: ' +
+ * myHeading.toFixed(2) +
+ * ' radians or ' +
+ * degrees(myHeading).toFixed(2) +
+ * ' degrees',
+ * 10,
+ * 50,
+ * 90,
+ * 50
+ * );
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
-p5.Vector.prototype.heading = function () {
+p5.Vector.prototype.heading = function heading() {
var h = Math.atan2(this.y, this.x);
- if (this.p5) {
- if (this.p5._angleMode === constants.RADIANS) {
- return h;
- } else {
- return polarGeometry.radiansToDegrees(h);
- }
- } else {
- return h;
- }
+ if (this.p5) return this.p5._fromRadians(h);
+ return h;
};
/**
@@ -62353,14 +68219,40 @@ p5.Vector.prototype.heading = function () {
* // v's components are set to [-20.0, 9.999999, 0.0]
*
*
+ *
+ *
+ *
+ * var angle = 0;
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(50, 50);
+ * var v1 = createVector(50, 0);
+ *
+ * drawArrow(v0, v1.rotate(angle), 'black');
+ * angle += 0.01;
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
+ *
+ *
*/
-p5.Vector.prototype.rotate = function (a) {
+p5.Vector.prototype.rotate = function rotate(a) {
var newHeading = this.heading() + a;
- if (this.p5) {
- if (this.p5._angleMode === constants.DEGREES) {
- newHeading = polarGeometry.degreesToRadians(newHeading);
- }
- }
+ if (this.p5) newHeading = this.p5._toRadians(newHeading);
var mag = this.mag();
this.x = Math.cos(newHeading) * mag;
this.y = Math.sin(newHeading) * mag;
@@ -62370,7 +68262,7 @@ p5.Vector.prototype.rotate = function (a) {
/**
* Calculates and returns the angle (in radians) between two vectors.
* @method angleBetween
- * @param {p5.Vector} the x, y, and z components of a p5.Vector
+ * @param {p5.Vector} the x, y, and z components of a p5.Vector
* @return {Number} the angle between (in radians)
* @example
*
@@ -62380,10 +68272,55 @@ p5.Vector.prototype.rotate = function (a) {
*
* var angle = v1.angleBetween(v2);
* // angle is PI/2
+ * print(angle);
+ *
+ *
+ *
+ *
+ *
+ * function draw() {
+ * background(240);
+ * var v0 = createVector(50, 50);
+ *
+ * var v1 = createVector(50, 0);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var v2 = createVector(mouseX - 50, mouseY - 50);
+ * drawArrow(v0, v2, 'blue');
+ *
+ * var angleBetween = v1.angleBetween(v2);
+ * noStroke();
+ * text(
+ * 'angle between: ' +
+ * angleBetween.toFixed(2) +
+ * ' radians or ' +
+ * degrees(angleBetween).toFixed(2) +
+ * ' degrees',
+ * 10,
+ * 50,
+ * 90,
+ * 50
+ * );
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.angleBetween = function (v) {
+p5.Vector.prototype.angleBetween = function angleBetween(v) {
var dotmagmag = this.dot(v) / (this.mag() * v.mag());
// Mathematically speaking: the dotmagmag variable will be between -1 and 1
// inclusive. Practically though it could be slightly outside this range due
@@ -62391,11 +68328,7 @@ p5.Vector.prototype.angleBetween = function (v) {
//
// Solution: we'll clamp the value to the -1,1 range
var angle = Math.acos(Math.min(1, Math.max(-1, dotmagmag)));
- if (this.p5) {
- if (this.p5._angleMode === constants.DEGREES) {
- angle = polarGeometry.radiansToDegrees(angle);
- }
- }
+ if (this.p5) return this.p5._fromRadians(angle);
return angle;
};
@@ -62403,19 +68336,13 @@ p5.Vector.prototype.angleBetween = function (v) {
* Linear interpolate the vector to another vector
*
* @method lerp
- * @param {p5.Vector} x the x component
- * @param {p5.Vector} y the y component
- * @param {p5.Vector} z the z component
+ * @param {Number} x the x component
+ * @param {Number} y the y component
+ * @param {Number} z the z component
* @param {Number} amt the amount of interpolation; some value between 0.0
* (old vector) and 1.0 (new vector). 0.9 is very near
* the new vector. 0.5 is halfway in between.
* @chainable
- */
-/**
- * @method lerp
- * @param {p5.Vector} v the p5.Vector to lerp to
- * @param {Number} amt
- * @chainable
*
* @example
*
@@ -62433,10 +68360,58 @@ p5.Vector.prototype.angleBetween = function (v) {
*
* var v3 = p5.Vector.lerp(v1, v2, 0.5);
* // v3 has components [50,50,0]
+ * print(v3);
+ *
+ *
+ *
+ *
+ *
+ * var step = 0.01;
+ * var amount = 0;
+ *
+ * function draw() {
+ * background(240);
+ * var v0 = createVector(0, 0);
+ *
+ * var v1 = createVector(mouseX, mouseY);
+ * drawArrow(v0, v1, 'red');
+ *
+ * var v2 = createVector(90, 90);
+ * drawArrow(v0, v2, 'blue');
+ *
+ * if (amount > 1 || amount < 0) {
+ * step *= -1;
+ * }
+ * amount += step;
+ * var v3 = p5.Vector.lerp(v1, v2, amount);
+ *
+ * drawArrow(v0, v3, 'purple');
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.prototype.lerp = function (x, y, z, amt) {
+/**
+ * @method lerp
+ * @param {p5.Vector} v the p5.Vector to lerp to
+ * @param {Number} amt
+ * @chainable
+ */
+p5.Vector.prototype.lerp = function lerp(x, y, z, amt) {
if (x instanceof p5.Vector) {
return this.lerp(x.x, x.y, x.z, y);
}
@@ -62449,18 +68424,21 @@ p5.Vector.prototype.lerp = function (x, y, z, amt) {
/**
* Return a representation of this vector as a float array. This is only
* for temporary use. If used in any other fashion, the contents should be
- * copied by using the p5.Vector.copy() method to copy into your own
+ * copied by using the p5.Vector.copy() method to copy into your own
* array.
*
* @method array
* @return {Number[]} an Array with the 3 values
* @example
- *
+ *
+ *
* function setup() {
- * var v = createVector(20,30);
+ * var v = createVector(20, 30);
* print(v.array()); // Prints : Array [20, 30, 0]
* }
- *
+ *
+ *
+ *
*
*
* var v = createVector(10.0, 20.0, 30.0);
@@ -62471,39 +68449,46 @@ p5.Vector.prototype.lerp = function (x, y, z, amt) {
*
*
*/
-p5.Vector.prototype.array = function () {
+p5.Vector.prototype.array = function array() {
return [this.x || 0, this.y || 0, this.z || 0];
};
/**
- * Equality check against a p5.Vector
+ * Equality check against a p5.Vector
*
* @method equals
- * @param {Number|p5.Vector|Array} [x] the x component of the vector or a
- * p5.Vector or an Array
- * @param {Number} [y] the y component of the vector
- * @param {Number} [z] the z component of the vector
+ * @param {Number} [x] the x component of the vector
+ * @param {Number} [y] the y component of the vector
+ * @param {Number} [z] the z component of the vector
* @return {Boolean} whether the vectors are equals
* @example
- *
- * v1 = createVector(5,10,20);
- * v2 = createVector(5,10,20);
- * v3 = createVector(13,10,19);
+ *
+ *
+ * var v1 = createVector(5, 10, 20);
+ * var v2 = createVector(5, 10, 20);
+ * var v3 = createVector(13, 10, 19);
+ *
+ * print(v1.equals(v2.x, v2.y, v2.z)); // true
+ * print(v1.equals(v3.x, v3.y, v3.z)); // false
+ *
+ *
*
- * print(v1.equals(v2.x,v2.y,v2.z)); // true
- * print(v1.equals(v3.x,v3.y,v3.z)); // false
- *
*
*
* var v1 = createVector(10.0, 20.0, 30.0);
* var v2 = createVector(10.0, 20.0, 30.0);
* var v3 = createVector(0.0, 0.0, 0.0);
- * print (v1.equals(v2)) // true
- * print (v1.equals(v3)) // false
+ * print(v1.equals(v2)); // true
+ * print(v1.equals(v3)); // false
*
*
*/
-p5.Vector.prototype.equals = function (x, y, z) {
+/**
+ * @method equals
+ * @param {p5.Vector|Array} value the vector to compare
+ * @return {Boolean}
+ */
+p5.Vector.prototype.equals = function equals(x, y, z) {
var a, b, c;
if (x instanceof p5.Vector) {
a = x.x || 0;
@@ -62521,65 +68506,107 @@ p5.Vector.prototype.equals = function (x, y, z) {
return this.x === a && this.y === b && this.z === c;
};
-
// Static Methods
-
/**
- * Make a new 2D unit vector from an angle
+ * Make a new 2D vector from an angle
*
* @method fromAngle
* @static
- * @param {Number} angle the desired angle
- * @return {p5.Vector} the new p5.Vector object
+ * @param {Number} angle the desired angle, in radians
+ * @param {Number} [length] the length of the new vector (defaults to 1)
+ * @return {p5.Vector} the new p5.Vector object
* @example
*
*
* function draw() {
- * background (200);
+ * background(200);
*
* // Create a variable, proportional to the mouseX,
* // varying from 0-360, to represent an angle in degrees.
* angleMode(DEGREES);
- * var myDegrees = map(mouseX, 0,width, 0,360);
+ * var myDegrees = map(mouseX, 0, width, 0, 360);
*
* // Display that variable in an onscreen text.
* // (Note the nfc() function to truncate additional decimal places,
* // and the "\xB0" character for the degree symbol.)
- * var readout = "angle = " + nfc(myDegrees,1,1) + "\xB0"
+ * var readout = 'angle = ' + nfc(myDegrees, 1) + '\xB0';
* noStroke();
- * fill (0);
- * text (readout, 5, 15);
+ * fill(0);
+ * text(readout, 5, 15);
*
* // Create a p5.Vector using the fromAngle function,
* // and extract its x and y components.
- * var v = p5.Vector.fromAngle(radians(myDegrees));
+ * var v = p5.Vector.fromAngle(radians(myDegrees), 30);
* var vx = v.x;
* var vy = v.y;
*
* push();
- * translate (width/2, height/2);
+ * translate(width / 2, height / 2);
* noFill();
- * stroke (150);
- * line (0,0, 30,0);
- * stroke (0);
- * line (0,0, 30*vx, 30*vy);
- * pop()
+ * stroke(150);
+ * line(0, 0, 30, 0);
+ * stroke(0);
+ * line(0, 0, vx, vy);
+ * pop();
* }
*
*
*/
-p5.Vector.fromAngle = function(angle) {
- if (this.p5) {
- if (this.p5._angleMode === constants.DEGREES) {
- angle = polarGeometry.degreesToRadians(angle);
- }
+p5.Vector.fromAngle = function fromAngle(angle, length) {
+ if (typeof length === 'undefined') {
+ length = 1;
}
- if (this.p5) {
- return new p5.Vector(this.p5,[Math.cos(angle),Math.sin(angle),0]);
- } else {
- return new p5.Vector(Math.cos(angle),Math.sin(angle),0);
+ return new p5.Vector(length * Math.cos(angle), length * Math.sin(angle), 0);
+};
+
+/**
+ * Make a new 3D vector from a pair of ISO spherical angles
+ *
+ * @method fromAngles
+ * @static
+ * @param {Number} theta the polar angle, in radians (zero is up)
+ * @param {Number} phi the azimuthal angle, in radians
+ * (zero is out of the screen)
+ * @param {Number} [length] the length of the new vector (defaults to 1)
+ * @return {p5.Vector} the new p5.Vector object
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * fill(255);
+ * noStroke();
+ * }
+ * function draw() {
+ * background(255);
+ *
+ * var t = millis() / 1000;
+ *
+ * // add three point lights
+ * pointLight(color('#f00'), p5.Vector.fromAngles(t * 1.0, t * 1.3, 100));
+ * pointLight(color('#0f0'), p5.Vector.fromAngles(t * 1.1, t * 1.2, 100));
+ * pointLight(color('#00f'), p5.Vector.fromAngles(t * 1.2, t * 1.1, 100));
+ *
+ * sphere(35);
+ * }
+ *
+ *
+ */
+p5.Vector.fromAngles = function(theta, phi, length) {
+ if (typeof length === 'undefined') {
+ length = 1;
}
+ var cosPhi = Math.cos(phi);
+ var sinPhi = Math.sin(phi);
+ var cosTheta = Math.cos(theta);
+ var sinTheta = Math.sin(theta);
+
+ return new p5.Vector(
+ length * sinTheta * sinPhi,
+ -length * cosTheta,
+ length * sinTheta * cosPhi
+ );
};
/**
@@ -62587,7 +68614,7 @@ p5.Vector.fromAngle = function(angle) {
*
* @method random2D
* @static
- * @return {p5.Vector} the new p5.Vector object
+ * @return {p5.Vector} the new p5.Vector object
* @example
*
*
@@ -62596,23 +68623,43 @@ p5.Vector.fromAngle = function(angle) {
* // [0.61554617, -0.51195765, 0.0] or
* // [-0.4695841, -0.14366731, 0.0] or
* // [0.6091097, -0.22805278, 0.0]
+ * print(v);
+ *
+ *
+ *
+ *
+ *
+ * function setup() {
+ * frameRate(1);
+ * }
+ *
+ * function draw() {
+ * background(240);
+ *
+ * var v0 = createVector(50, 50);
+ * var v1 = p5.Vector.random2D();
+ * drawArrow(v0, v1.mult(50), 'black');
+ * }
+ *
+ * // draw an arrow for a vector at a given base position
+ * function drawArrow(base, vec, myColor) {
+ * push();
+ * stroke(myColor);
+ * strokeWeight(3);
+ * fill(myColor);
+ * translate(base.x, base.y);
+ * line(0, 0, vec.x, vec.y);
+ * rotate(vec.heading());
+ * var arrowSize = 7;
+ * translate(vec.mag() - arrowSize, 0);
+ * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);
+ * pop();
+ * }
*
*
*/
-p5.Vector.random2D = function () {
- var angle;
- // A lot of nonsense to determine if we know about a
- // p5 sketch and whether we should make a random angle in degrees or radians
- if (this.p5) {
- if (this.p5._angleMode === constants.DEGREES) {
- angle = this.p5.random(360);
- } else {
- angle = this.p5.random(constants.TWO_PI);
- }
- } else {
- angle = Math.random()*Math.PI*2;
- }
- return this.fromAngle(angle);
+p5.Vector.random2D = function random2D() {
+ return this.fromAngle(Math.random() * constants.TWO_PI);
};
/**
@@ -62620,7 +68667,7 @@ p5.Vector.random2D = function () {
*
* @method random3D
* @static
- * @return {p5.Vector} the new p5.Vector object
+ * @return {p5.Vector} the new p5.Vector object
* @example
*
*
@@ -62629,34 +68676,25 @@ p5.Vector.random2D = function () {
* // [0.61554617, -0.51195765, 0.599168] or
* // [-0.4695841, -0.14366731, -0.8711202] or
* // [0.6091097, -0.22805278, -0.7595902]
+ * print(v);
*
*
*/
-p5.Vector.random3D = function () {
- var angle,vz;
- // If we know about p5
- if (this.p5) {
- angle = this.p5.random(0,constants.TWO_PI);
- vz = this.p5.random(-1,1);
- } else {
- angle = Math.random()*Math.PI*2;
- vz = Math.random()*2-1;
- }
- var vx = Math.sqrt(1-vz*vz)*Math.cos(angle);
- var vy = Math.sqrt(1-vz*vz)*Math.sin(angle);
- if (this.p5) {
- return new p5.Vector(this.p5,[vx,vy,vz]);
- } else {
- return new p5.Vector(vx,vy,vz);
- }
+p5.Vector.random3D = function random3D() {
+ var angle = Math.random() * constants.TWO_PI;
+ var vz = Math.random() * 2 - 1;
+ var vzBase = Math.sqrt(1 - vz * vz);
+ var vx = vzBase * Math.cos(angle);
+ var vy = vzBase * Math.sin(angle);
+ return new p5.Vector(vx, vy, vz);
};
// Adds two vectors together and returns a new one.
/**
* @method add
* @static
- * @param {p5.Vector} v1 a p5.Vector to add
- * @param {p5.Vector} v2 a p5.Vector to add
+ * @param {p5.Vector} v1 a p5.Vector to add
+ * @param {p5.Vector} v2 a p5.Vector to add
* @param {p5.Vector} target the vector to receive the result
*/
/**
@@ -62664,11 +68702,11 @@ p5.Vector.random3D = function () {
* @static
* @param {p5.Vector} v1
* @param {p5.Vector} v2
- * @return {p5.Vector} the resulting p5.Vector
+ * @return {p5.Vector} the resulting p5.Vector
*
*/
-p5.Vector.add = function (v1, v2, target) {
+p5.Vector.add = function add(v1, v2, target) {
if (!target) {
target = v1.copy();
} else {
@@ -62679,14 +68717,14 @@ p5.Vector.add = function (v1, v2, target) {
};
/*
- * Subtracts one p5.Vector from another and returns a new one. The second
+ * Subtracts one p5.Vector from another and returns a new one. The second
* vector (v2) is subtracted from the first (v1), resulting in v1-v2.
*/
/**
* @method sub
* @static
- * @param {p5.Vector} v1 a p5.Vector to subtract from
- * @param {p5.Vector} v2 a p5.Vector to subtract
+ * @param {p5.Vector} v1 a p5.Vector to subtract from
+ * @param {p5.Vector} v2 a p5.Vector to subtract
* @param {p5.Vector} target if undefined a new vector will be created
*/
/**
@@ -62694,10 +68732,10 @@ p5.Vector.add = function (v1, v2, target) {
* @static
* @param {p5.Vector} v1
* @param {p5.Vector} v2
- * @return {p5.Vector} the resulting p5.Vector
+ * @return {p5.Vector} the resulting p5.Vector
*/
-p5.Vector.sub = function (v1, v2, target) {
+p5.Vector.sub = function sub(v1, v2, target) {
if (!target) {
target = v1.copy();
} else {
@@ -62707,7 +68745,6 @@ p5.Vector.sub = function (v1, v2, target) {
return target;
};
-
/**
* Multiplies a vector by a scalar and returns a new vector.
*/
@@ -62723,9 +68760,9 @@ p5.Vector.sub = function (v1, v2, target) {
* @static
* @param {p5.Vector} v
* @param {Number} n
- * @return {p5.Vector} the resulting new p5.Vector
+ * @return {p5.Vector} the resulting new p5.Vector
*/
-p5.Vector.mult = function (v, n, target) {
+p5.Vector.mult = function mult(v, n, target) {
if (!target) {
target = v.copy();
} else {
@@ -62750,9 +68787,9 @@ p5.Vector.mult = function (v, n, target) {
* @static
* @param {p5.Vector} v
* @param {Number} n
- * @return {p5.Vector} the resulting new p5.Vector
+ * @return {p5.Vector} the resulting new p5.Vector
*/
-p5.Vector.div = function (v, n, target) {
+p5.Vector.div = function div(v, n, target) {
if (!target) {
target = v.copy();
} else {
@@ -62762,18 +68799,17 @@ p5.Vector.div = function (v, n, target) {
return target;
};
-
/**
* Calculates the dot product of two vectors.
*/
/**
* @method dot
* @static
- * @param {p5.Vector} v1 the first p5.Vector
- * @param {p5.Vector} v2 the second p5.Vector
+ * @param {p5.Vector} v1 the first p5.Vector
+ * @param {p5.Vector} v2 the second p5.Vector
* @return {Number} the dot product
*/
-p5.Vector.dot = function (v1, v2) {
+p5.Vector.dot = function dot(v1, v2) {
return v1.dot(v2);
};
@@ -62783,11 +68819,11 @@ p5.Vector.dot = function (v1, v2) {
/**
* @method cross
* @static
- * @param {p5.Vector} v1 the first p5.Vector
- * @param {p5.Vector} v2 the second p5.Vector
+ * @param {p5.Vector} v1 the first p5.Vector
+ * @param {p5.Vector} v2 the second p5.Vector
* @return {Number} the cross product
*/
-p5.Vector.cross = function (v1, v2) {
+p5.Vector.cross = function cross(v1, v2) {
return v1.cross(v2);
};
@@ -62798,11 +68834,11 @@ p5.Vector.cross = function (v1, v2) {
/**
* @method dist
* @static
- * @param {p5.Vector} v1 the first p5.Vector
- * @param {p5.Vector} v2 the second p5.Vector
+ * @param {p5.Vector} v1 the first p5.Vector
+ * @param {p5.Vector} v2 the second p5.Vector
* @return {Number} the distance
*/
-p5.Vector.dist = function (v1,v2) {
+p5.Vector.dist = function dist(v1, v2) {
return v1.dist(v2);
};
@@ -62826,7 +68862,7 @@ p5.Vector.dist = function (v1,v2) {
* @param {Number} amt
* @return {Number} the lerped value
*/
-p5.Vector.lerp = function (v1, v2, amt, target) {
+p5.Vector.lerp = function lerp(v1, v2, amt, target) {
if (!target) {
target = v1.copy();
} else {
@@ -62842,7 +68878,7 @@ p5.Vector.lerp = function (v1, v2, amt, target) {
* @return {Number} the magnitude of vecT
* @static
*/
-p5.Vector.mag = function (vecT){
+p5.Vector.mag = function mag(vecT) {
var x = vecT.x,
y = vecT.y,
z = vecT.z;
@@ -62852,21 +68888,7 @@ p5.Vector.mag = function (vecT){
module.exports = p5.Vector;
-},{"../core/constants":54,"../core/core":55,"./polargeometry":87}],87:[function(_dereq_,module,exports){
-
-module.exports = {
-
- degreesToRadians: function(x) {
- return 2 * Math.PI * x / 360;
- },
-
- radiansToDegrees: function(x) {
- return 360 * x / (2 * Math.PI);
- }
-
-};
-
-},{}],88:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/main":25}],56:[function(_dereq_,module,exports){
/**
* @module Math
* @submodule Random
@@ -62876,7 +68898,7 @@ module.exports = {
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var seeded = false;
var previous = false;
@@ -62893,17 +68915,18 @@ var lcg = (function() {
a = 1664525,
// c and m should be co-prime
c = 1013904223,
- seed, z;
+ seed,
+ z;
return {
- setSeed : function(val) {
+ setSeed: function(val) {
// pick a random seed if val is undefined or null
// the >>> 0 casts the seed to an unsigned 32-bit integer
z = seed = (val == null ? Math.random() * m : val) >>> 0;
},
- getSeed : function() {
+ getSeed: function() {
return seed;
},
- rand : function() {
+ rand: function() {
// define the recurrence relationship
z = (a * z + c) % m;
// return a float in [0, 1)
@@ -62911,12 +68934,12 @@ var lcg = (function() {
return z / m;
}
};
-}());
+})();
/**
- * Sets the seed value for random().
+ * Sets the seed value for random().
*
- * By default, random() produces different results each time the program
+ * By default, random() produces different results each time the program
* is run. Set the seed parameter to a constant to return the same
* pseudo-random numbers each time the software is run.
*
@@ -62926,7 +68949,7 @@ var lcg = (function() {
*
*
* randomSeed(99);
- * for (var i=0; i < 100; i++) {
+ * for (var i = 0; i < 100; i++) {
* var r = random(0, 255);
* stroke(r);
* line(i, 0, i, 100);
@@ -62970,8 +68993,8 @@ p5.prototype.randomSeed = function(seed) {
*
* for (var i = 0; i < 100; i++) {
* var r = random(50);
- * stroke(r*5);
- * line(50, i, 50+r, i);
+ * stroke(r * 5);
+ * line(50, i, 50 + r, i);
* }
*
*
@@ -62979,16 +69002,16 @@ p5.prototype.randomSeed = function(seed) {
*
* for (var i = 0; i < 100; i++) {
* var r = random(-50, 50);
- * line(50,i,50+r,i);
+ * line(50, i, 50 + r, i);
* }
*
*
*
*
* // Get a random element from an array using the random(Array) syntax
- * var words = [ "apple", "bear", "cat", "dog" ];
- * var word = random(words); // select random word
- * text(word,10,50); // draw the word
+ * var words = ['apple', 'bear', 'cat', 'dog'];
+ * var word = random(words); // select random word
+ * text(word, 10, 50); // draw the word
*
*
*
@@ -63004,19 +69027,17 @@ p5.prototype.randomSeed = function(seed) {
* @return {*} the random element from the array
* @example
*/
-p5.prototype.random = function (min, max) {
-
+p5.prototype.random = function(min, max) {
var rand;
if (seeded) {
- rand = lcg.rand();
+ rand = lcg.rand();
} else {
rand = Math.random();
}
if (typeof min === 'undefined') {
return rand;
- } else
- if (typeof max === 'undefined') {
+ } else if (typeof max === 'undefined') {
if (min instanceof Array) {
return min[Math.floor(rand * min.length)];
} else {
@@ -63029,16 +69050,15 @@ p5.prototype.random = function (min, max) {
max = tmp;
}
- return rand * (max-min) + min;
+ return rand * (max - min) + min;
}
};
-
/**
*
* Returns a random number fitting a Gaussian, or
* normal, distribution. There is theoretically no minimum or maximum
- * value that randomGaussian() might return. Rather, there is
+ * value that randomGaussian() might return. Rather, there is
* just a very low probability that values far from the mean will be
* returned; and a higher probability that numbers near the mean will
* be returned.
@@ -63054,43 +69074,44 @@ p5.prototype.random = function (min, max) {
* @return {Number} the random number
* @example
*
- * for (var y = 0; y < 100; y++) {
- * var x = randomGaussian(50,15);
- * line(50, y, x, y);
- *}
+ *
+ * for (var y = 0; y < 100; y++) {
+ * var x = randomGaussian(50, 15);
+ * line(50, y, x, y);
+ * }
*
*
*
*
- *var distribution = new Array(360);
- *
- *function setup() {
- * createCanvas(100, 100);
- * for (var i = 0; i < distribution.length; i++) {
- * distribution[i] = floor(randomGaussian(0,15));
- * }
- *}
- *
- *function draw() {
- * background(204);
- *
- * translate(width/2, width/2);
- *
- * for (var i = 0; i < distribution.length; i++) {
- * rotate(TWO_PI/distribution.length);
- * stroke(0);
- * var dist = abs(distribution[i]);
- * line(0, 0, dist, 0);
- * }
- *}
+ * var distribution = new Array(360);
+ *
+ * function setup() {
+ * createCanvas(100, 100);
+ * for (var i = 0; i < distribution.length; i++) {
+ * distribution[i] = floor(randomGaussian(0, 15));
+ * }
+ * }
+ *
+ * function draw() {
+ * background(204);
+ *
+ * translate(width / 2, width / 2);
+ *
+ * for (var i = 0; i < distribution.length; i++) {
+ * rotate(TWO_PI / distribution.length);
+ * stroke(0);
+ * var dist = abs(distribution[i]);
+ * line(0, 0, dist, 0);
+ * }
+ * }
*
*
* @alt
* 100 horizontal lines from center of canvas. height & side change each render
* black lines radiate from center of canvas. size determined each render
*/
-p5.prototype.randomGaussian = function(mean, sd) {
- var y1,x1,x2,w;
+p5.prototype.randomGaussian = function(mean, sd) {
+ var y1, x1, x2, w;
if (previous) {
y1 = y2;
previous = false;
@@ -63100,7 +69121,7 @@ p5.prototype.randomGaussian = function(mean, sd) {
x2 = this.random(2) - 1;
w = x1 * x1 + x2 * x2;
} while (w >= 1);
- w = Math.sqrt((-2 * Math.log(w))/w);
+ w = Math.sqrt(-2 * Math.log(w) / w);
y1 = x1 * w;
y2 = x2 * w;
previous = true;
@@ -63108,31 +69129,33 @@ p5.prototype.randomGaussian = function(mean, sd) {
var m = mean || 0;
var s = sd || 1;
- return y1*s + m;
+ return y1 * s + m;
};
module.exports = p5;
-},{"../core/core":55}],89:[function(_dereq_,module,exports){
+},{"../core/main":25}],57:[function(_dereq_,module,exports){
/**
* @module Math
* @submodule Trigonometry
* @for p5
* @requires core
- * @requires polargeometry
* @requires constants
*/
'use strict';
-var p5 = _dereq_('../core/core');
-var polarGeometry = _dereq_('./polargeometry');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
+/*
+ * all DEGREES/RADIANS conversion should be done in the p5 instance
+ * if possible, using the p5._toRadians(), p5._fromRadians() methods.
+ */
p5.prototype._angleMode = constants.RADIANS;
/**
- * The inverse of cos(), returns the arc cosine of a value. This function
+ * 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).
*
@@ -63147,30 +69170,26 @@ p5.prototype._angleMode = constants.RADIANS;
* var c = cos(a);
* var ac = acos(c);
* // Prints: "3.1415927 : -1.0 : 3.1415927"
- * print(a + " : " + c + " : " + ac);
+ * print(a + ' : ' + c + ' : ' + ac);
*
*
*
*
*
- * var a = PI + PI/4.0;
+ * var a = PI + PI / 4.0;
* var c = cos(a);
* var ac = acos(c);
* // Prints: "3.926991 : -0.70710665 : 2.3561943"
- * print(a + " : " + c + " : " + ac);
+ * print(a + ' : ' + c + ' : ' + ac);
*
*
*/
p5.prototype.acos = function(ratio) {
- if (this._angleMode === constants.RADIANS) {
- return Math.acos(ratio);
- } else {
- return polarGeometry.radiansToDegrees(Math.acos(ratio));
- }
+ return this._fromRadians(Math.acos(ratio));
};
/**
- * The inverse of sin(), returns the arc sine of a value. This function
+ * 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 -PI/2 to PI/2.
*
@@ -63181,35 +69200,31 @@ p5.prototype.acos = function(ratio) {
* @example
*
*
- * var a = PI + PI/3;
+ * var a = PI + PI / 3;
* var s = sin(a);
* var as = asin(s);
* // Prints: "1.0471976 : 0.86602545 : 1.0471976"
- * print(a + " : " + s + " : " + as);
+ * print(a + ' : ' + s + ' : ' + as);
*
*
*
*
*
- * var a = PI + PI/3.0;
+ * var a = PI + PI / 3.0;
* var s = sin(a);
* var as = asin(s);
* // Prints: "4.1887903 : -0.86602545 : -1.0471976"
- * print(a + " : " + s + " : " + as);
+ * print(a + ' : ' + s + ' : ' + as);
*
*
*
*/
p5.prototype.asin = function(ratio) {
- if (this._angleMode === constants.RADIANS) {
- return Math.asin(ratio);
- } else {
- return polarGeometry.radiansToDegrees(Math.asin(ratio));
- }
+ return this._fromRadians(Math.asin(ratio));
};
/**
- * The inverse of tan(), returns the arc tangent of a value. This function
+ * The inverse of tan(), returns the arc tangent of a value. This function
* expects the values in the range of -Infinity to Infinity (exclusive) and
* values are returned in the range -PI/2 to PI/2.
*
@@ -63220,37 +69235,33 @@ p5.prototype.asin = function(ratio) {
* @example
*
*
- * var a = PI + PI/3;
+ * var a = PI + PI / 3;
* var t = tan(a);
* var at = atan(t);
* // Prints: "1.0471976 : 1.7320509 : 1.0471976"
- * print(a + " : " + t + " : " + at);
+ * print(a + ' : ' + t + ' : ' + at);
*
*
*
*
*
- * var a = PI + PI/3.0;
+ * var a = PI + PI / 3.0;
* var t = tan(a);
* var at = atan(t);
* // Prints: "4.1887903 : 1.7320513 : 1.0471977"
- * print(a + " : " + t + " : " + at);
+ * print(a + ' : ' + t + ' : ' + at);
*
*
*
*/
p5.prototype.atan = function(ratio) {
- if (this._angleMode === constants.RADIANS) {
- return Math.atan(ratio);
- } else {
- return polarGeometry.radiansToDegrees(Math.atan(ratio));
- }
+ return this._fromRadians(Math.atan(ratio));
};
/**
* 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
+ * 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
@@ -63267,8 +69278,8 @@ p5.prototype.atan = function(ratio) {
*
* function draw() {
* background(204);
- * translate(width/2, height/2);
- * var a = atan2(mouseY-height/2, mouseX-width/2);
+ * translate(width / 2, height / 2);
+ * var a = atan2(mouseY - height / 2, mouseX - width / 2);
* rotate(a);
* rect(-30, -5, 60, 10);
* }
@@ -63279,17 +69290,13 @@ p5.prototype.atan = function(ratio) {
* 60 by 10 rect at center of canvas rotates with mouse movements
*
*/
-p5.prototype.atan2 = function (y, x) {
- if (this._angleMode === constants.RADIANS) {
- return Math.atan2(y, x);
- } else {
- return polarGeometry.radiansToDegrees(Math.atan2(y, x));
- }
+p5.prototype.atan2 = function(y, x) {
+ return this._fromRadians(Math.atan2(y, x));
};
/**
* Calculates the cosine of an angle. This function takes into account the
- * current angleMode. Values are returned in the range -1 to 1.
+ * current angleMode. Values are returned in the range -1 to 1.
*
* @method cos
* @param {Number} angle the angle
@@ -63299,9 +69306,9 @@ p5.prototype.atan2 = function (y, x) {
*
*
* var a = 0.0;
- * var inc = TWO_PI/25.0;
+ * var inc = TWO_PI / 25.0;
* for (var i = 0; i < 25; i++) {
- * line(i*4, 50, i*4, 50+cos(a)*40.0);
+ * line(i * 4, 50, i * 4, 50 + cos(a) * 40.0);
* a = a + inc;
* }
*
@@ -63312,16 +69319,12 @@ p5.prototype.atan2 = function (y, x) {
*
*/
p5.prototype.cos = function(angle) {
- if (this._angleMode === constants.RADIANS) {
- return Math.cos(angle);
- } else {
- return Math.cos(this.radians(angle));
- }
+ return Math.cos(this._toRadians(angle));
};
/**
* Calculates the sine of an angle. This function takes into account the
- * current angleMode. Values are returned in the range -1 to 1.
+ * current angleMode. Values are returned in the range -1 to 1.
*
* @method sin
* @param {Number} angle the angle
@@ -63331,9 +69334,9 @@ p5.prototype.cos = function(angle) {
*
*
* var a = 0.0;
- * var inc = TWO_PI/25.0;
+ * var inc = TWO_PI / 25.0;
* for (var i = 0; i < 25; i++) {
- * line(i*4, 50, i*4, 50+sin(a)*40.0);
+ * line(i * 4, 50, i * 4, 50 + sin(a) * 40.0);
* a = a + inc;
* }
*
@@ -63344,16 +69347,12 @@ p5.prototype.cos = function(angle) {
*
*/
p5.prototype.sin = function(angle) {
- if (this._angleMode === constants.RADIANS) {
- return Math.sin(angle);
- } else {
- return Math.sin(this.radians(angle));
- }
+ return Math.sin(this._toRadians(angle));
};
/**
* Calculates the tangent of an angle. This function takes into account
- * the current angleMode. Values are returned in the range -1 to 1.
+ * the current angleMode. Values are returned in the range -1 to 1.
*
* @method tan
* @param {Number} angle the angle
@@ -63362,12 +69361,12 @@ p5.prototype.sin = function(angle) {
* @example
*
*
- * var a = 0.0;
- * var inc = TWO_PI/50.0;
- * for (var i = 0; i < 100; i = i+2) {
- * line(i, 50, i, 50+tan(a)*2.0);
- * a = a + inc;
- * }
+ * var a = 0.0;
+ * var inc = TWO_PI / 50.0;
+ * for (var i = 0; i < 100; i = i + 2) {
+ * line(i, 50, i, 50 + tan(a) * 2.0);
+ * a = a + inc;
+ * }
*
*
*
@@ -63376,18 +69375,15 @@ p5.prototype.sin = function(angle) {
*
*/
p5.prototype.tan = function(angle) {
- if (this._angleMode === constants.RADIANS) {
- return Math.tan(angle);
- } else {
- return Math.tan(this.radians(angle));
- }
+ return Math.tan(this._toRadians(angle));
};
/**
* 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.
+ * 90° = PI/2 = 1.5707964. This function does not take into account the
+ * current angleMode.
*
* @method degrees
* @param {Number} radians the radians value to convert to degrees
@@ -63397,23 +69393,24 @@ p5.prototype.tan = function(angle) {
* @example
*
*
- * var rad = PI/4;
+ * var rad = PI / 4;
* var deg = degrees(rad);
- * print(rad + " radians is " + deg + " degrees");
+ * print(rad + ' radians is ' + deg + ' degrees');
* // Prints: 0.7853981633974483 radians is 45 degrees
*
*
*
*/
p5.prototype.degrees = function(angle) {
- return polarGeometry.radiansToDegrees(angle);
+ return angle * constants.RAD_TO_DEG;
};
/**
* 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.
+ * 90° = PI/2 = 1.5707964. This function does not take into account the
+ * current angleMode.
*
* @method radians
* @param {Number} degrees the degree value to convert to radians
@@ -63424,13 +69421,13 @@ p5.prototype.degrees = function(angle) {
*
* var deg = 45.0;
* var rad = radians(deg);
- * print(deg + " degrees is " + rad + " radians");
+ * print(deg + ' degrees is ' + rad + ' radians');
* // Prints: 45 degrees is 0.7853981633974483 radians
*
*
*/
p5.prototype.radians = function(angle) {
- return polarGeometry.degreesToRadians(angle);
+ return angle * constants.DEG_TO_RAD;
};
/**
@@ -63442,11 +69439,11 @@ p5.prototype.radians = function(angle) {
* @example
*
*
- * function draw(){
+ * function draw() {
* background(204);
* angleMode(DEGREES); // Change the mode to DEGREES
- * var a = atan2(mouseY-height/2, mouseX-width/2);
- * translate(width/2, height/2);
+ * var a = atan2(mouseY - height / 2, mouseX - width / 2);
+ * translate(width / 2, height / 2);
* push();
* rotate(a);
* rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees
@@ -63469,9 +69466,54 @@ p5.prototype.angleMode = function(mode) {
}
};
+/**
+ * converts angles from the current angleMode to RADIANS
+ *
+ * @method _toRadians
+ * @private
+ * @param {Number} angle
+ * @returns {Number}
+ */
+p5.prototype._toRadians = function(angle) {
+ if (this._angleMode === constants.DEGREES) {
+ return angle * constants.DEG_TO_RAD;
+ }
+ return angle;
+};
+
+/**
+ * converts angles from the current angleMode to DEGREES
+ *
+ * @method _toDegrees
+ * @private
+ * @param {Number} angle
+ * @returns {Number}
+ */
+p5.prototype._toDegrees = function(angle) {
+ if (this._angleMode === constants.RADIANS) {
+ return angle * constants.RAD_TO_DEG;
+ }
+ return angle;
+};
+
+/**
+ * converts angles from RADIANS into the current angleMode
+ *
+ * @method _fromRadians
+ * @private
+ * @param {Number} angle
+ * @returns {Number}
+ */
+p5.prototype._fromRadians = function(angle) {
+ if (this._angleMode === constants.DEGREES) {
+ return angle * constants.RAD_TO_DEG;
+ }
+ return angle;
+};
+
module.exports = p5;
-},{"../core/constants":54,"../core/core":55,"./polargeometry":87}],90:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/main":25}],58:[function(_dereq_,module,exports){
/**
* @module Typography
* @submodule Attributes
@@ -63482,7 +69524,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* Sets the current alignment for drawing text. Accepts two
@@ -63490,11 +69532,11 @@ var p5 = _dereq_('../core/core');
* vertAlign (TOP, BOTTOM, CENTER, or BASELINE).
*
* The horizAlign parameter is in reference to the x value
- * of the text() function, while the vertAlign parameter is
+ * of the text() function, while the vertAlign parameter is
* in reference to the y value.
*
* So if you write textAlign(LEFT), you are aligning the left
- * edge of your text to the x value you give in text(). If you
+ * edge of your text to the x value you give in text(). If you
* write textAlign(RIGHT, TOP), you are aligning the right edge
* of your text to the x value and the top of edge of the text
* to the y value.
@@ -63504,93 +69546,124 @@ var p5 = _dereq_('../core/core');
* CENTER, or RIGHT
* @param {Constant} [vertAlign] vertical alignment, either TOP,
* BOTTOM, CENTER, or BASELINE
- * @return {Number}
+ * @chainable
* @example
*
*
* textSize(16);
* textAlign(RIGHT);
- * text("ABCD", 50, 30);
+ * text('ABCD', 50, 30);
* textAlign(CENTER);
- * text("EFGH", 50, 50);
+ * text('EFGH', 50, 50);
* textAlign(LEFT);
- * text("IJKL", 50, 70);
+ * text('IJKL', 50, 70);
+ *
+ *
+ *
+ *
+ *
+ * textSize(16);
+ * strokeWeight(0.5);
+ *
+ * line(0, 12, width, 12);
+ * textAlign(CENTER, TOP);
+ * text('TOP', 0, 12, width);
+ *
+ * line(0, 37, width, 37);
+ * textAlign(CENTER, CENTER);
+ * text('CENTER', 0, 37, width);
+ *
+ * line(0, 62, width, 62);
+ * textAlign(CENTER, BASELINE);
+ * text('BASELINE', 0, 62, width);
+ *
+ * line(0, 87, width, 87);
+ * textAlign(CENTER, BOTTOM);
+ * text('BOTTOM', 0, 87, width);
*
*
*
* @alt
*Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left.
+ * The names of the four vertical alignments rendered each showing that alignment's placement relative to a horizontal line.
*
*/
+/**
+ * @method textAlign
+ * @return {Object}
+ */
p5.prototype.textAlign = function(horizAlign, vertAlign) {
+ p5._validateParameters('textAlign', arguments);
return this._renderer.textAlign.apply(this._renderer, arguments);
};
/**
* Sets/gets the spacing, in pixels, between lines of text. This
- * setting will be used in all subsequent calls to the text() function.
+ * setting will be used in all subsequent calls to the text() function.
*
* @method textLeading
* @param {Number} leading the size in pixels for spacing between lines
* @chainable
- */
-/**
- * @method textLeading
- * @return {Number}
+ *
* @example
*
*
* // Text to display. The "\n" is a "new line" character
- * lines = "L1\nL2\nL3";
+ * var lines = 'L1\nL2\nL3';
* textSize(12);
*
- * textLeading(10); // Set leading to 10
+ * textLeading(10); // Set leading to 10
* text(lines, 10, 25);
*
- * textLeading(20); // Set leading to 20
+ * textLeading(20); // Set leading to 20
* text(lines, 40, 25);
*
- * textLeading(30); // Set leading to 30
+ * textLeading(30); // Set leading to 30
* text(lines, 70, 25);
*
*
*
* @alt
*set L1 L2 & L3 displayed vertically 3 times. spacing increases for each set
- *
+ */
+/**
+ * @method textLeading
+ * @return {Number}
*/
p5.prototype.textLeading = function(theLeading) {
+ p5._validateParameters('textLeading', arguments);
return this._renderer.textLeading.apply(this._renderer, arguments);
};
/**
* Sets/gets the current font size. This size will be used in all subsequent
- * calls to the text() function. Font size is measured in pixels.
+ * calls to the text() function. Font size is measured in pixels.
*
* @method textSize
* @param {Number} theSize the size of the letters in units of pixels
* @chainable
- */
-/**
- * @method textSize
- * @return {Number}
+ *
* @example
*
*
* textSize(12);
- * text("Font Size 12", 10, 30);
+ * text('Font Size 12', 10, 30);
* textSize(14);
- * text("Font Size 14", 10, 60);
+ * text('Font Size 14', 10, 60);
* textSize(16);
- * text("Font Size 16", 10, 90);
+ * text('Font Size 16', 10, 90);
*
*
*
* @alt
*Font Size 12 displayed small, Font Size 14 medium & Font Size 16 large
- *
+ */
+/**
+ * @method textSize
+ * @return {Number}
*/
p5.prototype.textSize = function(theSize) {
+ p5._validateParameters('textSize', arguments);
return this._renderer.textSize.apply(this._renderer, arguments);
};
@@ -63603,29 +69676,29 @@ p5.prototype.textSize = function(theSize) {
* @param {Constant} theStyle styling for text, either NORMAL,
* ITALIC, or BOLD
* @chainable
- */
-/**
- * @method textStyle
- * @return {String}
* @example
*
*
* strokeWeight(0);
* textSize(12);
* textStyle(NORMAL);
- * text("Font Style Normal", 10, 30);
+ * text('Font Style Normal', 10, 30);
* textStyle(ITALIC);
- * text("Font Style Italic", 10, 60);
+ * text('Font Style Italic', 10, 60);
* textStyle(BOLD);
- * text("Font Style Bold", 10, 90);
+ * text('Font Style Bold', 10, 90);
*
*
*
* @alt
*words Font Style Normal displayed normally, Italic in italic and bold in bold
- *
+ */
+/**
+ * @method textStyle
+ * @return {String}
*/
p5.prototype.textStyle = function(theStyle) {
+ p5._validateParameters('textStyle', arguments);
return this._renderer.textStyle.apply(this._renderer, arguments);
};
@@ -63645,7 +69718,7 @@ p5.prototype.textStyle = function(theStyle) {
* text(aChar, 0, 40);
* line(cWidth, 0, cWidth, 50);
*
- * var aString = "p5.js";
+ * var aString = 'p5.js';
* var sWidth = textWidth(aString);
* text(aString, 0, 85);
* line(sWidth, 50, sWidth, 100);
@@ -63657,6 +69730,7 @@ p5.prototype.textStyle = function(theStyle) {
*
*/
p5.prototype.textWidth = function(theText) {
+ p5._validateParameters('textWidth', arguments);
if (theText.length === 0) {
return 0;
}
@@ -63675,19 +69749,20 @@ p5.prototype.textWidth = function(theText) {
* var base = height * 0.75;
* var scalar = 0.8; // Different for each font
*
- * textSize(32); // Set initial text size
- * var asc = textAscent() * scalar; // Calc ascent
+ * textSize(32); // Set initial text size
+ * var asc = textAscent() * scalar; // Calc ascent
* line(0, base - asc, width, base - asc);
- * text("dp", 0, base); // Draw text on baseline
+ * text('dp', 0, base); // Draw text on baseline
*
- * textSize(64); // Increase text size
- * asc = textAscent() * scalar; // Recalc ascent
+ * textSize(64); // Increase text size
+ * asc = textAscent() * scalar; // Recalc ascent
* line(40, base - asc, width, base - asc);
- * text("dp", 40, base); // Draw text on baseline
+ * text('dp', 40, base); // Draw text on baseline
*
*
*/
p5.prototype.textAscent = function() {
+ p5._validateParameters('textAscent', arguments);
return this._renderer.textAscent();
};
@@ -63703,19 +69778,20 @@ p5.prototype.textAscent = function() {
* var base = height * 0.75;
* var scalar = 0.8; // Different for each font
*
- * textSize(32); // Set initial text size
- * var desc = textDescent() * scalar; // Calc ascent
- * line(0, base+desc, width, base+desc);
- * text("dp", 0, base); // Draw text on baseline
+ * textSize(32); // Set initial text size
+ * var desc = textDescent() * scalar; // Calc ascent
+ * line(0, base + desc, width, base + desc);
+ * text('dp', 0, base); // Draw text on baseline
*
- * textSize(64); // Increase text size
- * desc = textDescent() * scalar; // Recalc ascent
+ * textSize(64); // Increase text size
+ * desc = textDescent() * scalar; // Recalc ascent
* line(40, base + desc, width, base + desc);
- * text("dp", 40, base); // Draw text on baseline
+ * text('dp', 40, base); // Draw text on baseline
*
*
*/
p5.prototype.textDescent = function() {
+ p5._validateParameters('textDescent', arguments);
return this._renderer.textDescent();
};
@@ -63728,7 +69804,7 @@ p5.prototype._updateTextMetrics = function() {
module.exports = p5;
-},{"../core/core":55}],91:[function(_dereq_,module,exports){
+},{"../core/main":25}],59:[function(_dereq_,module,exports){
/**
* @module Typography
* @submodule Loading & Displaying
@@ -63738,7 +69814,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
var opentype = _dereq_('opentype.js');
@@ -63758,13 +69834,14 @@ _dereq_('../core/error_helpers');
* @method loadFont
* @param {String} path name of the file or url to load
* @param {Function} [callback] function to be executed after
- * loadFont()
- * completes
- * @return {p5.Font} p5.Font object
+ * loadFont() completes
+ * @param {Function} [onError] function to be executed if
+ * an error occurs
+ * @return {p5.Font} p5.Font object
* @example
*
- * Calling loadFont() inside preload() guarantees that the load
- * operation will have completed before setup() and draw() are called.
+ * Calling loadFont() inside preload() guarantees that the load
+ * operation will have completed before setup() and draw() are called.
*
*
* var myFont;
@@ -63780,7 +69857,7 @@ _dereq_('../core/error_helpers');
* }
*
*
- * Outside of preload(), you may supply a callback function to handle the
+ * Outside of preload(), you may supply a callback function to handle the
* object:
*
*
@@ -63793,17 +69870,14 @@ _dereq_('../core/error_helpers');
* textFont(font, 36);
* text('p5*js', 10, 50);
* }
- *
*
*
* You can also use the string name of the font to style other HTML
* elements.
*
*
- * var myFont;
- *
* function preload() {
- * myFont = loadFont('assets/Avenir.otf');
+ * loadFont('assets/Avenir.otf');
* }
*
* function setup() {
@@ -63817,15 +69891,13 @@ _dereq_('../core/error_helpers');
* p5*js in p5's theme dark pink
*
*/
-p5.prototype.loadFont = function (path, onSuccess, onError) {
-
+p5.prototype.loadFont = function(path, onSuccess, onError) {
+ p5._validateParameters('loadFont', arguments);
var p5Font = new p5.Font(this);
var self = this;
- opentype.load(path, function (err, font) {
-
+ opentype.load(path, function(err, font) {
if (err) {
-
if (typeof onError !== 'undefined') {
return onError(err);
}
@@ -63843,21 +69915,33 @@ p5.prototype.loadFont = function (path, onSuccess, onError) {
self._decrementPreload();
// check that we have an acceptable font type
- var validFontTypes = [ 'ttf', 'otf', 'woff', 'woff2' ],
- fileNoPath = path.split('\\').pop().split('/').pop(),
- lastDotIdx = fileNoPath.lastIndexOf('.'), fontFamily, newStyle,
+ var validFontTypes = ['ttf', 'otf', 'woff', 'woff2'],
+ fileNoPath = path
+ .split('\\')
+ .pop()
+ .split('/')
+ .pop(),
+ lastDotIdx = fileNoPath.lastIndexOf('.'),
+ fontFamily,
+ newStyle,
fileExt = lastDotIdx < 1 ? null : fileNoPath.substr(lastDotIdx + 1);
// if so, add it to the DOM (name-only) for use with p5.dom
if (validFontTypes.indexOf(fileExt) > -1) {
-
fontFamily = fileNoPath.substr(0, lastDotIdx);
newStyle = document.createElement('style');
- newStyle.appendChild(document.createTextNode('\n@font-face {' +
- '\nfont-family: ' + fontFamily + ';\nsrc: url(' + path + ');\n}\n'));
+ newStyle.appendChild(
+ document.createTextNode(
+ '\n@font-face {' +
+ '\nfont-family: ' +
+ fontFamily +
+ ';\nsrc: url(' +
+ path +
+ ');\n}\n'
+ )
+ );
document.head.appendChild(newStyle);
}
-
});
return p5Font;
@@ -63867,123 +69951,157 @@ p5.prototype.loadFont = function (path, onSuccess, onError) {
* Draws text to the screen. Displays the information specified in the first
* parameter on the screen in the position specified by the additional
* parameters. A default font will be used unless a font is set with the
- * textFont() function and a default size will be used unless a font is set
- * with textSize(). Change the color of the text with the fill() function.
- * Change the outline of the text with the stroke() and strokeWeight()
+ * textFont() function and a default size will be used unless a font is set
+ * with textSize(). Change the color of the text with the fill() function.
+ * Change the outline of the text with the stroke() and strokeWeight()
* functions.
*
- * The text displays in relation to the textAlign() function, which gives the
+ * The text displays in relation to the textAlign() function, which gives the
* option to draw to the left, right, and center of the coordinates.
*
* The x2 and y2 parameters define a rectangular area to display within and
* may only be used with string data. When these parameters are specified,
- * they are interpreted based on the current rectMode() setting. Text that
+ * they are interpreted based on the current rectMode() setting. Text that
* does not fit completely within the rectangle specified will not be drawn
- * to the screen.
+ * to the screen. If x2 and y2 are not specified, the baseline alignment is the
+ * default, which means that the text will be drawn upwards from x and y.
+ *
+ * WEBGL: Only opentype/truetype fonts are supported. You must load a font using the
+ * loadFont() method (see the example above).
+ * stroke() currently has no effect in webgl mode.
*
* @method text
- * @param {String} str the alphanumeric symbols to be displayed
+ * @param {String|Object|Array|Number|Boolean} str the alphanumeric
+ * symbols to be displayed
* @param {Number} x x-coordinate of text
* @param {Number} y y-coordinate of text
* @param {Number} [x2] by default, the width of the text box,
- * see rectMode() for more info
+ * see rectMode() for more info
* @param {Number} [y2] by default, the height of the text box,
- * see rectMode() for more info
- * @return {p5} this
+ * see rectMode() for more info
+ * @chainable
* @example
*
*
* textSize(32);
- * text("word", 10, 30);
+ * text('word', 10, 30);
* fill(0, 102, 153);
- * text("word", 10, 60);
+ * text('word', 10, 60);
* fill(0, 102, 153, 51);
- * text("word", 10, 90);
+ * text('word', 10, 90);
*
*
*
*
- * s = "The quick brown fox jumped over the lazy dog.";
+ * var s = 'The quick brown fox jumped over the lazy dog.';
* fill(50);
* text(s, 10, 10, 70, 80); // Text wraps within text box
*
*
*
+ *
+ *
+ * var avenir;
+ * function preload() {
+ * avenir = loadFont('assets/Avenir.otf');
+ * }
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * textFont(avenir);
+ * textSize(width / 3);
+ * textAlign(CENTER, CENTER);
+ * }
+ * function draw() {
+ * background(0);
+ * var time = millis();
+ * rotateX(time / 1000);
+ * rotateZ(time / 1234);
+ * text('p5.js', 0, 0);
+ * }
+ *
+ *
+ *
* @alt
*'word' displayed 3 times going from black, blue to translucent blue
* The quick brown fox jumped over the lazy dog.
+ * the text 'p5.js' spinning in 3d
*
*/
p5.prototype.text = function(str, x, y, maxWidth, maxHeight) {
- return (!(this._renderer._doFill || this._renderer._doStroke)) ? this :
- this._renderer.text.apply(this._renderer, arguments);
+ p5._validateParameters('text', arguments);
+ return !(this._renderer._doFill || this._renderer._doStroke)
+ ? this
+ : this._renderer.text.apply(this._renderer, arguments);
};
/**
- * Sets the current font that will be drawn with the text() function.
+ * Sets the current font that will be drawn with the text() function.
+ *
+ * WEBGL: Only fonts loaded via loadFont() are supported.
*
* @method textFont
* @return {Object} the current font
- */
-/**
- * @method textFont
- * @param {Object|String} font a font loaded via loadFont(), or a String
- * representing a web safe font (a font
- * that is generally available across all systems)
- * @param {Number} [size] the font size to use
- * @chainable
+ *
* @example
*
*
* fill(0);
* textSize(12);
- * textFont("Georgia");
- * text("Georgia", 12, 30);
- * textFont("Helvetica");
- * text("Helvetica", 12, 60);
+ * textFont('Georgia');
+ * text('Georgia', 12, 30);
+ * textFont('Helvetica');
+ * text('Helvetica', 12, 60);
*
*
*
*
* var fontRegular, fontItalic, fontBold;
* function preload() {
- * fontRegular = loadFont("assets/Regular.otf");
- * fontItalic = loadFont("assets/Italic.ttf");
- * fontBold = loadFont("assets/Bold.ttf");
+ * fontRegular = loadFont('assets/Regular.otf');
+ * fontItalic = loadFont('assets/Italic.ttf');
+ * fontBold = loadFont('assets/Bold.ttf');
* }
* function setup() {
- * background(210);
- * fill(0).strokeWeight(0).textSize(10);
- * textFont(fontRegular);
- * text("Font Style Normal", 10, 30);
- * textFont(fontItalic);
- * text("Font Style Italic", 10, 50);
- * textFont(fontBold);
- * text("Font Style Bold", 10, 70);
+ * background(210);
+ * fill(0)
+ .strokeWeight(0)
+ .textSize(10);
+ * textFont(fontRegular);
+ * text('Font Style Normal', 10, 30);
+ * textFont(fontItalic);
+ * text('Font Style Italic', 10, 50);
+ * textFont(fontBold);
+ * text('Font Style Bold', 10, 70);
* }
*
*
*
* @alt
*words Font Style Normal displayed normally, Italic in italic and bold in bold
- *
+ */
+/**
+ * @method textFont
+ * @param {Object|String} font a font loaded via loadFont(), or a String
+ * representing a web safe font (a font
+ * that is generally available across all systems)
+ * @param {Number} [size] the font size to use
+ * @chainable
*/
p5.prototype.textFont = function(theFont, theSize) {
-
+ p5._validateParameters('textFont', arguments);
if (arguments.length) {
-
if (!theFont) {
-
- throw Error('null font passed to textFont');
+ throw new Error('null font passed to textFont');
}
this._renderer._setProperty('_textFont', theFont);
if (theSize) {
-
this._renderer._setProperty('_textSize', theSize);
- this._renderer._setProperty('_textLeading',
- theSize * constants._DEFAULT_LEADMULT);
+ this._renderer._setProperty(
+ '_textLeading',
+ theSize * constants._DEFAULT_LEADMULT
+ );
}
return this._renderer._applyTextProperties();
@@ -63994,9 +70112,9 @@ p5.prototype.textFont = function(theFont, theSize) {
module.exports = p5;
-},{"../core/constants":54,"../core/core":55,"../core/error_helpers":58,"opentype.js":18}],92:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/error_helpers":21,"../core/main":25,"opentype.js":11}],60:[function(_dereq_,module,exports){
/**
- * This module defines the p5.Font class and functions for
+ * This module defines the p5.Font class and functions for
* drawing text to the display canvas.
* @module Typography
* @submodule Font
@@ -64006,7 +70124,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
/*
@@ -64018,11 +70136,9 @@ var constants = _dereq_('../core/constants');
/**
* Base class for font handling
* @class p5.Font
- * @constructor
* @param {p5} [pInst] pointer to p5 instance
*/
p5.Font = function(p) {
-
this.parent = p;
this.cache = {};
@@ -64032,13 +70148,11 @@ p5.Font = function(p) {
* @property font
*/
this.font = undefined;
- this.name = 'p5.Font'; // for friendly debugger system
};
p5.Font.prototype.list = function() {
-
// TODO
- throw 'not yet implemented';
+ throw new Error('not yet implemented');
};
/**
@@ -64049,8 +70163,8 @@ p5.Font.prototype.list = function() {
* @param {String} line a line of text
* @param {Number} x x-position
* @param {Number} y y-position
- * @param {Number} fontSize font size to use (optional)
- * @param {Object} options opentype options (optional)
+ * @param {Number} [fontSize] font size to use (optional)
+ * @param {Object} [options] opentype options (optional)
*
* @return {Object} a rectangle object with properties: x, y, w, h
*
@@ -64060,22 +70174,22 @@ p5.Font.prototype.list = function() {
* var font;
* var textString = 'Lorem ipsum dolor sit amet.';
* function preload() {
- * font = loadFont('./assets/Regular.otf');
- * };
+ * font = loadFont('./assets/Regular.otf');
+ * }
* function setup() {
- * background(210);
- *
- * var bbox = font.textBounds(textString, 10, 30, 12);
- * fill(255);
- * stroke(0);
- * rect(bbox.x, bbox.y, bbox.w, bbox.h);
- * fill(0);
- * noStroke();
- *
- * textFont(font);
- * textSize(12);
- * text(textString, 10, 30);
- * };
+ * background(210);
+ *
+ * var bbox = font.textBounds(textString, 10, 30, 12);
+ * fill(255);
+ * stroke(0);
+ * rect(bbox.x, bbox.y, bbox.w, bbox.h);
+ * fill(0);
+ * noStroke();
+ *
+ * textFont(font);
+ * textSize(12);
+ * text(textString, 10, 30);
+ * }
*
*
*
@@ -64084,7 +70198,6 @@ p5.Font.prototype.list = function() {
*
*/
p5.Font.prototype.textBounds = function(str, x, y, fontSize, options) {
-
x = x !== undefined ? x : 0;
y = y !== undefined ? y : 0;
fontSize = fontSize || this.parent._renderer._textSize;
@@ -64092,27 +70205,36 @@ p5.Font.prototype.textBounds = function(str, x, y, fontSize, options) {
// Check cache for existing bounds. Take into consideration the text alignment
// settings. Default alignment should match opentype's origin: left-aligned &
// alphabetic baseline.
- var p = (options && options.renderer && options.renderer._pInst) ||
- this.parent, ctx = p._renderer.drawingContext,
- alignment = ctx.textAlign || constants.LEFT,
- baseline = ctx.textBaseline || constants.BASELINE,
+ var p =
+ (options && options.renderer && options.renderer._pInst) || this.parent,
+ renderer = p._renderer,
+ alignment = renderer._textAlign || constants.LEFT,
+ baseline = renderer._textBaseline || constants.BASELINE,
key = cacheKey('textBounds', str, x, y, fontSize, alignment, baseline),
result = this.cache[key];
if (!result) {
-
- var minX, minY, maxX, maxY, pos, xCoords = [], yCoords = [],
+ var minX,
+ minY,
+ maxX,
+ maxY,
+ pos,
+ xCoords = [],
+ yCoords = [],
scale = this._scale(fontSize);
- this.font.forEachGlyph(str, x, y, fontSize, options,
- function(glyph, gX, gY, gFontSize) {
-
- var gm = glyph.getMetrics();
- xCoords.push(gX + (gm.xMin * scale));
- xCoords.push(gX + (gm.xMax * scale));
- yCoords.push(gY + (-gm.yMin * scale));
- yCoords.push(gY + (-gm.yMax * scale));
- });
+ this.font.forEachGlyph(str, x, y, fontSize, options, function(
+ glyph,
+ gX,
+ gY,
+ gFontSize
+ ) {
+ var gm = glyph.getMetrics();
+ xCoords.push(gX + gm.xMin * scale);
+ xCoords.push(gX + gm.xMax * scale);
+ yCoords.push(gY + -gm.yMin * scale);
+ yCoords.push(gY + -gm.yMax * scale);
+ });
minX = Math.min.apply(null, xCoords);
minY = Math.min.apply(null, yCoords);
@@ -64128,20 +70250,25 @@ p5.Font.prototype.textBounds = function(str, x, y, fontSize, options) {
};
// Bounds are now calculated, so shift the x & y to match alignment settings
- pos = this._handleAlignment(p, ctx, str, result.x, result.y,
- result.w + result.advance);
+ pos = this._handleAlignment(
+ renderer,
+ str,
+ result.x,
+ result.y,
+ result.w + result.advance
+ );
result.x = pos.x;
result.y = pos.y;
- this.cache[cacheKey('textBounds', str, x, y, fontSize, alignment,
- baseline)] = result;
+ this.cache[
+ cacheKey('textBounds', str, x, y, fontSize, alignment, baseline)
+ ] = result;
}
return result;
};
-
/**
* Computes an array of points following the path for specified text
*
@@ -64150,7 +70277,7 @@ p5.Font.prototype.textBounds = function(str, x, y, fontSize, options) {
* @param {Number} x x-position
* @param {Number} y y-position
* @param {Number} fontSize font size to use (optional)
- * @param {Object} options an (optional) object that can contain:
+ * @param {Object} [options] an (optional) object that can contain:
*
*
sampleFactor - the ratio of path-length to number of samples
* (default=.25); higher values yield more points and are therefore
@@ -64161,28 +70288,69 @@ p5.Font.prototype.textBounds = function(str, x, y, fontSize, options) {
* when determining whether two edges are collinear
*
* @return {Array} an array of points, each with x, y, alpha (the path angle)
+ * @example
+ *
+ *
+ * var font;
+ * function preload() {
+ * font = loadFont('./assets/Avenir.otf');
+ * }
+ *
+ * var points;
+ * var bounds;
+ * function setup() {
+ * createCanvas(100, 100);
+ * stroke(0);
+ * fill(255, 104, 204);
+ *
+ * points = font.textToPoints('p5', 0, 0, 10, {
+ * sampleFactor: 5,
+ * simplifyThreshold: 0
+ * });
+ * bounds = font.textBounds(' p5 ', 0, 0, 10);
+ * }
+ *
+ * function draw() {
+ * background(255);
+ * beginShape();
+ * translate(-bounds.x * width / bounds.w, -bounds.y * height / bounds.h);
+ * for (var i = 0; i < points.length; i++) {
+ * var p = points[i];
+ * vertex(
+ * p.x * width / bounds.w +
+ * sin(20 * p.y / bounds.h + millis() / 1000) * width / 30,
+ * p.y * height / bounds.h
+ * );
+ * }
+ * endShape(CLOSE);
+ * }
+ *
+ *
+ *
*/
p5.Font.prototype.textToPoints = function(txt, x, y, fontSize, options) {
+ var xoff = 0,
+ result = [],
+ glyphs = this._getGlyphs(txt);
function isSpace(i) {
- return ((glyphs[i].name && glyphs[i].name === 'space') ||
+ return (
+ (glyphs[i].name && glyphs[i].name === 'space') ||
(txt.length === glyphs.length && txt[i] === ' ') ||
- (glyphs[i].index && glyphs[i].index === 3));
+ (glyphs[i].index && glyphs[i].index === 3)
+ );
}
- var xoff = 0, result = [], glyphs = this._getGlyphs(txt);
-
fontSize = fontSize || this.parent._renderer._textSize;
for (var i = 0; i < glyphs.length; i++) {
-
- if (!isSpace(i)) { // fix to #1817, #2069
+ if (!isSpace(i)) {
+ // fix to #1817, #2069
var gpath = glyphs[i].getPath(x, y, fontSize),
paths = splitPaths(gpath.commands);
for (var j = 0; j < paths.length; j++) {
-
var pts = pathToPoints(paths[j], options);
for (var k = 0; k < pts.length; k++) {
@@ -64207,17 +70375,18 @@ p5.Font.prototype.textToPoints = function(txt, x, y, fontSize, options) {
* and glyphs, so the list of returned glyphs can be larger or smaller
* than the length of the given string.
*
+ * @private
* @param {String} str the string to be converted
* @return {Array} the opentype glyphs
*/
p5.Font.prototype._getGlyphs = function(str) {
-
return this.font.stringToGlyphs(str);
};
/**
* Returns an opentype path for the supplied string and position.
*
+ * @private
* @param {String} line a line of text
* @param {Number} x x-position
* @param {Number} y y-position
@@ -64225,13 +70394,12 @@ p5.Font.prototype._getGlyphs = function(str) {
* @return {Object} the opentype path
*/
p5.Font.prototype._getPath = function(line, x, y, options) {
+ var p =
+ (options && options.renderer && options.renderer._pInst) || this.parent,
+ renderer = p._renderer,
+ pos = this._handleAlignment(renderer, line, x, y);
- var p = (options && options.renderer && options.renderer._pInst) ||
- this.parent,
- ctx = p._renderer.drawingContext,
- pos = this._handleAlignment(p, ctx, line, x, y);
-
- return this.font.getPath(line, pos.x, pos.y, p._renderer._textSize, options);
+ return this.font.getPath(line, pos.x, pos.y, renderer._textSize, options);
};
/*
@@ -64250,23 +70418,18 @@ p5.Font.prototype._getPath = function(line, x, y, options) {
* @return {Object} this p5.Font object
*/
p5.Font.prototype._getPathData = function(line, x, y, options) {
-
var decimals = 3;
// create path from string/position
if (typeof line === 'string' && arguments.length > 2) {
-
line = this._getPath(line, x, y, options);
- }
- // handle options specified in 2nd arg
- else if (typeof x === 'object') {
-
+ } else if (typeof x === 'object') {
+ // handle options specified in 2nd arg
options = x;
}
// handle svg arguments
if (options && typeof options.decimals === 'number') {
-
decimals = options.decimals;
}
@@ -64291,17 +70454,13 @@ p5.Font.prototype._getPathData = function(line, x, y, options) {
* @return {Object} this p5.Font object
*/
p5.Font.prototype._getSVG = function(line, x, y, options) {
-
var decimals = 3;
// create path from string/position
if (typeof line === 'string' && arguments.length > 2) {
-
line = this._getPath(line, x, y, options);
- }
- // handle options specified in 2nd arg
- else if (typeof x === 'object') {
-
+ } else if (typeof x === 'object') {
+ // handle options specified in 2nd arg
options = x;
}
@@ -64338,22 +70497,19 @@ p5.Font.prototype._getSVG = function(line, x, y, options) {
* @return {p5.Font} this p5.Font object
*/
p5.Font.prototype._renderPath = function(line, x, y, options) {
-
- var pdata, pg = (options && options.renderer) || this.parent._renderer,
+ var pdata,
+ pg = (options && options.renderer) || this.parent._renderer,
ctx = pg.drawingContext;
if (typeof line === 'object' && line.commands) {
-
pdata = line.commands;
} else {
-
//pos = handleAlignment(p, ctx, line, x, y);
pdata = this._getPath(line, x, y, options).commands;
}
ctx.beginPath();
for (var i = 0; i < pdata.length; i += 1) {
-
var cmd = pdata[i];
if (cmd.type === 'M') {
ctx.moveTo(cmd.x, cmd.y);
@@ -64370,12 +70526,10 @@ p5.Font.prototype._renderPath = function(line, x, y, options) {
// only draw stroke if manually set by user
if (pg._doStroke && pg._strokeSet) {
-
ctx.stroke();
}
if (pg._doFill) {
-
// if fill hasn't been set by user, use default-text-fill
if (!pg._fillSet) {
pg._setFill(constants._DEFAULT_TEXT_FILL);
@@ -64387,46 +70541,49 @@ p5.Font.prototype._renderPath = function(line, x, y, options) {
};
p5.Font.prototype._textWidth = function(str, fontSize) {
-
return this.font.getAdvanceWidth(str, fontSize);
};
p5.Font.prototype._textAscent = function(fontSize) {
-
return this.font.ascender * this._scale(fontSize);
};
p5.Font.prototype._textDescent = function(fontSize) {
-
return -this.font.descender * this._scale(fontSize);
};
p5.Font.prototype._scale = function(fontSize) {
-
- return (1 / this.font.unitsPerEm) * (fontSize ||
- this.parent._renderer._textSize);
+ return (
+ 1 / this.font.unitsPerEm * (fontSize || this.parent._renderer._textSize)
+ );
};
-p5.Font.prototype._handleAlignment = function(p, ctx, line, x, y, textWidth) {
- var fontSize = p._renderer._textSize,
- textAscent = this._textAscent(fontSize),
- textDescent = this._textDescent(fontSize);
+p5.Font.prototype._handleAlignment = function(renderer, line, x, y, textWidth) {
+ var fontSize = renderer._textSize;
- textWidth = textWidth !== undefined ? textWidth :
- this._textWidth(line, fontSize);
+ if (typeof textWidth === 'undefined') {
+ textWidth = this._textWidth(line, fontSize);
+ }
- if (ctx.textAlign === constants.CENTER) {
- x -= textWidth / 2;
- } else if (ctx.textAlign === constants.RIGHT) {
- x -= textWidth;
+ switch (renderer._textAlign) {
+ case constants.CENTER:
+ x -= textWidth / 2;
+ break;
+ case constants.RIGHT:
+ x -= textWidth;
+ break;
}
- if (ctx.textBaseline === constants.TOP) {
- y += textAscent;
- } else if (ctx.textBaseline === constants._CTX_MIDDLE) {
- y += textAscent / 2;
- } else if (ctx.textBaseline === constants.BOTTOM) {
- y -= textDescent;
+ switch (renderer._textBaseline) {
+ case constants.TOP:
+ y += this._textAscent(fontSize);
+ break;
+ case constants.CENTER:
+ y += this._textAscent(fontSize) / 2;
+ break;
+ case constants.BOTTOM:
+ y -= this._textDescent(fontSize);
+ break;
}
return { x: x, y: y };
@@ -64435,13 +70592,12 @@ p5.Font.prototype._handleAlignment = function(p, ctx, line, x, y, textWidth) {
// path-utils
function pathToPoints(cmds, options) {
-
var opts = parseOpts(options, {
sampleFactor: 0.1,
- simplifyThreshold: 0,
+ simplifyThreshold: 0
});
- var len = pointAtLength(cmds,0,1), // total-length
+ var len = pointAtLength(cmds, 0, 1), // total-length
t = len / (len * opts.sampleFactor),
pts = [];
@@ -64450,7 +70606,7 @@ function pathToPoints(cmds, options) {
}
if (opts.simplifyThreshold) {
- /*var count = */simplify(pts, opts.simplifyThreshold);
+ /*var count = */ simplify(pts, opts.simplifyThreshold);
//console.log('Simplify: removed ' + count + ' pts');
}
@@ -64458,14 +70614,11 @@ function pathToPoints(cmds, options) {
}
function simplify(pts, angle) {
-
- angle = (typeof angle === 'undefined') ? 0 : angle;
+ angle = typeof angle === 'undefined' ? 0 : angle;
var num = 0;
for (var i = pts.length - 1; pts.length > 3 && i >= 0; --i) {
-
if (collinear(at(pts, i - 1), at(pts, i), at(pts, i + 1), angle)) {
-
// Remove the middle point
pts.splice(i % pts.length, 1);
num++;
@@ -64475,8 +70628,8 @@ function simplify(pts, angle) {
}
function splitPaths(cmds) {
-
- var paths = [], current;
+ var paths = [],
+ current;
for (var i = 0; i < cmds.length; i++) {
if (cmds[i].type === 'M') {
if (current) {
@@ -64492,9 +70645,9 @@ function splitPaths(cmds) {
}
function cmdToArr(cmd) {
-
- var arr = [ cmd.type ];
- if (cmd.type === 'M' || cmd.type === 'L') { // moveto or lineto
+ var arr = [cmd.type];
+ if (cmd.type === 'M' || cmd.type === 'L') {
+ // moveto or lineto
arr.push(cmd.x, cmd.y);
} else if (cmd.type === 'C') {
arr.push(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
@@ -64506,11 +70659,9 @@ function cmdToArr(cmd) {
}
function parseOpts(options, defaults) {
-
if (typeof options !== 'object') {
options = defaults;
- }
- else {
+ } else {
for (var key in defaults) {
if (typeof options[key] === 'undefined') {
options[key] = defaults[key];
@@ -64528,7 +70679,6 @@ function at(v, i) {
}
function collinear(a, b, c, thresholdAngle) {
-
if (!thresholdAngle) {
return areaTriangle(a, b, c) === 0;
}
@@ -64538,7 +70688,8 @@ function collinear(a, b, c, thresholdAngle) {
collinear.tmpPoint2 = [];
}
- var ab = collinear.tmpPoint1, bc = collinear.tmpPoint2;
+ var ab = collinear.tmpPoint1,
+ bc = collinear.tmpPoint2;
ab.x = b.x - a.x;
ab.y = b.y - a.y;
bc.x = c.x - b.x;
@@ -64553,40 +70704,80 @@ function collinear(a, b, c, thresholdAngle) {
}
function areaTriangle(a, b, c) {
- return (((b[0] - a[0]) * (c[1] - a[1])) - ((c[0] - a[0]) * (b[1] - a[1])));
+ return (b[0] - a[0]) * (c[1] - a[1]) - (c[0] - a[0]) * (b[1] - a[1]);
}
// Portions of below code copyright 2008 Dmitry Baranovskiy (via MIT license)
function findDotsAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t) {
-
- var t1 = 1 - t, t13 = Math.pow(t1, 3), t12 = Math.pow(t1, 2), t2 = t * t,
- t3 = t2 * t, x = t13 * p1x + t12 * 3 * t * c1x + t1 * 3 * t * t * c2x +
- t3 * p2x, y = t13 * p1y + t12 * 3 * t * c1y + t1 * 3 * t * t * c2y +
- t3 * p2y, mx = p1x + 2 * t * (c1x - p1x) + t2 * (c2x - 2 * c1x + p1x),
+ var t1 = 1 - t,
+ t13 = Math.pow(t1, 3),
+ t12 = Math.pow(t1, 2),
+ t2 = t * t,
+ t3 = t2 * t,
+ x = t13 * p1x + t12 * 3 * t * c1x + t1 * 3 * t * t * c2x + t3 * p2x,
+ y = t13 * p1y + t12 * 3 * t * c1y + t1 * 3 * t * t * c2y + t3 * p2y,
+ mx = p1x + 2 * t * (c1x - p1x) + t2 * (c2x - 2 * c1x + p1x),
my = p1y + 2 * t * (c1y - p1y) + t2 * (c2y - 2 * c1y + p1y),
nx = c1x + 2 * t * (c2x - c1x) + t2 * (p2x - 2 * c2x + c1x),
ny = c1y + 2 * t * (c2y - c1y) + t2 * (p2y - 2 * c2y + c1y),
- ax = t1 * p1x + t * c1x, ay = t1 * p1y + t * c1y,
- cx = t1 * c2x + t * p2x, cy = t1 * c2y + t * p2y,
- alpha = (90 - Math.atan2(mx - nx, my - ny) * 180 / Math.PI);
+ ax = t1 * p1x + t * c1x,
+ ay = t1 * p1y + t * c1y,
+ cx = t1 * c2x + t * p2x,
+ cy = t1 * c2y + t * p2y,
+ alpha = 90 - Math.atan2(mx - nx, my - ny) * 180 / Math.PI;
- if (mx > nx || my < ny) { alpha += 180; }
+ if (mx > nx || my < ny) {
+ alpha += 180;
+ }
- return { x: x, y: y, m: { x: mx, y: my }, n: { x: nx, y: ny },
- start: { x: ax, y: ay }, end: { x: cx, y: cy }, alpha: alpha
+ return {
+ x: x,
+ y: y,
+ m: { x: mx, y: my },
+ n: { x: nx, y: ny },
+ start: { x: ax, y: ay },
+ end: { x: cx, y: cy },
+ alpha: alpha
};
}
-function getPointAtSegmentLength(p1x,p1y,c1x,c1y,c2x,c2y,p2x,p2y,length) {
- return (length == null) ? bezlen(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y) :
- findDotsAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y,
- getTatLen(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, length));
+function getPointAtSegmentLength(
+ p1x,
+ p1y,
+ c1x,
+ c1y,
+ c2x,
+ c2y,
+ p2x,
+ p2y,
+ length
+) {
+ return length == null
+ ? bezlen(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y)
+ : findDotsAtSegment(
+ p1x,
+ p1y,
+ c1x,
+ c1y,
+ c2x,
+ c2y,
+ p2x,
+ p2y,
+ getTatLen(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, length)
+ );
}
function pointAtLength(path, length, istotal) {
path = path2curve(path);
- var x, y, p, l, sp = '', subpaths = {}, point, len = 0;
+ var x,
+ y,
+ p,
+ l,
+ sp = '',
+ subpaths = {},
+ point,
+ len = 0;
for (var i = 0, ii = path.length; i < ii; i++) {
p = path[i];
if (p[0] === 'M') {
@@ -64596,8 +70787,17 @@ function pointAtLength(path, length, istotal) {
l = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6]);
if (len + l > length) {
if (!istotal) {
- point = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5],
- p[6], length - len);
+ point = getPointAtSegmentLength(
+ x,
+ y,
+ p[1],
+ p[2],
+ p[3],
+ p[4],
+ p[5],
+ p[6],
+ length - len
+ );
return { x: point.x, y: point.y, alpha: point.alpha };
}
}
@@ -64609,8 +70809,9 @@ function pointAtLength(path, length, istotal) {
}
subpaths.end = sp;
- point = istotal ? len : findDotsAtSegment
- (x, y, p[0], p[1], p[2], p[3], p[4], p[5], 1);
+ point = istotal
+ ? len
+ : findDotsAtSegment(x, y, p[0], p[1], p[2], p[3], p[4], p[5], 1);
if (point.alpha) {
point = { x: point.x, y: point.y, alpha: point.alpha };
@@ -64620,8 +70821,12 @@ function pointAtLength(path, length, istotal) {
}
function pathToAbsolute(pathArray) {
-
- var res = [], x = 0, y = 0, mx = 0, my = 0, start = 0;
+ var res = [],
+ x = 0,
+ y = 0,
+ mx = 0,
+ my = 0,
+ start = 0;
if (!pathArray) {
// console.warn("Unexpected state: undefined pathArray"); // shouldn't happen
return res;
@@ -64635,11 +70840,15 @@ function pathToAbsolute(pathArray) {
res[0] = ['M', x, y];
}
- var dots,crz = pathArray.length===3 && pathArray[0][0]==='M' &&
- pathArray[1][0].toUpperCase()==='R' && pathArray[2][0].toUpperCase()==='Z';
+ var dots,
+ crz =
+ pathArray.length === 3 &&
+ pathArray[0][0] === 'M' &&
+ pathArray[1][0].toUpperCase() === 'R' &&
+ pathArray[2][0].toUpperCase() === 'Z';
for (var r, pa, i = start, ii = pathArray.length; i < ii; i++) {
- res.push(r = []);
+ res.push((r = []));
pa = pathArray[i];
if (pa[0] !== String.prototype.toUpperCase.call(pa[0])) {
r[0] = String.prototype.toUpperCase.call(pa[0]);
@@ -64674,7 +70883,7 @@ function pathToAbsolute(pathArray) {
break;
default:
for (j = 1, jj = pa.length; j < jj; j++) {
- r[j] = +pa[j] + ((j % 2) ? x : y);
+ r[j] = +pa[j] + (j % 2 ? x : y);
}
}
} else if (pa[0] === 'R') {
@@ -64711,15 +70920,24 @@ function pathToAbsolute(pathArray) {
}
function path2curve(path, path2) {
-
- var p = pathToAbsolute(path), p2 = path2 && pathToAbsolute(path2),
- attrs = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null },
- attrs2 = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null },
-
- processPath = function(path, d, pcom) {
- var nx, ny, tq = { T: 1, Q: 1 };
- if (!path) { return ['C', d.x, d.y, d.x, d.y, d.x, d.y]; }
- if (!(path[0] in tq)) { d.qx = d.qy = null; }
+ var p = pathToAbsolute(path),
+ p2 = path2 && pathToAbsolute(path2);
+ var attrs = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null };
+ var attrs2 = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null };
+ var pcoms1 = []; // path commands of original path p
+ var pcoms2 = []; // path commands of original path p2
+ var ii;
+
+ var processPath = function(path, d, pcom) {
+ var nx,
+ ny,
+ tq = { T: 1, Q: 1 };
+ if (!path) {
+ return ['C', d.x, d.y, d.x, d.y, d.x, d.y];
+ }
+ if (!(path[0] in tq)) {
+ d.qx = d.qy = null;
+ }
switch (path[0]) {
case 'M':
d.X = path[1];
@@ -64751,7 +70969,9 @@ function path2curve(path, path2) {
case 'Q':
d.qx = path[1];
d.qy = path[2];
- path = ['C'].concat(q2c(d.x,d.y,path[1],path[2],path[3],path[4]));
+ path = ['C'].concat(
+ q2c(d.x, d.y, path[1], path[2], path[3], path[4])
+ );
break;
case 'L':
path = ['C'].concat(l2c(d.x, d.y, path[1], path[2]));
@@ -64768,21 +70988,21 @@ function path2curve(path, path2) {
}
return path;
},
-
fixArc = function(pp, i) {
if (pp[i].length > 7) {
pp[i].shift();
var pi = pp[i];
while (pi.length) {
pcoms1[i] = 'A';
- if (p2) { pcoms2[i] = 'A'; }
+ if (p2) {
+ pcoms2[i] = 'A';
+ }
pp.splice(i++, 0, ['C'].concat(pi.splice(0, 6)));
}
pp.splice(i, 1);
- ii = Math.max(p.length, p2 && p2.length || 0);
+ ii = Math.max(p.length, (p2 && p2.length) || 0);
}
},
-
fixM = function(path1, path2, a1, a2, i) {
if (path1 && path2 && path1[i][0] === 'M' && path2[i][0] !== 'M') {
path2.splice(i, 0, ['M', a2.x, a2.y]);
@@ -64790,43 +71010,57 @@ function path2curve(path, path2) {
a1.by = 0;
a1.x = path1[i][1];
a1.y = path1[i][2];
- ii = Math.max(p.length, p2 && p2.length || 0);
+ ii = Math.max(p.length, (p2 && p2.length) || 0);
}
- },
+ };
- pcoms1 = [], // path commands of original path p
- pcoms2 = [], // path commands of original path p2
- pfirst = '', // temporary holder for original path command
- pcom = ''; // holder for previous path command of original path
+ var pfirst = ''; // temporary holder for original path command
+ var pcom = ''; // holder for previous path command of original path
- for (var i = 0, ii = Math.max(p.length, p2 && p2.length || 0); i < ii; i++) {
- if (p[i]) { pfirst = p[i][0]; } // save current path command
+ ii = Math.max(p.length, (p2 && p2.length) || 0);
+ for (var i = 0; i < ii; i++) {
+ if (p[i]) {
+ pfirst = p[i][0];
+ } // save current path command
if (pfirst !== 'C') {
pcoms1[i] = pfirst; // Save current path command
- if (i) { pcom = pcoms1[i - 1]; } // Get previous path command pcom
+ if (i) {
+ pcom = pcoms1[i - 1];
+ } // Get previous path command pcom
}
p[i] = processPath(p[i], attrs, pcom);
- if (pcoms1[i] !== 'A' && pfirst === 'C') { pcoms1[i] = 'C'; }
+ if (pcoms1[i] !== 'A' && pfirst === 'C') {
+ pcoms1[i] = 'C';
+ }
fixArc(p, i); // fixArc adds also the right amount of A:s to pcoms1
- if (p2) { // the same procedures is done to p2
- if (p2[i]) { pfirst = p2[i][0]; }
+ if (p2) {
+ // the same procedures is done to p2
+ if (p2[i]) {
+ pfirst = p2[i][0];
+ }
if (pfirst !== 'C') {
pcoms2[i] = pfirst;
- if (i) { pcom = pcoms2[i - 1]; }
+ if (i) {
+ pcom = pcoms2[i - 1];
+ }
}
p2[i] = processPath(p2[i], attrs2, pcom);
- if (pcoms2[i] !== 'A' && pfirst === 'C') { pcoms2[i] = 'C'; }
+ if (pcoms2[i] !== 'A' && pfirst === 'C') {
+ pcoms2[i] = 'C';
+ }
fixArc(p2, i);
}
fixM(p, p2, attrs, attrs2, i);
fixM(p2, p, attrs2, attrs, i);
- var seg = p[i], seg2 = p2 && p2[i], seglen = seg.length,
+ var seg = p[i],
+ seg2 = p2 && p2[i],
+ seglen = seg.length,
seg2len = p2 && seg2.length;
attrs.x = seg[seglen - 2];
attrs.y = seg[seglen - 1];
@@ -64844,9 +71078,16 @@ function path2curve(path, path2) {
function a2c(x1, y1, rx, ry, angle, lac, sweep_flag, x2, y2, recursive) {
// for more information of where this Math came from visit:
// http://www.w3.org/TR/SVG11/implnote.html#ArcImplementationNotes
- var PI = Math.PI, _120 = PI * 120 / 180, f1, f2, cx, cy,
- rad = PI / 180 * (+angle || 0), res = [], xy,
- rotate = function (x, y, rad) {
+ var PI = Math.PI,
+ _120 = PI * 120 / 180,
+ f1,
+ f2,
+ cx,
+ cy,
+ rad = PI / 180 * (+angle || 0),
+ res = [],
+ xy,
+ rotate = function(x, y, rad) {
var X = x * Math.cos(rad) - y * Math.sin(rad),
Y = x * Math.sin(rad) + y * Math.cos(rad);
return { x: X, y: Y };
@@ -64858,16 +71099,23 @@ function a2c(x1, y1, rx, ry, angle, lac, sweep_flag, x2, y2, recursive) {
xy = rotate(x2, y2, -rad);
x2 = xy.x;
y2 = xy.y;
- var x = (x1 - x2) / 2, y = (y1 - y2) / 2,
- h = (x * x) / (rx * rx) + (y * y) / (ry * ry);
+ var x = (x1 - x2) / 2,
+ y = (y1 - y2) / 2,
+ h = x * x / (rx * rx) + y * y / (ry * ry);
if (h > 1) {
h = Math.sqrt(h);
rx = h * rx;
ry = h * ry;
}
- var rx2 = rx * rx, ry2 = ry * ry,
- k = (lac === sweep_flag ? -1 : 1) * Math.sqrt(Math.abs
- ((rx2 * ry2 - rx2 * y * y - ry2 * x * x)/(rx2 * y * y + ry2 * x * x)));
+ var rx2 = rx * rx,
+ ry2 = ry * ry;
+ var k =
+ (lac === sweep_flag ? -1 : 1) *
+ Math.sqrt(
+ Math.abs(
+ (rx2 * ry2 - rx2 * y * y - ry2 * x * x) / (rx2 * y * y + ry2 * x * x)
+ )
+ );
cx = k * rx * y / ry + (x1 + x2) / 2;
cy = k * -ry * x / rx + (y1 + y2) / 2;
@@ -64877,8 +71125,12 @@ function a2c(x1, y1, rx, ry, angle, lac, sweep_flag, x2, y2, recursive) {
f1 = x1 < cx ? PI - f1 : f1;
f2 = x2 < cx ? PI - f2 : f2;
- if (f1 < 0) { f1 = PI * 2 + f1; }
- if (f2 < 0) { f2 = PI * 2 + f2; }
+ if (f1 < 0) {
+ f1 = PI * 2 + f1;
+ }
+ if (f2 < 0) {
+ f2 = PI * 2 + f2;
+ }
if (sweep_flag && f1 > f2) {
f1 = f1 - PI * 2;
@@ -64894,12 +71146,18 @@ function a2c(x1, y1, rx, ry, angle, lac, sweep_flag, x2, y2, recursive) {
}
var df = f2 - f1;
if (Math.abs(df) > _120) {
- var f2old = f2, x2old = x2, y2old = y2;
+ var f2old = f2,
+ x2old = x2,
+ y2old = y2;
f2 = f1 + _120 * (sweep_flag && f2 > f1 ? 1 : -1);
x2 = cx + rx * Math.cos(f2);
y2 = cy + ry * Math.sin(f2);
- res = a2c(x2, y2, rx, ry, angle, 0, sweep_flag, x2old, y2old,
- [f2, f2old, cx, cy]);
+ res = a2c(x2, y2, rx, ry, angle, 0, sweep_flag, x2old, y2old, [
+ f2,
+ f2old,
+ cx,
+ cy
+ ]);
}
df = f2 - f1;
var c1 = Math.cos(f1),
@@ -64918,11 +71176,16 @@ function a2c(x1, y1, rx, ry, angle, lac, sweep_flag, x2, y2, recursive) {
if (recursive) {
return [m2, m3, m4].concat(res);
} else {
- res = [m2, m3, m4].concat(res).join().split(',');
+ res = [m2, m3, m4]
+ .concat(res)
+ .join()
+ .split(',');
var newres = [];
for (var i = 0, ii = res.length; i < ii; i++) {
- newres[i] = i % 2 ? rotate(res[i - 1], res[i], rad).y : rotate(res[i],
- res[i + 1], rad).x;
+ newres[i] =
+ i % 2
+ ? rotate(res[i - 1], res[i], rad).y
+ : rotate(res[i], res[i + 1], rad).x;
}
return newres;
}
@@ -64932,19 +71195,24 @@ function a2c(x1, y1, rx, ry, angle, lac, sweep_flag, x2, y2, recursive) {
function catmullRom2bezier(crp, z) {
var d = [];
for (var i = 0, iLen = crp.length; iLen - 2 * !z > i; i += 2) {
- var p = [{
- x: +crp[i - 2],
- y: +crp[i - 1]
- }, {
- x: +crp[i],
- y: +crp[i + 1]
- }, {
- x: +crp[i + 2],
- y: +crp[i + 3]
- }, {
- x: +crp[i + 4],
- y: +crp[i + 5]
- }];
+ var p = [
+ {
+ x: +crp[i - 2],
+ y: +crp[i - 1]
+ },
+ {
+ x: +crp[i],
+ y: +crp[i + 1]
+ },
+ {
+ x: +crp[i + 2],
+ y: +crp[i + 3]
+ },
+ {
+ x: +crp[i + 4],
+ y: +crp[i + 5]
+ }
+ ];
if (z) {
if (!i) {
p[0] = {
@@ -64976,32 +71244,75 @@ function catmullRom2bezier(crp, z) {
};
}
}
- d.push(['C', (-p[0].x + 6 * p[1].x + p[2].x) / 6, (-p[0].y + 6 * p[1].y +
- p[2].y) / 6, (p[1].x + 6 * p[2].x - p[3].x) / 6, (p[1].y + 6 * p[2].y -
- p[3].y) / 6, p[2].x, p[2].y ]);
+ d.push([
+ 'C',
+ (-p[0].x + 6 * p[1].x + p[2].x) / 6,
+ (-p[0].y + 6 * p[1].y + p[2].y) / 6,
+ (p[1].x + 6 * p[2].x - p[3].x) / 6,
+ (p[1].y + 6 * p[2].y - p[3].y) / 6,
+ p[2].x,
+ p[2].y
+ ]);
}
return d;
}
-function l2c(x1, y1, x2, y2) { return [x1, y1, x2, y2, x2, y2]; }
+function l2c(x1, y1, x2, y2) {
+ return [x1, y1, x2, y2, x2, y2];
+}
function q2c(x1, y1, ax, ay, x2, y2) {
- var _13 = 1 / 3, _23 = 2 / 3;
+ var _13 = 1 / 3,
+ _23 = 2 / 3;
return [
- _13 * x1 + _23 * ax, _13 * y1 + _23 * ay,
- _13 * x2 + _23 * ax, _13 * y2 + _23 * ay, x2, y2
+ _13 * x1 + _23 * ax,
+ _13 * y1 + _23 * ay,
+ _13 * x2 + _23 * ax,
+ _13 * y2 + _23 * ay,
+ x2,
+ y2
];
}
function bezlen(x1, y1, x2, y2, x3, y3, x4, y4, z) {
- if (z == null) { z = 1; }
+ if (z == null) {
+ z = 1;
+ }
z = z > 1 ? 1 : z < 0 ? 0 : z;
- var z2 = z / 2,
- n = 12, Tvalues = [-0.1252, 0.1252, -0.3678, 0.3678, -0.5873, 0.5873,
- -0.7699, 0.7699, -0.9041, 0.9041, -0.9816, 0.9816],
- sum = 0, Cvalues = [0.2491, 0.2491, 0.2335, 0.2335, 0.2032, 0.2032,
- 0.1601, 0.1601, 0.1069, 0.1069, 0.0472, 0.0472 ];
+ var z2 = z / 2;
+ var n = 12;
+ var Tvalues = [
+ -0.1252,
+ 0.1252,
+ -0.3678,
+ 0.3678,
+ -0.5873,
+ 0.5873,
+ -0.7699,
+ 0.7699,
+ -0.9041,
+ 0.9041,
+ -0.9816,
+ 0.9816
+ ];
+
+ var sum = 0;
+ var Cvalues = [
+ 0.2491,
+ 0.2491,
+ 0.2335,
+ 0.2335,
+ 0.2032,
+ 0.2032,
+ 0.1601,
+ 0.1601,
+ 0.1069,
+ 0.1069,
+ 0.0472,
+ 0.0472
+ ];
+
for (var i = 0; i < n; i++) {
var ct = z2 * Tvalues[i] + z2,
xbase = base3(ct, x1, x2, x3, x4),
@@ -65016,7 +71327,11 @@ function getTatLen(x1, y1, x2, y2, x3, y3, x4, y4, ll) {
if (ll < 0 || bezlen(x1, y1, x2, y2, x3, y3, x4, y4) < ll) {
return;
}
- var t = 1, step = t / 2, t2 = t - step, l, e = 0.01;
+ var t = 1,
+ step = t / 2,
+ t2 = t - step,
+ l,
+ e = 0.01;
l = bezlen(x1, y1, x2, y2, x3, y3, x4, y4, t2);
while (Math.abs(l - ll) > e) {
step /= 2;
@@ -65033,22 +71348,17 @@ function base3(t, p1, p2, p3, p4) {
}
function cacheKey() {
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- i = args.length;
var hash = '';
- while (i--) {
- hash += (args[i] === Object(args[i])) ?
- JSON.stringify(args[i]) : args[i];
+ for (var i = arguments.length - 1; i >= 0; --i) {
+ var v = arguments[i];
+ hash += v === Object(v) ? JSON.stringify(v) : v;
}
return hash;
}
module.exports = p5;
-},{"../core/constants":54,"../core/core":55}],93:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/main":25}],61:[function(_dereq_,module,exports){
/**
* @module Data
* @submodule Array Functions
@@ -65058,27 +71368,27 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* Adds a value to the end of an array. Extends the length of
* the array by one. Maps to Array.push().
*
* @method append
+ * @deprecated Use array.push(value) instead.
* @param {Array} array Array to append
* @param {any} value to be added to the Array
+ * @return {Array} the array that was appended to
* @example
- *
+ *
* function setup() {
+ * var myArray = ['Mango', 'Apple', 'Papaya'];
+ * print(myArray); // ['Mango', 'Apple', 'Papaya']
*
- * var myArray = new Array("Mango", "Apple", "Papaya")
- * print(myArray) // ["Mango", "Apple", "Papaya"]
- *
- * append(myArray, "Peach")
- * print(myArray) // ["Mango", "Apple", "Papaya", "Peach"]
- *
+ * append(myArray, 'Peach');
+ * print(myArray); // ['Mango', 'Apple', 'Papaya', 'Peach']
* }
- *
+ *
*/
p5.prototype.append = function(array, value) {
array.push(value);
@@ -65091,7 +71401,7 @@ p5.prototype.append = function(array, value) {
* srcPosition and into the position specified by dstPosition. The number of
* elements to copy is determined by length. Note that copying values
* overwrites existing values in the destination array. To append values
- * instead of overwriting them, use concat().
+ * instead of overwriting them, use concat().
*
* The simplified version with only two arguments, arrayCopy(src, dst),
* copies an entire array to another of the same size. It is equivalent to
@@ -65101,61 +71411,52 @@ p5.prototype.append = function(array, value) {
* iterating through a for() loop and copying each element individually.
*
* @method arrayCopy
+ * @deprecated
* @param {Array} src the source Array
- * @param {Number} srcPosition starting position in the source Array
+ * @param {Integer} srcPosition starting position in the source Array
* @param {Array} dst the destination Array
- * @param {Number} dstPosition starting position in the destination Array
- * @param {Number} length number of Array elements to be copied
+ * @param {Integer} dstPosition starting position in the destination Array
+ * @param {Integer} length number of Array elements to be copied
+ *
+ * @example
+ *
+ * var src = ['A', 'B', 'C'];
+ * var dst = [1, 2, 3];
+ * var srcPosition = 1;
+ * var dstPosition = 0;
+ * var length = 2;
+ *
+ * print(src); // ['A', 'B', 'C']
+ * print(dst); // [ 1 , 2 , 3 ]
+ *
+ * arrayCopy(src, srcPosition, dst, dstPosition, length);
+ * print(dst); // ['B', 'C', 3]
+ *
*/
/**
* @method arrayCopy
+ * @deprecated Use arr1.copyWithin(arr2) instead.
* @param {Array} src
* @param {Array} dst
- * @param {Number} [length]
- *
- * @example
- *
- * function setup() {
- *
- * var src = new Array("A", "B", "C");
- * var dst = new Array( 1 , 2 , 3 );
- * var srcPosition = 1;
- * var dstPosition = 0;
- * var length = 2;
- *
- * print(src); // ["A", "B", "C"]
- * print(dst); // [ 1 , 2 , 3 ]
- *
- * arrayCopy(src, srcPosition, dst, dstPosition, length);
- * print(dst); // ["B", "C", 3]
- *
- * }
- *
+ * @param {Integer} [length]
*/
-p5.prototype.arrayCopy = function(
- src,
- srcPosition,
- dst,
- dstPosition,
- length) {
-
+p5.prototype.arrayCopy = function(src, srcPosition, dst, dstPosition, length) {
// the index to begin splicing from dst array
- var start,
- end;
+ var start;
+ var end;
if (typeof length !== 'undefined') {
-
end = Math.min(length, src.length);
start = dstPosition;
src = src.slice(srcPosition, end + srcPosition);
-
} else {
-
- if (typeof dst !== 'undefined') { // src, dst, length
+ if (typeof dst !== 'undefined') {
+ // src, dst, length
// rename so we don't get confused
end = dst;
end = Math.min(end, src.length);
- } else { // src, dst
+ } else {
+ // src, dst
end = src.length;
}
@@ -65169,7 +71470,6 @@ p5.prototype.arrayCopy = function(
// we must modify the actual values of the array
// instead of reassigning arrays
Array.prototype.splice.apply(dst, [start, end].concat(src));
-
};
/**
@@ -65177,1601 +71477,3413 @@ p5.prototype.arrayCopy = function(
* input arrays.
*
* @method concat
+ * @deprecated Use arr1.concat(arr2) instead.
* @param {Array} a first Array to concatenate
* @param {Array} b second Array to concatenate
* @return {Array} concatenated array
*
* @example
- *
+ *
* function setup() {
- * var arr1 = new Array("A", "B", "C");
- * var arr2 = new Array( 1 , 2 , 3 );
+ * var arr1 = ['A', 'B', 'C'];
+ * var arr2 = [1, 2, 3];
*
- * print(arr1); // ["A","B","C"]
+ * print(arr1); // ['A','B','C']
* print(arr2); // [1,2,3]
*
* var arr3 = concat(arr1, arr2);
*
- * print(arr1); // ["A","B","C"]
- * print(arr2); // [1,2,3]
- * print(arr3); // ["A","B","C",1,2,3]
+ * print(arr1); // ['A','B','C']
+ * print(arr2); // [1, 2, 3]
+ * print(arr3); // ['A','B','C', 1, 2, 3]
+ * }
+ *
+ */
+p5.prototype.concat = function(list0, list1) {
+ return list0.concat(list1);
+};
+
+/**
+ * Reverses the order of an array, maps to Array.reverse()
+ *
+ * @method reverse
+ * @deprecated Use array.reverse() instead.
+ * @param {Array} list Array to reverse
+ * @return {Array} the reversed list
+ * @example
+ *
+ * function setup() {
+ * var myArray = ['A', 'B', 'C'];
+ * print(myArray); // ['A','B','C']
+ *
+ * reverse(myArray);
+ * print(myArray); // ['C','B','A']
+ * }
+ *
+ */
+p5.prototype.reverse = function(list) {
+ return list.reverse();
+};
+
+/**
+ * Decreases an array by one element and returns the shortened array,
+ * maps to Array.pop().
+ *
+ * @method shorten
+ * @deprecated Use array.pop() instead.
+ * @param {Array} list Array to shorten
+ * @return {Array} shortened Array
+ * @example
+ *
+ * function setup() {
+ * var myArray = ['A', 'B', 'C'];
+ * print(myArray); // ['A', 'B', 'C']
+ * var newArray = shorten(myArray);
+ * print(myArray); // ['A','B','C']
+ * print(newArray); // ['A','B']
+ * }
+ *
+ */
+p5.prototype.shorten = function(list) {
+ list.pop();
+ return list;
+};
+
+/**
+ * Randomizes the order of the elements of an array. Implements
+ *
+ * Fisher-Yates Shuffle Algorithm.
+ *
+ * @method shuffle
+ * @deprecated See shuffling an array with JS instead.
+ * @param {Array} array Array to shuffle
+ * @param {Boolean} [bool] modify passed array
+ * @return {Array} shuffled Array
+ * @example
+ *
+ * function setup() {
+ * var regularArr = ['ABC', 'def', createVector(), TAU, Math.E];
+ * print(regularArr);
+ * shuffle(regularArr, true); // force modifications to passed array
+ * print(regularArr);
+ *
+ * // By default shuffle() returns a shuffled cloned array:
+ * var newArr = shuffle(regularArr);
+ * print(regularArr);
+ * print(newArr);
+ * }
+ *
+ */
+p5.prototype.shuffle = function(arr, bool) {
+ var isView = ArrayBuffer && ArrayBuffer.isView && ArrayBuffer.isView(arr);
+ arr = bool || isView ? arr : arr.slice();
+
+ var rnd,
+ tmp,
+ idx = arr.length;
+ while (idx > 1) {
+ rnd = (Math.random() * idx) | 0;
+
+ tmp = arr[--idx];
+ arr[idx] = arr[rnd];
+ arr[rnd] = tmp;
+ }
+
+ return arr;
+};
+
+/**
+ * Sorts an array of numbers from smallest to largest, or puts an array of
+ * words in alphabetical order. The original array is not modified; a
+ * re-ordered array is returned. The count parameter states the number of
+ * elements to sort. For example, if there are 12 elements in an array and
+ * count is set to 5, only the first 5 elements in the array will be sorted.
+ *
+ * @method sort
+ * @deprecated Use array.sort() instead.
+ * @param {Array} list Array to sort
+ * @param {Integer} [count] number of elements to sort, starting from 0
+ * @return {Array} the sorted list
*
+ * @example
+ *
+ * function setup() {
+ * var words = ['banana', 'apple', 'pear', 'lime'];
+ * print(words); // ['banana', 'apple', 'pear', 'lime']
+ * var count = 4; // length of array
+ *
+ * words = sort(words, count);
+ * print(words); // ['apple', 'banana', 'lime', 'pear']
+ * }
+ *
+ *
+ * function setup() {
+ * var numbers = [2, 6, 1, 5, 14, 9, 8, 12];
+ * print(numbers); // [2, 6, 1, 5, 14, 9, 8, 12]
+ * var count = 5; // Less than the length of the array
+ *
+ * numbers = sort(numbers, count);
+ * print(numbers); // [1,2,5,6,14,9,8,12]
+ * }
+ *
+ */
+p5.prototype.sort = function(list, count) {
+ var arr = count ? list.slice(0, Math.min(count, list.length)) : list;
+ var rest = count ? list.slice(Math.min(count, list.length)) : [];
+ if (typeof arr[0] === 'string') {
+ arr = arr.sort();
+ } else {
+ arr = arr.sort(function(a, b) {
+ return a - b;
+ });
+ }
+ return arr.concat(rest);
+};
+
+/**
+ * Inserts a value or an array of values into an existing array. The first
+ * parameter specifies the initial array to be modified, and the second
+ * parameter defines the data to be inserted. The third parameter is an index
+ * value which specifies the array position from which to insert data.
+ * (Remember that array index numbering starts at zero, so the first position
+ * is 0, the second position is 1, and so on.)
+ *
+ * @method splice
+ * @deprecated Use array.splice() instead.
+ * @param {Array} list Array to splice into
+ * @param {any} value value to be spliced in
+ * @param {Integer} position in the array from which to insert data
+ * @return {Array} the list
+ *
+ * @example
+ *
+ * function setup() {
+ * var myArray = [0, 1, 2, 3, 4];
+ * var insArray = ['A', 'B', 'C'];
+ * print(myArray); // [0, 1, 2, 3, 4]
+ * print(insArray); // ['A','B','C']
+ *
+ * splice(myArray, insArray, 3);
+ * print(myArray); // [0,1,2,'A','B','C',3,4]
+ * }
+ *
+ */
+p5.prototype.splice = function(list, value, index) {
+ // note that splice returns spliced elements and not an array
+ Array.prototype.splice.apply(list, [index, 0].concat(value));
+
+ return list;
+};
+
+/**
+ * Extracts an array of elements from an existing array. The list parameter
+ * defines the array from which the elements will be copied, and the start
+ * and count parameters specify which elements to extract. If no count is
+ * given, elements will be extracted from the start to the end of the array.
+ * When specifying the start, remember that the first array element is 0.
+ * This function does not change the source array.
+ *
+ * @method subset
+ * @deprecated Use array.slice() instead.
+ * @param {Array} list Array to extract from
+ * @param {Integer} start position to begin
+ * @param {Integer} [count] number of values to extract
+ * @return {Array} Array of extracted elements
+ *
+ * @example
+ *
+ * function setup() {
+ * var myArray = [1, 2, 3, 4, 5];
+ * print(myArray); // [1, 2, 3, 4, 5]
+ *
+ * var sub1 = subset(myArray, 0, 3);
+ * var sub2 = subset(myArray, 2, 2);
+ * print(sub1); // [1,2,3]
+ * print(sub2); // [3,4]
* }
- *
+ *
+ */
+p5.prototype.subset = function(list, start, count) {
+ if (typeof count !== 'undefined') {
+ return list.slice(start, start + count);
+ } else {
+ return list.slice(start, list.length);
+ }
+};
+
+module.exports = p5;
+
+},{"../core/main":25}],62:[function(_dereq_,module,exports){
+/**
+ * @module Data
+ * @submodule Conversion
+ * @for p5
+ * @requires core
+ */
+
+'use strict';
+
+var p5 = _dereq_('../core/main');
+
+/**
+ * Converts a string to its floating point representation. The contents of a
+ * string must resemble a number, or NaN (not a number) will be returned.
+ * For example, float("1234.56") evaluates to 1234.56, but float("giraffe")
+ * will return NaN.
+ *
+ * When an array of values is passed in, then an array of floats of the same
+ * length is returned.
+ *
+ * @method float
+ * @param {String} str float string to parse
+ * @return {Number} floating point representation of string
+ * @example
+ *
+ * var str = '20';
+ * var diameter = float(str);
+ * ellipse(width / 2, height / 2, diameter, diameter);
+ *
+ *
+ * @alt
+ * 20 by 20 white ellipse in the center of the canvas
+ *
+ */
+p5.prototype.float = function(str) {
+ if (str instanceof Array) {
+ return str.map(parseFloat);
+ }
+ return parseFloat(str);
+};
+
+/**
+ * Converts a boolean, string, or float to its integer representation.
+ * When an array of values is passed in, then an int array of the same length
+ * is returned.
+ *
+ * @method int
+ * @param {String|Boolean|Number} n value to parse
+ * @param {Integer} [radix] the radix to convert to (default: 10)
+ * @return {Number} integer representation of value
+ *
+ * @example
+ *
+ * print(int('10')); // 10
+ * print(int(10.31)); // 10
+ * print(int(-10)); // -10
+ * print(int(true)); // 1
+ * print(int(false)); // 0
+ * print(int([false, true, '10.3', 9.8])); // [0, 1, 10, 9]
+ *
+ */
+/**
+ * @method int
+ * @param {Array} ns values to parse
+ * @return {Number[]} integer representation of values
+ */
+p5.prototype.int = function(n, radix) {
+ radix = radix || 10;
+ if (typeof n === 'string') {
+ return parseInt(n, radix);
+ } else if (typeof n === 'number') {
+ return n | 0;
+ } else if (typeof n === 'boolean') {
+ return n ? 1 : 0;
+ } else if (n instanceof Array) {
+ return n.map(function(n) {
+ return p5.prototype.int(n, radix);
+ });
+ }
+};
+
+/**
+ * Converts a boolean, string or number to its string representation.
+ * When an array of values is passed in, then an array of strings of the same
+ * length is returned.
+ *
+ * @method str
+ * @param {String|Boolean|Number|Array} n value to parse
+ * @return {String} string representation of value
+ * @example
+ *
+ * print(str('10')); // "10"
+ * print(str(10.31)); // "10.31"
+ * print(str(-10)); // "-10"
+ * print(str(true)); // "true"
+ * print(str(false)); // "false"
+ * print(str([true, '10.3', 9.8])); // [ "true", "10.3", "9.8" ]
+ *
+ */
+p5.prototype.str = function(n) {
+ if (n instanceof Array) {
+ return n.map(p5.prototype.str);
+ } else {
+ return String(n);
+ }
+};
+
+/**
+ * Converts a number or string to its boolean representation.
+ * For a number, any non-zero value (positive or negative) evaluates to true,
+ * while zero evaluates to false. For a string, the value "true" evaluates to
+ * true, while any other value evaluates to false. When an array of number or
+ * string values is passed in, then a array of booleans of the same length is
+ * returned.
+ *
+ * @method boolean
+ * @param {String|Boolean|Number|Array} n value to parse
+ * @return {Boolean} boolean representation of value
+ * @example
+ *
+ * print(boolean(0)); // false
+ * print(boolean(1)); // true
+ * print(boolean('true')); // true
+ * print(boolean('abcd')); // false
+ * print(boolean([0, 12, 'true'])); // [false, true, false]
+ *
+ */
+p5.prototype.boolean = function(n) {
+ if (typeof n === 'number') {
+ return n !== 0;
+ } else if (typeof n === 'string') {
+ return n.toLowerCase() === 'true';
+ } else if (typeof n === 'boolean') {
+ return n;
+ } else if (n instanceof Array) {
+ return n.map(p5.prototype.boolean);
+ }
+};
+
+/**
+ * Converts a number, string representation of a number, or boolean to its byte
+ * representation. A byte can be only a whole number between -128 and 127, so
+ * when a value outside of this range is converted, it wraps around to the
+ * corresponding byte representation. When an array of number, string or boolean
+ * values is passed in, then an array of bytes the same length is returned.
+ *
+ * @method byte
+ * @param {String|Boolean|Number} n value to parse
+ * @return {Number} byte representation of value
+ *
+ * @example
+ *
+ * print(byte(127)); // 127
+ * print(byte(128)); // -128
+ * print(byte(23.4)); // 23
+ * print(byte('23.4')); // 23
+ * print(byte('hello')); // NaN
+ * print(byte(true)); // 1
+ * print(byte([0, 255, '100'])); // [0, -1, 100]
+ *
+ */
+/**
+ * @method byte
+ * @param {Array} ns values to parse
+ * @return {Number[]} array of byte representation of values
+ */
+p5.prototype.byte = function(n) {
+ var nn = p5.prototype.int(n, 10);
+ if (typeof nn === 'number') {
+ return (nn + 128) % 256 - 128;
+ } else if (nn instanceof Array) {
+ return nn.map(p5.prototype.byte);
+ }
+};
+
+/**
+ * Converts a number or string to its corresponding single-character
+ * string representation. If a string parameter is provided, it is first
+ * parsed as an integer and then translated into a single-character string.
+ * When an array of number or string values is passed in, then an array of
+ * single-character strings of the same length is returned.
+ *
+ * @method char
+ * @param {String|Number} n value to parse
+ * @return {String} string representation of value
+ *
+ * @example
+ *
+ * print(char(65)); // "A"
+ * print(char('65')); // "A"
+ * print(char([65, 66, 67])); // [ "A", "B", "C" ]
+ * print(join(char([65, 66, 67]), '')); // "ABC"
+ *
+ */
+/**
+ * @method char
+ * @param {Array} ns values to parse
+ * @return {String[]} array of string representation of values
+ */
+p5.prototype.char = function(n) {
+ if (typeof n === 'number' && !isNaN(n)) {
+ return String.fromCharCode(n);
+ } else if (n instanceof Array) {
+ return n.map(p5.prototype.char);
+ } else if (typeof n === 'string') {
+ return p5.prototype.char(parseInt(n, 10));
+ }
+};
+
+/**
+ * Converts a single-character string to its corresponding integer
+ * representation. When an array of single-character string values is passed
+ * in, then an array of integers of the same length is returned.
+ *
+ * @method unchar
+ * @param {String} n value to parse
+ * @return {Number} integer representation of value
+ *
+ * @example
+ *
+ * print(unchar('A')); // 65
+ * print(unchar(['A', 'B', 'C'])); // [ 65, 66, 67 ]
+ * print(unchar(split('ABC', ''))); // [ 65, 66, 67 ]
+ *
+ */
+/**
+ * @method unchar
+ * @param {Array} ns values to parse
+ * @return {Number[]} integer representation of values
+ */
+p5.prototype.unchar = function(n) {
+ if (typeof n === 'string' && n.length === 1) {
+ return n.charCodeAt(0);
+ } else if (n instanceof Array) {
+ return n.map(p5.prototype.unchar);
+ }
+};
+
+/**
+ * Converts a number to a string in its equivalent hexadecimal notation. If a
+ * second parameter is passed, it is used to set the number of characters to
+ * generate in the hexadecimal notation. When an array is passed in, an
+ * array of strings in hexadecimal notation of the same length is returned.
+ *
+ * @method hex
+ * @param {Number} n value to parse
+ * @param {Number} [digits]
+ * @return {String} hexadecimal string representation of value
+ *
+ * @example
+ *
+ * print(hex(255)); // "000000FF"
+ * print(hex(255, 6)); // "0000FF"
+ * print(hex([0, 127, 255], 6)); // [ "000000", "00007F", "0000FF" ]
+ *
+ */
+/**
+ * @method hex
+ * @param {Number[]} ns array of values to parse
+ * @param {Number} [digits]
+ * @return {String[]} hexadecimal string representation of values
+ */
+p5.prototype.hex = function(n, digits) {
+ digits = digits === undefined || digits === null ? (digits = 8) : digits;
+ if (n instanceof Array) {
+ return n.map(function(n) {
+ return p5.prototype.hex(n, digits);
+ });
+ } else if (typeof n === 'number') {
+ if (n < 0) {
+ n = 0xffffffff + n + 1;
+ }
+ var hex = Number(n)
+ .toString(16)
+ .toUpperCase();
+ while (hex.length < digits) {
+ hex = '0' + hex;
+ }
+ if (hex.length >= digits) {
+ hex = hex.substring(hex.length - digits, hex.length);
+ }
+ return hex;
+ }
+};
+
+/**
+ * Converts a string representation of a hexadecimal number to its equivalent
+ * integer value. When an array of strings in hexadecimal notation is passed
+ * in, an array of integers of the same length is returned.
+ *
+ * @method unhex
+ * @param {String} n value to parse
+ * @return {Number} integer representation of hexadecimal value
+ *
+ * @example
+ *
+ * print(unhex('A')); // 10
+ * print(unhex('FF')); // 255
+ * print(unhex(['FF', 'AA', '00'])); // [ 255, 170, 0 ]
+ *
+ */
+/**
+ * @method unhex
+ * @param {Array} ns values to parse
+ * @return {Number[]} integer representations of hexadecimal value
+ */
+p5.prototype.unhex = function(n) {
+ if (n instanceof Array) {
+ return n.map(p5.prototype.unhex);
+ } else {
+ return parseInt('0x' + n, 16);
+ }
+};
+
+module.exports = p5;
+
+},{"../core/main":25}],63:[function(_dereq_,module,exports){
+/**
+ * @module Data
+ * @submodule String Functions
+ * @for p5
+ * @requires core
+ */
+
+'use strict';
+
+var p5 = _dereq_('../core/main');
+_dereq_('../core/error_helpers');
+
+//return p5; //LM is this a mistake?
+
+/**
+ * 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
+ * @param {Array} list array of Strings to be joined
+ * @param {String} separator String to be placed between each item
+ * @return {String} joined String
+ * @example
+ *
+ *
+ * var array = ['Hello', 'world!'];
+ * var separator = ' ';
+ * var message = join(array, separator);
+ * text(message, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * "hello world!" displayed middle left of canvas.
+ *
*/
-p5.prototype.concat = function(list0, list1) {
- return list0.concat(list1);
+p5.prototype.join = function(list, separator) {
+ p5._validateParameters('join', arguments);
+ return list.join(separator);
};
/**
- * Reverses the order of an array, maps to Array.reverse()
+ * This function is used to apply a regular expression to a piece of text,
+ * and return matching groups (elements found inside parentheses) as a
+ * String array. If there are no matches, a null value will be returned.
+ * If no groups are specified in the regular expression, but the sequence
+ * matches, an array of length 1 (with the matched text as the first element
+ * of the array) will be returned.
+ *
+ * To use the function, first check to see if the result is null. If the
+ * result is null, then the sequence did not match at all. If the sequence
+ * did match, an array is returned.
+ *
+ * If there are groups (specified by sets of parentheses) in the regular
+ * expression, then the contents of each will be returned in the array.
+ * Element [0] of a regular expression match returns the entire matching
+ * string, and the match groups start at element [1] (the first group is [1],
+ * the second [2], and so on).
*
- * @method reverse
- * @param {Array} list Array to reverse
+ * @method match
+ * @param {String} str the String to be searched
+ * @param {String} regexp the regexp to be used for matching
+ * @return {String[]} Array of Strings found
* @example
- *
- * function setup() {
- * var myArray = new Array("A", "B", "C");
- * print(myArray); // ["A","B","C"]
+ *
+ *
+ * var string = 'Hello p5js*!';
+ * var regexp = 'p5js\\*';
+ * var m = match(string, regexp);
+ * text(m, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * "p5js*" displayed middle left of canvas.
*
- * reverse(myArray);
- * print(myArray); // ["C","B","A"]
- * }
- *
*/
-p5.prototype.reverse = function(list) {
- return list.reverse();
+p5.prototype.match = function(str, reg) {
+ p5._validateParameters('match', arguments);
+ return str.match(reg);
};
/**
- * Decreases an array by one element and returns the shortened array,
- * maps to Array.pop().
+ * This function is used to apply a regular expression to a piece of text,
+ * and return a list of matching groups (elements found inside parentheses)
+ * as a two-dimensional String array. If there are no matches, a null value
+ * will be returned. If no groups are specified in the regular expression,
+ * but the sequence matches, a two dimensional array is still returned, but
+ * the second dimension is only of length one.
+ *
+ * To use the function, first check to see if the result is null. If the
+ * result is null, then the sequence did not match at all. If the sequence
+ * did match, a 2D array is returned.
+ *
+ * If there are groups (specified by sets of parentheses) in the regular
+ * expression, then the contents of each will be returned in the array.
+ * Assuming a loop with counter variable i, element [i][0] of a regular
+ * expression match returns the entire matching string, and the match groups
+ * start at element [i][1] (the first group is [i][1], the second [i][2],
+ * and so on).
*
- * @method shorten
- * @param {Array} list Array to shorten
- * @return {Array} shortened Array
+ * @method matchAll
+ * @param {String} str the String to be searched
+ * @param {String} regexp the regexp to be used for matching
+ * @return {String[]} 2d Array of Strings found
* @example
- *
- * function setup() {
- * var myArray = new Array("A", "B", "C");
- * print(myArray); // ["A","B","C"]
- *
- * var newArray = shorten(myArray);
- * print(myArray); // ["A","B","C"]
- * print(newArray); // ["A","B"]
- * }
- *
+ *
+ *
+ * var string = 'Hello p5js*! Hello world!';
+ * var regexp = 'Hello';
+ * matchAll(string, regexp);
+ *
+ *
*/
-p5.prototype.shorten = function(list) {
- list.pop();
- return list;
+p5.prototype.matchAll = function(str, reg) {
+ p5._validateParameters('matchAll', arguments);
+ var re = new RegExp(reg, 'g');
+ var match = re.exec(str);
+ var matches = [];
+ while (match !== null) {
+ matches.push(match);
+ // matched text: match[0]
+ // match start: match.index
+ // capturing group n: match[n]
+ match = re.exec(str);
+ }
+ return matches;
};
/**
- * Randomizes the order of the elements of an array. Implements
- *
- * Fisher-Yates Shuffle Algorithm.
+ * 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.
+ *
+ * @method nf
+ * @param {Number|String} num the Number to format
+ * @param {Integer|String} [left] number of digits to the left of the
+ * decimal point
+ * @param {Integer|String} [right] number of digits to the right of the
+ * decimal point
+ * @return {String} formatted String
*
- * @method shuffle
- * @param {Array} array Array to shuffle
- * @param {Boolean} [bool] modify passed array
- * @return {Array} shuffled Array
* @example
- *
+ *
+ *
* function setup() {
- * var regularArr = ['ABC', 'def', createVector(), TAU, Math.E];
- * print(regularArr);
- * shuffle(regularArr, true); // force modifications to passed array
- * print(regularArr);
+ * background(200);
+ * var num = 112.53106115;
*
- * // By default shuffle() returns a shuffled cloned array:
- * var newArr = shuffle(regularArr);
- * print(regularArr);
- * print(newArr);
+ * noStroke();
+ * fill(0);
+ * textSize(14);
+ * // Draw formatted numbers
+ * text(nf(num, 5, 2), 10, 20);
+ *
+ * text(nf(num, 4, 3), 10, 55);
+ *
+ * text(nf(num, 3, 6), 10, 85);
+ *
+ * // Draw dividing lines
+ * stroke(120);
+ * line(0, 30, width, 30);
+ * line(0, 65, width, 65);
* }
- *
+ *
+ *
+ *
+ * @alt
+ * "0011253" top left, "0112.531" mid left, "112.531061" bottom left canvas
*/
-p5.prototype.shuffle = function(arr, bool) {
- var isView = ArrayBuffer && ArrayBuffer.isView && ArrayBuffer.isView(arr);
- arr = bool || isView ? arr : arr.slice();
-
- var rnd, tmp, idx = arr.length;
- while (idx > 1) {
- rnd = Math.random()*idx | 0;
-
- tmp = arr[--idx];
- arr[idx] = arr[rnd];
- arr[rnd] = tmp;
+/**
+ * @method nf
+ * @param {Array} nums the Numbers to format
+ * @param {Integer|String} [left]
+ * @param {Integer|String} [right]
+ * @return {String[]} formatted Strings
+ */
+p5.prototype.nf = function(nums, left, right) {
+ p5._validateParameters('nf', arguments);
+ if (nums instanceof Array) {
+ return nums.map(function(x) {
+ return doNf(x, left, right);
+ });
+ } else {
+ var typeOfFirst = Object.prototype.toString.call(nums);
+ if (typeOfFirst === '[object Arguments]') {
+ if (nums.length === 3) {
+ return this.nf(nums[0], nums[1], nums[2]);
+ } else if (nums.length === 2) {
+ return this.nf(nums[0], nums[1]);
+ } else {
+ return this.nf(nums[0]);
+ }
+ } else {
+ return doNf(nums, left, right);
+ }
}
-
- return arr;
};
+function doNf(num, left, right) {
+ var neg = num < 0;
+ var n = neg ? num.toString().substring(1) : num.toString();
+ var decimalInd = n.indexOf('.');
+ var intPart = decimalInd !== -1 ? n.substring(0, decimalInd) : n;
+ var decPart = decimalInd !== -1 ? n.substring(decimalInd + 1) : '';
+ var str = neg ? '-' : '';
+ if (typeof right !== 'undefined') {
+ var decimal = '';
+ if (decimalInd !== -1 || right - decPart.length > 0) {
+ decimal = '.';
+ }
+ if (decPart.length > right) {
+ decPart = decPart.substring(0, right);
+ }
+ for (var i = 0; i < left - intPart.length; i++) {
+ str += '0';
+ }
+ str += intPart;
+ str += decimal;
+ str += decPart;
+ for (var j = 0; j < right - decPart.length; j++) {
+ str += '0';
+ }
+ return str;
+ } else {
+ for (var k = 0; k < Math.max(left - intPart.length, 0); k++) {
+ str += '0';
+ }
+ str += n;
+ return str;
+ }
+}
+
/**
- * Sorts an array of numbers from smallest to largest, or puts an array of
- * words in alphabetical order. The original array is not modified; a
- * re-ordered array is returned. The count parameter states the number of
- * elements to sort. For example, if there are 12 elements in an array and
- * count is set to 5, only the first 5 elements in the array will be sorted.
+ * 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 right parameter should always be a positive integer.
*
- * @method sort
- * @param {Array} list Array to sort
- * @param {Number} [count] number of elements to sort, starting from 0
+ * @method nfc
+ * @param {Number|String} num the Number to format
+ * @param {Integer|String} [right] number of digits to the right of the
+ * decimal point
+ * @return {String} formatted String
*
* @example
- *
+ *
+ *
* function setup() {
- * var words = new Array("banana", "apple", "pear","lime");
- * print(words); // ["banana", "apple", "pear", "lime"]
- * var count = 4; // length of array
+ * background(200);
+ * var num = 11253106.115;
+ * var numArr = [1, 1, 2];
*
- * words = sort(words, count);
- * print(words); // ["apple", "banana", "lime", "pear"]
- * }
- *
- *
- * function setup() {
- * var numbers = new Array(2,6,1,5,14,9,8,12);
- * print(numbers); // [2,6,1,5,14,9,8,12]
- * var count = 5; // Less than the length of the array
+ * noStroke();
+ * fill(0);
+ * textSize(12);
*
- * numbers = sort(numbers, count);
- * print(numbers); // [1,2,5,6,14,9,8,12]
+ * // Draw formatted numbers
+ * text(nfc(num, 4), 10, 30);
+ * text(nfc(numArr, 2), 10, 80);
+ *
+ * // Draw dividing line
+ * stroke(120);
+ * line(0, 50, width, 50);
* }
- *
+ *
+ *
+ *
+ * @alt
+ * "11,253,106.115" top middle and "1.00,1.00,2.00" displayed bottom mid
*/
-p5.prototype.sort = function(list, count) {
- var arr = count ? list.slice(0, Math.min(count, list.length)) : list;
- var rest = count ? list.slice(Math.min(count, list.length)) : [];
- if (typeof arr[0] === 'string') {
- arr = arr.sort();
+/**
+ * @method nfc
+ * @param {Array} nums the Numbers to format
+ * @param {Integer|String} [right]
+ * @return {String[]} formatted Strings
+ */
+p5.prototype.nfc = function(num, right) {
+ p5._validateParameters('nfc', arguments);
+ if (num instanceof Array) {
+ return num.map(function(x) {
+ return doNfc(x, right);
+ });
} else {
- arr = arr.sort(function(a,b){return a-b;});
+ return doNfc(num, right);
}
- return arr.concat(rest);
};
+function doNfc(num, right) {
+ num = num.toString();
+ var dec = num.indexOf('.');
+ var rem = dec !== -1 ? num.substring(dec) : '';
+ var n = dec !== -1 ? num.substring(0, dec) : num;
+ n = n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+ if (right === 0) {
+ rem = '';
+ } else if (typeof right !== 'undefined') {
+ if (right > rem.length) {
+ rem += dec === -1 ? '.' : '';
+ var len = right - rem.length + 1;
+ for (var i = 0; i < len; i++) {
+ rem += '0';
+ }
+ } else {
+ rem = rem.substring(0, right + 1);
+ }
+ }
+ return n + rem;
+}
/**
- * Inserts a value or an array of values into an existing array. The first
- * parameter specifies the initial array to be modified, and the second
- * parameter defines the data to be inserted. The third parameter is an index
- * value which specifies the array position from which to insert data.
- * (Remember that array index numbering starts at zero, so the first position
- * is 0, the second position is 1, and so on.)
+ * 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 left, and right parameters
+ * should always be positive integers.
*
- * @method splice
- * @param {Array} list Array to splice into
- * @param {any} value value to be spliced in
- * @param {Number} position in the array from which to insert data
+ * @method nfp
+ * @param {Number} num the Number to format
+ * @param {Integer} [left] number of digits to the left of the decimal
+ * point
+ * @param {Integer} [right] number of digits to the right of the
+ * decimal point
+ * @return {String} formatted String
*
* @example
- *
+ *
+ *
* function setup() {
- * var myArray = new Array(0,1,2,3,4);
- * var insArray = new Array("A","B","C");
- * print(myArray); // [0,1,2,3,4]
- * print(insArray); // ["A","B","C"]
+ * background(200);
+ * var num1 = 11253106.115;
+ * var num2 = -11253106.115;
*
- * splice(myArray, insArray, 3);
- * print(myArray); // [0,1,2,"A","B","C",3,4]
+ * noStroke();
+ * fill(0);
+ * textSize(12);
+ *
+ * // Draw formatted numbers
+ * text(nfp(num1, 4, 2), 10, 30);
+ * text(nfp(num2, 4, 2), 10, 80);
+ *
+ * // Draw dividing line
+ * stroke(120);
+ * line(0, 50, width, 50);
* }
- *
+ *
+ *
+ *
+ * @alt
+ * "+11253106.11" top middle and "-11253106.11" displayed bottom middle
*/
-p5.prototype.splice = function(list, value, index) {
-
- // note that splice returns spliced elements and not an array
- Array.prototype.splice.apply(list, [index, 0].concat(value));
-
- return list;
+/**
+ * @method nfp
+ * @param {Number[]} nums the Numbers to format
+ * @param {Integer} [left]
+ * @param {Integer} [right]
+ * @return {String[]} formatted Strings
+ */
+p5.prototype.nfp = function() {
+ p5._validateParameters('nfp', arguments);
+ var nfRes = p5.prototype.nf.apply(this, arguments);
+ if (nfRes instanceof Array) {
+ return nfRes.map(addNfp);
+ } else {
+ return addNfp(nfRes);
+ }
};
+function addNfp(num) {
+ return parseFloat(num) > 0 ? '+' + num.toString() : num.toString();
+}
+
/**
- * Extracts an array of elements from an existing array. The list parameter
- * defines the array from which the elements will be copied, and the start
- * and count parameters specify which elements to extract. If no count is
- * given, elements will be extracted from the start to the end of the array.
- * When specifying the start, remember that the first array element is 0.
- * This function does not change the source array.
+ * Utility function for formatting numbers into strings. Similar to nf() but
+ * puts a " " (space) 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.
*
- * @method subset
- * @param {Array} list Array to extract from
- * @param {Number} start position to begin
- * @param {Number} [count] number of values to extract
- * @return {Array} Array of extracted elements
+ * @method nfs
+ * @param {Number} num the Number to format
+ * @param {Integer} [left] number of digits to the left of the decimal
+ * point
+ * @param {Integer} [right] number of digits to the right of the
+ * decimal point
+ * @return {String} formatted String
*
* @example
- *
+ *
+ *
* function setup() {
- * var myArray = new Array(1,2,3,4,5);
- * print(myArray); // [1,2,3,4,5]
+ * background(200);
+ * var num1 = 11253106.115;
+ * var num2 = -11253106.115;
*
- * var sub1 = subset(myArray, 0, 3);
- * var sub2 = subset(myArray, 2, 2);
- * print(sub1); // [1,2,3]
- * print(sub2); // [3,4]
+ * noStroke();
+ * fill(0);
+ * textSize(12);
+ * // Draw formatted numbers
+ * text(nfs(num1, 4, 2), 10, 30);
+ *
+ * text(nfs(num2, 4, 2), 10, 80);
+ *
+ * // Draw dividing line
+ * stroke(120);
+ * line(0, 50, width, 50);
* }
- *
+ *
+ *
+ *
+ * @alt
+ * "11253106.11" top middle and "-11253106.11" displayed bottom middle
*/
-p5.prototype.subset = function(list, start, count) {
- if (typeof count !== 'undefined') {
- return list.slice(start, start + count);
+/**
+ * @method nfs
+ * @param {Array} nums the Numbers to format
+ * @param {Integer} [left]
+ * @param {Integer} [right]
+ * @return {String[]} formatted Strings
+ */
+p5.prototype.nfs = function() {
+ p5._validateParameters('nfs', arguments);
+ var nfRes = p5.prototype.nf.apply(this, arguments);
+ if (nfRes instanceof Array) {
+ return nfRes.map(addNfs);
} else {
- return list.slice(start, list.length);
+ return addNfs(nfRes);
}
};
-module.exports = p5;
-
-},{"../core/core":55}],94:[function(_dereq_,module,exports){
-/**
- * @module Data
- * @submodule Conversion
- * @for p5
- * @requires core
- */
-
-'use strict';
-
-var p5 = _dereq_('../core/core');
+function addNfs(num) {
+ return parseFloat(num) > 0 ? ' ' + num.toString() : num.toString();
+}
/**
- * Converts a string to its floating point representation. The contents of a
- * string must resemble a number, or NaN (not a number) will be returned.
- * For example, float("1234.56") evaluates to 1234.56, but float("giraffe")
- * will return NaN.
+ * The split() function maps to String.split(), it breaks a String into
+ * pieces using a character or string as the delimiter. 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.
*
- * When an array of values is passed in, then an array of floats of the same
- * length is returned.
+ * The splitTokens() function works in a similar fashion, except that it
+ * splits using a range of characters instead of a specific character or
+ * sequence.
*
- * @method float
- * @param {String} str float string to parse
- * @return {Number} floating point representation of string
+ * @method split
+ * @param {String} value the String to be split
+ * @param {String} delim the String used to separate the data
+ * @return {String[]} Array of Strings
* @example
- *
- * var str = '20';
- * var diameter = float(str);
- * ellipse(width/2, height/2, diameter, diameter);
- *
+ *
+ *
+ * var names = 'Pat,Xio,Alex';
+ * var splitString = split(names, ',');
+ * text(splitString[0], 5, 30);
+ * text(splitString[1], 5, 50);
+ * text(splitString[2], 5, 70);
+ *
+ *
*
* @alt
- * 20 by 20 white ellipse in the center of the canvas
+ * "pat" top left, "Xio" mid left and "Alex" displayed bottom left
*
*/
-p5.prototype.float = function(str) {
- if (str instanceof Array) {
- return str.map(parseFloat);
- }
- return parseFloat(str);
+p5.prototype.split = function(str, delim) {
+ p5._validateParameters('split', arguments);
+ return str.split(delim);
};
/**
- * Converts a boolean, string, or float to its integer representation.
- * When an array of values is passed in, then an int array of the same length
- * is returned.
- *
- * @method int
- * @param {String|Boolean|Number} n value to parse
- * @return {Number} integer representation of value
- */
-/**
- * @method int
- * @param {Array} ns values to parse
- * @return {Number[]} integer representation of values
+ * The splitTokens() function splits a String at one or many character
+ * delimiters or "tokens." The delim parameter specifies the character or
+ * characters to be used as a boundary.
+ *
+ * If no delim characters are specified, any whitespace character is used to
+ * split. Whitespace characters include tab (\t), line feed (\n), carriage
+ * return (\r), form feed (\f), and space.
*
+ * @method splitTokens
+ * @param {String} value the String to be split
+ * @param {String} [delim] list of individual Strings that will be used as
+ * separators
+ * @return {String[]} Array of Strings
* @example
- *
- * print(int("10")); // 10
- * print(int(10.31)); // 10
- * print(int(-10)); // -10
- * print(int(true)); // 1
- * print(int(false)); // 0
- * print(int([false, true, "10.3", 9.8])); // [0, 1, 10, 9]
- *
+ *
+ *
+ * function setup() {
+ * var myStr = 'Mango, Banana, Lime';
+ * var myStrArr = splitTokens(myStr, ',');
+ *
+ * print(myStrArr); // prints : ["Mango"," Banana"," Lime"]
+ * }
+ *
+ *
*/
-p5.prototype.int = function(n, radix) {
- radix = radix || 10;
- if (typeof n === 'string') {
- return parseInt(n, radix);
- } else if (typeof n === 'number') {
- return n | 0;
- } else if (typeof n === 'boolean') {
- return n ? 1 : 0;
- } else if (n instanceof Array) {
- return n.map(function(n) { return p5.prototype.int(n, radix); });
+p5.prototype.splitTokens = function(value, delims) {
+ p5._validateParameters('splitTokens', arguments);
+ var d;
+ if (typeof delims !== 'undefined') {
+ var str = delims;
+ var sqc = /\]/g.exec(str);
+ var sqo = /\[/g.exec(str);
+ if (sqo && sqc) {
+ str = str.slice(0, sqc.index) + str.slice(sqc.index + 1);
+ sqo = /\[/g.exec(str);
+ str = str.slice(0, sqo.index) + str.slice(sqo.index + 1);
+ d = new RegExp('[\\[' + str + '\\]]', 'g');
+ } else if (sqc) {
+ str = str.slice(0, sqc.index) + str.slice(sqc.index + 1);
+ d = new RegExp('[' + str + '\\]]', 'g');
+ } else if (sqo) {
+ str = str.slice(0, sqo.index) + str.slice(sqo.index + 1);
+ d = new RegExp('[' + str + '\\[]', 'g');
+ } else {
+ d = new RegExp('[' + str + ']', 'g');
+ }
+ } else {
+ d = /\s/g;
}
+ return value.split(d).filter(function(n) {
+ return n;
+ });
};
/**
- * Converts a boolean, string or number to its string representation.
- * When an array of values is passed in, then an array of strings of the same
- * length is returned.
+ * 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.
+ *
+ * @method trim
+ * @param {String} str a String to be trimmed
+ * @return {String} a trimmed String
*
- * @method str
- * @param {String|Boolean|Number|Array} n value to parse
- * @return {String} string representation of value
* @example
- *
- * print(str("10")); // "10"
- * print(str(10.31)); // "10.31"
- * print(str(-10)); // "-10"
- * print(str(true)); // "true"
- * print(str(false)); // "false"
- * print(str([true, "10.3", 9.8])); // [ "true", "10.3", "9.8" ]
- *
+ *
+ *
+ * var string = trim(' No new lines\n ');
+ * text(string + ' here', 2, 50);
+ *
+ *
+ *
+ * @alt
+ * "No new lines here" displayed center canvas
+ */
+/**
+ * @method trim
+ * @param {Array} strs an Array of Strings to be trimmed
+ * @return {String[]} an Array of trimmed Strings
*/
-p5.prototype.str = function(n) {
- if (n instanceof Array) {
- return n.map(p5.prototype.str);
+p5.prototype.trim = function(str) {
+ p5._validateParameters('trim', arguments);
+ if (str instanceof Array) {
+ return str.map(this.trim);
} else {
- return String(n);
+ return str.trim();
}
};
+module.exports = p5;
+
+},{"../core/error_helpers":21,"../core/main":25}],64:[function(_dereq_,module,exports){
/**
- * Converts a number or string to its boolean representation.
- * For a number, any non-zero value (positive or negative) evaluates to true,
- * while zero evaluates to false. For a string, the value "true" evaluates to
- * true, while any other value evaluates to false. When an array of number or
- * string values is passed in, then a array of booleans of the same length is
- * returned.
+ * @module IO
+ * @submodule Time & Date
+ * @for p5
+ * @requires core
+ */
+
+'use strict';
+
+var p5 = _dereq_('../core/main');
+
+/**
+ * p5.js communicates with the clock on your computer. The day() function
+ * returns the current day as a value from 1 - 31.
*
- * @method boolean
- * @param {String|Boolean|Number|Array} n value to parse
- * @return {Boolean} boolean representation of value
+ * @method day
+ * @return {Integer} the current day
* @example
- *
- * print(boolean(0)); // false
- * print(boolean(1)); // true
- * print(boolean("true")); // true
- * print(boolean("abcd")); // false
- * print(boolean([0, 12, "true"])); // [false, true, false]
- *
+ *
+ *
+ * var d = day();
+ * text('Current day: \n' + d, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * Current day is displayed
+ *
*/
-p5.prototype.boolean = function(n) {
- if (typeof n === 'number') {
- return n !== 0;
- } else if (typeof n === 'string') {
- return n.toLowerCase() === 'true';
- } else if (typeof n === 'boolean') {
- return n;
- } else if (n instanceof Array) {
- return n.map(p5.prototype.boolean);
- }
+p5.prototype.day = function() {
+ return new Date().getDate();
};
/**
- * Converts a number, string or boolean to its byte representation.
- * A byte can be only a whole number between -128 and 127, so when a value
- * outside of this range is converted, it wraps around to the corresponding
- * byte representation. When an array of number, string or boolean values is
- * passed in, then an array of bytes the same length is returned.
+ * p5.js communicates with the clock on your computer. The hour() function
+ * returns the current hour as a value from 0 - 23.
*
- * @method byte
- * @param {String|Boolean|Number} n value to parse
- * @return {Number} byte representation of value
- */
-/**
- * @method byte
- * @param {Array} ns values to parse
- * @return {Number[]} array of byte representation of values
+ * @method hour
+ * @return {Integer} the current hour
* @example
- *
- * print(byte(127)); // 127
- * print(byte(128)); // -128
- * print(byte(23.4)); // 23
- * print(byte("23.4")); // 23
- * print(byte(true)); // 1
- * print(byte([0, 255, "100"])); // [0, -1, 100]
- *
+ *
+ *
+ * var h = hour();
+ * text('Current hour:\n' + h, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * Current hour is displayed
+ *
*/
-p5.prototype.byte = function(n) {
- var nn = p5.prototype.int(n, 10);
- if (typeof nn === 'number') {
- return ((nn + 128) % 256) - 128;
- } else if (nn instanceof Array) {
- return nn.map(p5.prototype.byte);
- }
+p5.prototype.hour = function() {
+ return new Date().getHours();
};
/**
- * Converts a number or string to its corresponding single-character
- * string representation. If a string parameter is provided, it is first
- * parsed as an integer and then translated into a single-character string.
- * When an array of number or string values is passed in, then an array of
- * single-character strings of the same length is returned.
+ * p5.js communicates with the clock on your computer. The minute() function
+ * returns the current minute as a value from 0 - 59.
*
- * @method char
- * @param {String|Number} n value to parse
- * @return {String} string representation of value
- */
-/**
- * @method char
- * @param {Array} ns values to parse
- * @return {String[]} array of string representation of values
+ * @method minute
+ * @return {Integer} the current minute
* @example
- *
- * print(char(65)); // "A"
- * print(char("65")); // "A"
- * print(char([65, 66, 67])); // [ "A", "B", "C" ]
- * print(join(char([65, 66, 67]), '')); // "ABC"
- *
+ *
+ *
+ * var m = minute();
+ * text('Current minute: \n' + m, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * Current minute is displayed
+ *
*/
-p5.prototype.char = function(n) {
- if (typeof n === 'number' && !isNaN(n)) {
- return String.fromCharCode(n);
- } else if (n instanceof Array) {
- return n.map(p5.prototype.char);
- } else if (typeof n === 'string') {
- return p5.prototype.char(parseInt(n, 10));
- }
+p5.prototype.minute = function() {
+ return new Date().getMinutes();
};
/**
- * Converts a single-character string to its corresponding integer
- * representation. When an array of single-character string values is passed
- * in, then an array of integers of the same length is returned.
+ * Returns the number of milliseconds (thousandths of a second) since
+ * starting the program. This information is often used for timing events and
+ * animation sequences.
*
- * @method unchar
- * @param {String} n value to parse
- * @return {Number} integer representation of value
- */
-/**
- * @method unchar
- * @param {Array} ns values to parse
- * @return {Number[]} integer representation of values
+ * @method millis
+ * @return {Number} the number of milliseconds since starting the program
* @example
- *
- * print(unchar("A")); // 65
- * print(unchar(["A", "B", "C"])); // [ 65, 66, 67 ]
- * print(unchar(split("ABC", ""))); // [ 65, 66, 67 ]
- *
+ *
+ *
+ * var millisecond = millis();
+ * text('Milliseconds \nrunning: \n' + millisecond, 5, 40);
+ *
+ *
+ *
+ * @alt
+ * number of milliseconds since program has started displayed
+ *
*/
-p5.prototype.unchar = function(n) {
- if (typeof n === 'string' && n.length === 1) {
- return n.charCodeAt(0);
- } else if (n instanceof Array) {
- return n.map(p5.prototype.unchar);
- }
+p5.prototype.millis = function() {
+ return window.performance.now();
};
/**
- * Converts a number to a string in its equivalent hexadecimal notation. If a
- * second parameter is passed, it is used to set the number of characters to
- * generate in the hexadecimal notation. When an array is passed in, an
- * array of strings in hexadecimal notation of the same length is returned.
+ * p5.js communicates with the clock on your computer. The month() function
+ * returns the current month as a value from 1 - 12.
*
- * @method hex
- * @param {Number} n value to parse
- * @param {Number} [digits]
- * @return {String} hexadecimal string representation of value
- */
-/**
- * @method hex
- * @param {Number[]} ns array of values to parse
- * @param {Number} [digits]
- * @return {String[]} hexadecimal string representation of values
+ * @method month
+ * @return {Integer} the current month
* @example
- *
- * print(hex(255)); // "000000FF"
- * print(hex(255, 6)); // "0000FF"
- * print(hex([0, 127, 255], 6)); // [ "000000", "00007F", "0000FF" ]
- *
+ *
+ *
+ * var m = month();
+ * text('Current month: \n' + m, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * Current month is displayed
+ *
*/
-p5.prototype.hex = function(n, digits) {
- digits = (digits === undefined || digits === null) ? digits = 8 : digits;
- if (n instanceof Array) {
- return n.map(function(n) { return p5.prototype.hex(n, digits); });
- } else if (typeof n === 'number') {
- if (n < 0) {
- n = 0xFFFFFFFF + n + 1;
- }
- var hex = Number(n).toString(16).toUpperCase();
- while (hex.length < digits) {
- hex = '0' + hex;
- }
- if (hex.length >= digits) {
- hex = hex.substring(hex.length - digits, hex.length);
- }
- return hex;
- }
+p5.prototype.month = function() {
+ return new Date().getMonth() + 1; //January is 0!
};
/**
- * Converts a string representation of a hexadecimal number to its equivalent
- * integer value. When an array of strings in hexadecimal notation is passed
- * in, an array of integers of the same length is returned.
+ * p5.js communicates with the clock on your computer. The second() function
+ * returns the current second as a value from 0 - 59.
+ *
+ * @method second
+ * @return {Integer} the current second
+ * @example
+ *
+ *
+ * var s = second();
+ * text('Current second: \n' + s, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * Current second is displayed
*
- * @method unhex
- * @param {String} n value to parse
- * @return {Number} integer representation of hexadecimal value
*/
+p5.prototype.second = function() {
+ return new Date().getSeconds();
+};
+
/**
- * @method unhex
- * @param {Array} ns values to parse
- * @return {Number[]} integer representations of hexadecimal value
+ * p5.js communicates with the clock on your computer. The year() function
+ * returns the current year as an integer (2014, 2015, 2016, etc).
+ *
+ * @method year
+ * @return {Integer} the current year
* @example
- *
- * print(unhex("A")); // 10
- * print(unhex("FF")); // 255
- * print(unhex(["FF", "AA", "00"])); // [ 255, 170, 0 ]
- *
+ *
+ *
+ * var y = year();
+ * text('Current year: \n' + y, 5, 50);
+ *
+ *
+ *
+ * @alt
+ * Current year is displayed
+ *
*/
-p5.prototype.unhex = function(n) {
- if (n instanceof Array) {
- return n.map(p5.prototype.unhex);
- } else {
- return parseInt('0x' + n, 16);
- }
+p5.prototype.year = function() {
+ return new Date().getFullYear();
};
module.exports = p5;
-},{"../core/core":55}],95:[function(_dereq_,module,exports){
+},{"../core/main":25}],65:[function(_dereq_,module,exports){
/**
- * @module Data
- * @submodule String Functions
+ * @module Shape
+ * @submodule 3D Primitives
* @for p5
* @requires core
+ * @requires p5.Geometry
*/
'use strict';
-var p5 = _dereq_('../core/core');
-_dereq_('../core/error_helpers');
-
-//return p5; //LM is this a mistake?
+var p5 = _dereq_('../core/main');
+_dereq_('./p5.Geometry');
+var constants = _dereq_('../core/constants');
/**
- * 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
- * @param {Array} list array of Strings to be joined
- * @param {String} separator String to be placed between each item
- * @return {String} joined String
+ * Draw a plane with given a width and height
+ * @method plane
+ * @param {Number} [width] width of the plane
+ * @param {Number} [height] height of the plane
+ * @param {Integer} [detailX] Optional number of triangle
+ * subdivisions in x-dimension
+ * @param {Integer} [detailY] Optional number of triangle
+ * subdivisions in y-dimension
+ * @chainable
* @example
*
*
- * var array = ["Hello", "world!"]
- * var separator = " "
- * var message = join(array, separator);
- * text(message, 5, 50);
+ * //draw a plane with width 50 and height 50
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * plane(50, 50);
+ * }
*
*
*
* @alt
- * "hello world!" displayed middle left of canvas.
- *
+ * Nothing displayed on canvas
+ * Rotating interior view of a box with sides that change color.
+ * 3d red and green gradient.
+ * Rotating interior view of a cylinder with sides that change color.
+ * Rotating view of a cylinder with sides that change color.
+ * 3d red and green gradient.
+ * rotating view of a multi-colored cylinder with concave sides.
*/
-p5.prototype.join = function(list, separator) {
- p5._validateParameters('join', arguments);
- return list.join(separator);
+p5.prototype.plane = function(width, height, detailX, detailY) {
+ this._assert3d('plane');
+ p5._validateParameters('plane', arguments);
+ if (typeof width === 'undefined') {
+ width = 50;
+ }
+ if (typeof height === 'undefined') {
+ height = width;
+ }
+
+ if (typeof detailX === 'undefined') {
+ detailX = 1;
+ }
+ if (typeof detailY === 'undefined') {
+ detailY = 1;
+ }
+
+ var gId = 'plane|' + detailX + '|' + detailY;
+
+ if (!this._renderer.geometryInHash(gId)) {
+ var _plane = function() {
+ var u, v, p;
+ for (var i = 0; i <= this.detailY; i++) {
+ v = i / this.detailY;
+ for (var j = 0; j <= this.detailX; j++) {
+ u = j / this.detailX;
+ p = new p5.Vector(u - 0.5, v - 0.5, 0);
+ this.vertices.push(p);
+ this.uvs.push(u, v);
+ }
+ }
+ };
+ var planeGeom = new p5.Geometry(detailX, detailY, _plane);
+ planeGeom.computeFaces().computeNormals();
+ if (detailX <= 1 && detailY <= 1) {
+ planeGeom._makeTriangleEdges()._edgesToVertices();
+ } else {
+ console.log(
+ 'Cannot draw stroke on plane objects with more' +
+ ' than 1 detailX or 1 detailY'
+ );
+ }
+ this._renderer.createBuffers(gId, planeGeom);
+ }
+
+ this._renderer.drawBuffersScaled(gId, width, height, 1);
+ return this;
};
/**
- * This function is used to apply a regular expression to a piece of text,
- * and return matching groups (elements found inside parentheses) as a
- * String array. If there are no matches, a null value will be returned.
- * If no groups are specified in the regular expression, but the sequence
- * matches, an array of length 1 (with the matched text as the first element
- * of the array) will be returned.
- *
- * To use the function, first check to see if the result is null. If the
- * result is null, then the sequence did not match at all. If the sequence
- * did match, an array is returned.
- *
- * If there are groups (specified by sets of parentheses) in the regular
- * expression, then the contents of each will be returned in the array.
- * Element [0] of a regular expression match returns the entire matching
- * string, and the match groups start at element [1] (the first group is [1],
- * the second [2], and so on).
- *
- * @method match
- * @param {String} str the String to be searched
- * @param {String} regexp the regexp to be used for matching
- * @return {String[]} Array of Strings found
+ * Draw a box with given width, height and depth
+ * @method box
+ * @param {Number} [width] width of the box
+ * @param {Number} [Height] height of the box
+ * @param {Number} [depth] depth of the box
+ * @param {Integer} [detailX] Optional number of triangle
+ * subdivisions in x-dimension
+ * @param {Integer} [detailY] Optional number of triangle
+ * subdivisions in y-dimension
+ * @chainable
* @example
*
*
- * var string = "Hello p5js*!"
- * var regexp = "p5js\\*"
- * var match = match(string, regexp);
- * text(match, 5, 50);
+ * //draw a spinning box with width, height and depth 200
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * box(50);
+ * }
*
*
- *
- * @alt
- * "p5js*" displayed middle left of canvas.
- *
*/
-p5.prototype.match = function(str, reg) {
- p5._validateParameters('match', arguments);
- return str.match(reg);
+p5.prototype.box = function(width, height, depth, detailX, detailY) {
+ this._assert3d('box');
+ p5._validateParameters('box', arguments);
+ if (typeof width === 'undefined') {
+ width = 50;
+ }
+ if (typeof height === 'undefined') {
+ height = width;
+ }
+ if (typeof depth === 'undefined') {
+ depth = height;
+ }
+
+ var perPixelLighting =
+ this._renderer.attributes && this._renderer.attributes.perPixelLighting;
+ if (typeof detailX === 'undefined') {
+ detailX = perPixelLighting ? 1 : 4;
+ }
+ if (typeof detailY === 'undefined') {
+ detailY = perPixelLighting ? 1 : 4;
+ }
+
+ var gId = 'box|' + detailX + '|' + detailY;
+ if (!this._renderer.geometryInHash(gId)) {
+ var _box = function() {
+ var cubeIndices = [
+ [0, 4, 2, 6], // -1, 0, 0],// -x
+ [1, 3, 5, 7], // +1, 0, 0],// +x
+ [0, 1, 4, 5], // 0, -1, 0],// -y
+ [2, 6, 3, 7], // 0, +1, 0],// +y
+ [0, 2, 1, 3], // 0, 0, -1],// -z
+ [4, 5, 6, 7] // 0, 0, +1] // +z
+ ];
+ //using strokeIndices instead of faces for strokes
+ //to avoid diagonal stroke lines across face of box
+ this.strokeIndices = [
+ [0, 1],
+ [1, 3],
+ [3, 2],
+ [6, 7],
+ [8, 9],
+ [9, 11],
+ [14, 15],
+ [16, 17],
+ [17, 19],
+ [18, 19],
+ [20, 21],
+ [22, 23]
+ ];
+ for (var i = 0; i < cubeIndices.length; i++) {
+ var cubeIndex = cubeIndices[i];
+ var v = i * 4;
+ for (var j = 0; j < 4; j++) {
+ var d = cubeIndex[j];
+ //inspired by lightgl:
+ //https://github.com/evanw/lightgl.js
+ //octants:https://en.wikipedia.org/wiki/Octant_(solid_geometry)
+ var octant = new p5.Vector(
+ ((d & 1) * 2 - 1) / 2,
+ ((d & 2) - 1) / 2,
+ ((d & 4) / 2 - 1) / 2
+ );
+ this.vertices.push(octant);
+ this.uvs.push(j & 1, (j & 2) / 2);
+ }
+ this.faces.push([v, v + 1, v + 2]);
+ this.faces.push([v + 2, v + 1, v + 3]);
+ }
+ };
+ var boxGeom = new p5.Geometry(detailX, detailY, _box);
+ boxGeom.computeNormals();
+ if (detailX <= 4 && detailY <= 4) {
+ boxGeom._makeTriangleEdges()._edgesToVertices();
+ } else {
+ console.log(
+ 'Cannot draw stroke on box objects with more' +
+ ' than 4 detailX or 4 detailY'
+ );
+ }
+ //initialize our geometry buffer with
+ //the key val pair:
+ //geometry Id, Geom object
+ this._renderer.createBuffers(gId, boxGeom);
+ }
+ this._renderer.drawBuffersScaled(gId, width, height, depth);
+
+ return this;
};
/**
- * This function is used to apply a regular expression to a piece of text,
- * and return a list of matching groups (elements found inside parentheses)
- * as a two-dimensional String array. If there are no matches, a null value
- * will be returned. If no groups are specified in the regular expression,
- * but the sequence matches, a two dimensional array is still returned, but
- * the second dimension is only of length one.
- *
- * To use the function, first check to see if the result is null. If the
- * result is null, then the sequence did not match at all. If the sequence
- * did match, a 2D array is returned.
- *
- * If there are groups (specified by sets of parentheses) in the regular
- * expression, then the contents of each will be returned in the array.
- * Assuming a loop with counter variable i, element [i][0] of a regular
- * expression match returns the entire matching string, and the match groups
- * start at element [i][1] (the first group is [i][1], the second [i][2],
- * and so on).
- *
- * @method matchAll
- * @param {String} str the String to be searched
- * @param {String} regexp the regexp to be used for matching
- * @return {String[]} 2d Array of Strings found
+ * Draw a sphere with given radius
+ * @method sphere
+ * @param {Number} [radius] radius of circle
+ * @param {Integer} [detailX] number of segments,
+ * the more segments the smoother geometry
+ * default is 24
+ * @param {Integer} [detailY] number of segments,
+ * the more segments the smoother geometry
+ * default is 16
+ * @chainable
* @example
- *
+ *
*
- * var string = "Hello p5js*! Hello world!"
- * var regexp = "Hello"
- * matchAll(string, regexp);
+ * // draw a sphere with radius 200
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * sphere(40);
+ * }
*
*
*/
-p5.prototype.matchAll = function(str, reg) {
- p5._validateParameters('matchAll', arguments);
- var re = new RegExp(reg, 'g');
- var match = re.exec(str);
- var matches = [];
- while (match !== null) {
- matches.push(match);
- // matched text: match[0]
- // match start: match.index
- // capturing group n: match[n]
- match = re.exec(str);
+p5.prototype.sphere = function(radius, detailX, detailY) {
+ this._assert3d('sphere');
+ p5._validateParameters('sphere', arguments);
+ if (typeof radius === 'undefined') {
+ radius = 50;
}
- return matches;
+ if (typeof detailX === 'undefined') {
+ detailX = 24;
+ }
+ if (typeof detailY === 'undefined') {
+ detailY = 16;
+ }
+
+ this.ellipsoid(radius, radius, radius, detailX, detailY);
+
+ return this;
};
/**
- * 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.
- *
- * @method nf
- * @param {Number|String} num the Number to format
- * @param {Number|String} [left] number of digits to the left of the
- * decimal point
- * @param {Number|String} [right] number of digits to the right of the
- * decimal point
- * @return {String} formatted String
+ * @private
+ * Helper function for creating both cones and cyllinders
+ * Will only generate well-defined geometry when bottomRadius, height > 0
+ * and topRadius >= 0
+ * If topRadius == 0, topCap should be false
*/
+var _truncatedCone = function(
+ bottomRadius,
+ topRadius,
+ height,
+ detailX,
+ detailY,
+ bottomCap,
+ topCap
+) {
+ bottomRadius = bottomRadius <= 0 ? 1 : bottomRadius;
+ topRadius = topRadius < 0 ? 0 : topRadius;
+ height = height <= 0 ? bottomRadius : height;
+ detailX = detailX < 3 ? 3 : detailX;
+ detailY = detailY < 1 ? 1 : detailY;
+ bottomCap = bottomCap === undefined ? true : bottomCap;
+ topCap = topCap === undefined ? topRadius !== 0 : topCap;
+ var start = bottomCap ? -2 : 0;
+ var end = detailY + (topCap ? 2 : 0);
+ var vertsOnLayer = {};
+ //ensure constant slant for interior vertex normals
+ var slant = Math.atan2(bottomRadius - topRadius, height);
+ var yy, ii, jj, nextii, nextjj;
+ for (yy = start; yy <= end; ++yy) {
+ var v = yy / detailY;
+ var y = height * v;
+ var ringRadius;
+ if (yy < 0) {
+ //for the bottomCap edge
+ y = 0;
+ v = 0;
+ ringRadius = bottomRadius;
+ } else if (yy > detailY) {
+ //for the topCap edge
+ y = height;
+ v = 1;
+ ringRadius = topRadius;
+ } else {
+ //for the middle
+ ringRadius = bottomRadius + (topRadius - bottomRadius) * v;
+ }
+ if (yy === -2 || yy === detailY + 2) {
+ //center of bottom or top caps
+ ringRadius = 0;
+ }
+
+ y -= height / 2; //shift coordiate origin to the center of object
+ vertsOnLayer[yy] = ringRadius === 0 ? 1 : detailX;
+ for (ii = 0; ii < vertsOnLayer[yy]; ++ii) {
+ var u = ii / detailX;
+ //VERTICES
+ this.vertices.push(
+ new p5.Vector(
+ Math.sin(u * 2 * Math.PI) * ringRadius,
+ y,
+ Math.cos(u * 2 * Math.PI) * ringRadius
+ )
+ );
+ //VERTEX NORMALS
+ this.vertexNormals.push(
+ new p5.Vector(
+ yy < 0 || yy > detailY
+ ? 0
+ : Math.sin(u * 2 * Math.PI) * Math.cos(slant),
+ yy < 0 ? -1 : yy > detailY ? 1 : Math.sin(slant),
+ yy < 0 || yy > detailY
+ ? 0
+ : Math.cos(u * 2 * Math.PI) * Math.cos(slant)
+ )
+ );
+ //UVs
+ this.uvs.push(u, v);
+ }
+ }
+
+ var startIndex = 0;
+ if (bottomCap) {
+ for (jj = 0; jj < vertsOnLayer[-1]; ++jj) {
+ nextjj = (jj + 1) % vertsOnLayer[-1];
+ this.faces.push([
+ startIndex,
+ startIndex + 1 + nextjj,
+ startIndex + 1 + jj
+ ]);
+ }
+ startIndex += vertsOnLayer[-2] + vertsOnLayer[-1];
+ }
+ for (yy = 0; yy < detailY; ++yy) {
+ for (ii = 0; ii < vertsOnLayer[yy]; ++ii) {
+ if (vertsOnLayer[yy + 1] === 1) {
+ //top layer
+ nextii = (ii + 1) % vertsOnLayer[yy];
+ this.faces.push([
+ startIndex + ii,
+ startIndex + nextii,
+ startIndex + vertsOnLayer[yy]
+ ]);
+ } else {
+ //other side faces
+ //should have vertsOnLayer[yy] === vertsOnLayer[yy + 1]
+ nextii = (ii + 1) % vertsOnLayer[yy];
+ this.faces.push([
+ startIndex + ii,
+ startIndex + nextii,
+ startIndex + vertsOnLayer[yy] + nextii
+ ]);
+ this.faces.push([
+ startIndex + ii,
+ startIndex + vertsOnLayer[yy] + nextii,
+ startIndex + vertsOnLayer[yy] + ii
+ ]);
+ }
+ }
+ startIndex += vertsOnLayer[yy];
+ }
+ if (topCap) {
+ startIndex += vertsOnLayer[detailY];
+ for (ii = 0; ii < vertsOnLayer[detailY + 1]; ++ii) {
+ nextii = (ii + 1) % vertsOnLayer[detailY + 1];
+ this.faces.push([
+ startIndex + ii,
+ startIndex + nextii,
+ startIndex + vertsOnLayer[detailY + 1]
+ ]);
+ }
+ }
+};
+
/**
- * @method nf
- * @param {Array} nums the Numbers to format
- * @param {Number|String} [left]
- * @param {Number|String} [right]
- * @return {Array} formatted Strings\
+ * Draw a cylinder with given radius and height
+ * @method cylinder
+ * @param {Number} [radius] radius of the surface
+ * @param {Number} [height] height of the cylinder
+ * @param {Integer} [detailX] number of segments,
+ * the more segments the smoother geometry
+ * default is 24
+ * @param {Integer} [detailY] number of segments in y-dimension,
+ * the more segments the smoother geometry
+ * default is 1
+ * @param {Boolean} [bottomCap] whether to draw the bottom of the cylinder
+ * @param {Boolean} [topCap] whether to draw the top of the cylinder
+ * @chainable
* @example
*
*
+ * //draw a spinning cylinder with radius 20 and height 50
* function setup() {
- * background(200);
- * var num = 112.53106115;
- *
- * noStroke();
- * fill(0);
- * textSize(14);
- * // Draw formatted numbers
- * text(nf(num, 5, 2), 10, 20);
- *
- * text(nf(num, 4, 3), 10, 55);
- *
- * text(nf(num, 3, 6), 10, 85);
+ * createCanvas(100, 100, WEBGL);
+ * }
*
- * // Draw dividing lines
- * stroke(120);
- * line(0, 30, width, 30);
- * line(0, 65, width, 65);
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateZ(frameCount * 0.01);
+ * cylinder(20, 50);
* }
*
*
- *
- * @alt
- * "0011253" top left, "0112.531" mid left, "112.531061" bottom left canvas
- *
*/
-p5.prototype.nf = function () {
- p5._validateParameters('nf', arguments);
- if (arguments[0] instanceof Array) {
- var a = arguments[1];
- var b = arguments[2];
- return arguments[0].map(function (x) {
- return doNf(x, a, b);
- });
+p5.prototype.cylinder = function(
+ radius,
+ height,
+ detailX,
+ detailY,
+ bottomCap,
+ topCap
+) {
+ this._assert3d('cylinder');
+ p5._validateParameters('cylinder', arguments);
+ if (typeof radius === 'undefined') {
+ radius = 50;
}
- else{
- var typeOfFirst = Object.prototype.toString.call(arguments[0]);
- if(typeOfFirst === '[object Arguments]'){
- if(arguments[0].length===3){
- return this.nf(arguments[0][0],arguments[0][1],arguments[0][2]);
- }
- else if(arguments[0].length===2){
- return this.nf(arguments[0][0],arguments[0][1]);
- }
- else{
- return this.nf(arguments[0][0]);
- }
- }
- else {
- return doNf.apply(this, arguments);
- }
+ if (typeof height === 'undefined') {
+ height = radius;
}
-};
-
-function doNf() {
- var num = arguments[0];
- var neg = num < 0;
- var n = neg ? num.toString().substring(1) : num.toString();
- var decimalInd = n.indexOf('.');
- var intPart = decimalInd !== -1 ? n.substring(0, decimalInd) : n;
- var decPart = decimalInd !== -1 ? n.substring(decimalInd + 1) : '';
- var str = neg ? '-' : '';
- if (arguments.length === 3) {
- var decimal = '';
- if(decimalInd !== -1 || arguments[2] - decPart.length > 0){
- decimal = '.';
- }
- if (decPart.length > arguments[2]) {
- decPart = decPart.substring(0, arguments[2]);
- }
- for (var i = 0; i < arguments[1] - intPart.length; i++) {
- str += '0';
- }
- str += intPart;
- str += decimal;
- str += decPart;
- for (var j = 0; j < arguments[2] - decPart.length; j++) {
- str += '0';
- }
- return str;
+ if (typeof detailX === 'undefined') {
+ detailX = 24;
}
- else {
- for (var k = 0; k < Math.max(arguments[1] - intPart.length, 0); k++) {
- str += '0';
+ if (typeof detailY === 'undefined') {
+ detailY = 1;
+ }
+ if (typeof topCap === 'undefined') {
+ topCap = true;
+ }
+ if (typeof bottomCap === 'undefined') {
+ bottomCap = true;
+ }
+
+ var gId =
+ 'cylinder|' + detailX + '|' + detailY + '|' + bottomCap + '|' + topCap;
+ if (!this._renderer.geometryInHash(gId)) {
+ var cylinderGeom = new p5.Geometry(detailX, detailY);
+ _truncatedCone.call(
+ cylinderGeom,
+ 1,
+ 1,
+ 1,
+ detailX,
+ detailY,
+ bottomCap,
+ topCap
+ );
+ cylinderGeom.computeNormals();
+ if (detailX <= 24 && detailY <= 16) {
+ cylinderGeom._makeTriangleEdges()._edgesToVertices();
+ } else {
+ console.log(
+ 'Cannot draw stroke on cylinder objects with more' +
+ ' than 24 detailX or 16 detailY'
+ );
}
- str += n;
- return str;
+ this._renderer.createBuffers(gId, cylinderGeom);
}
-}
+
+ this._renderer.drawBuffersScaled(gId, radius, height, radius);
+
+ return this;
+};
/**
- * 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 right parameter should always be a positive integer.
- *
- * @method nfc
- * @param {Number|String} num the Number to format
- * @param {Number|String} [right] number of digits to the right of the
- * decimal point
- * @return {String} formatted String
- */
-/**
- * @method nfc
- * @param {Array} nums the Numbers to format
- * @param {Number|String} [right]
- * @return {Array} formatted Strings
+ * Draw a cone with given radius and height
+ * @method cone
+ * @param {Number} [radius] radius of the bottom surface
+ * @param {Number} [height] height of the cone
+ * @param {Integer} [detailX] number of segments,
+ * the more segments the smoother geometry
+ * default is 24
+ * @param {Integer} [detailY] number of segments,
+ * the more segments the smoother geometry
+ * default is 1
+ * @param {Boolean} [cap] whether to draw the base of the cone
+ * @chainable
* @example
*
*
+ * //draw a spinning cone with radius 40 and height 70
* function setup() {
- * background(200);
- * var num = 11253106.115;
- * var numArr = new Array(1,1,2);
- *
- * noStroke();
- * fill(0);
- * textSize(12);
- *
- * // Draw formatted numbers
- * text(nfc(num, 4, 2), 10, 30);
- * text(nfc(numArr, 2, 1), 10, 80);
+ * createCanvas(100, 100, WEBGL);
+ * }
*
- * // Draw dividing line
- * stroke(120);
- * line(0, 50, width, 50);
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateZ(frameCount * 0.01);
+ * cone(40, 70);
* }
*
*
- *
- * @alt
- * "11,253,106.115" top middle and "1.00,1.00,2.00" displayed bottom mid
- *
*/
-p5.prototype.nfc = function () {
- p5._validateParameters('nfc', arguments);
- if (arguments[0] instanceof Array) {
- var a = arguments[1];
- return arguments[0].map(function (x) {
- return doNfc(x, a);
- });
- } else {
- return doNfc.apply(this, arguments);
+p5.prototype.cone = function(radius, height, detailX, detailY, cap) {
+ this._assert3d('cone');
+ p5._validateParameters('cone', arguments);
+ if (typeof radius === 'undefined') {
+ radius = 50;
}
-};
-function doNfc() {
- var num = arguments[0].toString();
- var dec = num.indexOf('.');
- var rem = dec !== -1 ? num.substring(dec) : '';
- var n = dec !== -1 ? num.substring(0, dec) : num;
- n = n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
- if (arguments[1] === 0) {
- rem = '';
+ if (typeof height === 'undefined') {
+ height = radius;
}
- else if(arguments[1] !== undefined){
- if(arguments[1] > rem.length){
- rem+= dec === -1 ? '.' : '';
- var len = arguments[1] - rem.length + 1;
- for(var i =0; i< len; i++){
- rem += '0';
- }
- }
- else{
- rem = rem.substring(0, arguments[1] + 1);
+ if (typeof detailX === 'undefined') {
+ detailX = 24;
+ }
+ if (typeof detailY === 'undefined') {
+ detailY = 1;
+ }
+ if (typeof cap === 'undefined') {
+ cap = true;
+ }
+
+ var gId = 'cone|' + detailX + '|' + detailY + '|' + cap;
+ if (!this._renderer.geometryInHash(gId)) {
+ var coneGeom = new p5.Geometry(detailX, detailY);
+ _truncatedCone.call(coneGeom, 1, 0, 1, detailX, detailY, cap, false);
+ //for cones we need to average Normals
+ coneGeom.computeNormals();
+ if (detailX <= 24 && detailY <= 16) {
+ coneGeom._makeTriangleEdges()._edgesToVertices();
+ } else {
+ console.log(
+ 'Cannot draw stroke on cone objects with more' +
+ ' than 24 detailX or 16 detailY'
+ );
}
+ this._renderer.createBuffers(gId, coneGeom);
}
- return n + rem;
-}
+
+ this._renderer.drawBuffersScaled(gId, radius, height, radius);
+
+ return this;
+};
/**
- * 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 left, and right parameters
- * should always be positive integers.
- *
- * @method nfp
- * @param {Number} num the Number to format
- * @param {Number} [left] number of digits to the left of the decimal
- * point
- * @param {Number} [right] number of digits to the right of the
- * decimal point
- * @return {String} formatted String
- */
-/**
- * @method nfp
- * @param {Number[]} nums the Numbers to format
- * @param {Number} [left]
- * @param {Number} [right]
- * @return {String[]} formatted Strings
+ * Draw an ellipsoid with given radius
+ * @method ellipsoid
+ * @param {Number} [radiusx] xradius of circle
+ * @param {Number} [radiusy] yradius of circle
+ * @param {Number} [radiusz] zradius of circle
+ * @param {Integer} [detailX] number of segments,
+ * the more segments the smoother geometry
+ * default is 24. Avoid detail number above
+ * 150, it may crash the browser.
+ * @param {Integer} [detailY] number of segments,
+ * the more segments the smoother geometry
+ * default is 16. Avoid detail number above
+ * 150, it may crash the browser.
+ * @chainable
* @example
*
*
+ * // draw an ellipsoid with radius 20, 30 and 40.
* function setup() {
- * background(200);
- * var num1 = 11253106.115;
- * var num2 = -11253106.115;
- *
- * noStroke();
- * fill(0);
- * textSize(12);
- *
- * // Draw formatted numbers
- * text(nfp(num1, 4, 2), 10, 30);
- * text(nfp(num2, 4, 2), 10, 80);
+ * createCanvas(100, 100, WEBGL);
+ * }
*
- * // Draw dividing line
- * stroke(120);
- * line(0, 50, width, 50);
+ * function draw() {
+ * background(200);
+ * ellipsoid(20, 30, 40);
* }
*
*
- *
- * @alt
- * "+11253106.11" top middle and "-11253106.11" displayed bottom middle
- *
*/
-p5.prototype.nfp = function() {
- p5._validateParameters('nfp', arguments);
- var nfRes = p5.prototype.nf.apply(this, arguments);
- if (nfRes instanceof Array) {
- return nfRes.map(addNfp);
- } else {
- return addNfp(nfRes);
+p5.prototype.ellipsoid = function(radiusX, radiusY, radiusZ, detailX, detailY) {
+ this._assert3d('ellipsoid');
+ p5._validateParameters('ellipsoid', arguments);
+ if (typeof radiusX === 'undefined') {
+ radiusX = 50;
+ }
+ if (typeof radiusY === 'undefined') {
+ radiusY = radiusX;
+ }
+ if (typeof radiusZ === 'undefined') {
+ radiusZ = radiusX;
}
-};
-function addNfp() {
- return (
- parseFloat(arguments[0]) > 0) ?
- '+'+arguments[0].toString() :
- arguments[0].toString();
-}
+ if (typeof detailX === 'undefined') {
+ detailX = 24;
+ }
+ if (typeof detailY === 'undefined') {
+ detailY = 16;
+ }
+
+ var gId = 'ellipsoid|' + detailX + '|' + detailY;
+
+ if (!this._renderer.geometryInHash(gId)) {
+ var _ellipsoid = function() {
+ for (var i = 0; i <= this.detailY; i++) {
+ var v = i / this.detailY;
+ var phi = Math.PI * v - Math.PI / 2;
+ var cosPhi = Math.cos(phi);
+ var sinPhi = Math.sin(phi);
+
+ for (var j = 0; j <= this.detailX; j++) {
+ var u = j / this.detailX;
+ var theta = 2 * Math.PI * u;
+ var cosTheta = Math.cos(theta);
+ var sinTheta = Math.sin(theta);
+ var p = new p5.Vector(cosPhi * sinTheta, sinPhi, cosPhi * cosTheta);
+ this.vertices.push(p);
+ this.vertexNormals.push(p);
+ this.uvs.push(u, v);
+ }
+ }
+ };
+ var ellipsoidGeom = new p5.Geometry(detailX, detailY, _ellipsoid);
+ ellipsoidGeom.computeFaces();
+ if (detailX <= 24 && detailY <= 24) {
+ ellipsoidGeom._makeTriangleEdges()._edgesToVertices();
+ } else {
+ console.log(
+ 'Cannot draw stroke on ellipsoids with more' +
+ ' than 24 detailX or 24 detailY'
+ );
+ }
+ this._renderer.createBuffers(gId, ellipsoidGeom);
+ }
+
+ this._renderer.drawBuffersScaled(gId, radiusX, radiusY, radiusZ);
+
+ return this;
+};
/**
- * Utility function for formatting numbers into strings. Similar to nf() but
- * puts a " " (space) 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.
- *
- * @method nfs
- * @param {Number} num the Number to format
- * @param {Number} [left] number of digits to the left of the decimal
- * point
- * @param {Number} [right] number of digits to the right of the
- * decimal point
- * @return {String} formatted String
- */
-/**
- * @method nfs
- * @param {Array} nums the Numbers to format
- * @param {Number} [left]
- * @param {Number} [right]
- * @return {Array} formatted Strings
+ * Draw a torus with given radius and tube radius
+ * @method torus
+ * @param {Number} [radius] radius of the whole ring
+ * @param {Number} [tubeRadius] radius of the tube
+ * @param {Integer} [detailX] number of segments in x-dimension,
+ * the more segments the smoother geometry
+ * default is 24
+ * @param {Integer} [detailY] number of segments in y-dimension,
+ * the more segments the smoother geometry
+ * default is 16
+ * @chainable
* @example
*
*
+ * //draw a spinning torus with radius 200 and tube radius 60
* function setup() {
- * background(200);
- * var num1 = 11253106.115;
- * var num2 = -11253106.115;
- *
- * noStroke();
- * fill(0);
- * textSize(12);
- * // Draw formatted numbers
- * text(nfs(num1, 4, 2), 10, 30);
- *
- * text(nfs(num2, 4, 2), 10, 80);
+ * createCanvas(100, 100, WEBGL);
+ * }
*
- * // Draw dividing line
- * stroke(120);
- * line(0, 50, width, 50);
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * torus(50, 15);
* }
*
*
- *
- * @alt
- * "11253106.11" top middle and "-11253106.11" displayed bottom middle
- *
*/
-p5.prototype.nfs = function() {
- p5._validateParameters('nfs', arguments);
- var nfRes = p5.prototype.nf.apply(this, arguments);
- if (nfRes instanceof Array) {
- return nfRes.map(addNfs);
- } else {
- return addNfs(nfRes);
+p5.prototype.torus = function(radius, tubeRadius, detailX, detailY) {
+ this._assert3d('torus');
+ p5._validateParameters('torus', arguments);
+ if (typeof radius === 'undefined') {
+ radius = 50;
+ } else if (!radius) {
+ return; // nothing to draw
+ }
+
+ if (typeof tubeRadius === 'undefined') {
+ tubeRadius = 10;
+ } else if (!tubeRadius) {
+ return; // nothing to draw
+ }
+
+ if (typeof detailX === 'undefined') {
+ detailX = 24;
}
+ if (typeof detailY === 'undefined') {
+ detailY = 16;
+ }
+
+ var tubeRatio = (tubeRadius / radius).toPrecision(4);
+ var gId = 'torus|' + tubeRatio + '|' + detailX + '|' + detailY;
+
+ if (!this._renderer.geometryInHash(gId)) {
+ var _torus = function() {
+ for (var i = 0; i <= this.detailY; i++) {
+ var v = i / this.detailY;
+ var phi = 2 * Math.PI * v;
+ var cosPhi = Math.cos(phi);
+ var sinPhi = Math.sin(phi);
+ var r = 1 + tubeRatio * cosPhi;
+
+ for (var j = 0; j <= this.detailX; j++) {
+ var u = j / this.detailX;
+ var theta = 2 * Math.PI * u;
+ var cosTheta = Math.cos(theta);
+ var sinTheta = Math.sin(theta);
+
+ var p = new p5.Vector(r * cosTheta, r * sinTheta, tubeRatio * sinPhi);
+
+ var n = new p5.Vector(cosPhi * cosTheta, cosPhi * sinTheta, sinPhi);
+
+ this.vertices.push(p);
+ this.vertexNormals.push(n);
+ this.uvs.push(u, v);
+ }
+ }
+ };
+ var torusGeom = new p5.Geometry(detailX, detailY, _torus);
+ torusGeom.computeFaces();
+ if (detailX <= 24 && detailY <= 16) {
+ torusGeom._makeTriangleEdges()._edgesToVertices();
+ } else {
+ console.log(
+ 'Cannot draw strokes on torus object with more' +
+ ' than 24 detailX or 16 detailY'
+ );
+ }
+ this._renderer.createBuffers(gId, torusGeom);
+ }
+ this._renderer.drawBuffersScaled(gId, radius, radius, radius);
+
+ return this;
};
-function addNfs() {
- return (
- parseFloat(arguments[0]) > 0) ?
- ' '+arguments[0].toString() :
- arguments[0].toString();
-}
+///////////////////////
+/// 2D primitives
+/////////////////////////
/**
- * The split() function maps to String.split(), it breaks a String into
- * pieces using a character or string as the delimiter. 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.
- *
- * The splitTokens() function works in a similar fashion, except that it
- * splits using a range of characters instead of a specific character or
- * sequence.
- *
- * @method split
- * @param {String} value the String to be split
- * @param {String} delim the String used to separate the data
- * @return {String[]} Array of Strings
+ * Draws a point, a coordinate in space at the dimension of one pixel,
+ * given x, y and z coordinates. The color of the point is determined
+ * by the current stroke, while the point size is determined by current
+ * stroke weight.
+ * @private
+ * @param {Number} x x-coordinate of point
+ * @param {Number} y y-coordinate of point
+ * @param {Number} z z-coordinate of point
+ * @chainable
* @example
*
*
- * var names = "Pat,Xio,Alex"
- * var splitString = split(names, ",");
- * text(splitString[0], 5, 30);
- * text(splitString[1], 5, 50);
- * text(splitString[2], 5, 70);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(50);
+ * stroke(255);
+ * strokeWeight(4);
+ * point(25, 0);
+ * strokeWeight(3);
+ * point(-25, 0);
+ * strokeWeight(2);
+ * point(0, 25);
+ * strokeWeight(1);
+ * point(0, -25);
+ * }
*
*
- *
- * @alt
- * "pat" top left, "Xio" mid left and "Alex" displayed bottom left
- *
*/
-p5.prototype.split = function(str, delim) {
- p5._validateParameters('split', arguments);
- return str.split(delim);
+p5.RendererGL.prototype.point = function(x, y, z) {
+ this._usePointShader();
+ this.curPointShader.bindShader();
+ if (typeof z === 'undefined') {
+ z = 0;
+ }
+ var _vertex = [];
+ _vertex.push(new p5.Vector(x, y, z));
+ this._drawPoints(_vertex, this._pointVertexBuffer);
+ this.curPointShader.unbindShader();
+
+ return this;
+};
+
+p5.RendererGL.prototype.triangle = function(args) {
+ var x1 = args[0],
+ y1 = args[1];
+ var x2 = args[2],
+ y2 = args[3];
+ var x3 = args[4],
+ y3 = args[5];
+
+ var gId = 'tri';
+ if (!this.geometryInHash(gId)) {
+ var _triangle = function() {
+ var vertices = [];
+ vertices.push(new p5.Vector(0, 0, 0));
+ vertices.push(new p5.Vector(0, 1, 0));
+ vertices.push(new p5.Vector(1, 0, 0));
+ this.strokeIndices = [[0, 1], [1, 2], [2, 0]];
+ this.vertices = vertices;
+ this.faces = [[0, 1, 2]];
+ this.uvs = [0, 0, 0, 1, 1, 1];
+ };
+ var triGeom = new p5.Geometry(1, 1, _triangle);
+ triGeom._makeTriangleEdges()._edgesToVertices();
+ triGeom.computeNormals();
+ this.createBuffers(gId, triGeom);
+ }
+
+ // only one triangle is cached, one point is at the origin, and the
+ // two adjacent sides are tne unit vectors along the X & Y axes.
+ //
+ // this matrix multiplication transforms those two unit vectors
+ // onto the required vector prior to rendering, and moves the
+ // origin appropriately.
+ var uMVMatrix = this.uMVMatrix.copy();
+ try {
+ // prettier-ignore
+ var mult = new p5.Matrix([
+ x2 - x1, y2 - y1, 0, 0, // the resulting unit X-axis
+ x3 - x1, y3 - y1, 0, 0, // the resulting unit Y-axis
+ 0, 0, 1, 0, // the resulting unit Z-axis (unchanged)
+ x1, y1, 0, 1 // the resulting origin
+ ]).mult(this.uMVMatrix);
+
+ this.uMVMatrix = mult;
+
+ this.drawBuffers(gId);
+ } finally {
+ this.uMVMatrix = uMVMatrix;
+ }
+
+ return this;
+};
+
+p5.RendererGL.prototype.ellipse = function(args) {
+ this.arc(
+ args[0],
+ args[1],
+ args[2],
+ args[3],
+ 0,
+ constants.TWO_PI,
+ constants.OPEN,
+ args[4]
+ );
+};
+
+p5.RendererGL.prototype.arc = function(args) {
+ var x = arguments[0];
+ var y = arguments[1];
+ var width = arguments[2];
+ var height = arguments[3];
+ var start = arguments[4];
+ var stop = arguments[5];
+ var mode = arguments[6];
+ var detail = arguments[7] || 25;
+
+ var shape;
+ var gId;
+
+ // check if it is an ellipse or an arc
+ if (Math.abs(stop - start) >= constants.TWO_PI) {
+ shape = 'ellipse';
+ gId = shape + '|' + detail + '|';
+ } else {
+ shape = 'arc';
+ gId = shape + '|' + start + '|' + stop + '|' + mode + '|' + detail + '|';
+ }
+
+ if (!this.geometryInHash(gId)) {
+ var _arc = function() {
+ this.strokeIndices = [];
+
+ // if the start and stop angles are not the same, push vertices to the array
+ if (start.toFixed(10) !== stop.toFixed(10)) {
+ // if the mode specified is PIE or null, push the mid point of the arc in vertices
+ if (mode === constants.PIE || typeof mode === 'undefined') {
+ this.vertices.push(new p5.Vector(0.5, 0.5, 0));
+ this.uvs.push([0.5, 0.5]);
+ }
+
+ // vertices for the perimeter of the circle
+ for (var i = 0; i <= detail; i++) {
+ var u = i / detail;
+ var theta = (stop - start) * u + start;
+
+ var _x = 0.5 + Math.cos(theta) / 2;
+ var _y = 0.5 + Math.sin(theta) / 2;
+
+ this.vertices.push(new p5.Vector(_x, _y, 0));
+ this.uvs.push([_x, _y]);
+
+ if (i < detail - 1) {
+ this.faces.push([0, i + 1, i + 2]);
+ this.strokeIndices.push([i + 1, i + 2]);
+ }
+ }
+
+ // check the mode specified in order to push vertices and faces, different for each mode
+ switch (mode) {
+ case constants.PIE:
+ this.faces.push([
+ 0,
+ this.vertices.length - 2,
+ this.vertices.length - 1
+ ]);
+ this.strokeIndices.push([0, 1]);
+ this.strokeIndices.push([
+ this.vertices.length - 2,
+ this.vertices.length - 1
+ ]);
+ this.strokeIndices.push([0, this.vertices.length - 1]);
+ break;
+
+ case constants.CHORD:
+ this.strokeIndices.push([0, 1]);
+ this.strokeIndices.push([0, this.vertices.length - 1]);
+ break;
+
+ case constants.OPEN:
+ this.strokeIndices.push([0, 1]);
+ break;
+
+ default:
+ this.faces.push([
+ 0,
+ this.vertices.length - 2,
+ this.vertices.length - 1
+ ]);
+ this.strokeIndices.push([
+ this.vertices.length - 2,
+ this.vertices.length - 1
+ ]);
+ }
+ }
+ };
+
+ var arcGeom = new p5.Geometry(detail, 1, _arc);
+ arcGeom.computeNormals();
+
+ if (detail <= 50) {
+ arcGeom._makeTriangleEdges()._edgesToVertices(arcGeom);
+ } else {
+ console.log('Cannot stroke ' + shape + ' with more than 50 detail');
+ }
+
+ this.createBuffers(gId, arcGeom);
+ }
+
+ var uMVMatrix = this.uMVMatrix.copy();
+
+ try {
+ this.uMVMatrix.translate([x, y, 0]);
+ this.uMVMatrix.scale(width, height, 1);
+
+ this.drawBuffers(gId);
+ } finally {
+ this.uMVMatrix = uMVMatrix;
+ }
+
+ return this;
+};
+
+p5.RendererGL.prototype.rect = function(args) {
+ var perPixelLighting = this.attributes.perPixelLighting;
+ var x = args[0];
+ var y = args[1];
+ var width = args[2];
+ var height = args[3];
+ var detailX = args[4] || (perPixelLighting ? 1 : 24);
+ var detailY = args[5] || (perPixelLighting ? 1 : 16);
+ var gId = 'rect|' + detailX + '|' + detailY;
+ if (!this.geometryInHash(gId)) {
+ var _rect = function() {
+ for (var i = 0; i <= this.detailY; i++) {
+ var v = i / this.detailY;
+ for (var j = 0; j <= this.detailX; j++) {
+ var u = j / this.detailX;
+ var p = new p5.Vector(u, v, 0);
+ this.vertices.push(p);
+ this.uvs.push(u, v);
+ }
+ }
+ // using stroke indices to avoid stroke over face(s) of rectangle
+ if (detailX > 0 && detailY > 0) {
+ this.strokeIndices = [
+ [0, detailX],
+ [detailX, (detailX + 1) * (detailY + 1) - 1],
+ [(detailX + 1) * (detailY + 1) - 1, (detailX + 1) * detailY],
+ [(detailX + 1) * detailY, 0]
+ ];
+ }
+ };
+ var rectGeom = new p5.Geometry(detailX, detailY, _rect);
+ rectGeom
+ .computeFaces()
+ .computeNormals()
+ ._makeTriangleEdges()
+ ._edgesToVertices();
+ this.createBuffers(gId, rectGeom);
+ }
+
+ // only a single rectangle (of a given detail) is cached: a square with
+ // opposite corners at (0,0) & (1,1).
+ //
+ // before rendering, this square is scaled & moved to the required location.
+ var uMVMatrix = this.uMVMatrix.copy();
+ try {
+ this.uMVMatrix.translate([x, y, 0]);
+ this.uMVMatrix.scale(width, height, 1);
+
+ this.drawBuffers(gId);
+ } finally {
+ this.uMVMatrix = uMVMatrix;
+ }
+ return this;
+};
+
+p5.RendererGL.prototype.quad = function(x1, y1, x2, y2, x3, y3, x4, y4) {
+ var gId =
+ 'quad|' +
+ x1 +
+ '|' +
+ y1 +
+ '|' +
+ x2 +
+ '|' +
+ y2 +
+ '|' +
+ x3 +
+ '|' +
+ y3 +
+ '|' +
+ x4 +
+ '|' +
+ y4;
+ if (!this.geometryInHash(gId)) {
+ var _quad = function() {
+ this.vertices.push(new p5.Vector(x1, y1, 0));
+ this.vertices.push(new p5.Vector(x2, y2, 0));
+ this.vertices.push(new p5.Vector(x3, y3, 0));
+ this.vertices.push(new p5.Vector(x4, y4, 0));
+ this.uvs.push(0, 0, 1, 0, 1, 1, 0, 1);
+ this.strokeIndices = [[0, 1], [1, 2], [2, 3], [3, 0]];
+ };
+ var quadGeom = new p5.Geometry(2, 2, _quad);
+ quadGeom
+ .computeNormals()
+ ._makeTriangleEdges()
+ ._edgesToVertices();
+ quadGeom.faces = [[0, 1, 2], [2, 3, 0]];
+ this.createBuffers(gId, quadGeom);
+ }
+ this.drawBuffers(gId);
+ return this;
+};
+
+//this implementation of bezier curve
+//is based on Bernstein polynomial
+// pretier-ignore
+p5.RendererGL.prototype.bezier = function(
+ x1,
+ y1,
+ z1, // x2
+ x2, // y2
+ y2, // x3
+ z2, // y3
+ x3, // x4
+ y3, // y4
+ z3,
+ x4,
+ y4,
+ z4
+) {
+ if (arguments.length === 8) {
+ x4 = x3;
+ y4 = y3;
+ x3 = y2;
+ y3 = x2;
+ x2 = z1;
+ y2 = x2;
+ z1 = z2 = z3 = z4 = 0;
+ }
+
+ var bezierDetail = this._pInst._bezierDetail || 20; //value of Bezier detail
+ this.beginShape();
+ for (var i = 0; i <= bezierDetail; i++) {
+ var c1 = Math.pow(1 - i / bezierDetail, 3);
+ var c2 = 3 * (i / bezierDetail) * Math.pow(1 - i / bezierDetail, 2);
+ var c3 = 3 * Math.pow(i / bezierDetail, 2) * (1 - i / bezierDetail);
+ var c4 = Math.pow(i / bezierDetail, 3);
+ this.vertex(
+ x1 * c1 + x2 * c2 + x3 * c3 + x4 * c4,
+ y1 * c1 + y2 * c2 + y3 * c3 + y4 * c4,
+ z1 * c1 + z2 * c2 + z3 * c3 + z4 * c4
+ );
+ }
+ this.endShape();
+ return this;
+};
+
+// pretier-ignore
+p5.RendererGL.prototype.curve = function(
+ x1,
+ y1,
+ z1, // x2
+ x2, // y2
+ y2, // x3
+ z2, // y3
+ x3, // x4
+ y3, // y4
+ z3,
+ x4,
+ y4,
+ z4
+) {
+ if (arguments.length === 8) {
+ x4 = x3;
+ y4 = y3;
+ x3 = y2;
+ y3 = x2;
+ x2 = z1;
+ y2 = x2;
+ z1 = z2 = z3 = z4 = 0;
+ }
+ var curveDetail = this._pInst._curveDetail;
+ this.beginShape();
+ for (var i = 0; i <= curveDetail; i++) {
+ var c1 = Math.pow(i / curveDetail, 3) * 0.5;
+ var c2 = Math.pow(i / curveDetail, 2) * 0.5;
+ var c3 = i / curveDetail * 0.5;
+ var c4 = 0.5;
+ var vx =
+ c1 * (-x1 + 3 * x2 - 3 * x3 + x4) +
+ c2 * (2 * x1 - 5 * x2 + 4 * x3 - x4) +
+ c3 * (-x1 + x3) +
+ c4 * (2 * x2);
+ var vy =
+ c1 * (-y1 + 3 * y2 - 3 * y3 + y4) +
+ c2 * (2 * y1 - 5 * y2 + 4 * y3 - y4) +
+ c3 * (-y1 + y3) +
+ c4 * (2 * y2);
+ var vz =
+ c1 * (-z1 + 3 * z2 - 3 * z3 + z4) +
+ c2 * (2 * z1 - 5 * z2 + 4 * z3 - z4) +
+ c3 * (-z1 + z3) +
+ c4 * (2 * z2);
+ this.vertex(vx, vy, vz);
+ }
+ this.endShape();
+ return this;
};
/**
- * The splitTokens() function splits a String at one or many character
- * delimiters or "tokens." The delim parameter specifies the character or
- * characters to be used as a boundary.
- *
- * If no delim characters are specified, any whitespace character is used to
- * split. Whitespace characters include tab (\t), line feed (\n), carriage
- * return (\r), form feed (\f), and space.
- *
- * @method splitTokens
- * @param {String} value the String to be split
- * @param {String} [delim] list of individual Strings that will be used as
- * separators
- * @return {String[]} Array of Strings
+ * Draw a line given two points
+ * @private
+ * @param {Number} x0 x-coordinate of first vertex
+ * @param {Number} y0 y-coordinate of first vertex
+ * @param {Number} z0 z-coordinate of first vertex
+ * @param {Number} x1 x-coordinate of second vertex
+ * @param {Number} y1 y-coordinate of second vertex
+ * @param {Number} z1 z-coordinate of second vertex
+ * @chainable
* @example
- *
+ *
*
+ * //draw a line
* function setup() {
- * var myStr = "Mango, Banana, Lime";
- * var myStrArr = splitTokens(myStr, ",");
+ * createCanvas(100, 100, WEBGL);
+ * }
*
- * print(myStrArr); // prints : ["Mango"," Banana"," Lime"]
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * // Use fill instead of stroke to change the color of shape.
+ * fill(255, 0, 0);
+ * line(10, 10, 0, 60, 60, 20);
* }
*
*
*/
-p5.prototype.splitTokens = function() {
- p5._validateParameters('splitTokens', arguments);
- var d,sqo,sqc,str;
- str = arguments[1];
- if (arguments.length > 1) {
- sqc = /\]/g.exec(str);
- sqo = /\[/g.exec(str);
- if ( sqo && sqc ) {
- str = str.slice(0, sqc.index) + str.slice(sqc.index+1);
- sqo = /\[/g.exec(str);
- str = str.slice(0, sqo.index) + str.slice(sqo.index+1);
- d = new RegExp('[\\['+str+'\\]]','g');
- } else if ( sqc ) {
- str = str.slice(0, sqc.index) + str.slice(sqc.index+1);
- d = new RegExp('[' + str + '\\]]', 'g');
- } else if(sqo) {
- str = str.slice(0, sqo.index) + str.slice(sqo.index+1);
- d = new RegExp('[' + str + '\\[]', 'g');
- } else {
- d = new RegExp('[' + str + ']', 'g');
- }
+p5.RendererGL.prototype.line = function() {
+ if (arguments.length === 6) {
+ this.beginShape();
+ this.vertex(arguments[0], arguments[1], arguments[2]);
+ this.vertex(arguments[3], arguments[4], arguments[5]);
+ this.endShape();
+ } else if (arguments.length === 4) {
+ this.beginShape();
+ this.vertex(arguments[0], arguments[1], 0);
+ this.vertex(arguments[2], arguments[3], 0);
+ this.endShape();
+ }
+ return this;
+};
+
+p5.RendererGL.prototype.bezierVertex = function() {
+ if (this.immediateMode._bezierVertex.length === 0) {
+ throw Error('vertex() must be used once before calling bezierVertex()');
} else {
- d = /\s/g;
+ var w_x = [];
+ var w_y = [];
+ var w_z = [];
+ var t, _x, _y, _z, i;
+ var argLength = arguments.length;
+
+ t = 0;
+
+ if (
+ this._lookUpTableBezier.length === 0 ||
+ this._lutBezierDetail !== this._pInst._curveDetail
+ ) {
+ this._lookUpTableBezier = [];
+ this._lutBezierDetail = this._pInst._curveDetail;
+ var step = 1 / this._lutBezierDetail;
+ var start = 0;
+ var end = 1;
+ var j = 0;
+ while (start < 1) {
+ t = parseFloat(start.toFixed(6));
+ this._lookUpTableBezier[j] = this._bezierCoefficients(t);
+ if (end.toFixed(6) === step.toFixed(6)) {
+ t = parseFloat(end.toFixed(6)) + parseFloat(start.toFixed(6));
+ ++j;
+ this._lookUpTableBezier[j] = this._bezierCoefficients(t);
+ break;
+ }
+ start += step;
+ end -= step;
+ ++j;
+ }
+ }
+
+ var LUTLength = this._lookUpTableBezier.length;
+
+ if (argLength === 6) {
+ this.isBezier = true;
+
+ w_x = [
+ this.immediateMode._bezierVertex[0],
+ arguments[0],
+ arguments[2],
+ arguments[4]
+ ];
+ w_y = [
+ this.immediateMode._bezierVertex[1],
+ arguments[1],
+ arguments[3],
+ arguments[5]
+ ];
+
+ for (i = 0; i < LUTLength; i++) {
+ _x =
+ w_x[0] * this._lookUpTableBezier[i][0] +
+ w_x[1] * this._lookUpTableBezier[i][1] +
+ w_x[2] * this._lookUpTableBezier[i][2] +
+ w_x[3] * this._lookUpTableBezier[i][3];
+ _y =
+ w_y[0] * this._lookUpTableBezier[i][0] +
+ w_y[1] * this._lookUpTableBezier[i][1] +
+ w_y[2] * this._lookUpTableBezier[i][2] +
+ w_y[3] * this._lookUpTableBezier[i][3];
+ this.vertex(_x, _y);
+ }
+ this.immediateMode._bezierVertex[0] = arguments[4];
+ this.immediateMode._bezierVertex[1] = arguments[5];
+ } else if (argLength === 9) {
+ this.isBezier = true;
+
+ w_x = [
+ this.immediateMode._bezierVertex[0],
+ arguments[0],
+ arguments[3],
+ arguments[6]
+ ];
+ w_y = [
+ this.immediateMode._bezierVertex[1],
+ arguments[1],
+ arguments[4],
+ arguments[7]
+ ];
+ w_z = [
+ this.immediateMode._bezierVertex[2],
+ arguments[2],
+ arguments[5],
+ arguments[8]
+ ];
+ for (i = 0; i < LUTLength; i++) {
+ _x =
+ w_x[0] * this._lookUpTableBezier[i][0] +
+ w_x[1] * this._lookUpTableBezier[i][1] +
+ w_x[2] * this._lookUpTableBezier[i][2] +
+ w_x[3] * this._lookUpTableBezier[i][3];
+ _y =
+ w_y[0] * this._lookUpTableBezier[i][0] +
+ w_y[1] * this._lookUpTableBezier[i][1] +
+ w_y[2] * this._lookUpTableBezier[i][2] +
+ w_y[3] * this._lookUpTableBezier[i][3];
+ _z =
+ w_z[0] * this._lookUpTableBezier[i][0] +
+ w_z[1] * this._lookUpTableBezier[i][1] +
+ w_z[2] * this._lookUpTableBezier[i][2] +
+ w_z[3] * this._lookUpTableBezier[i][3];
+ this.vertex(_x, _y, _z);
+ }
+ this.immediateMode._bezierVertex[0] = arguments[6];
+ this.immediateMode._bezierVertex[1] = arguments[7];
+ this.immediateMode._bezierVertex[2] = arguments[8];
+ }
}
- return arguments[0].split(d).filter(function(n){return n;});
};
-/**
- * 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.
- *
- * @method trim
- * @param {String} str a String to be trimmed
- * @return {String} a trimmed String
- */
-/**
- * @method trim
- * @param {Array} strs an Array of Strings to be trimmed
- * @return {Array} an Array of trimmed Strings
- * @example
- *
- *
- * var string = trim(" No new lines\n ");
- * text(string +" here", 2, 50);
- *
- *
- *
- * @alt
- * "No new lines here" displayed center canvas
- *
- */
-p5.prototype.trim = function(str) {
- p5._validateParameters('trim', arguments);
- if (str instanceof Array) {
- return str.map(this.trim);
+p5.RendererGL.prototype.quadraticVertex = function() {
+ if (this.immediateMode._quadraticVertex.length === 0) {
+ throw Error('vertex() must be used once before calling quadraticVertex()');
} else {
- return str.trim();
+ var w_x = [];
+ var w_y = [];
+ var w_z = [];
+ var t, _x, _y, _z, i;
+ var argLength = arguments.length;
+
+ t = 0;
+
+ if (
+ this._lookUpTableQuadratic.length === 0 ||
+ this._lutQuadraticDetail !== this._pInst._curveDetail
+ ) {
+ this._lookUpTableQuadratic = [];
+ this._lutQuadraticDetail = this._pInst._curveDetail;
+ var step = 1 / this._lutQuadraticDetail;
+ var start = 0;
+ var end = 1;
+ var j = 0;
+ while (start < 1) {
+ t = parseFloat(start.toFixed(6));
+ this._lookUpTableQuadratic[j] = this._quadraticCoefficients(t);
+ if (end.toFixed(6) === step.toFixed(6)) {
+ t = parseFloat(end.toFixed(6)) + parseFloat(start.toFixed(6));
+ ++j;
+ this._lookUpTableQuadratic[j] = this._quadraticCoefficients(t);
+ break;
+ }
+ start += step;
+ end -= step;
+ ++j;
+ }
+ }
+
+ var LUTLength = this._lookUpTableQuadratic.length;
+
+ if (argLength === 4) {
+ this.isQuadratic = true;
+
+ w_x = [
+ this.immediateMode._quadraticVertex[0],
+ arguments[0],
+ arguments[2]
+ ];
+ w_y = [
+ this.immediateMode._quadraticVertex[1],
+ arguments[1],
+ arguments[3]
+ ];
+
+ for (i = 0; i < LUTLength; i++) {
+ _x =
+ w_x[0] * this._lookUpTableQuadratic[i][0] +
+ w_x[1] * this._lookUpTableQuadratic[i][1] +
+ w_x[2] * this._lookUpTableQuadratic[i][2];
+ _y =
+ w_y[0] * this._lookUpTableQuadratic[i][0] +
+ w_y[1] * this._lookUpTableQuadratic[i][1] +
+ w_y[2] * this._lookUpTableQuadratic[i][2];
+ this.vertex(_x, _y);
+ }
+
+ this.immediateMode._quadraticVertex[0] = arguments[2];
+ this.immediateMode._quadraticVertex[1] = arguments[3];
+ } else if (argLength === 6) {
+ this.isQuadratic = true;
+
+ w_x = [
+ this.immediateMode._quadraticVertex[0],
+ arguments[0],
+ arguments[3]
+ ];
+ w_y = [
+ this.immediateMode._quadraticVertex[1],
+ arguments[1],
+ arguments[4]
+ ];
+ w_z = [
+ this.immediateMode._quadraticVertex[2],
+ arguments[2],
+ arguments[5]
+ ];
+
+ for (i = 0; i < LUTLength; i++) {
+ _x =
+ w_x[0] * this._lookUpTableQuadratic[i][0] +
+ w_x[1] * this._lookUpTableQuadratic[i][1] +
+ w_x[2] * this._lookUpTableQuadratic[i][2];
+ _y =
+ w_y[0] * this._lookUpTableQuadratic[i][0] +
+ w_y[1] * this._lookUpTableQuadratic[i][1] +
+ w_y[2] * this._lookUpTableQuadratic[i][2];
+ _z =
+ w_z[0] * this._lookUpTableQuadratic[i][0] +
+ w_z[1] * this._lookUpTableQuadratic[i][1] +
+ w_z[2] * this._lookUpTableQuadratic[i][2];
+ this.vertex(_x, _y, _z);
+ }
+
+ this.immediateMode._quadraticVertex[0] = arguments[3];
+ this.immediateMode._quadraticVertex[1] = arguments[4];
+ this.immediateMode._quadraticVertex[2] = arguments[5];
+ }
+ }
+};
+
+p5.RendererGL.prototype.curveVertex = function() {
+ var w_x = [];
+ var w_y = [];
+ var w_z = [];
+ var t, _x, _y, _z, i;
+ t = 0;
+ var argLength = arguments.length;
+
+ if (
+ this._lookUpTableBezier.length === 0 ||
+ this._lutBezierDetail !== this._pInst._curveDetail
+ ) {
+ this._lookUpTableBezier = [];
+ this._lutBezierDetail = this._pInst._curveDetail;
+ var step = 1 / this._lutBezierDetail;
+ var start = 0;
+ var end = 1;
+ var j = 0;
+ while (start < 1) {
+ t = parseFloat(start.toFixed(6));
+ this._lookUpTableBezier[j] = this._bezierCoefficients(t);
+ if (end.toFixed(6) === step.toFixed(6)) {
+ t = parseFloat(end.toFixed(6)) + parseFloat(start.toFixed(6));
+ ++j;
+ this._lookUpTableBezier[j] = this._bezierCoefficients(t);
+ break;
+ }
+ start += step;
+ end -= step;
+ ++j;
+ }
+ }
+
+ var LUTLength = this._lookUpTableBezier.length;
+
+ if (argLength === 2) {
+ this.immediateMode._curveVertex.push(arguments[0]);
+ this.immediateMode._curveVertex.push(arguments[1]);
+ if (this.immediateMode._curveVertex.length === 8) {
+ this.isCurve = true;
+ w_x = this._bezierToCatmull([
+ this.immediateMode._curveVertex[0],
+ this.immediateMode._curveVertex[2],
+ this.immediateMode._curveVertex[4],
+ this.immediateMode._curveVertex[6]
+ ]);
+ w_y = this._bezierToCatmull([
+ this.immediateMode._curveVertex[1],
+ this.immediateMode._curveVertex[3],
+ this.immediateMode._curveVertex[5],
+ this.immediateMode._curveVertex[7]
+ ]);
+ for (i = 0; i < LUTLength; i++) {
+ _x =
+ w_x[0] * this._lookUpTableBezier[i][0] +
+ w_x[1] * this._lookUpTableBezier[i][1] +
+ w_x[2] * this._lookUpTableBezier[i][2] +
+ w_x[3] * this._lookUpTableBezier[i][3];
+ _y =
+ w_y[0] * this._lookUpTableBezier[i][0] +
+ w_y[1] * this._lookUpTableBezier[i][1] +
+ w_y[2] * this._lookUpTableBezier[i][2] +
+ w_y[3] * this._lookUpTableBezier[i][3];
+ this.vertex(_x, _y);
+ }
+ for (i = 0; i < argLength; i++) {
+ this.immediateMode._curveVertex.shift();
+ }
+ }
+ } else if (argLength === 3) {
+ this.immediateMode._curveVertex.push(arguments[0]);
+ this.immediateMode._curveVertex.push(arguments[1]);
+ this.immediateMode._curveVertex.push(arguments[2]);
+ if (this.immediateMode._curveVertex.length === 12) {
+ this.isCurve = true;
+ w_x = this._bezierToCatmull([
+ this.immediateMode._curveVertex[0],
+ this.immediateMode._curveVertex[3],
+ this.immediateMode._curveVertex[6],
+ this.immediateMode._curveVertex[9]
+ ]);
+ w_y = this._bezierToCatmull([
+ this.immediateMode._curveVertex[1],
+ this.immediateMode._curveVertex[4],
+ this.immediateMode._curveVertex[7],
+ this.immediateMode._curveVertex[10]
+ ]);
+ w_z = this._bezierToCatmull([
+ this.immediateMode._curveVertex[2],
+ this.immediateMode._curveVertex[5],
+ this.immediateMode._curveVertex[8],
+ this.immediateMode._curveVertex[11]
+ ]);
+ for (i = 0; i < LUTLength; i++) {
+ _x =
+ w_x[0] * this._lookUpTableBezier[i][0] +
+ w_x[1] * this._lookUpTableBezier[i][1] +
+ w_x[2] * this._lookUpTableBezier[i][2] +
+ w_x[3] * this._lookUpTableBezier[i][3];
+ _y =
+ w_y[0] * this._lookUpTableBezier[i][0] +
+ w_y[1] * this._lookUpTableBezier[i][1] +
+ w_y[2] * this._lookUpTableBezier[i][2] +
+ w_y[3] * this._lookUpTableBezier[i][3];
+ _z =
+ w_z[0] * this._lookUpTableBezier[i][0] +
+ w_z[1] * this._lookUpTableBezier[i][1] +
+ w_z[2] * this._lookUpTableBezier[i][2] +
+ w_z[3] * this._lookUpTableBezier[i][3];
+ this.vertex(_x, _y, _z);
+ }
+ for (i = 0; i < argLength; i++) {
+ this.immediateMode._curveVertex.shift();
+ }
+ }
}
};
module.exports = p5;
-},{"../core/core":55,"../core/error_helpers":58}],96:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/main":25,"./p5.Geometry":71}],66:[function(_dereq_,module,exports){
/**
- * @module IO
- * @submodule Time & Date
+ * @module Lights, Camera
+ * @submodule Interaction
* @for p5
* @requires core
*/
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
/**
- * p5.js communicates with the clock on your computer. The day() function
- * returns the current day as a value from 1 - 31.
- *
- * @method day
- * @return {Number} the current day
+ * Allows movement around a 3D sketch using a mouse or trackpad. Left-clicking
+ * and dragging will rotate the camera position about the center of the sketch,
+ * right-clicking and dragging will pan the camera position without rotation,
+ * and using the mouse wheel (scrolling) will move the camera closer or further
+ * from the center of the sketch. This function can be called with parameters
+ * dictating sensitivity to mouse movement along the X and Y axes. Calling
+ * this function without parameters is equivalent to calling orbitControl(1,1).
+ * To reverse direction of movement in either axis, enter a negative number
+ * for sensitivity.
+ * @method orbitControl
+ * @for p5
+ * @param {Number} [sensitivityX] sensitivity to mouse movement along X axis
+ * @param {Number} [sensitivityY] sensitivity to mouse movement along Y axis
+ * @chainable
* @example
*
*
- * var d = day();
- * text("Current day: \n" + d, 5, 50);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * normalMaterial();
+ * }
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * rotateY(0.5);
+ * box(30, 50);
+ * }
*
*
*
* @alt
- * Current day is displayed
- *
+ * Camera orbits around a box when mouse is hold-clicked & then moved.
*/
-p5.prototype.day = function() {
- return new Date().getDate();
-};
-/**
- * p5.js communicates with the clock on your computer. The hour() function
- * returns the current hour as a value from 0 - 23.
- *
- * @method hour
- * @return {Number} the current hour
- * @example
- *
- *
- * var h = hour();
- * text("Current hour:\n" + h, 5, 50);
- *
- *
- *
- * @alt
- * Current hour is displayed
- *
- */
-p5.prototype.hour = function() {
- return new Date().getHours();
+// implementation based on three.js 'orbitControls':
+// https://github.com/mrdoob/three.js/blob/dev/examples/js/controls/OrbitControls.js
+p5.prototype.orbitControl = function(sensitivityX, sensitivityY) {
+ this._assert3d('orbitControl');
+ p5._validateParameters('orbitControl', arguments);
+
+ // If the mouse is not in bounds of the canvas, disable all behaviors:
+ var mouseInCanvas =
+ this.mouseX < this.width &&
+ this.mouseX > 0 &&
+ this.mouseY < this.height &&
+ this.mouseY > 0;
+ if (!mouseInCanvas) return;
+
+ var cam = this._renderer._curCamera;
+
+ if (typeof sensitivityX === 'undefined') {
+ sensitivityX = 1;
+ }
+ if (typeof sensitivityY === 'undefined') {
+ sensitivityY = sensitivityX;
+ }
+
+ // default right-mouse and mouse-wheel behaviors (context menu and scrolling,
+ // respectively) are disabled here to allow use of those events for panning and
+ // zooming
+
+ // disable context menu for canvas element and add 'contextMenuDisabled'
+ // flag to p5 instance
+ if (this.contextMenuDisabled !== true) {
+ this.canvas.oncontextmenu = function() {
+ return false;
+ };
+ this._setProperty('contextMenuDisabled', true);
+ }
+
+ // disable default scrolling behavior on the canvas element and add
+ // 'wheelDefaultDisabled' flag to p5 instance
+ if (this.wheelDefaultDisabled !== true) {
+ this.canvas.onwheel = function() {
+ return false;
+ };
+ this._setProperty('wheelDefaultDisabled', true);
+ }
+
+ var scaleFactor = this.height < this.width ? this.height : this.width;
+
+ // ZOOM if there is a change in mouseWheelDelta
+ if (this._mouseWheelDeltaY !== this._pmouseWheelDeltaY) {
+ // zoom according to direction of mouseWheelDeltaY rather than value
+ if (this._mouseWheelDeltaY > 0) {
+ this._renderer._curCamera._orbit(0, 0, 0.5 * scaleFactor);
+ } else {
+ this._renderer._curCamera._orbit(0, 0, -0.5 * scaleFactor);
+ }
+ }
+
+ if (this.mouseIsPressed) {
+ // ORBIT BEHAVIOR
+ if (this.mouseButton === this.LEFT) {
+ var deltaTheta =
+ -sensitivityX * (this.mouseX - this.pmouseX) / scaleFactor;
+ var deltaPhi = sensitivityY * (this.mouseY - this.pmouseY) / scaleFactor;
+ this._renderer._curCamera._orbit(deltaTheta, deltaPhi, 0);
+ } else if (this.mouseButton === this.RIGHT) {
+ // PANNING BEHAVIOR along X/Z camera axes and restricted to X/Z plane
+ // in world space
+ var local = cam._getLocalAxes();
+
+ // normalize portions along X/Z axes
+ var xmag = Math.sqrt(local.x[0] * local.x[0] + local.x[2] * local.x[2]);
+ if (xmag !== 0) {
+ local.x[0] /= xmag;
+ local.x[2] /= xmag;
+ }
+
+ // normalize portions along X/Z axes
+ var ymag = Math.sqrt(local.y[0] * local.y[0] + local.y[2] * local.y[2]);
+ if (ymag !== 0) {
+ local.y[0] /= ymag;
+ local.y[2] /= ymag;
+ }
+
+ // move along those vectors by amount controlled by mouseX, pmouseY
+ var dx = -1 * sensitivityX * (this.mouseX - this.pmouseX);
+ var dz = -1 * sensitivityY * (this.mouseY - this.pmouseY);
+
+ // restrict movement to XZ plane in world space
+ cam.setPosition(
+ cam.eyeX + dx * local.x[0] + dz * local.z[0],
+ cam.eyeY,
+ cam.eyeZ + dx * local.x[2] + dz * local.z[2]
+ );
+ }
+ }
+ return this;
};
/**
- * p5.js communicates with the clock on your computer. The minute() function
- * returns the current minute as a value from 0 - 59.
+ * debugMode() helps visualize 3D space by adding a grid to indicate where the
+ * ‘ground’ is in a sketch and an axes icon which indicates the +X, +Y, and +Z
+ * directions. This function can be called without parameters to create a
+ * default grid and axes icon, or it can be called according to the examples
+ * above to customize the size and position of the grid and/or axes icon. The
+ * grid is drawn using the most recently set stroke color and weight. To
+ * specify these parameters, add a call to stroke() and strokeWeight()
+ * just before the end of the draw() loop.
*
- * @method minute
- * @return {Number} the current minute
+ * By default, the grid will run through the origin (0,0,0) of the sketch
+ * along the XZ plane
+ * and the axes icon will be offset from the origin. Both the grid and axes
+ * icon will be sized according to the current canvas size. Note that because the
+ * grid runs parallel to the default camera view, it is often helpful to use
+ * debugMode along with orbitControl to allow full view of the grid.
+ * @method debugMode
* @example
*
*
- * var m = minute();
- * text("Current minute: \n" + m, 5, 50);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * camera(0, -30, 100, 0, 0, 0, 0, 1, 0);
+ * normalMaterial();
+ * debugMode();
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * box(15, 30);
+ * // Press the spacebar to turn debugMode off!
+ * if (keyIsDown(32)) {
+ * noDebugMode();
+ * }
+ * }
*
*
- *
* @alt
- * Current minute is displayed
- *
- */
-p5.prototype.minute = function() {
- return new Date().getMinutes();
-};
-
-/**
- * Returns the number of milliseconds (thousandths of a second) since
- * starting the program. This information is often used for timing events and
- * animation sequences.
+ * a 3D box is centered on a grid in a 3D sketch. an icon
+ * indicates the direction of each axis: a red line points +X,
+ * a green line +Y, and a blue line +Z. the grid and icon disappear when the
+ * spacebar is pressed.
*
- * @method millis
- * @return {Number} the number of milliseconds since starting the program
* @example
*
*
- * var millisecond = millis();
- * text("Milliseconds \nrunning: \n" + millisecond, 5, 40);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * camera(0, -30, 100, 0, 0, 0, 0, 1, 0);
+ * normalMaterial();
+ * debugMode(GRID);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * box(15, 30);
+ * }
*
*
- *
* @alt
- * number of milliseconds since program has started displayed
+ * a 3D box is centered on a grid in a 3D sketch.
*
- */
-p5.prototype.millis = function() {
- return window.performance.now();
-};
-
-/**
- * p5.js communicates with the clock on your computer. The month() function
- * returns the current month as a value from 1 - 12.
- *
- * @method month
- * @return {Number} the current month
* @example
*
*
- * var m = month();
- * text("Current month: \n" + m, 5, 50);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * camera(0, -30, 100, 0, 0, 0, 0, 1, 0);
+ * normalMaterial();
+ * debugMode(AXES);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * box(15, 30);
+ * }
*
*
- *
* @alt
- * Current month is displayed
- *
- */
-p5.prototype.month = function() {
- return new Date().getMonth() + 1; //January is 0!
-};
-
-/**
- * p5.js communicates with the clock on your computer. The second() function
- * returns the current second as a value from 0 - 59.
+ * a 3D box is centered in a 3D sketch. an icon
+ * indicates the direction of each axis: a red line points +X,
+ * a green line +Y, and a blue line +Z.
*
- * @method second
- * @return {Number} the current second
* @example
*
*
- * var s = second();
- * text("Current second: \n" + s, 5, 50);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * camera(0, -30, 100, 0, 0, 0, 0, 1, 0);
+ * normalMaterial();
+ * debugMode(GRID, 100, 10, 0, 0, 0);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * box(15, 30);
+ * }
*
*
- *
* @alt
- * Current second is displayed
- *
- */
-p5.prototype.second = function() {
- return new Date().getSeconds();
-};
-
-/**
- * p5.js communicates with the clock on your computer. The year() function
- * returns the current year as an integer (2014, 2015, 2016, etc).
+ * a 3D box is centered on a grid in a 3D sketch
*
- * @method year
- * @return {Number} the current year
* @example
*
*
- * var y = year();
- * text("Current year: \n" + y, 5, 50);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * camera(0, -30, 100, 0, 0, 0, 0, 1, 0);
+ * normalMaterial();
+ * debugMode(100, 10, 0, 0, 0, 20, 0, -40, 0);
+ * }
+ *
+ * function draw() {
+ * noStroke();
+ * background(200);
+ * orbitControl();
+ * box(15, 30);
+ * // set the stroke color and weight for the grid!
+ * stroke(255, 0, 150);
+ * strokeWeight(0.8);
+ * }
*
*
- *
* @alt
- * Current year is displayed
- *
+ * a 3D box is centered on a grid in a 3D sketch. an icon
+ * indicates the direction of each axis: a red line points +X,
+ * a green line +Y, and a blue line +Z.
*/
-p5.prototype.year = function() {
- return new Date().getFullYear();
-};
-
-module.exports = p5;
-},{"../core/core":55}],97:[function(_dereq_,module,exports){
/**
- * @module Lights, Camera
- * @submodule Camera
- * @for p5
- * @requires core
+ * @method debugMode
+ * @param {Constant} mode either GRID or AXES
*/
-'use strict';
-
-var p5 = _dereq_('../core/core');
-
/**
- * Sets camera position for a 3D sketch. The function behaves similarly
- * gluLookAt, except that it replaces the existing modelview matrix instead
- * of applying any transformations calculated here on top of the existing
- * model view.
- * When called with no arguments, this function
- * sets a default camera equivalent to calling
- * camera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0);
- * @method camera
- * @param {Number} [x] camera position value on x axis
- * @param {Number} [y] camera position value on y axis
- * @param {Number} [z] camera position value on z axis
- * @param {Number} [centerX] x coordinate representing center of the sketch
- * @param {Number} [centerY] y coordinate representing center of the sketch
- * @param {Number} [centerZ] z coordinate representing center of the sketch
- * @param {Number} [upX] x component of direction 'up' from camera
- * @param {Number} [upY] y component of direction 'up' from camera
- * @param {Number} [upZ] z component of direction 'up' from camera
- * @return {p5} the p5 object
- * @example
- *
- *
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- * function draw(){
- * //move the camera away from the plane by a sin wave
- * camera(0, 0, sin(frameCount * 0.01) * 100, 0, 0, 0, 0, 1, 0);
- * plane(120, 120);
- * }
- *
- *
- *
- * @alt
- * blue square shrinks in size grows to fill canvas. disappears then loops.
- *
+ * @method debugMode
+ * @param {Constant} mode
+ * @param {Number} [gridSize] size of one side of the grid
+ * @param {Number} [gridDivisions] number of divisions in the grid
+ * @param {Number} [xOff] X axis offset from origin (0,0,0)
+ * @param {Number} [yOff] Y axis offset from origin (0,0,0)
+ * @param {Number} [zOff] Z axis offset from origin (0,0,0)
*/
-p5.prototype.camera = function(){
- this._renderer.camera.apply(this._renderer, arguments);
- return this;
-};
-p5.RendererGL.prototype.camera = function () {
- var eyeX, eyeY, eyeZ;
- var centerX, centerY, centerZ;
- var upX, upY, upZ;
- if (arguments.length === 0) {
- eyeX = this.defaultCameraX;
- eyeY = this.defaultCameraY;
- eyeZ = this.defaultCameraZ;
- centerX = eyeX;
- centerY = eyeY;
- centerZ = 0;
- upX = 0;
- upY = 1;
- upZ = 0;
+/**
+ * @method debugMode
+ * @param {Constant} mode
+ * @param {Number} [axesSize] size of axes icon
+ * @param {Number} [xOff]
+ * @param {Number} [yOff]
+ * @param {Number} [zOff]
+ */
+
+/**
+ * @method debugMode
+ * @param {Number} [gridSize]
+ * @param {Number} [gridDivisions]
+ * @param {Number} [xOff]
+ * @param {Number} [yOff]
+ * @param {Number} [zOff]
+ * @param {Number} [axesSize]
+ * @param {Number} [xOff]
+ * @param {Number} [yOff]
+ * @param {Number} [zOff]
+ */
+
+p5.prototype.debugMode = function() {
+ this._assert3d('debugMode');
+ p5._validateParameters('debugMode', arguments);
+
+ // start by removing existing 'post' registered debug methods
+ for (var i = this._registeredMethods.post.length - 1; i >= 0; i--) {
+ // test for equality...
+ if (
+ this._registeredMethods.post[i].toString() === this._grid().toString() ||
+ this._registeredMethods.post[i].toString() === this._axesIcon().toString()
+ ) {
+ this._registeredMethods.post.splice(i, 1);
+ }
+ }
+
+ // then add new debugMode functions according to the argument list
+ if (arguments[0] === constants.GRID) {
+ this.registerMethod(
+ 'post',
+ this._grid.call(
+ this,
+ arguments[1],
+ arguments[2],
+ arguments[3],
+ arguments[4],
+ arguments[5]
+ )
+ );
+ } else if (arguments[0] === constants.AXES) {
+ this.registerMethod(
+ 'post',
+ this._axesIcon.call(
+ this,
+ arguments[1],
+ arguments[2],
+ arguments[3],
+ arguments[4]
+ )
+ );
} else {
- eyeX = arguments[0];
- eyeY = arguments[1];
- eyeZ = arguments[2];
- centerX = arguments[3];
- centerY = arguments[4];
- centerZ = arguments[5];
- upX = arguments[6];
- upY = arguments[7];
- upZ = arguments[8];
- }
-
- this.cameraX = eyeX;
- this.cameraY = eyeY;
- this.cameraZ = eyeZ;
-
- // calculate camera Z vector
- var z0 = eyeX - centerX;
- var z1 = eyeY - centerY;
- var z2 = eyeZ - centerZ;
-
- this.eyeDist = Math.sqrt(z0 * z0 + z1 * z1 + z2 * z2);
- if (this.eyeDist !== 0) {
- z0 /= this.eyeDist;
- z1 /= this.eyeDist;
- z2 /= this.eyeDist;
- }
-
- // calculate camera Y vector
- var y0 = upX;
- var y1 = upY;
- var y2 = upZ;
-
- // computer x vector as y cross z
- var x0 = y1 * z2 - y2 * z1;
- var x1 = -y0 * z2 + y2 * z0;
- var x2 = y0 * z1 - y1 * z0;
-
- // recomputer y = z cross x
- y0 = z1 * x2 - z2 * x1;
- y1 = -z0 * x2 + z2 * x0;
- y2 = z0 * x1 - z1 * x0;
-
- // cross product gives area of parallelogram, which is < 1.0 for
- // non-perpendicular unit-length vectors; so normalize x, y here:
- var xmag = Math.sqrt (x0 * x0 + x1 * x1 + x2 * x2);
- if (xmag !== 0) {
- x0 /= xmag;
- x1 /= xmag;
- x2 /= xmag;
- }
-
- var ymag = Math.sqrt (y0 * y0 + y1 * y1 + y2 * y2);
- if (ymag !== 0) {
- y0 /= ymag;
- y1 /= ymag;
- y2 /= ymag;
+ this.registerMethod(
+ 'post',
+ this._grid.call(
+ this,
+ arguments[0],
+ arguments[1],
+ arguments[2],
+ arguments[3],
+ arguments[4]
+ )
+ );
+ this.registerMethod(
+ 'post',
+ this._axesIcon.call(
+ this,
+ arguments[5],
+ arguments[6],
+ arguments[7],
+ arguments[8]
+ )
+ );
}
-
- // the camera affects the model view matrix, insofar as it
- // inverse translates the world to the eye position of the camera
- // and rotates it.
- this.cameraMatrix.set(x0, y0, z0, 0,
- x1, y1, z1, 0,
- x2, y2, z2, 0,
- 0, 0, 0, 1);
-
- var tx = -eyeX;
- var ty = -eyeY;
- var tz = -eyeZ;
-
- this.cameraMatrix.translate([tx, ty, tz]);
- this.uMVMatrix.set(this.cameraMatrix.mat4[0],
- this.cameraMatrix.mat4[1],
- this.cameraMatrix.mat4[2],
- this.cameraMatrix.mat4[3],
- this.cameraMatrix.mat4[4],
- this.cameraMatrix.mat4[5],
- this.cameraMatrix.mat4[6],
- this.cameraMatrix.mat4[7],
- this.cameraMatrix.mat4[8],
- this.cameraMatrix.mat4[9],
- this.cameraMatrix.mat4[10],
- this.cameraMatrix.mat4[11],
- this.cameraMatrix.mat4[12],
- this.cameraMatrix.mat4[13],
- this.cameraMatrix.mat4[14],
- this.cameraMatrix.mat4[15]
- );
- return this;
};
/**
- * Sets perspective camera. When called with no arguments, the defaults
- * provided are equivalent to
- * perspective(PI/3.0, width/height, cameraZ/10.0, cameraZ*10.0)
- * where cameraZ is ((height/2.0) / tan(PI*60.0/360.0));
- * @method perspective
- * @param {Number} [fovy] camera frustum vertical field of view,
- * from bottom to top of view, in degrees
- * @param {Number} [aspect] camera frustum aspect ratio
- * @param {Number} [near] frustum near plane length
- * @param {Number} [far] frustum far plane length
- * @return {p5} the p5 object
+ * Turns off debugMode() in a 3D sketch.
+ * @method noDebugMode
* @example
*
*
- * //drag mouse to toggle the world!
- * //you will see there's a vanish point
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
- * var fov = 60 / 180 * PI;
- * var cameraZ = (height/2.0) / tan(fov/2.0);
- * perspective(60 / 180 * PI, width/height, cameraZ * 0.1, cameraZ * 10);
- * }
- * function draw(){
- * background(200);
- * orbitControl();
- * for(var i = -1; i < 2; i++){
- * for(var j = -2; j < 3; j++){
- * push();
- * translate(i*160, 0, j*160);
- * box(40, 40, 40);
- * pop();
- * }
+ * camera(0, -30, 100, 0, 0, 0, 0, 1, 0);
+ * normalMaterial();
+ * debugMode();
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * box(15, 30);
+ * // Press the spacebar to turn debugMode off!
+ * if (keyIsDown(32)) {
+ * noDebugMode();
* }
* }
*
*
- *
* @alt
- * colored 3d boxes toggleable with mouse position
- *
+ * a 3D box is centered on a grid in a 3D sketch. an icon
+ * indicates the direction of each axis: a red line points +X,
+ * a green line +Y, and a blue line +Z. the grid and icon disappear when the
+ * spacebar is pressed.
*/
-p5.prototype.perspective = function() {
- this._renderer.perspective.apply(this._renderer, arguments);
- return this;
-};
-
-p5.RendererGL.prototype.perspective = function() {
- var fovy = arguments[0] || this.defaultCameraFOV;
- var aspect = arguments[1] || this.defaultCameraAspect;
- var near = arguments[2] || this.defaultCameraNear;
- var far = arguments[3] || this.defaultCameraFar;
-
- this.cameraFOV = fovy;
- this.cameraAspect = aspect;
- this.cameraNear = near;
- this.cameraFar = far;
+p5.prototype.noDebugMode = function() {
+ this._assert3d('noDebugMode');
- this.uPMatrix = p5.Matrix.identity();
-
- var f = 1.0 / Math.tan(this.cameraFOV / 2);
- var nf = 1.0 / (this.cameraNear - this.cameraFar);
-
- this.uPMatrix.set(
- f / aspect, 0, 0, 0,
- 0, -f, 0, 0,
- 0, 0, (far + near) * nf, -1,
- 0, 0, (2 * far * near) * nf, 0);
-
- this._curCamera = 'custom';
+ // start by removing existing 'post' registered debug methods
+ for (var i = this._registeredMethods.post.length - 1; i >= 0; i--) {
+ // test for equality...
+ if (
+ this._registeredMethods.post[i].toString() === this._grid().toString() ||
+ this._registeredMethods.post[i].toString() === this._axesIcon().toString()
+ ) {
+ this._registeredMethods.post.splice(i, 1);
+ }
+ }
};
/**
- * Setup ortho camera
- * @method ortho
- * @param {Number} left camera frustum left plane
- * @param {Number} right camera frustum right plane
- * @param {Number} bottom camera frustum bottom plane
- * @param {Number} top camera frustum top plane
- * @param {Number} near camera frustum near plane
- * @param {Number} far camera frustum far plane
- * @return {p5} the p5 object
- * @example
- *
- *
- * //drag mouse to toggle the world!
- * //there's no vanish point
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * ortho(-width/2, width/2, height/2, -height/2, 0, 500);
- * }
- * function draw(){
- * background(200);
- * orbitControl();
- * for(var i = -1; i < 2; i++){
- * for(var j = -2; j < 3; j++){
- * push();
- * translate(i*160, 0, j*160);
- * box(40, 40, 40);
- * pop();
- * }
- * }
- * }
- *
- *
- *
- * @alt
- * 3 3d boxes, reveal several more boxes on 3d plane when mouse used to toggle
- *
+ * For use with debugMode
+ * @private
+ * @method _grid
+ * @param {Number} [size] size of grid sides
+ * @param {Number} [div] number of grid divisions
+ * @param {Number} [xOff] offset of grid center from origin in X axis
+ * @param {Number} [yOff] offset of grid center from origin in Y axis
+ * @param {Number} [zOff] offset of grid center from origin in Z axis
*/
-p5.prototype.ortho = function(left,right,bottom,top,near,far) {
- left = left || (-this.width/2);
- right = right || (this.width/2);
- bottom = bottom || (-this.height/2);
- top = top || (this.height/2);
- near = near || 0;
- far = far || Math.max(this.width, this.height);
- this._renderer.uPMatrix = p5.Matrix.identity();
- //this._renderer.uPMatrix.ortho(left,right,bottom,top,near,far);
+p5.prototype._grid = function(size, numDivs, xOff, yOff, zOff) {
+ if (typeof size === 'undefined') {
+ size = this.width / 2;
+ }
+ if (typeof numDivs === 'undefined') {
+ // ensure at least 2 divisions
+ numDivs = Math.round(size / 30) < 4 ? 4 : Math.round(size / 30);
+ }
+ if (typeof xOff === 'undefined') {
+ xOff = 0;
+ }
+ if (typeof yOff === 'undefined') {
+ yOff = 0;
+ }
+ if (typeof zOff === 'undefined') {
+ zOff = 0;
+ }
- var w = right - left;
- var h = top - bottom;
- var d = far - near;
+ var spacing = size / numDivs;
+ var halfSize = size / 2;
- var x = 2.0 / w;
- var y = 2.0 / h;
- var z = -2.0 / d;
+ return function() {
+ this.push();
+ this.stroke(
+ this._renderer.curStrokeColor[0] * 255,
+ this._renderer.curStrokeColor[1] * 255,
+ this._renderer.curStrokeColor[2] * 255
+ );
+ this._renderer.uMVMatrix.set(
+ this._renderer._curCamera.cameraMatrix.mat4[0],
+ this._renderer._curCamera.cameraMatrix.mat4[1],
+ this._renderer._curCamera.cameraMatrix.mat4[2],
+ this._renderer._curCamera.cameraMatrix.mat4[3],
+ this._renderer._curCamera.cameraMatrix.mat4[4],
+ this._renderer._curCamera.cameraMatrix.mat4[5],
+ this._renderer._curCamera.cameraMatrix.mat4[6],
+ this._renderer._curCamera.cameraMatrix.mat4[7],
+ this._renderer._curCamera.cameraMatrix.mat4[8],
+ this._renderer._curCamera.cameraMatrix.mat4[9],
+ this._renderer._curCamera.cameraMatrix.mat4[10],
+ this._renderer._curCamera.cameraMatrix.mat4[11],
+ this._renderer._curCamera.cameraMatrix.mat4[12],
+ this._renderer._curCamera.cameraMatrix.mat4[13],
+ this._renderer._curCamera.cameraMatrix.mat4[14],
+ this._renderer._curCamera.cameraMatrix.mat4[15]
+ );
- var tx = -(right + left) / w;
- var ty = -(top + bottom) / h;
- var tz = -(far + near) / d;
+ // Lines along X axis
+ for (var q = 0; q <= numDivs; q++) {
+ this.beginShape(this.LINES);
+ this.vertex(-halfSize + xOff, yOff, q * spacing - halfSize + zOff);
+ this.vertex(+halfSize + xOff, yOff, q * spacing - halfSize + zOff);
+ this.endShape();
+ }
- // The minus sign is needed to invert the Y axis.
- this._renderer.uPMatrix.set( x, 0, 0, 0,
- 0, -y, 0, 0,
- 0, 0, z, 0,
- tx, ty, tz, 1);
+ // Lines along Z axis
+ for (var i = 0; i <= numDivs; i++) {
+ this.beginShape(this.LINES);
+ this.vertex(i * spacing - halfSize + xOff, yOff, -halfSize + zOff);
+ this.vertex(i * spacing - halfSize + xOff, yOff, +halfSize + zOff);
+ this.endShape();
+ }
- this._renderer._curCamera = 'custom';
+ this.pop();
+ };
};
-module.exports = p5;
-
-},{"../core/core":55}],98:[function(_dereq_,module,exports){
-'use strict';
-
-var p5 = _dereq_('../core/core');
+/**
+ * For use with debugMode
+ * @private
+ * @method _axesIcon
+ * @param {Number} [size] size of axes icon lines
+ * @param {Number} [xOff] offset of icon from origin in X axis
+ * @param {Number} [yOff] offset of icon from origin in Y axis
+ * @param {Number} [zOff] offset of icon from origin in Z axis
+ */
+p5.prototype._axesIcon = function(size, xOff, yOff, zOff) {
+ if (typeof size === 'undefined') {
+ size = this.width / 20 > 40 ? this.width / 20 : 40;
+ }
+ if (typeof xOff === 'undefined') {
+ xOff = -this.width / 4;
+ }
+ if (typeof yOff === 'undefined') {
+ yOff = xOff;
+ }
+ if (typeof zOff === 'undefined') {
+ zOff = xOff;
+ }
+
+ return function() {
+ this.push();
+ this._renderer.uMVMatrix.set(
+ this._renderer._curCamera.cameraMatrix.mat4[0],
+ this._renderer._curCamera.cameraMatrix.mat4[1],
+ this._renderer._curCamera.cameraMatrix.mat4[2],
+ this._renderer._curCamera.cameraMatrix.mat4[3],
+ this._renderer._curCamera.cameraMatrix.mat4[4],
+ this._renderer._curCamera.cameraMatrix.mat4[5],
+ this._renderer._curCamera.cameraMatrix.mat4[6],
+ this._renderer._curCamera.cameraMatrix.mat4[7],
+ this._renderer._curCamera.cameraMatrix.mat4[8],
+ this._renderer._curCamera.cameraMatrix.mat4[9],
+ this._renderer._curCamera.cameraMatrix.mat4[10],
+ this._renderer._curCamera.cameraMatrix.mat4[11],
+ this._renderer._curCamera.cameraMatrix.mat4[12],
+ this._renderer._curCamera.cameraMatrix.mat4[13],
+ this._renderer._curCamera.cameraMatrix.mat4[14],
+ this._renderer._curCamera.cameraMatrix.mat4[15]
+ );
-//@TODO: implement full orbit controls including
-//pan, zoom, quaternion rotation, etc.
-p5.prototype.orbitControl = function(){
- if(this.mouseIsPressed){
- this.rotateY((this.mouseX - this.width / 2) / (this.width / 2));
- this.rotateX((this.mouseY - this.height / 2) / (this.width / 2));
- }
- return this;
+ // X axis
+ this.strokeWeight(2);
+ this.stroke(255, 0, 0);
+ this.beginShape(this.LINES);
+ this.vertex(xOff, yOff, zOff);
+ this.vertex(xOff + size, yOff, zOff);
+ this.endShape();
+ // Y axis
+ this.stroke(0, 255, 0);
+ this.beginShape(this.LINES);
+ this.vertex(xOff, yOff, zOff);
+ this.vertex(xOff, yOff + size, zOff);
+ this.endShape();
+ // Z axis
+ this.stroke(0, 0, 255);
+ this.beginShape(this.LINES);
+ this.vertex(xOff, yOff, zOff);
+ this.vertex(xOff, yOff, zOff + size);
+ this.endShape();
+ this.pop();
+ };
};
module.exports = p5;
-},{"../core/core":55}],99:[function(_dereq_,module,exports){
+
+},{"../core/constants":19,"../core/main":25}],67:[function(_dereq_,module,exports){
/**
* @module Lights, Camera
* @submodule Lights
@@ -66781,7 +74893,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* Creates an ambient light with a color
@@ -66793,13 +74905,39 @@ var p5 = _dereq_('../core/core');
* relative to the current color range
* @param {Number} v3 blue or brightness value
* relative to the current color range
- * @param {Number} [alpha]
+ * @param {Number} [alpha] the alpha value
* @chainable
+ *
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(0);
+ * ambientLight(150);
+ * ambientMaterial(250);
+ * noStroke();
+ * sphere(25);
+ * }
+ *
+ *
+ *
+ * @alt
+ * evenly distributed light across a sphere
+ *
*/
/**
* @method ambientLight
* @param {String} value a color string
+ * @chainable
+ */
+
+/**
+ * @method ambientLight
+ * @param {Number} gray a gray value
* @param {Number} [alpha]
* @chainable
*/
@@ -66814,79 +74952,62 @@ var p5 = _dereq_('../core/core');
/**
* @method ambientLight
* @param {p5.Color} color the ambient light color
- * @param {Number} [alpha]
* @chainable
- *
- * @example
- *
- *
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- * function draw(){
- * background(0);
- * ambientLight(150);
- * ambientMaterial(250);
- * sphere(50);
- * }
- *
- *
- *
- * @alt
- * nothing displayed
- *
*/
-p5.prototype.ambientLight = function(v1, v2, v3, a){
- if (! this._renderer.curFillShader.isLightShader()) {
- this._renderer.setFillShader(this._renderer._getLightShader());
- }
+p5.prototype.ambientLight = function(v1, v2, v3, a) {
+ this._assert3d('ambientLight');
+ p5._validateParameters('ambientLight', arguments);
+ var color = this.color.apply(this, arguments);
- var color = this._renderer._pInst.color.apply(
- this._renderer._pInst, arguments);
+ var shader = this._renderer._useLightShader();
//@todo this is a bit icky. array uniforms have
//to be multiples of the type 3(rgb) in this case.
//a preallocated Float32Array(24) that we copy into
//would be better
- var colors = new Float32Array(color._array.slice(0,3));
- this._renderer.curFillShader.setUniform('uAmbientColor', colors);
- this._renderer.curFillShader.setUniform('uUseLighting', true);
- this._renderer.ambientLightCount++;
+ shader.setUniform('uUseLighting', true);
//in case there's no material color for the geometry
- this._renderer.curFillShader.setUniform('uMaterialColor',
- this._renderer.curFillColor);
- this._renderer.curFillShader.setUniform('uAmbientLightCount',
- this._renderer.ambientLightCount);
+ shader.setUniform('uMaterialColor', this._renderer.curFillColor);
+
+ this._renderer.ambientLightColors.push(
+ color._array[0],
+ color._array[1],
+ color._array[2]
+ );
+ shader.setUniform('uAmbientColor', this._renderer.ambientLightColors);
+
+ shader.setUniform(
+ 'uAmbientLightCount',
+ this._renderer.ambientLightColors.length / 3
+ );
+
return this;
};
/**
* Creates a directional light with a color and a direction
- * @method directionalLight
- * @param {Number|Array|String|p5.Color} v1 gray value,
- * red or hue value (depending on the current color mode),
- * or color Array, or CSS color string
- * @param {Number} [v2] green or saturation value
- * @param {Number} [v3] blue or brightness value
- * @param {Number} [a] opacity
- * @param {Number|p5.Vector} x x axis direction or a p5.Vector
- * @param {Number} [y] y axis direction
- * @param {Number} [z] z axis direction
+ * @method directionalLight
+ * @param {Number} v1 red or hue value (depending on the current
+ * color mode),
+ * @param {Number} v2 green or saturation value
+ * @param {Number} v3 blue or brightness value
+ * @param {p5.Vector} position the direction of the light
* @chainable
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
* }
- * function draw(){
+ * function draw() {
* background(0);
* //move your mouse to change light direction
- * var dirX = (mouseX / width - 0.5) *2;
- * var dirY = (mouseY / height - 0.5) *(-2);
- * directionalLight(250, 250, 250, dirX, dirY, 0.25);
+ * var dirX = (mouseX / width - 0.5) * 2;
+ * var dirY = (mouseY / height - 0.5) * 2;
+ * directionalLight(250, 250, 250, -dirX, -dirY, 0.25);
* ambientMaterial(250);
- * sphere(50);
+ * noStroke();
+ * sphere(25);
* }
*
*
@@ -66895,84 +75016,118 @@ p5.prototype.ambientLight = function(v1, v2, v3, a){
* light source on canvas changeable with mouse position
*
*/
-p5.prototype.directionalLight = function(v1, v2, v3, x, y, z) {
- if (! this._renderer.curFillShader.isLightShader()) {
- this._renderer.setFillShader(this._renderer._getLightShader());
- }
- //@TODO: check parameters number
- var color = this._renderer._pInst.color.apply(
- this._renderer._pInst, [v1, v2, v3]);
+/**
+ * @method directionalLight
+ * @param {Number[]|String|p5.Color} color color Array, CSS color string,
+ * or p5.Color value
+ * @param {Number} x x axis direction
+ * @param {Number} y y axis direction
+ * @param {Number} z z axis direction
+ * @chainable
+ */
- var colors = new Float32Array(color._array.slice(0,3));
- this._renderer.curFillShader.setUniform('uDirectionalColor', colors);
+/**
+ * @method directionalLight
+ * @param {Number[]|String|p5.Color} color
+ * @param {p5.Vector} position
+ * @chainable
+ */
- var _x, _y, _z;
+/**
+ * @method directionalLight
+ * @param {Number} v1
+ * @param {Number} v2
+ * @param {Number} v3
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} z
+ * @chainable
+ */
+p5.prototype.directionalLight = function(v1, v2, v3, x, y, z) {
+ this._assert3d('directionalLight');
+ p5._validateParameters('directionalLight', arguments);
+ var shader = this._renderer._useLightShader();
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
+ //@TODO: check parameters number
+ var color;
+ if (v1 instanceof p5.Color) {
+ color = v1;
+ } else {
+ color = this.color(v1, v2, v3);
}
- if(typeof args[args.length-1] === 'number'){
- _x = args[args.length-3];
- _y = args[args.length-2];
- _z = args[args.length-1];
- }else{
- try{
- _x = args[args.length-1].x;
- _y = args[args.length-1].y;
- _z = args[args.length-1].z;
- }
- catch(error){
- throw error;
- }
+ var _x, _y, _z;
+ var v = arguments[arguments.length - 1];
+ if (typeof v === 'number') {
+ _x = arguments[arguments.length - 3];
+ _y = arguments[arguments.length - 2];
+ _z = arguments[arguments.length - 1];
+ } else {
+ _x = v.x;
+ _y = v.y;
+ _z = v.z;
}
- this._renderer.curFillShader.setUniform('uUseLighting', true);
+ shader.setUniform('uUseLighting', true);
//in case there's no material color for the geometry
- this._renderer.curFillShader.setUniform('uMaterialColor',
- this._renderer.curFillColor);
- this._renderer.curFillShader.setUniform('uLightingDirection', [_x, _y, _z]);
- this._renderer.directionalLightCount ++;
- this._renderer.curFillShader.setUniform('uDirectionalLightCount',
- this._renderer.directionalLightCount);
+ shader.setUniform('uMaterialColor', this._renderer.curFillColor);
+
+ // normalize direction
+ var l = Math.sqrt(_x * _x + _y * _y + _z * _z);
+ this._renderer.directionalLightDirections.push(_x / l, _y / l, _z / l);
+ shader.setUniform(
+ 'uLightingDirection',
+ this._renderer.directionalLightDirections
+ );
+
+ this._renderer.directionalLightColors.push(
+ color._array[0],
+ color._array[1],
+ color._array[2]
+ );
+ shader.setUniform('uDirectionalColor', this._renderer.directionalLightColors);
+
+ shader.setUniform(
+ 'uDirectionalLightCount',
+ this._renderer.directionalLightColors.length / 3
+ );
+
return this;
};
/**
* Creates a point light with a color and a light position
- * @method pointLight
- * @param {Number|Array|String|p5.Color} v1 gray value,
- * red or hue value (depending on the current color mode),
- * or color Array, or CSS color string
- * @param {Number} [v2] green or saturation value
- * @param {Number} [v3] blue or brightness value
- * @param {Number} [a] opacity
- * @param {Number|p5.Vector} x x axis position or a p5.Vector
- * @param {Number} [y] y axis position
- * @param {Number} [z] z axis position
+ * @method pointLight
+ * @param {Number} v1 red or hue value (depending on the current
+ * color mode),
+ * @param {Number} v2 green or saturation value
+ * @param {Number} v3 blue or brightness value
+ * @param {Number} x x axis position
+ * @param {Number} y y axis position
+ * @param {Number} z z axis position
* @chainable
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
* }
- * function draw(){
+ * function draw() {
* background(0);
* //move your mouse to change light position
- * var locY = (mouseY / height - 0.5) *(-2);
- * var locX = (mouseX / width - 0.5) *2;
- * //to set the light position,
- * //think of the world's coordinate as:
- * // -1,1 -------- 1,1
- * // | |
- * // | |
- * // | |
- * // -1,-1---------1,-1
- * pointLight(250, 250, 250, locX, locY, 0);
+ * var locX = mouseX - width / 2;
+ * var locY = mouseY - height / 2;
+ * // to set the light position,
+ * // think of the world's coordinate as:
+ * // -width/2,-height/2 -------- width/2,-height/2
+ * // | |
+ * // | 0,0 |
+ * // | |
+ * // -width/2,height/2--------width/2,height/2
+ * pointLight(250, 250, 250, locX, locY, 50);
* ambientMaterial(250);
- * sphere(50);
+ * noStroke();
+ * sphere(25);
* }
*
*
@@ -66981,52 +75136,81 @@ p5.prototype.directionalLight = function(v1, v2, v3, x, y, z) {
* spot light on canvas changes position with mouse
*
*/
-p5.prototype.pointLight = function(v1, v2, v3, a, x, y, z) {
- if (! this._renderer.curFillShader.isLightShader()) {
- this._renderer.setFillShader(this._renderer._getLightShader());
- }
- //@TODO: check parameters number
- var color = this._renderer._pInst.color.apply(
- this._renderer._pInst, [v1, v2, v3]);
- var colors = new Float32Array(color._array.slice(0,3));
- this._renderer.curFillShader.setUniform('uPointLightColor', colors);
+/**
+ * @method pointLight
+ * @param {Number} v1
+ * @param {Number} v2
+ * @param {Number} v3
+ * @param {p5.Vector} position the position of the light
+ * @chainable
+ */
- var _x, _y, _z;
+/**
+ * @method pointLight
+ * @param {Number[]|String|p5.Color} color color Array, CSS color string,
+ * or p5.Color value
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} z
+ * @chainable
+ */
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
+/**
+ * @method pointLight
+ * @param {Number[]|String|p5.Color} color
+ * @param {p5.Vector} position
+ * @chainable
+ */
+p5.prototype.pointLight = function(v1, v2, v3, x, y, z) {
+ this._assert3d('pointLight');
+ p5._validateParameters('pointLight', arguments);
+ //@TODO: check parameters number
+ var color;
+ if (v1 instanceof p5.Color) {
+ color = v1;
+ } else {
+ color = this.color(v1, v2, v3);
+ }
+
+ var _x, _y, _z;
+ var v = arguments[arguments.length - 1];
+ if (typeof v === 'number') {
+ _x = arguments[arguments.length - 3];
+ _y = arguments[arguments.length - 2];
+ _z = arguments[arguments.length - 1];
+ } else {
+ _x = v.x;
+ _y = v.y;
+ _z = v.z;
}
- if(typeof args[args.length-1] === 'number'){
- _x = args[args.length-3];
- _y = args[args.length-2];
- _z = args[args.length-1];
- }else{
- try{
- _x = args[args.length-1].x;
- _y = args[args.length-1].y;
- _z = args[args.length-1].z;
- }
- catch(error){
- throw error;
- }
- }
- this._renderer.curFillShader.setUniform('uUseLighting', true);
- //in case there's no material color for the geometry
- this._renderer.curFillShader.setUniform('uMaterialColor',
- this._renderer.curFillColor);
- this._renderer.curFillShader.setUniform('uPointLightLocation', [_x, _y, _z]);
- this._renderer.pointLightCount++;
- this._renderer.curFillShader.setUniform('uPointLightCount',
- this._renderer.pointLightCount);
+ var shader = this._renderer._useLightShader();
+ shader.setUniform('uUseLighting', true);
+ //in case there's no material color for the geometry
+ shader.setUniform('uMaterialColor', this._renderer.curFillColor);
+
+ this._renderer.pointLightPositions.push(_x, _y, _z);
+ shader.setUniform('uPointLightLocation', this._renderer.pointLightPositions);
+
+ this._renderer.pointLightColors.push(
+ color._array[0],
+ color._array[1],
+ color._array[2]
+ );
+ shader.setUniform('uPointLightColor', this._renderer.pointLightColors);
+
+ shader.setUniform(
+ 'uPointLightCount',
+ this._renderer.pointLightColors.length / 3
+ );
+
return this;
};
module.exports = p5;
-},{"../core/core":55}],100:[function(_dereq_,module,exports){
+},{"../core/main":25}],68:[function(_dereq_,module,exports){
/**
* @module Shape
* @submodule 3D Models
@@ -67037,7 +75221,7 @@ module.exports = p5;
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
_dereq_('./p5.Geometry');
/**
@@ -67046,9 +75230,9 @@ _dereq_('./p5.Geometry');
* One of the limitations of the OBJ format is that it doesn't have a built-in
* sense of scale. This means that models exported from different programs might
* be very different sizes. If your model isn't displaying, try calling
- * loadModel() with the normalized parameter set to true. This will resize the
+ * loadModel() with the normalized parameter set to true. This will resize the
* model to a scale appropriate for p5. You can also make additional changes to
- * the final size of your model with the scale() function.
+ * the final size of your model with the scale() function.
*
* @method loadModel
* @param {String} path Path of the model to be loaded
@@ -67059,30 +75243,55 @@ _dereq_('./p5.Geometry');
* the 3D model object.
* @param {function(Event)} [failureCallback] called with event error if
* the image fails to load.
- * @return {p5.Geometry} the p5.Geometry object
- */
-/**
- * @method loadModel
- * @param {String} path
- * @param {function(p5.Geometry)} [successCallback]
- * @param {function(Event)} [failureCallback]
- * @return {p5.Geometry} the p5.Geometry object
+ * @return {p5.Geometry} the p5.Geometry object
+ *
+ * @example
+ *
+ *
+ * //draw a spinning octahedron
+ * var octahedron;
+ *
+ * function preload() {
+ * octahedron = loadModel('assets/octahedron.obj');
+ * }
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * model(octahedron);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Vertically rotating 3-d octahedron.
+ *
* @example
*
*
* //draw a spinning teapot
* var teapot;
*
- * function setup(){
- * createCanvas(100, 100, WEBGL);
+ * function preload() {
+ * // Load model with normalise parameter set to true
+ * teapot = loadModel('assets/teapot.obj', true);
+ * }
*
- * teapot = loadModel('assets/teapot.obj');
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
* }
*
- * function draw(){
+ * function draw() {
* background(200);
+ * scale(0.4); // Scaled to make model fit into canvas
* rotateX(frameCount * 0.01);
* rotateY(frameCount * 0.01);
+ * normalMaterial(); // For effect
* model(teapot);
* }
*
@@ -67090,14 +75299,20 @@ _dereq_('./p5.Geometry');
*
* @alt
* Vertically rotating 3-d teapot with red, green and blue gradient.
- *
*/
-p5.prototype.loadModel = function () {
- var path = arguments[0];
+/**
+ * @method loadModel
+ * @param {String} path
+ * @param {function(p5.Geometry)} [successCallback]
+ * @param {function(Event)} [failureCallback]
+ * @return {p5.Geometry} the p5.Geometry object
+ */
+p5.prototype.loadModel = function(path) {
+ p5._validateParameters('loadModel', arguments);
var normalize;
var successCallback;
var failureCallback;
- if(typeof arguments[1] === 'boolean') {
+ if (typeof arguments[1] === 'boolean') {
normalize = arguments[1];
successCallback = arguments[2];
failureCallback = arguments[3];
@@ -67109,17 +75324,23 @@ p5.prototype.loadModel = function () {
var model = new p5.Geometry();
model.gid = path + '|' + normalize;
- this.loadStrings(path, function(strings) {
- parseObj(model, strings);
+ var self = this;
+ this.loadStrings(
+ path,
+ function(strings) {
+ parseObj(model, strings);
- if (normalize) {
- model.normalize();
- }
+ if (normalize) {
+ model.normalize();
+ }
- if (typeof successCallback === 'function') {
- successCallback(model);
- }
- }.bind(this), failureCallback);
+ self._decrementPreload();
+ if (typeof successCallback === 'function') {
+ successCallback(model);
+ }
+ }.bind(this),
+ failureCallback
+ );
return model;
};
@@ -67135,7 +75356,7 @@ p5.prototype.loadModel = function () {
*
* f 4 3 2 1
*/
-function parseObj( model, lines ) {
+function parseObj(model, lines) {
// OBJ allows a face to specify an index for a vertex (in the above example),
// but it also allows you to specify a custom combination of vertex, UV
// coordinate, and vertex normal. So, "3/4/3" would mean, "use vertex 3 with
@@ -67145,9 +75366,11 @@ function parseObj( model, lines ) {
// used to map a specific combination (keyed on, for example, the string
// "3/4/3"), to the actual index of the newly created vertex in the final
// object.
- var loadedVerts = {'v' : [],
- 'vt' : [],
- 'vn' : []};
+ var loadedVerts = {
+ v: [],
+ vt: [],
+ vn: []
+ };
var indexedVerts = {};
for (var line = 0; line < lines.length; ++line) {
@@ -67160,9 +75383,11 @@ function parseObj( model, lines ) {
if (tokens[0] === 'v' || tokens[0] === 'vn') {
// Check if this line describes a vertex or vertex normal.
// It will have three numeric parameters.
- var vertex = new p5.Vector(parseFloat(tokens[1]),
- parseFloat(tokens[2]),
- parseFloat(tokens[3]));
+ var vertex = new p5.Vector(
+ parseFloat(tokens[1]),
+ parseFloat(tokens[2]),
+ parseFloat(tokens[3])
+ );
loadedVerts[tokens[0]].push(vertex);
} else if (tokens[0] === 'vt') {
// Check if this line describes a texture coordinate.
@@ -67194,423 +75419,1714 @@ function parseObj( model, lines ) {
vertParts[i] = parseInt(vertParts[i]) - 1;
}
- vertIndex = indexedVerts[vertString] = model.vertices.length;
- model.vertices.push(loadedVerts.v[vertParts[0]].copy());
- if (loadedVerts.vt[vertParts[1]]) {
- model.uvs.push(loadedVerts.vt[vertParts[1]].slice());
- } else {
- model.uvs.push([0, 0]);
- }
+ vertIndex = indexedVerts[vertString] = model.vertices.length;
+ model.vertices.push(loadedVerts.v[vertParts[0]].copy());
+ if (loadedVerts.vt[vertParts[1]]) {
+ model.uvs.push(loadedVerts.vt[vertParts[1]].slice());
+ } else {
+ model.uvs.push([0, 0]);
+ }
+
+ if (loadedVerts.vn[vertParts[2]]) {
+ model.vertexNormals.push(loadedVerts.vn[vertParts[2]].copy());
+ }
+ }
+
+ face.push(vertIndex);
+ }
+
+ if (
+ face[0] !== face[1] &&
+ face[0] !== face[2] &&
+ face[1] !== face[2]
+ ) {
+ model.faces.push(face);
+ }
+ }
+ }
+ }
+ }
+ // If the model doesn't have normals, compute the normals
+ if (model.vertexNormals.length === 0) {
+ model.computeNormals();
+ }
+
+ return model;
+}
+
+/**
+ * Render a 3d model to the screen.
+ *
+ * @method model
+ * @param {p5.Geometry} model Loaded 3d model to be rendered
+ * @example
+ *
+ *
+ * //draw a spinning octahedron
+ * var octahedron;
+ *
+ * function preload() {
+ * octahedron = loadModel('assets/octahedron.obj');
+ * }
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * model(octahedron);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Vertically rotating 3-d octahedron.
+ *
+ */
+p5.prototype.model = function(model) {
+ this._assert3d('model');
+ p5._validateParameters('model', arguments);
+ if (model.vertices.length > 0) {
+ if (!this._renderer.geometryInHash(model.gid)) {
+ model._makeTriangleEdges()._edgesToVertices();
+ this._renderer.createBuffers(model.gid, model);
+ }
+
+ this._renderer.drawBuffers(model.gid);
+ }
+};
+
+module.exports = p5;
+
+},{"../core/main":25,"./p5.Geometry":71}],69:[function(_dereq_,module,exports){
+/**
+ * @module Lights, Camera
+ * @submodule Material
+ * @for p5
+ * @requires core
+ */
+
+'use strict';
+
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
+_dereq_('./p5.Texture');
+
+/**
+ * Loads a custom shader from the provided vertex and fragment
+ * shader paths. The shader files are loaded asynchronously in the
+ * background, so this method should be used in preload().
+ *
+ * For now, there are three main types of shaders. p5 will automatically
+ * supply appropriate vertices, normals, colors, and lighting attributes
+ * if the parameters defined in the shader match the names.
+ *
+ * @method loadShader
+ * @param {String} [vertFilename] path to file containing vertex shader
+ * source code
+ * @param {String} [fragFilename] path to file containing fragment shader
+ * source code
+ * @return {p5.Shader} a shader object created from the provided
+ * vertex and fragment shader files.
+ *
+ * @example
+ *
+ *
+ * var mandel;
+ * function preload() {
+ * // load the shader definitions from files
+ * mandel = loadShader('assets/shader.vert', 'assets/shader.frag');
+ * }
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * // use the shader
+ * shader(mandel);
+ * noStroke();
+ * mandel.setUniform('p', [-0.74364388703, 0.13182590421]);
+ * }
+ *
+ * function draw() {
+ * mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000))));
+ * quad(-1, -1, 1, -1, 1, 1, -1, 1);
+ * }
+ *
+ *
+ *
+ * @alt
+ * zooming Mandelbrot set. a colorful, infinitely detailed fractal.
+ */
+p5.prototype.loadShader = function(vertFilename, fragFilename) {
+ p5._validateParameters('loadShader', arguments);
+ var loadedShader = new p5.Shader();
+
+ var self = this;
+ var loadedFrag = false;
+ var loadedVert = false;
+
+ this.loadStrings(fragFilename, function(result) {
+ loadedShader._fragSrc = result.join('\n');
+ loadedFrag = true;
+ if (loadedVert) {
+ self._decrementPreload();
+ }
+ });
+ this.loadStrings(vertFilename, function(result) {
+ loadedShader._vertSrc = result.join('\n');
+ loadedVert = true;
+ if (loadedFrag) {
+ self._decrementPreload();
+ }
+ });
+
+ return loadedShader;
+};
+
+/**
+ * @method createShader
+ * @param {String} vertSrc source code for the vertex shader
+ * @param {String} fragSrc source code for the fragment shader
+ * @returns {p5.Shader} a shader object created from the provided
+ * vertex and fragment shaders.
+ *
+ * @example
+ *
+ *
+ * // the 'varying's are shared between both vertex & fragment shaders
+ * var varying = 'precision highp float; varying vec2 vPos;';
+ *
+ * // the vertex shader is called for each vertex
+ * var vs =
+ * varying +
+ * 'attribute vec3 aPosition;' +
+ * 'void main() { vPos = (gl_Position = vec4(aPosition,1.0)).xy; }';
+ *
+ * // the fragment shader is called for each pixel
+ * var fs =
+ * varying +
+ * 'uniform vec2 p;' +
+ * 'uniform float r;' +
+ * 'const int I = 500;' +
+ * 'void main() {' +
+ * ' vec2 c = p + vPos * r, z = c;' +
+ * ' float n = 0.0;' +
+ * ' for (int i = I; i > 0; i --) {' +
+ * ' if(z.x*z.x+z.y*z.y > 4.0) {' +
+ * ' n = float(i)/float(I);' +
+ * ' break;' +
+ * ' }' +
+ * ' z = vec2(z.x*z.x-z.y*z.y, 2.0*z.x*z.y) + c;' +
+ * ' }' +
+ * ' gl_FragColor = vec4(0.5-cos(n*17.0)/2.0,0.5-cos(n*13.0)/2.0,0.5-cos(n*23.0)/2.0,1.0);' +
+ * '}';
+ *
+ * var mandel;
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ *
+ * // create and initialize the shader
+ * mandel = createShader(vs, fs);
+ * shader(mandel);
+ * noStroke();
+ *
+ * // 'p' is the center point of the Mandelbrot image
+ * mandel.setUniform('p', [-0.74364388703, 0.13182590421]);
+ * }
+ *
+ * function draw() {
+ * // 'r' is the size of the image in Mandelbrot-space
+ * mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000))));
+ * quad(-1, -1, 1, -1, 1, 1, -1, 1);
+ * }
+ *
+ *
+ *
+ * @alt
+ * zooming Mandelbrot set. a colorful, infinitely detailed fractal.
+ */
+p5.prototype.createShader = function(vertSrc, fragSrc) {
+ this._assert3d('createShader');
+ p5._validateParameters('createShader', arguments);
+ return new p5.Shader(this._renderer, vertSrc, fragSrc);
+};
+
+/**
+ * The shader() function lets the user provide a custom shader
+ * to fill in shapes in WEBGL mode. Users can create their
+ * own shaders by loading vertex and fragment shaders with
+ * loadShader().
+ *
+ * @method shader
+ * @chainable
+ * @param {p5.Shader} [s] the desired p5.Shader to use for rendering
+ * shapes.
+ */
+p5.prototype.shader = function(s) {
+ this._assert3d('shader');
+ p5._validateParameters('shader', arguments);
+ if (s._renderer === undefined) {
+ s._renderer = this._renderer;
+ }
+ if (s.isStrokeShader()) {
+ this._renderer.setStrokeShader(s);
+ } else {
+ this._renderer.setFillShader(s);
+ }
+ return this;
+};
+
+/**
+ * Normal material for geometry. You can view all
+ * possible materials in this
+ * example.
+ * @method normalMaterial
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(200);
+ * normalMaterial();
+ * sphere(50);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Red, green and blue gradient.
+ *
+ */
+p5.prototype.normalMaterial = function() {
+ this._assert3d('normalMaterial');
+ p5._validateParameters('normalMaterial', arguments);
+ this._renderer.drawMode = constants.FILL;
+ this._renderer.setFillShader(this._renderer._getNormalShader());
+ this._renderer.curFillColor = [1, 1, 1, 1];
+ this.noStroke();
+ return this;
+};
+
+/**
+ * Texture for geometry. You can view other possible materials in this
+ * example.
+ * @method texture
+ * @param {p5.Image|p5.MediaElement|p5.Graphics} tex 2-dimensional graphics
+ * to render as texture
+ * @chainable
+ * @example
+ *
+ *
+ * var img;
+ * function preload() {
+ * img = loadImage('assets/laDefense.jpg');
+ * }
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(0);
+ * rotateZ(frameCount * 0.01);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * //pass image as texture
+ * texture(img);
+ * box(200, 200, 200);
+ * }
+ *
+ *
+ *
+ *
+ *
+ * var pg;
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * pg = createGraphics(200, 200);
+ * pg.textSize(100);
+ * }
+ *
+ * function draw() {
+ * background(0);
+ * pg.background(255);
+ * pg.text('hello!', 0, 100);
+ * //pass image as texture
+ * texture(pg);
+ * plane(200);
+ * }
+ *
+ *
+ *
+ *
+ *
+ * var vid;
+ * function preload() {
+ * vid = createVideo('assets/fingers.mov');
+ * vid.hide();
+ * vid.loop();
+ * }
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ *
+ * function draw() {
+ * background(0);
+ * //pass video frame as texture
+ * texture(vid);
+ * plane(200);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Rotating view of many images umbrella and grid roof on a 3d plane
+ * black canvas
+ * black canvas
+ *
+ */
+p5.prototype.texture = function(tex) {
+ this._assert3d('texture');
+ p5._validateParameters('texture', arguments);
+ this._renderer.drawMode = constants.TEXTURE;
+ var shader = this._renderer._useLightShader();
+ shader.setUniform('uSpecular', false);
+ shader.setUniform('isTexture', true);
+ shader.setUniform('uSampler', tex);
+ this.noStroke();
+ return this;
+};
+
+/**
+ * Ambient material for geometry with a given color. You can view all
+ * possible materials in this
+ * example.
+ * @method ambientMaterial
+ * @param {Number} v1 gray value, red or hue value
+ * (depending on the current color mode),
+ * @param {Number} [v2] green or saturation value
+ * @param {Number} [v3] blue or brightness value
+ * @param {Number} [a] opacity
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(0);
+ * ambientLight(100);
+ * pointLight(250, 250, 250, 100, 100, 0);
+ * ambientMaterial(250);
+ * sphere(50);
+ * }
+ *
+ *
+ *
+ * @alt
+ * radiating light source from top right of canvas
+ *
+ */
+/**
+ * @method ambientMaterial
+ * @param {Number[]|String|p5.Color} color color, color Array, or CSS color string
+ * @chainable
+ */
+p5.prototype.ambientMaterial = function(v1, v2, v3, a) {
+ this._assert3d('ambientMaterial');
+ p5._validateParameters('ambientMaterial', arguments);
+ var color = p5.prototype.color.apply(this, arguments);
+ this._renderer.curFillColor = color._array;
+
+ var shader = this._renderer._useLightShader();
+ shader.setUniform('uMaterialColor', this._renderer.curFillColor);
+ shader.setUniform('uSpecular', false);
+ shader.setUniform('isTexture', false);
+ return this;
+};
+
+/**
+ * Specular material for geometry with a given color. You can view all
+ * possible materials in this
+ * example.
+ * @method specularMaterial
+ * @param {Number} v1 gray value, red or hue value
+ * (depending on the current color mode),
+ * @param {Number} [v2] green or saturation value
+ * @param {Number} [v3] blue or brightness value
+ * @param {Number} [a] opacity
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(0);
+ * ambientLight(100);
+ * pointLight(250, 250, 250, 100, 100, 0);
+ * specularMaterial(250);
+ * sphere(50);
+ * }
+ *
+ *
+ *
+ * @alt
+ * diffused radiating light source from top right of canvas
+ *
+ */
+/**
+ * @method specularMaterial
+ * @param {Number[]|String|p5.Color} color color Array, or CSS color string
+ * @chainable
+ */
+p5.prototype.specularMaterial = function(v1, v2, v3, a) {
+ this._assert3d('specularMaterial');
+ p5._validateParameters('specularMaterial', arguments);
+ var color = p5.prototype.color.apply(this, arguments);
+ this._renderer.curFillColor = color._array;
+
+ var shader = this._renderer._useLightShader();
+ shader.setUniform('uMaterialColor', this._renderer.curFillColor);
+ shader.setUniform('uSpecular', true);
+ shader.setUniform('isTexture', false);
+ return this;
+};
+
+/**
+ * @private blends colors according to color components.
+ * If alpha value is less than 1, we need to enable blending
+ * on our gl context. Otherwise opaque objects need to a depthMask.
+ * @param {Number[]} color [description]
+ * @return {Number[]]} Normalized numbers array
+ */
+p5.RendererGL.prototype._applyColorBlend = function(colors) {
+ var gl = this.GL;
+
+ var isTexture = this.drawMode === constants.TEXTURE;
+ if (isTexture || colors[colors.length - 1] < 1.0) {
+ gl.depthMask(isTexture);
+ gl.enable(gl.BLEND);
+ gl.blendEquation(gl.FUNC_ADD);
+ gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA);
+ } else {
+ gl.depthMask(true);
+ gl.disable(gl.BLEND);
+ }
+ return colors;
+};
+
+module.exports = p5;
+
+},{"../core/constants":19,"../core/main":25,"./p5.Texture":77}],70:[function(_dereq_,module,exports){
+/**
+ * @module Lights, Camera
+ * @submodule Camera
+ * @requires core
+ */
+
+'use strict';
+
+var p5 = _dereq_('../core/main');
+
+////////////////////////////////////////////////////////////////////////////////
+// p5.Prototype Methods
+////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Sets the camera position for a 3D sketch. Parameters for this function define
+ * the position for the camera, the center of the sketch (where the camera is
+ * pointing), and an up direction (the orientation of the camera).
+ *
+ * When called with no arguments, this function creates a default camera
+ * equivalent to
+ * camera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0);
+ * @method camera
+ * @for p5
+ * @param {Number} [x] camera position value on x axis
+ * @param {Number} [y] camera position value on y axis
+ * @param {Number} [z] camera position value on z axis
+ * @param {Number} [centerX] x coordinate representing center of the sketch
+ * @param {Number} [centerY] y coordinate representing center of the sketch
+ * @param {Number} [centerZ] z coordinate representing center of the sketch
+ * @param {Number} [upX] x component of direction 'up' from camera
+ * @param {Number} [upY] y component of direction 'up' from camera
+ * @param {Number} [upZ] z component of direction 'up' from camera
+ * @chainable
+ * @example
+ *
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
+ * function draw() {
+ * background(204);
+ * //move the camera away from the plane by a sin wave
+ * camera(0, 0, 20 + sin(frameCount * 0.01) * 10, 0, 0, 0, 0, 1, 0);
+ * plane(10, 10);
+ * }
+ *
+ *
+ *
+ * @alt
+ * White square repeatedly grows to fill canvas and then shrinks.
+ *
+ */
+p5.prototype.camera = function() {
+ this._assert3d('camera');
+ p5._validateParameters('camera', arguments);
+ this._renderer._curCamera.camera.apply(this._renderer._curCamera, arguments);
+ return this;
+};
+
+/**
+ * Sets a perspective projection for the camera in a 3D sketch. This projection
+ * represents depth through foreshortening: objects that are close to the camera
+ * appear their actual size while those that are further away from the camera
+ * appear smaller. The parameters to this function define the viewing frustum
+ * (the truncated pyramid within which objects are seen by the camera) through
+ * vertical field of view, aspect ratio (usually width/height), and near and far
+ * clipping planes.
+ *
+ * When called with no arguments, the defaults
+ * provided are equivalent to
+ * perspective(PI/3.0, width/height, eyeZ/10.0, eyeZ*10.0), where eyeZ
+ * is equal to ((height/2.0) / tan(PI*60.0/360.0));
+ * @method perspective
+ * @for p5
+ * @param {Number} [fovy] camera frustum vertical field of view,
+ * from bottom to top of view, in angleMode units
+ * @param {Number} [aspect] camera frustum aspect ratio
+ * @param {Number} [near] frustum near plane length
+ * @param {Number} [far] frustum far plane length
+ * @chainable
+ * @example
+ *
+ *
+ * //drag the mouse to look around!
+ * //you will see there's a vanishing point
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * perspective(PI / 3.0, width / height, 0.1, 500);
+ * }
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * normalMaterial();
+ *
+ * rotateX(-0.3);
+ * rotateY(-0.2);
+ * translate(0, 0, -50);
+ *
+ * push();
+ * translate(-15, 0, sin(frameCount / 30) * 95);
+ * box(30);
+ * pop();
+ * push();
+ * translate(15, 0, sin(frameCount / 30 + PI) * 95);
+ * box(30);
+ * pop();
+ * }
+ *
+ *
+ *
+ * @alt
+ * two colored 3D boxes move back and forth, rotating as mouse is dragged.
+ *
+ */
+p5.prototype.perspective = function() {
+ this._assert3d('perspective');
+ p5._validateParameters('perspective', arguments);
+ this._renderer._curCamera.perspective.apply(
+ this._renderer._curCamera,
+ arguments
+ );
+ return this;
+};
+
+/**
+ * Sets an orthographic projection for the camera in a 3D sketch and defines a
+ * box-shaped viewing frustum within which objects are seen. In this projection,
+ * all objects with the same dimension appear the same size, regardless of
+ * whether they are near or far from the camera. The parameters to this
+ * function specify the viewing frustum where left and right are the minimum and
+ * maximum x values, top and bottom are the minimum and maximum y values, and near
+ * and far are the minimum and maximum z values. If no parameters are given, the
+ * default is used: ortho(-width/2, width/2, -height/2, height/2).
+ * @method ortho
+ * @for p5
+ * @param {Number} [left] camera frustum left plane
+ * @param {Number} [right] camera frustum right plane
+ * @param {Number} [bottom] camera frustum bottom plane
+ * @param {Number} [top] camera frustum top plane
+ * @param {Number} [near] camera frustum near plane
+ * @param {Number} [far] camera frustum far plane
+ * @chainable
+ * @example
+ *
+ *
+ * //drag the mouse to look around!
+ * //there's no vanishing point
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * ortho(-width / 2, width / 2, height / 2, -height / 2, 0, 500);
+ * }
+ * function draw() {
+ * background(200);
+ * orbitControl();
+ * normalMaterial();
+ *
+ * rotateX(0.2);
+ * rotateY(-0.2);
+ * push();
+ * translate(-15, 0, sin(frameCount / 30) * 65);
+ * box(30);
+ * pop();
+ * push();
+ * translate(15, 0, sin(frameCount / 30 + PI) * 65);
+ * box(30);
+ * pop();
+ * }
+ *
+ *
+ *
+ * @alt
+ * two 3D boxes move back and forth along same plane, rotating as mouse is dragged.
+ *
+ */
+p5.prototype.ortho = function() {
+ this._assert3d('ortho');
+ p5._validateParameters('ortho', arguments);
+ this._renderer._curCamera.ortho.apply(this._renderer._curCamera, arguments);
+ return this;
+};
+
+////////////////////////////////////////////////////////////////////////////////
+// p5.Camera
+////////////////////////////////////////////////////////////////////////////////
- if (loadedVerts.vn[vertParts[2]]) {
- model.vertexNormals.push(loadedVerts.vn[vertParts[2]].copy());
- }
- }
+/**
+ * Creates a new p5.Camera object and tells the
+ * renderer to use that camera.
+ * Returns the p5.Camera object.
+ * @method createCamera
+ * @return {p5.Camera} The newly created camera object.
+ * @for p5
+ */
+p5.prototype.createCamera = function() {
+ this._assert3d('createCamera');
+ var _cam = new p5.Camera(this._renderer);
- face.push(vertIndex);
- }
+ // compute default camera settings, then set a default camera
+ _cam._computeCameraDefaultSettings();
+ _cam._setDefaultCamera();
- model.faces.push(face);
- }
- }
- }
- }
- // If the model doesn't have normals, compute the normals
- if(model.vertexNormals.length === 0) {
- model.computeNormals();
- }
+ // set renderer current camera to the new camera
+ this._renderer._curCamera = _cam;
- return model;
-}
+ return _cam;
+};
/**
- * Render a 3d model to the screen.
+ * This class describes a camera for use in p5's
+ *
+ * WebGL mode. It contains camera position, orientation, and projection
+ * information necessary for rendering a 3D scene.
*
- * @method model
- * @param {p5.Geometry} model Loaded 3d model to be rendered
+ * New p5.Camera objects can be made through the
+ * createCamera() function and controlled through
+ * the methods described below. A camera created in this way will use a default
+ * position in the scene and a default perspective projection until these
+ * properties are changed through the various methods available. It is possible
+ * to create multiple cameras, in which case the current camera
+ * can be set through the setCamera() method.
+ *
+ *
+ * Note:
+ * The methods below operate in two coordinate systems: the 'world' coordinate
+ * system describe positions in terms of their relationship to the origin along
+ * the X, Y and Z axes whereas the camera's 'local' coordinate system
+ * describes positions from the camera's point of view: left-right, up-down,
+ * and forward-backward. The move() method,
+ * for instance, moves the camera along its own axes, whereas the
+ * setPosition()
+ * method sets the camera's position in world-space.
+ *
+ *
+ * @class p5.Camera
+ * @param {rendererGL} rendererGL instance of WebGL renderer
* @example
*
*
- * //draw a spinning teapot
- * var teapot;
+ * var cam;
+ * var delta = 0.01;
*
- * function setup(){
+ * function setup() {
* createCanvas(100, 100, WEBGL);
- *
- * teapot = loadModel('assets/teapot.obj');
+ * normalMaterial();
+ * cam = createCamera();
+ * // set initial pan angle
+ * cam.pan(-0.8);
* }
*
- * function draw(){
+ * function draw() {
* background(200);
+ *
+ * // pan camera according to angle 'delta'
+ * cam.pan(delta);
+ *
+ * // every 160 frames, switch direction
+ * if (frameCount % 160 === 0) {
+ * delta *= -1;
+ * }
+ *
* rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * model(teapot);
+ * translate(-100, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
* }
*
*
*
* @alt
- * Vertically rotating 3-d teapot with red, green and blue gradient.
+ * camera view pans left and right across a series of rotating 3D boxes.
*
*/
-p5.prototype.model = function ( model ) {
- if (model.vertices.length > 0) {
- if (!this._renderer.geometryInHash(model.gid)) {
- model._makeTriangleEdges();
- this._renderer._edgesToVertices(model);
- this._renderer.createBuffers(model.gid, model);
- }
+p5.Camera = function(renderer) {
+ this._renderer = renderer;
- this._renderer.drawBuffers(model.gid);
- }
+ this.cameraType = 'default';
+
+ this.cameraMatrix = new p5.Matrix();
+ this.projMatrix = new p5.Matrix();
};
-module.exports = p5;
+////////////////////////////////////////////////////////////////////////////////
+// Camera Projection Methods
+////////////////////////////////////////////////////////////////////////////////
-},{"../core/core":55,"./p5.Geometry":102}],101:[function(_dereq_,module,exports){
/**
- * @module Lights, Camera
- * @submodule Material
- * @for p5
- * @requires core
+ * Sets a perspective projection for a p5.Camera object and sets parameters
+ * for that projection according to perspective()
+ * syntax.
+ * @method perspective
+ * @for p5.Camera
*/
+p5.Camera.prototype.perspective = function(fovy, aspect, near, far) {
+ if (typeof fovy === 'undefined') {
+ fovy = this.defaultCameraFOV;
+ // this avoids issue where setting angleMode(DEGREES) before calling
+ // perspective leads to a smaller than expected FOV (because
+ // _computeCameraDefaultSettings computes in radians)
+ this.cameraFOV = fovy;
+ } else {
+ this.cameraFOV = this._renderer._pInst._toRadians(fovy);
+ }
+ if (typeof aspect === 'undefined') {
+ aspect = this.defaultAspectRatio;
+ }
+ if (typeof near === 'undefined') {
+ near = this.defaultCameraNear;
+ }
+ if (typeof far === 'undefined') {
+ far = this.defaultCameraFar;
+ }
-'use strict';
+ if (near <= 0.0001) {
+ near = 0.01;
+ console.log(
+ 'Avoid perspective near plane values close to or below 0. ' +
+ 'Setting value to 0.01.'
+ );
+ }
-var p5 = _dereq_('../core/core');
-var constants = _dereq_('../core/constants');
-_dereq_('./p5.Texture');
+ if (far < near) {
+ console.log(
+ 'Perspective far plane value is less than near plane value. ' +
+ 'Nothing will be shown.'
+ );
+ }
+
+ this.cameraFOV = this._renderer._pInst._toRadians(fovy);
+ this.aspectRatio = aspect;
+ this.cameraNear = near;
+ this.cameraFar = far;
+
+ this.projMatrix = p5.Matrix.identity();
+
+ var f = 1.0 / Math.tan(this.cameraFOV / 2);
+ var nf = 1.0 / (this.cameraNear - this.cameraFar);
+
+ // prettier-ignore
+ this.projMatrix.set(f / aspect, 0, 0, 0,
+ 0, -f, 0, 0,
+ 0, 0, (far + near) * nf, -1,
+ 0, 0, (2 * far * near) * nf, 0);
+
+ if (this._isActive()) {
+ this._renderer.uPMatrix.set(
+ this.projMatrix.mat4[0],
+ this.projMatrix.mat4[1],
+ this.projMatrix.mat4[2],
+ this.projMatrix.mat4[3],
+ this.projMatrix.mat4[4],
+ this.projMatrix.mat4[5],
+ this.projMatrix.mat4[6],
+ this.projMatrix.mat4[7],
+ this.projMatrix.mat4[8],
+ this.projMatrix.mat4[9],
+ this.projMatrix.mat4[10],
+ this.projMatrix.mat4[11],
+ this.projMatrix.mat4[12],
+ this.projMatrix.mat4[13],
+ this.projMatrix.mat4[14],
+ this.projMatrix.mat4[15]
+ );
+ }
+ this.cameraType = 'custom';
+};
/**
- * Loads a custom shader from the provided vertex and fragment
- * shader paths. The shader files are loaded asynchronously in the
- * background, so this method should be used in preload().
- *
- * For now, there are three main types of shaders. p5 will automatically
- * supply appropriate vertices, normals, colors, and lighting attributes
- * if the parameters defined in the shader match the names.
- *
- * @method loadShader
- * @param {String} [vertFilename] path to file containing vertex shader
- * source code
- * @param {String} [fragFilename] path to file containing fragment shader
- * source code
- * @return {p5.Shader} a shader object created from the provided
- * vertex and fragment shader files.
+ * Sets an orthographic projection for a p5.Camera object and sets parameters
+ * for that projection according to ortho() syntax.
+ * @method ortho
+ * @for p5.Camera
*/
-p5.prototype.loadShader = function (vertFilename, fragFilename) {
- var loadedShader = new p5.Shader();
+p5.Camera.prototype.ortho = function(left, right, bottom, top, near, far) {
+ if (left === undefined) left = -this._renderer.width / 2;
+ if (right === undefined) right = +this._renderer.width / 2;
+ if (bottom === undefined) bottom = -this._renderer.height / 2;
+ if (top === undefined) top = +this._renderer.height / 2;
+ if (near === undefined) near = 0;
+ if (far === undefined)
+ far = Math.max(this._renderer.width, this._renderer.height);
- var self = this;
- var loadedFrag = false;
- var loadedVert = false;
+ var w = right - left;
+ var h = top - bottom;
+ var d = far - near;
- this.loadStrings(fragFilename, function(result) {
- loadedShader._fragSrc = result.join('\n');
- loadedFrag = true;
- if (!loadedVert) {
- self._incrementPreload();
- }
- });
- this.loadStrings(vertFilename, function(result) {
- loadedShader._vertSrc = result.join('\n');
- loadedVert = true;
- if (!loadedFrag) {
- self._incrementPreload();
- }
- });
+ var x = +2.0 / w;
+ var y = +2.0 / h;
+ var z = -2.0 / d;
- return loadedShader;
+ var tx = -(right + left) / w;
+ var ty = -(top + bottom) / h;
+ var tz = -(far + near) / d;
+
+ this.projMatrix = p5.Matrix.identity();
+
+ // prettier-ignore
+ this.projMatrix.set( x, 0, 0, 0,
+ 0, -y, 0, 0,
+ 0, 0, z, 0,
+ tx, ty, tz, 1);
+
+ if (this._isActive()) {
+ this._renderer.uPMatrix.set(
+ this.projMatrix.mat4[0],
+ this.projMatrix.mat4[1],
+ this.projMatrix.mat4[2],
+ this.projMatrix.mat4[3],
+ this.projMatrix.mat4[4],
+ this.projMatrix.mat4[5],
+ this.projMatrix.mat4[6],
+ this.projMatrix.mat4[7],
+ this.projMatrix.mat4[8],
+ this.projMatrix.mat4[9],
+ this.projMatrix.mat4[10],
+ this.projMatrix.mat4[11],
+ this.projMatrix.mat4[12],
+ this.projMatrix.mat4[13],
+ this.projMatrix.mat4[14],
+ this.projMatrix.mat4[15]
+ );
+ }
+
+ this.cameraType = 'custom';
};
+////////////////////////////////////////////////////////////////////////////////
+// Camera Orientation Methods
+////////////////////////////////////////////////////////////////////////////////
/**
- * The shader() function lets the user provide a custom shader
- * to fill in shapes in WEBGL mode. Users can create their
- * own shaders by loading vertex and fragment shaders with
- * loadShader().
- *
- * @method shader
- * @chainable
- * @param {p5.Shader} [s] the desired p5.Shader to use for rendering
- * shapes.
+ * Rotate camera view about arbitrary axis defined by x,y,z
+ * based on http://learnwebgl.brown37.net/07_cameras/camera_rotating_motion.html
+ * @method _rotateView
+ * @private
*/
-p5.prototype.shader = function (s) {
- if (s._renderer === undefined) {
- s._renderer = this._renderer;
- }
- if(s.isStrokeShader()) {
- this._renderer.setStrokeShader(s);
- } else {
- this._renderer.setFillShader(s);
- }
- return this;
+p5.Camera.prototype._rotateView = function(a, x, y, z) {
+ var centerX = this.centerX;
+ var centerY = this.centerY;
+ var centerZ = this.centerZ;
+
+ // move center by eye position such that rotation happens around eye position
+ centerX -= this.eyeX;
+ centerY -= this.eyeY;
+ centerZ -= this.eyeZ;
+
+ var rotation = p5.Matrix.identity(this._renderer._pInst);
+ rotation.rotate(a, x, y, z);
+
+ // prettier-ignore
+ var rotatedCenter = [
+ centerX * rotation.mat4[0]+ centerY * rotation.mat4[4]+ centerZ * rotation.mat4[8],
+ centerX * rotation.mat4[1]+ centerY * rotation.mat4[5]+ centerZ * rotation.mat4[9],
+ centerX * rotation.mat4[2]+ centerY * rotation.mat4[6]+ centerZ * rotation.mat4[10]
+ ]
+
+ // add eye position back into center
+ rotatedCenter[0] += this.eyeX;
+ rotatedCenter[1] += this.eyeY;
+ rotatedCenter[2] += this.eyeZ;
+
+ this.camera(
+ this.eyeX,
+ this.eyeY,
+ this.eyeZ,
+ rotatedCenter[0],
+ rotatedCenter[1],
+ rotatedCenter[2],
+ this.upX,
+ this.upY,
+ this.upZ
+ );
};
/**
- * Normal material for geometry. You can view all
- * possible materials in this
- * example.
- * @method normalMaterial
- * @chainable
+ * Panning rotates the camera view to the left and right.
+ * @method pan
+ * @param {Number} angle amount to rotate camera in current
+ * angleMode units.
+ * Greater than 0 values rotate counterclockwise (to the left).
* @example
*
*
- * function setup(){
+ * var cam;
+ * var delta = 0.01;
+ *
+ * function setup() {
* createCanvas(100, 100, WEBGL);
+ * normalMaterial();
+ * cam = createCamera();
+ * // set initial pan angle
+ * cam.pan(-0.8);
* }
*
- * function draw(){
- * background(200);
- * normalMaterial();
- * sphere(50);
+ * function draw() {
+ * background(200);
+ *
+ * // pan camera according to angle 'delta'
+ * cam.pan(delta);
+ *
+ * // every 160 frames, switch direction
+ * if (frameCount % 160 === 0) {
+ * delta *= -1;
+ * }
+ *
+ * rotateX(frameCount * 0.01);
+ * translate(-100, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
* }
*
*
*
* @alt
- * Red, green and blue gradient.
+ * camera view pans left and right across a series of rotating 3D boxes.
*
*/
-p5.prototype.normalMaterial = function(){
- this._renderer.drawMode = constants.FILL;
- this._renderer.setFillShader(this._renderer._getNormalShader());
- this._renderer.noStroke();
- return this;
+p5.Camera.prototype.pan = function(amount) {
+ var local = this._getLocalAxes();
+ this._rotateView(amount, local.y[0], local.y[1], local.y[2]);
};
/**
- * Texture for geometry. You can view other possible materials in this
- * example.
- * @method texture
- * @param {p5.Image|p5.MediaElement|p5.Graphics} tex 2-dimensional graphics
- * to render as texture
- * @chainable
+ * Tilting rotates the camera view up and down.
+ * @method tilt
+ * @param {Number} angle amount to rotate camera in current
+ * angleMode units.
+ * Greater than 0 values rotate counterclockwise (to the left).
* @example
*
*
- * var img;
- * function setup(){
+ * var cam;
+ * var delta = 0.01;
+ *
+ * function setup() {
* createCanvas(100, 100, WEBGL);
- * img = loadImage("assets/laDefense.jpg");
+ * normalMaterial();
+ * cam = createCamera();
+ * // set initial tilt
+ * cam.tilt(-0.8);
* }
*
- * function draw(){
- * background(0);
- * rotateZ(frameCount * 0.01);
- * rotateX(frameCount * 0.01);
+ * function draw() {
+ * background(200);
+ *
+ * // pan camera according to angle 'delta'
+ * cam.tilt(delta);
+ *
+ * // every 160 frames, switch direction
+ * if (frameCount % 160 === 0) {
+ * delta *= -1;
+ * }
+ *
* rotateY(frameCount * 0.01);
- * //pass image as texture
- * texture(img);
- * box(200, 200, 200);
+ * translate(0, -100, 0);
+ * box(20);
+ * translate(0, 35, 0);
+ * box(20);
+ * translate(0, 35, 0);
+ * box(20);
+ * translate(0, 35, 0);
+ * box(20);
+ * translate(0, 35, 0);
+ * box(20);
+ * translate(0, 35, 0);
+ * box(20);
+ * translate(0, 35, 0);
+ * box(20);
* }
*
*
*
+ * @alt
+ * camera view tilts up and down across a series of rotating 3D boxes.
+ */
+p5.Camera.prototype.tilt = function(amount) {
+ var local = this._getLocalAxes();
+ this._rotateView(amount, local.x[0], local.x[1], local.x[2]);
+};
+
+/**
+ * Reorients the camera to look at a position in world space.
+ * @method lookAt
+ * @for p5.Camera
+ * @param {Number} x x position of a point in world space
+ * @param {Number} y y position of a point in world space
+ * @param {Number} z z position of a point in world space
+ * @example
*
*
- * var pg;
- * function setup(){
+ * var cam;
+ *
+ * function setup() {
* createCanvas(100, 100, WEBGL);
- * pg = createGraphics(200, 200);
- * pg.textSize(100);
+ * normalMaterial();
+ * cam = createCamera();
* }
*
- * function draw(){
- * background(0);
- * pg.background(255);
- * pg.text('hello!', 0, 100);
- * //pass image as texture
- * texture(pg);
- * plane(200);
- * }
- *
- *
+ * function draw() {
+ * background(200);
*
- *
- *
- * var vid;
- * function preload(){
- * vid = createVideo("assets/fingers.mov");
- * vid.hide();
- * vid.loop();
- * }
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
+ * // look at a new random point every 60 frames
+ * if (frameCount % 60 === 0) {
+ * cam.lookAt(random(-100, 100), random(-50, 50), 0);
+ * }
*
- * function draw(){
- * background(0);
- * //pass video frame as texture
- * texture(vid);
- * plane(200);
+ * rotateX(frameCount * 0.01);
+ * translate(-100, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
* }
*
*
*
* @alt
- * Rotating view of many images umbrella and grid roof on a 3d plane
- * black canvas
- * black canvas
- *
- */
-p5.prototype.texture = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
+ * camera view of rotating 3D cubes changes to look at a new random
+ * point every second .
+ */
+p5.Camera.prototype.lookAt = function(x, y, z) {
+ this.camera(
+ this.eyeX,
+ this.eyeY,
+ this.eyeZ,
+ x,
+ y,
+ z,
+ this.upX,
+ this.upY,
+ this.upZ
+ );
+};
+
+////////////////////////////////////////////////////////////////////////////////
+// Camera Position Methods
+////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Sets a camera's position and orientation. This is equivalent to calling
+ * camera() on a p5.Camera object.
+ * @method camera
+ * @for p5.Camera
+ */
+p5.Camera.prototype.camera = function(
+ eyeX,
+ eyeY,
+ eyeZ,
+ centerX,
+ centerY,
+ centerZ,
+ upX,
+ upY,
+ upZ
+) {
+ if (typeof eyeX === 'undefined') {
+ eyeX = this.defaultEyeX;
+ eyeY = this.defaultEyeY;
+ eyeZ = this.defaultEyeZ;
+ centerX = eyeX;
+ centerY = eyeY;
+ centerZ = 0;
+ upX = 0;
+ upY = 1;
+ upZ = 0;
}
- this._renderer.GL.depthMask(true);
- this._renderer.GL.enable(this._renderer.GL.BLEND);
- this._renderer.GL.blendFunc(this._renderer.GL.SRC_ALPHA,
- this._renderer.GL.ONE_MINUS_SRC_ALPHA);
- this._renderer.drawMode = constants.TEXTURE;
- if (! this._renderer.curFillShader.isTextureShader()) {
- this._renderer.setFillShader(this._renderer._getLightShader());
+ this.eyeX = eyeX;
+ this.eyeY = eyeY;
+ this.eyeZ = eyeZ;
+
+ this.centerX = centerX;
+ this.centerY = centerY;
+ this.centerZ = centerZ;
+
+ this.upX = upX;
+ this.upY = upY;
+ this.upZ = upZ;
+
+ var local = this._getLocalAxes();
+
+ // the camera affects the model view matrix, insofar as it
+ // inverse translates the world to the eye position of the camera
+ // and rotates it.
+ // prettier-ignore
+ this.cameraMatrix.set(local.x[0], local.y[0], local.z[0], 0,
+ local.x[1], local.y[1], local.z[1], 0,
+ local.x[2], local.y[2], local.z[2], 0,
+ 0, 0, 0, 1);
+
+ var tx = -eyeX;
+ var ty = -eyeY;
+ var tz = -eyeZ;
+
+ this.cameraMatrix.translate([tx, ty, tz]);
+
+ if (this._isActive()) {
+ this._renderer.uMVMatrix.set(
+ this.cameraMatrix.mat4[0],
+ this.cameraMatrix.mat4[1],
+ this.cameraMatrix.mat4[2],
+ this.cameraMatrix.mat4[3],
+ this.cameraMatrix.mat4[4],
+ this.cameraMatrix.mat4[5],
+ this.cameraMatrix.mat4[6],
+ this.cameraMatrix.mat4[7],
+ this.cameraMatrix.mat4[8],
+ this.cameraMatrix.mat4[9],
+ this.cameraMatrix.mat4[10],
+ this.cameraMatrix.mat4[11],
+ this.cameraMatrix.mat4[12],
+ this.cameraMatrix.mat4[13],
+ this.cameraMatrix.mat4[14],
+ this.cameraMatrix.mat4[15]
+ );
}
- this._renderer.curFillShader.setUniform('uSpecular', false);
- this._renderer.curFillShader.setUniform('isTexture', true);
- this._renderer.curFillShader.setUniform('uSampler', args[0]);
- this._renderer.noStroke();
return this;
};
-
/**
- * Ambient material for geometry with a given color. You can view all
- * possible materials in this
- * example.
- * @method ambientMaterial
- * @param {Number|Array|String|p5.Color} v1 gray value,
- * red or hue value (depending on the current color mode),
- * or color Array, or CSS color string
- * @param {Number} [v2] green or saturation value
- * @param {Number} [v3] blue or brightness value
- * @param {Number} [a] opacity
- * @chainable
+ * Move camera along its local axes while maintaining current camera orientation.
+ * @method move
+ * @param {Number} x amount to move along camera's left-right axis
+ * @param {Number} y amount to move along camera's up-down axis
+ * @param {Number} z amount to move along camera's forward-backward axis
* @example
*
*
- * function setup(){
+ * // see the camera move along its own axes while maintaining its orientation
+ * var cam;
+ * var delta = 0.5;
+ *
+ * function setup() {
* createCanvas(100, 100, WEBGL);
+ * normalMaterial();
+ * cam = createCamera();
* }
- * function draw(){
- * background(0);
- * ambientLight(100);
- * pointLight(250, 250, 250, 100, 100, 0);
- * ambientMaterial(250);
- * sphere(50);
+ *
+ * function draw() {
+ * background(200);
+ *
+ * // move the camera along its local axes
+ * cam.move(delta, delta, 0);
+ *
+ * // every 100 frames, switch direction
+ * if (frameCount % 150 === 0) {
+ * delta *= -1;
+ * }
+ *
+ * translate(-10, -10, 0);
+ * box(50, 8, 50);
+ * translate(15, 15, 0);
+ * box(50, 8, 50);
+ * translate(15, 15, 0);
+ * box(50, 8, 50);
+ * translate(15, 15, 0);
+ * box(50, 8, 50);
+ * translate(15, 15, 0);
+ * box(50, 8, 50);
+ * translate(15, 15, 0);
+ * box(50, 8, 50);
* }
*
*
*
* @alt
- * radiating light source from top right of canvas
- *
- */
-p5.prototype.ambientMaterial = function(v1, v2, v3, a) {
- if (! this._renderer.curFillShader.isLightShader()) {
- this._renderer.setFillShader(this._renderer._getLightShader());
- }
- var colors = this._renderer._applyColorBlend.apply(this._renderer, arguments);
- this._renderer.curFillShader.setUniform('uMaterialColor', colors);
- this._renderer.curFillShader.setUniform('uSpecular', false);
- this._renderer.curFillShader.setUniform('isTexture', false);
- return this;
+ * camera view moves along a series of 3D boxes, maintaining the same
+ * orientation throughout the move
+ */
+p5.Camera.prototype.move = function(x, y, z) {
+ var local = this._getLocalAxes();
+
+ // scale local axes by movement amounts
+ // based on http://learnwebgl.brown37.net/07_cameras/camera_linear_motion.html
+ var dx = [local.x[0] * x, local.x[1] * x, local.x[2] * x];
+ var dy = [local.y[0] * y, local.y[1] * y, local.y[2] * y];
+ var dz = [local.z[0] * z, local.z[1] * z, local.z[2] * z];
+
+ this.camera(
+ this.eyeX + dx[0] + dy[0] + dz[0],
+ this.eyeY + dx[1] + dy[1] + dz[1],
+ this.eyeZ + dx[2] + dy[2] + dz[2],
+ this.centerX + dx[0] + dy[0] + dz[0],
+ this.centerY + dx[1] + dy[1] + dz[1],
+ this.centerZ + dx[2] + dy[2] + dz[2],
+ 0,
+ 1,
+ 0
+ );
};
/**
- * Specular material for geometry with a given color. You can view all
- * possible materials in this
- * example.
- * @method specularMaterial
- * @param {Number|Array|String|p5.Color} v1 gray value,
- * red or hue value (depending on the current color mode),
- * or color Array, or CSS color string
- * @param {Number} [v2] green or saturation value
- * @param {Number} [v3] blue or brightness value
- * @param {Number} [a] opacity
- * @chainable
+ * Set camera position in world-space while maintaining current camera
+ * orientation.
+ * @method setPosition
+ * @param {Number} x x position of a point in world space
+ * @param {Number} y y position of a point in world space
+ * @param {Number} z z position of a point in world space
* @example
*
*
- * function setup(){
+ * // press '1' '2' or '3' keys to set camera position
+ *
+ * var cam;
+ *
+ * function setup() {
* createCanvas(100, 100, WEBGL);
+ * normalMaterial();
+ * cam = createCamera();
* }
- * function draw(){
- * background(0);
- * ambientLight(100);
- * pointLight(250, 250, 250, 100, 100, 0);
- * specularMaterial(250);
- * sphere(50);
+ *
+ * function draw() {
+ * background(200);
+ *
+ * // '1' key
+ * if (keyIsDown(49)) {
+ * cam.setPosition(30, 0, 80);
+ * }
+ * // '2' key
+ * if (keyIsDown(50)) {
+ * cam.setPosition(0, 0, 80);
+ * }
+ * // '3' key
+ * if (keyIsDown(51)) {
+ * cam.setPosition(-30, 0, 80);
+ * }
+ *
+ * box(20);
* }
*
*
*
* @alt
- * diffused radiating light source from top right of canvas
- *
+ * camera position changes as the user presses keys, altering view of a 3D box
*/
-p5.prototype.specularMaterial = function(v1, v2, v3, a) {
- if (! this._renderer.curFillShader.isLightShader()) {
- this._renderer.setFillShader(this._renderer._getLightShader());
+p5.Camera.prototype.setPosition = function(x, y, z) {
+ var diffX = x - this.eyeX;
+ var diffY = y - this.eyeY;
+ var diffZ = z - this.eyeZ;
+
+ this.camera(
+ x,
+ y,
+ z,
+ this.centerX + diffX,
+ this.centerY + diffY,
+ this.centerZ + diffZ,
+ 0,
+ 1,
+ 0
+ );
+};
+
+////////////////////////////////////////////////////////////////////////////////
+// Camera Helper Methods
+////////////////////////////////////////////////////////////////////////////////
+
+// @TODO: combine this function with _setDefaultCamera to compute these values
+// as-needed
+p5.Camera.prototype._computeCameraDefaultSettings = function() {
+ this.defaultCameraFOV = 60 / 180 * Math.PI;
+ this.defaultAspectRatio = this._renderer.width / this._renderer.height;
+ this.defaultEyeX = 0;
+ this.defaultEyeY = 0;
+ this.defaultEyeZ =
+ this._renderer.height / 2.0 / Math.tan(this.defaultCameraFOV / 2.0);
+ this.defaultCenterX = 0;
+ this.defaultCenterY = 0;
+ this.defaultCenterZ = 0;
+ this.defaultCameraNear = this.defaultEyeZ * 0.1;
+ this.defaultCameraFar = this.defaultEyeZ * 10;
+};
+
+//detect if user didn't set the camera
+//then call this function below
+p5.Camera.prototype._setDefaultCamera = function() {
+ this.cameraFOV = this.defaultCameraFOV;
+ this.aspectRatio = this.defaultAspectRatio;
+ this.eyeX = this.defaultEyeX;
+ this.eyeY = this.defaultEyeY;
+ this.eyeZ = this.defaultEyeZ;
+ this.centerX = this.defaultCenterX;
+ this.centerY = this.defaultCenterY;
+ this.centerZ = this.defaultCenterZ;
+ this.upX = 0;
+ this.upY = 1;
+ this.upZ = 0;
+ this.cameraNear = this.defaultCameraNear;
+ this.cameraFar = this.defaultCameraFar;
+
+ this.perspective();
+ this.camera();
+
+ this.cameraType = 'default';
+};
+
+p5.Camera.prototype._resize = function() {
+ // If we're using the default camera, update the aspect ratio
+ if (this.cameraType === 'default') {
+ this._computeCameraDefaultSettings();
+ this._setDefaultCamera();
+ } else {
+ this.perspective(
+ this.cameraFOV,
+ this._renderer.width / this._renderer.height
+ );
}
+};
- var colors = this._renderer._applyColorBlend.apply(this._renderer, arguments);
- this._renderer.curFillShader.setUniform('uMaterialColor', colors);
- this._renderer.curFillShader.setUniform('uSpecular', true);
- this._renderer.curFillShader.setUniform('isTexture', false);
- return this;
+/**
+ * Returns a copy of a camera.
+ * @method copy
+ * @private
+ */
+p5.Camera.prototype.copy = function() {
+ var _cam = new p5.Camera(this._renderer);
+ _cam.cameraFOV = this.cameraFOV;
+ _cam.aspectRatio = this.aspectRatio;
+ _cam.eyeX = this.eyeX;
+ _cam.eyeY = this.eyeY;
+ _cam.eyeZ = this.eyeZ;
+ _cam.centerX = this.centerX;
+ _cam.centerY = this.centerY;
+ _cam.centerZ = this.centerZ;
+ _cam.cameraNear = this.cameraNear;
+ _cam.cameraFar = this.cameraFar;
+
+ _cam.cameraType = this.cameraType;
+
+ _cam.cameraMatrix = this.cameraMatrix.copy();
+ _cam.projMatrix = this.projMatrix.copy();
+
+ return _cam;
};
/**
- * @private blends colors according to color components.
- * If alpha value is less than 1, we need to enable blending
- * on our gl context. Otherwise opaque objects need to a depthMask.
- * @param {Number} v1 [description]
- * @param {Number} v2 [description]
- * @param {Number} v3 [description]
- * @param {Number} a [description]
- * @return {[Number]} Normalized numbers array
+ * Returns a camera's local axes: left-right, up-down, and forward-backward,
+ * as defined by vectors in world-space.
+ * @method _getLocalAxes
+ * @private
*/
-p5.RendererGL.prototype._applyColorBlend = function(v1,v2,v3,a){
- var gl = this.GL;
- var color = this._pInst.color.apply(
- this._pInst, arguments);
- var colors = color._array;
- if(colors[colors.length-1] < 1.0){
- gl.depthMask(false);
- gl.enable(gl.BLEND);
- gl.blendEquation( gl.FUNC_ADD );
- gl.blendFunc( gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA );
- } else {
- gl.depthMask(true);
- gl.disable(gl.BLEND);
+p5.Camera.prototype._getLocalAxes = function() {
+ // calculate camera local Z vector
+ var z0 = this.eyeX - this.centerX;
+ var z1 = this.eyeY - this.centerY;
+ var z2 = this.eyeZ - this.centerZ;
+
+ // normalize camera local Z vector
+ var eyeDist = Math.sqrt(z0 * z0 + z1 * z1 + z2 * z2);
+ if (eyeDist !== 0) {
+ z0 /= eyeDist;
+ z1 /= eyeDist;
+ z2 /= eyeDist;
}
- return colors;
+
+ // calculate camera Y vector
+ var y0 = this.upX;
+ var y1 = this.upY;
+ var y2 = this.upZ;
+
+ // compute camera local X vector as up vector (local Y) cross local Z
+ var x0 = y1 * z2 - y2 * z1;
+ var x1 = -y0 * z2 + y2 * z0;
+ var x2 = y0 * z1 - y1 * z0;
+
+ // recompute y = z cross x
+ y0 = z1 * x2 - z2 * x1;
+ y1 = -z0 * x2 + z2 * x0;
+ y2 = z0 * x1 - z1 * x0;
+
+ // cross product gives area of parallelogram, which is < 1.0 for
+ // non-perpendicular unit-length vectors; so normalize x, y here:
+ var xmag = Math.sqrt(x0 * x0 + x1 * x1 + x2 * x2);
+ if (xmag !== 0) {
+ x0 /= xmag;
+ x1 /= xmag;
+ x2 /= xmag;
+ }
+
+ var ymag = Math.sqrt(y0 * y0 + y1 * y1 + y2 * y2);
+ if (ymag !== 0) {
+ y0 /= ymag;
+ y1 /= ymag;
+ y2 /= ymag;
+ }
+
+ return {
+ x: [x0, x1, x2],
+ y: [y0, y1, y2],
+ z: [z0, z1, z2]
+ };
};
-module.exports = p5;
-},{"../core/constants":54,"../core/core":55,"./p5.Texture":108}],102:[function(_dereq_,module,exports){
+/**
+ * Orbits the camera about center point. For use with orbitControl().
+ * @method _orbit
+ * @private
+ * @param {Number} dTheta change in spherical coordinate theta
+ * @param {Number} dPhi change in spherical coordinate phi
+ * @param {Number} dRadius change in radius
+ */
+p5.Camera.prototype._orbit = function(dTheta, dPhi, dRadius) {
+ var diffX = this.eyeX - this.centerX;
+ var diffY = this.eyeY - this.centerY;
+ var diffZ = this.eyeZ - this.centerZ;
+
+ // get spherical coorinates for current camera position about origin
+ var camRadius = Math.sqrt(diffX * diffX + diffY * diffY + diffZ * diffZ);
+ // from https://github.com/mrdoob/three.js/blob/dev/src/math/Spherical.js#L72-L73
+ var camTheta = Math.atan2(diffX, diffZ); // equatorial angle
+ var camPhi = Math.acos(Math.max(-1, Math.min(1, diffY / camRadius))); // polar angle
+
+ // add change
+ camTheta += dTheta;
+ camPhi += dPhi;
+ camRadius += dRadius;
+
+ // prevent zooming through the center:
+ if (camRadius < 0) {
+ camRadius = 0.1;
+ }
+
+ // prevent rotation over the zenith / under bottom
+ if (camPhi > Math.PI) {
+ camPhi = Math.PI;
+ } else if (camPhi <= 0) {
+ camPhi = 0.001;
+ }
+
+ // from https://github.com/mrdoob/three.js/blob/dev/src/math/Vector3.js#L628-L632
+ var _x = Math.sin(camPhi) * camRadius * Math.sin(camTheta);
+ var _y = Math.cos(camPhi) * camRadius;
+ var _z = Math.sin(camPhi) * camRadius * Math.cos(camTheta);
+
+ this.camera(
+ _x + this.centerX,
+ _y + this.centerY,
+ _z + this.centerZ,
+ this.centerX,
+ this.centerY,
+ this.centerZ,
+ 0,
+ 1,
+ 0
+ );
+};
+
+/**
+ * Returns true if camera is currently attached to renderer.
+ * @method _isActive
+ * @private
+ */
+p5.Camera.prototype._isActive = function() {
+ return this === this._renderer._curCamera;
+};
+
+/**
+ * Sets rendererGL's current camera to a p5.Camera object. Allows switching
+ * between multiple cameras.
+ * @method setCamera
+ * @param {p5.Camera} cam p5.Camera object
+ * @for p5
+ * @example
+ *
+ *
+ * var cam1, cam2;
+ * var currentCamera;
+ *
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * normalMaterial();
+ *
+ * cam1 = createCamera();
+ * cam2 = createCamera();
+ * cam2.setPosition(30, 0, 50);
+ * cam2.lookAt(0, 0, 0);
+ * cam2.ortho();
+ *
+ * // set variable for previously active camera:
+ * currentCamera = 1;
+ * }
+ *
+ * function draw() {
+ * background(200);
+ *
+ * // camera 1:
+ * cam1.lookAt(0, 0, 0);
+ * cam1.setPosition(sin(frameCount / 60) * 200, 0, 100);
+ *
+ * // every 100 frames, switch between the two cameras
+ * if (frameCount % 100 === 0) {
+ * if (currentCamera === 1) {
+ * setCamera(cam1);
+ * currentCamera = 0;
+ * } else {
+ * setCamera(cam2);
+ * currentCamera = 1;
+ * }
+ * }
+ *
+ * drawBoxes();
+ * }
+ *
+ * function drawBoxes() {
+ * rotateX(frameCount * 0.01);
+ * translate(-100, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * translate(35, 0, 0);
+ * box(20);
+ * }
+ *
+ *
+ *
+ * @alt
+ * Canvas switches between two camera views, each showing a series of spinning
+ * 3D boxes.
+ */
+p5.prototype.setCamera = function(cam) {
+ this._renderer._curCamera = cam;
+
+ // set the projection matrix (which is not normally updated each frame)
+ this._renderer.uPMatrix.set(
+ cam.projMatrix.mat4[0],
+ cam.projMatrix.mat4[1],
+ cam.projMatrix.mat4[2],
+ cam.projMatrix.mat4[3],
+ cam.projMatrix.mat4[4],
+ cam.projMatrix.mat4[5],
+ cam.projMatrix.mat4[6],
+ cam.projMatrix.mat4[7],
+ cam.projMatrix.mat4[8],
+ cam.projMatrix.mat4[9],
+ cam.projMatrix.mat4[10],
+ cam.projMatrix.mat4[11],
+ cam.projMatrix.mat4[12],
+ cam.projMatrix.mat4[13],
+ cam.projMatrix.mat4[14],
+ cam.projMatrix.mat4[15]
+ );
+};
+
+module.exports = p5.Camera;
+
+},{"../core/main":25}],71:[function(_dereq_,module,exports){
//some of the functions are adjusted from Three.js(http://threejs.org)
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
/**
* p5 Geometry class
* @class p5.Geometry
* @constructor
- * @param {function | Object} vertData callback function or Object
- * containing routine(s) for vertex data generation
- * @param {Number} [detailX] number of vertices on horizontal surface
- * @param {Number} [detailY] number of vertices on horizontal surface
+ * @param {Integer} [detailX] number of vertices on horizontal surface
+ * @param {Integer} [detailY] number of vertices on horizontal surface
* @param {function} [callback] function to call upon object instantiation.
*
*/
-p5.Geometry = function
-(detailX, detailY, callback){
+p5.Geometry = function(detailX, detailY, callback) {
//an array containing every vertex
//@type [p5.Vector]
this.vertices = [];
@@ -67637,25 +77153,28 @@ p5.Geometry = function
// a 2D array containing edge connectivity pattern for create line vertices
//based on faces for most objects;
this.edges = [];
- this.detailX = (detailX !== undefined) ? detailX: 1;
- this.detailY = (detailY !== undefined) ? detailY: 1;
- if(callback instanceof Function){
+ this.detailX = detailX !== undefined ? detailX : 1;
+ this.detailY = detailY !== undefined ? detailY : 1;
+ if (callback instanceof Function) {
callback.call(this);
}
- this.name = 'p5.Geometry'; // for friendly debugger system
-
return this; // TODO: is this a constructor?
};
-p5.Geometry.prototype.computeFaces = function(){
+/**
+ * @method computeFaces
+ * @chainable
+ */
+p5.Geometry.prototype.computeFaces = function() {
+ this.faces.length = 0;
var sliceCount = this.detailX + 1;
var a, b, c, d;
- for (var i = 0; i < this.detailY; i++){
- for (var j = 0; j < this.detailX; j++){
- a = i * sliceCount + j;// + offset;
- b = i * sliceCount + j + 1;// + offset;
- c = (i + 1)* sliceCount + j + 1;// + offset;
- d = (i + 1)* sliceCount + j;// + offset;
+ for (var i = 0; i < this.detailY; i++) {
+ for (var j = 0; j < this.detailX; j++) {
+ a = i * sliceCount + j; // + offset;
+ b = i * sliceCount + j + 1; // + offset;
+ c = (i + 1) * sliceCount + j + 1; // + offset;
+ d = (i + 1) * sliceCount + j; // + offset;
this.faces.push([a, b, d]);
this.faces.push([d, b, c]);
}
@@ -67663,91 +77182,120 @@ p5.Geometry.prototype.computeFaces = function(){
return this;
};
-p5.Geometry.prototype._getFaceNormal = function(faceId,vertId){
+p5.Geometry.prototype._getFaceNormal = function(faceId) {
//This assumes that vA->vB->vC is a counter-clockwise ordering
var face = this.faces[faceId];
- var vA = this.vertices[face[vertId%3]];
- var vB = this.vertices[face[(vertId+1)%3]];
- var vC = this.vertices[face[(vertId+2)%3]];
- var n = p5.Vector.cross(
- p5.Vector.sub(vB,vA),
- p5.Vector.sub(vC,vA));
- var sinAlpha = p5.Vector.mag(n) /
- (p5.Vector.mag(p5.Vector.sub(vB,vA))*
- p5.Vector.mag(p5.Vector.sub(vC,vA)));
- n = n.normalize();
- return n.mult(Math.asin(sinAlpha));
+ var vA = this.vertices[face[0]];
+ var vB = this.vertices[face[1]];
+ var vC = this.vertices[face[2]];
+ var ab = p5.Vector.sub(vB, vA);
+ var ac = p5.Vector.sub(vC, vA);
+ var n = p5.Vector.cross(ab, ac);
+ var ln = p5.Vector.mag(n);
+ var sinAlpha = ln / (p5.Vector.mag(ab) * p5.Vector.mag(ac));
+ if (sinAlpha === 0 || isNaN(sinAlpha)) {
+ console.warn(
+ 'p5.Geometry.prototype._getFaceNormal:',
+ 'face has colinear sides or a repeated vertex'
+ );
+ return n;
+ }
+ if (sinAlpha > 1) sinAlpha = 1; // handle float rounding error
+ return n.mult(Math.asin(sinAlpha) / ln);
};
/**
* computes smooth normals per vertex as an average of each
* face.
+ * @method computeNormals
* @chainable
*/
-p5.Geometry.prototype.computeNormals = function (){
- for(var v=0; v < this.vertices.length; v++){
- var normal = new p5.Vector();
- for(var i=0; i < this.faces.length; i++){
- //if our face contains a given vertex
- //calculate an average of the normals
- //of the triangles adjacent to that vertex
- if(this.faces[i][0] === v ||
- this.faces[i][1] === v ||
- this.faces[i][2] === v)
- {
- normal = normal.add(this._getFaceNormal(i, v));
- }
+p5.Geometry.prototype.computeNormals = function() {
+ var vertexNormals = this.vertexNormals;
+ var vertices = this.vertices;
+ var faces = this.faces;
+ var iv;
+
+ // initialize the vertexNormals array with empty vectors
+ vertexNormals.length = 0;
+ for (iv = 0; iv < vertices.length; ++iv) {
+ vertexNormals.push(new p5.Vector());
+ }
+
+ // loop through all the faces adding its normal to the normal
+ // of each of its vertices
+ for (var f = 0; f < faces.length; ++f) {
+ var face = faces[f];
+ var faceNormal = this._getFaceNormal(f);
+
+ // all three vertices get the normal added
+ for (var fv = 0; fv < 3; ++fv) {
+ var vertexIndex = face[fv];
+ vertexNormals[vertexIndex].add(faceNormal);
}
- normal = normal.normalize();
- this.vertexNormals.push(normal);
}
+
+ // normalize the normals
+ for (iv = 0; iv < vertices.length; ++iv) {
+ vertexNormals[iv].normalize();
+ }
+
return this;
};
/**
* Averages the vertex normals. Used in curved
* surfaces
+ * @method averageNormals
* @chainable
*/
p5.Geometry.prototype.averageNormals = function() {
-
- for(var i = 0; i <= this.detailY; i++){
+ for (var i = 0; i <= this.detailY; i++) {
var offset = this.detailX + 1;
- var temp = p5.Vector
- .add(this.vertexNormals[i*offset],
- this.vertexNormals[i*offset + this.detailX]);
+ var temp = p5.Vector.add(
+ this.vertexNormals[i * offset],
+ this.vertexNormals[i * offset + this.detailX]
+ );
+
temp = p5.Vector.div(temp, 2);
- this.vertexNormals[i*offset] = temp;
- this.vertexNormals[i*offset + this.detailX] = temp;
+ this.vertexNormals[i * offset] = temp;
+ this.vertexNormals[i * offset + this.detailX] = temp;
}
return this;
};
/**
* Averages pole normals. Used in spherical primitives
+ * @method averagePoleNormals
* @chainable
*/
p5.Geometry.prototype.averagePoleNormals = function() {
//average the north pole
var sum = new p5.Vector(0, 0, 0);
- for(var i = 0; i < this.detailX; i++){
+ for (var i = 0; i < this.detailX; i++) {
sum.add(this.vertexNormals[i]);
}
sum = p5.Vector.div(sum, this.detailX);
- for(i = 0; i < this.detailX; i++){
+ for (i = 0; i < this.detailX; i++) {
this.vertexNormals[i] = sum;
}
//average the south pole
sum = new p5.Vector(0, 0, 0);
- for(i = this.vertices.length - 1;
- i > this.vertices.length - 1 - this.detailX; i--){
+ for (
+ i = this.vertices.length - 1;
+ i > this.vertices.length - 1 - this.detailX;
+ i--
+ ) {
sum.add(this.vertexNormals[i]);
}
sum = p5.Vector.div(sum, this.detailX);
- for(i = this.vertices.length - 1;
- i > this.vertices.length - 1 - this.detailX; i--){
+ for (
+ i = this.vertices.length - 1;
+ i > this.vertices.length - 1 - this.detailX;
+ i--
+ ) {
this.vertexNormals[i] = sum;
}
return this;
@@ -67755,16 +77303,17 @@ p5.Geometry.prototype.averagePoleNormals = function() {
/**
* Create a 2D array for establishing stroke connections
- * @return {p5.Geometry}
+ * @private
+ * @chainable
*/
p5.Geometry.prototype._makeTriangleEdges = function() {
+ this.edges.length = 0;
if (Array.isArray(this.strokeIndices)) {
- for (var i=0, max=this.strokeIndices.length; i 0) {
+ if (this.vertices.length > 0) {
// Find the corners of our bounding box
var maxPosition = this.vertices[0].copy();
var minPosition = this.vertices[0].copy();
- for(var i = 0; i < this.vertices.length; i++) {
+ for (var i = 0; i < this.vertices.length; i++) {
maxPosition.x = Math.max(maxPosition.x, this.vertices[i].x);
minPosition.x = Math.min(minPosition.x, this.vertices[i].x);
maxPosition.y = Math.max(maxPosition.y, this.vertices[i].y);
@@ -67825,7 +77381,7 @@ p5.Geometry.prototype.normalize = function() {
var longestDist = Math.max(Math.max(dist.x, dist.y), dist.z);
var scale = 200 / longestDist;
- for(i = 0; i < this.vertices.length; i++) {
+ for (i = 0; i < this.vertices.length; i++) {
this.vertices[i].sub(center);
this.vertices[i].mult(scale);
}
@@ -67835,29 +77391,36 @@ p5.Geometry.prototype.normalize = function() {
module.exports = p5.Geometry;
-},{"../core/core":55}],103:[function(_dereq_,module,exports){
+},{"../core/main":25}],72:[function(_dereq_,module,exports){
/**
-* @requires constants
-* @todo see methods below needing further implementation.
-* future consideration: implement SIMD optimizations
-* when browser compatibility becomes available
-* https://developer.mozilla.org/en-US/docs/Web/JavaScript/
-* Reference/Global_Objects/SIMD
-*/
+ * @requires constants
+ * @todo see methods below needing further implementation.
+ * future consideration: implement SIMD optimizations
+ * when browser compatibility becomes available
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/
+ * Reference/Global_Objects/SIMD
+ */
'use strict';
-var p5 = _dereq_('../core/core');
-var polarGeometry = _dereq_('../math/polargeometry');
-var constants = _dereq_('../core/constants');
-var GLMAT_ARRAY_TYPE = (
- typeof Float32Array !== 'undefined') ?
- Float32Array : Array;
+var p5 = _dereq_('../core/main');
+
+var GLMAT_ARRAY_TYPE = Array;
+var isMatrixArray = function(x) {
+ return x instanceof Array;
+};
+if (typeof Float32Array !== 'undefined') {
+ GLMAT_ARRAY_TYPE = Float32Array;
+ isMatrixArray = function(x) {
+ return x instanceof Array || x instanceof Float32Array;
+ };
+}
/**
* A class to describe a 4x4 matrix
* for model and view matrix manipulation in the p5js webgl renderer.
- * class p5.Matrix
+ * @class p5.Matrix
+ * @private
* @constructor
* @param {Array} [mat4] array literal of our 4x4 matrix
*/
@@ -67866,47 +77429,23 @@ p5.Matrix = function() {
for (var i = 0; i < args.length; ++i) {
args[i] = arguments[i];
}
+
// This is default behavior when object
// instantiated using createMatrix()
// @todo implement createMatrix() in core/math.js
- if(args[0] instanceof p5) {
- // save reference to p5 if passed in
- this.p5 = args[0];
- if(args[1] === 'mat3'){
- this.mat3 = args[2] || new GLMAT_ARRAY_TYPE([
- 1, 0, 0,
- 0, 1, 0,
- 0, 0, 1
- ]);
- }
- else {
- this.mat4 = args[1] || new GLMAT_ARRAY_TYPE([
- 1, 0, 0, 0,
- 0, 1, 0, 0,
- 0, 0, 1, 0,
- 0, 0, 0, 1
- ]);
- }
- // default behavior when object
- // instantiated using new p5.Matrix()
+ if (args.length && args[args.length - 1] instanceof p5) {
+ this.p5 = args[args.length - 1];
+ }
+
+ if (args[0] === 'mat3') {
+ this.mat3 = Array.isArray(args[1])
+ ? args[1]
+ : new GLMAT_ARRAY_TYPE([1, 0, 0, 0, 1, 0, 0, 0, 1]);
} else {
- if(args[0] === 'mat3'){
- this.mat3 = args[1] || new GLMAT_ARRAY_TYPE([
- 1, 0, 0,
- 0, 1, 0,
- 0, 0, 1
- ]);
- }
- else {
- this.mat4 = args[0] || new GLMAT_ARRAY_TYPE([
- 1, 0, 0, 0,
- 0, 1, 0, 0,
- 0, 0, 1, 0,
- 0, 0, 0, 1
- ]);
- }
+ this.mat4 = Array.isArray(args[0])
+ ? args[0]
+ : new GLMAT_ARRAY_TYPE([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
}
- this.name = 'p5.Matrix'; // for friendly debugger system
return this;
};
@@ -67914,17 +77453,22 @@ p5.Matrix = function() {
* Sets the x, y, and z component of the vector using two or three separate
* variables, the data from a p5.Matrix, or the values from a float array.
*
- * @param {p5.Matrix|Float32Array|Array} [inMatrix] the input p5.Matrix or
+ * @method set
+ * @param {p5.Matrix|Float32Array|Number[]} [inMatrix] the input p5.Matrix or
* an Array of length 16
- * @param {Number} [n00..n33] 16 numbers passed by value to avoid
+ * @chainable
+ */
+/**
+ * @method set
+ * @param {Number[]} elements 16 numbers passed by value to avoid
* array copying.
* @chainable
*/
-p5.Matrix.prototype.set = function (inMatrix) {
+p5.Matrix.prototype.set = function(inMatrix) {
if (inMatrix instanceof p5.Matrix) {
this.mat4 = inMatrix.mat4;
return this;
- } else if (inMatrix instanceof GLMAT_ARRAY_TYPE) {
+ } else if (isMatrixArray(inMatrix)) {
this.mat4 = inMatrix;
return this;
} else if (arguments.length === 16) {
@@ -67951,18 +77495,20 @@ p5.Matrix.prototype.set = function (inMatrix) {
/**
* Gets a copy of the vector, returns a p5.Matrix object.
*
+ * @method get
* @return {p5.Matrix} the copy of the p5.Matrix object
*/
-p5.Matrix.prototype.get = function () {
- return new p5.Matrix(this.mat4);
+p5.Matrix.prototype.get = function() {
+ return new p5.Matrix(this.mat4, this.p5);
};
/**
* return a copy of a matrix
+ * @method copy
* @return {p5.Matrix} the result matrix
*/
-p5.Matrix.prototype.copy = function(){
- var copied = new p5.Matrix();
+p5.Matrix.prototype.copy = function() {
+ var copied = new p5.Matrix(this.p5);
copied.mat4[0] = this.mat4[0];
copied.mat4[1] = this.mat4[1];
copied.mat4[2] = this.mat4[2];
@@ -67984,20 +77530,23 @@ p5.Matrix.prototype.copy = function(){
/**
* return an identity matrix
+ * @method identity
* @return {p5.Matrix} the result matrix
*/
-p5.Matrix.identity = function(){
- return new p5.Matrix();
+p5.Matrix.identity = function(pInst) {
+ return new p5.Matrix(pInst);
};
/**
* transpose according to a given matrix
- * @param {p5.Matrix|Float32Array|Array} a the matrix to be based on to transpose
+ * @method transpose
+ * @param {p5.Matrix|Float32Array|Number[]} a the matrix to be
+ * based on to transpose
* @chainable
*/
-p5.Matrix.prototype.transpose = function(a){
+p5.Matrix.prototype.transpose = function(a) {
var a01, a02, a03, a12, a13, a23;
- if(a instanceof p5.Matrix){
+ if (a instanceof p5.Matrix) {
a01 = a.mat4[1];
a02 = a.mat4[2];
a03 = a.mat4[3];
@@ -68021,8 +77570,7 @@ p5.Matrix.prototype.transpose = function(a){
this.mat4[13] = a13;
this.mat4[14] = a23;
this.mat4[15] = a.mat4[15];
-
- }else if(a instanceof GLMAT_ARRAY_TYPE){
+ } else if (isMatrixArray(a)) {
a01 = a[1];
a02 = a[2];
a03 = a[3];
@@ -68052,13 +77600,15 @@ p5.Matrix.prototype.transpose = function(a){
/**
* invert matrix according to a give matrix
- * @param {p5.Matrix|Float32Array|Array} a the matrix to be based on to invert
+ * @method invert
+ * @param {p5.Matrix|Float32Array|Number[]} a the matrix to be
+ * based on to invert
* @chainable
*/
-p5.Matrix.prototype.invert = function(a){
- var a00, a01, a02, a03, a10, a11, a12, a13,
- a20, a21, a22, a23, a30, a31, a32, a33;
- if(a instanceof p5.Matrix){
+p5.Matrix.prototype.invert = function(a) {
+ var a00, a01, a02, a03, a10, a11, a12, a13;
+ var a20, a21, a22, a23, a30, a31, a32, a33;
+ if (a instanceof p5.Matrix) {
a00 = a.mat4[0];
a01 = a.mat4[1];
a02 = a.mat4[2];
@@ -68075,7 +77625,7 @@ p5.Matrix.prototype.invert = function(a){
a31 = a.mat4[13];
a32 = a.mat4[14];
a33 = a.mat4[15];
- }else if(a instanceof GLMAT_ARRAY_TYPE){
+ } else if (isMatrixArray(a)) {
a00 = a[0];
a01 = a[1];
a02 = a[2];
@@ -68093,22 +77643,22 @@ p5.Matrix.prototype.invert = function(a){
a32 = a[14];
a33 = a[15];
}
- var b00 = a00 * a11 - a01 * a10,
- b01 = a00 * a12 - a02 * a10,
- b02 = a00 * a13 - a03 * a10,
- b03 = a01 * a12 - a02 * a11,
- b04 = a01 * a13 - a03 * a11,
- b05 = a02 * a13 - a03 * a12,
- b06 = a20 * a31 - a21 * a30,
- b07 = a20 * a32 - a22 * a30,
- b08 = a20 * a33 - a23 * a30,
- b09 = a21 * a32 - a22 * a31,
- b10 = a21 * a33 - a23 * a31,
- b11 = a22 * a33 - a23 * a32,
+ var b00 = a00 * a11 - a01 * a10;
+ var b01 = a00 * a12 - a02 * a10;
+ var b02 = a00 * a13 - a03 * a10;
+ var b03 = a01 * a12 - a02 * a11;
+ var b04 = a01 * a13 - a03 * a11;
+ var b05 = a02 * a13 - a03 * a12;
+ var b06 = a20 * a31 - a21 * a30;
+ var b07 = a20 * a32 - a22 * a30;
+ var b08 = a20 * a33 - a23 * a30;
+ var b09 = a21 * a32 - a22 * a31;
+ var b10 = a21 * a33 - a23 * a31;
+ var b11 = a22 * a33 - a23 * a32;
// Calculate the determinant
- det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 -
- b04 * b07 + b05 * b06;
+ var det =
+ b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;
if (!det) {
return null;
@@ -68137,24 +77687,25 @@ p5.Matrix.prototype.invert = function(a){
/**
* Inverts a 3x3 matrix
+ * @method invert3x3
* @chainable
*/
-p5.Matrix.prototype.invert3x3 = function (){
- var a00 = this.mat3[0],
- a01 = this.mat3[1],
- a02 = this.mat3[2],
- a10 = this.mat3[3],
- a11 = this.mat3[4],
- a12 = this.mat3[5],
- a20 = this.mat3[6],
- a21 = this.mat3[7],
- a22 = this.mat3[8],
- b01 = a22 * a11 - a12 * a21,
- b11 = -a22 * a10 + a12 * a20,
- b21 = a21 * a10 - a11 * a20,
+p5.Matrix.prototype.invert3x3 = function() {
+ var a00 = this.mat3[0];
+ var a01 = this.mat3[1];
+ var a02 = this.mat3[2];
+ var a10 = this.mat3[3];
+ var a11 = this.mat3[4];
+ var a12 = this.mat3[5];
+ var a20 = this.mat3[6];
+ var a21 = this.mat3[7];
+ var a22 = this.mat3[8];
+ var b01 = a22 * a11 - a12 * a21;
+ var b11 = -a22 * a10 + a12 * a20;
+ var b21 = a21 * a10 - a11 * a20;
// Calculate the determinant
- det = a00 * b01 + a01 * b11 + a02 * b21;
+ var det = a00 * b01 + a01 * b11 + a02 * b21;
if (!det) {
return null;
}
@@ -68173,11 +77724,14 @@ p5.Matrix.prototype.invert3x3 = function (){
/**
* transposes a 3x3 p5.Matrix by a mat3
- * @param {[Number]} mat3 1-dimensional array
+ * @method transpose3x3
+ * @param {Number[]} mat3 1-dimensional array
* @chainable
*/
-p5.Matrix.prototype.transpose3x3 = function (mat3){
- var a01 = mat3[1], a02 = mat3[2], a12 = mat3[5];
+p5.Matrix.prototype.transpose3x3 = function(mat3) {
+ var a01 = mat3[1],
+ a02 = mat3[2],
+ a12 = mat3[5];
this.mat3[1] = mat3[3];
this.mat3[2] = mat3[6];
this.mat3[3] = a01;
@@ -68190,15 +77744,15 @@ p5.Matrix.prototype.transpose3x3 = function (mat3){
/**
* converts a 4x4 matrix to its 3x3 inverse tranform
* commonly used in MVMatrix to NMatrix conversions.
+ * @method invertTranspose
* @param {p5.Matrix} mat4 the matrix to be based on to invert
* @chainable
* @todo finish implementation
*/
-p5.Matrix.prototype.inverseTranspose = function (matrix){
- if(this.mat3 === undefined){
+p5.Matrix.prototype.inverseTranspose = function(matrix) {
+ if (this.mat3 === undefined) {
console.error('sorry, this function only works with mat3');
- }
- else {
+ } else {
//convert mat4 -> mat3
this.mat3[0] = matrix.mat4[0];
this.mat3[1] = matrix.mat4[1];
@@ -68211,168 +77765,164 @@ p5.Matrix.prototype.inverseTranspose = function (matrix){
this.mat3[8] = matrix.mat4[10];
}
- this.invert3x3().transpose3x3(this.mat3);
+ var inverse = this.invert3x3();
+ // check inverse succeded
+ if (inverse) {
+ inverse.transpose3x3(this.mat3);
+ } else {
+ // in case of singularity, just zero the matrix
+ for (var i = 0; i < 9; i++) {
+ this.mat3[i] = 0;
+ }
+ }
return this;
};
/**
* inspired by Toji's mat4 determinant
+ * @method determinant
* @return {Number} Determinant of our 4x4 matrix
*/
-p5.Matrix.prototype.determinant = function(){
- var d00 = (this.mat4[0] * this.mat4[5]) - (this.mat4[1] * this.mat4[4]),
- d01 = (this.mat4[0] * this.mat4[6]) - (this.mat4[2] * this.mat4[4]),
- d02 = (this.mat4[0] * this.mat4[7]) - (this.mat4[3] * this.mat4[4]),
- d03 = (this.mat4[1] * this.mat4[6]) - (this.mat4[2] * this.mat4[5]),
- d04 = (this.mat4[1] * this.mat4[7]) - (this.mat4[3] * this.mat4[5]),
- d05 = (this.mat4[2] * this.mat4[7]) - (this.mat4[3] * this.mat4[6]),
- d06 = (this.mat4[8] * this.mat4[13]) - (this.mat4[9] * this.mat4[12]),
- d07 = (this.mat4[8] * this.mat4[14]) - (this.mat4[10] * this.mat4[12]),
- d08 = (this.mat4[8] * this.mat4[15]) - (this.mat4[11] * this.mat4[12]),
- d09 = (this.mat4[9] * this.mat4[14]) - (this.mat4[10] * this.mat4[13]),
- d10 = (this.mat4[9] * this.mat4[15]) - (this.mat4[11] * this.mat4[13]),
- d11 = (this.mat4[10] * this.mat4[15]) - (this.mat4[11] * this.mat4[14]);
+p5.Matrix.prototype.determinant = function() {
+ var d00 = this.mat4[0] * this.mat4[5] - this.mat4[1] * this.mat4[4],
+ d01 = this.mat4[0] * this.mat4[6] - this.mat4[2] * this.mat4[4],
+ d02 = this.mat4[0] * this.mat4[7] - this.mat4[3] * this.mat4[4],
+ d03 = this.mat4[1] * this.mat4[6] - this.mat4[2] * this.mat4[5],
+ d04 = this.mat4[1] * this.mat4[7] - this.mat4[3] * this.mat4[5],
+ d05 = this.mat4[2] * this.mat4[7] - this.mat4[3] * this.mat4[6],
+ d06 = this.mat4[8] * this.mat4[13] - this.mat4[9] * this.mat4[12],
+ d07 = this.mat4[8] * this.mat4[14] - this.mat4[10] * this.mat4[12],
+ d08 = this.mat4[8] * this.mat4[15] - this.mat4[11] * this.mat4[12],
+ d09 = this.mat4[9] * this.mat4[14] - this.mat4[10] * this.mat4[13],
+ d10 = this.mat4[9] * this.mat4[15] - this.mat4[11] * this.mat4[13],
+ d11 = this.mat4[10] * this.mat4[15] - this.mat4[11] * this.mat4[14];
// Calculate the determinant
- return d00 * d11 - d01 * d10 + d02 * d09 +
- d03 * d08 - d04 * d07 + d05 * d06;
+ return d00 * d11 - d01 * d10 + d02 * d09 + d03 * d08 - d04 * d07 + d05 * d06;
};
/**
* multiply two mat4s
- * @param {p5.Matrix|Float32Array|Array} multMatrix The matrix
+ * @method mult
+ * @param {p5.Matrix|Float32Array|Number[]} multMatrix The matrix
* we want to multiply by
* @chainable
*/
-p5.Matrix.prototype.mult = function(multMatrix){
- var _dest = new GLMAT_ARRAY_TYPE(16);
- var _src = new GLMAT_ARRAY_TYPE(16);
+p5.Matrix.prototype.mult = function(multMatrix) {
+ var _src;
- if(multMatrix instanceof p5.Matrix) {
+ if (multMatrix === this || multMatrix === this.mat4) {
+ _src = this.copy().mat4; // only need to allocate in this rare case
+ } else if (multMatrix instanceof p5.Matrix) {
_src = multMatrix.mat4;
- }
- else if(multMatrix instanceof GLMAT_ARRAY_TYPE){
+ } else if (isMatrixArray(multMatrix)) {
_src = multMatrix;
+ } else {
+ return; // nothing to do.
}
// each row is used for the multiplier
- var b0 = this.mat4[0], b1 = this.mat4[1],
- b2 = this.mat4[2], b3 = this.mat4[3];
- _dest[0] = b0*_src[0] + b1*_src[4] + b2*_src[8] + b3*_src[12];
- _dest[1] = b0*_src[1] + b1*_src[5] + b2*_src[9] + b3*_src[13];
- _dest[2] = b0*_src[2] + b1*_src[6] + b2*_src[10] + b3*_src[14];
- _dest[3] = b0*_src[3] + b1*_src[7] + b2*_src[11] + b3*_src[15];
+ var b0 = this.mat4[0],
+ b1 = this.mat4[1],
+ b2 = this.mat4[2],
+ b3 = this.mat4[3];
+ this.mat4[0] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12];
+ this.mat4[1] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13];
+ this.mat4[2] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14];
+ this.mat4[3] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15];
b0 = this.mat4[4];
b1 = this.mat4[5];
b2 = this.mat4[6];
b3 = this.mat4[7];
- _dest[4] = b0*_src[0] + b1*_src[4] + b2*_src[8] + b3*_src[12];
- _dest[5] = b0*_src[1] + b1*_src[5] + b2*_src[9] + b3*_src[13];
- _dest[6] = b0*_src[2] + b1*_src[6] + b2*_src[10] + b3*_src[14];
- _dest[7] = b0*_src[3] + b1*_src[7] + b2*_src[11] + b3*_src[15];
+ this.mat4[4] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12];
+ this.mat4[5] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13];
+ this.mat4[6] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14];
+ this.mat4[7] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15];
b0 = this.mat4[8];
b1 = this.mat4[9];
b2 = this.mat4[10];
b3 = this.mat4[11];
- _dest[8] = b0*_src[0] + b1*_src[4] + b2*_src[8] + b3*_src[12];
- _dest[9] = b0*_src[1] + b1*_src[5] + b2*_src[9] + b3*_src[13];
- _dest[10] = b0*_src[2] + b1*_src[6] + b2*_src[10] + b3*_src[14];
- _dest[11] = b0*_src[3] + b1*_src[7] + b2*_src[11] + b3*_src[15];
+ this.mat4[8] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12];
+ this.mat4[9] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13];
+ this.mat4[10] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14];
+ this.mat4[11] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15];
b0 = this.mat4[12];
b1 = this.mat4[13];
b2 = this.mat4[14];
b3 = this.mat4[15];
- _dest[12] = b0*_src[0] + b1*_src[4] + b2*_src[8] + b3*_src[12];
- _dest[13] = b0*_src[1] + b1*_src[5] + b2*_src[9] + b3*_src[13];
- _dest[14] = b0*_src[2] + b1*_src[6] + b2*_src[10] + b3*_src[14];
- _dest[15] = b0*_src[3] + b1*_src[7] + b2*_src[11] + b3*_src[15];
-
- this.mat4 = _dest;
+ this.mat4[12] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12];
+ this.mat4[13] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13];
+ this.mat4[14] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14];
+ this.mat4[15] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15];
return this;
};
/**
* scales a p5.Matrix by scalars or a vector
- * @param {p5.Vector|Float32Array|Array} s vector to scale by
+ * @method scale
+ * @param {p5.Vector|Float32Array|Number[]} s vector to scale by
* @chainable
*/
-p5.Matrix.prototype.scale = function() {
- var x,y,z;
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- //if our 1st arg is a type p5.Vector
- if (args[0] instanceof p5.Vector){
- x = args[0].x;
- y = args[0].y;
- z = args[0].z;
- }
- //otherwise if it's an array
- else if (args[0] instanceof Array){
- x = args[0][0];
- y = args[0][1];
- z = args[0][2];
- }
- var _dest = new GLMAT_ARRAY_TYPE(16);
- _dest[0] = this.mat4[0] * x;
- _dest[1] = this.mat4[1] * x;
- _dest[2] = this.mat4[2] * x;
- _dest[3] = this.mat4[3] * x;
- _dest[4] = this.mat4[4] * y;
- _dest[5] = this.mat4[5] * y;
- _dest[6] = this.mat4[6] * y;
- _dest[7] = this.mat4[7] * y;
- _dest[8] = this.mat4[8] * z;
- _dest[9] = this.mat4[9] * z;
- _dest[10] = this.mat4[10] * z;
- _dest[11] = this.mat4[11] * z;
- _dest[12] = this.mat4[12];
- _dest[13] = this.mat4[13];
- _dest[14] = this.mat4[14];
- _dest[15] = this.mat4[15];
-
- this.mat4 = _dest;
+p5.Matrix.prototype.scale = function(x, y, z) {
+ if (x instanceof p5.Vector) {
+ // x is a vector, extract the components from it.
+ y = x.y;
+ z = x.z;
+ x = x.x; // must be last
+ } else if (x instanceof Array) {
+ // x is an array, extract the components from it.
+ y = x[1];
+ z = x[2];
+ x = x[0]; // must be last
+ }
+
+ this.mat4[0] *= x;
+ this.mat4[1] *= x;
+ this.mat4[2] *= x;
+ this.mat4[3] *= x;
+ this.mat4[4] *= y;
+ this.mat4[5] *= y;
+ this.mat4[6] *= y;
+ this.mat4[7] *= y;
+ this.mat4[8] *= z;
+ this.mat4[9] *= z;
+ this.mat4[10] *= z;
+ this.mat4[11] *= z;
+
return this;
};
/**
* rotate our Matrix around an axis by the given angle.
+ * @method rotate
* @param {Number} a The angle of rotation in radians
- * @param {p5.Vector|Array} axis the axis(es) to rotate around
+ * @param {p5.Vector|Number[]} axis the axis(es) to rotate around
* @chainable
* inspired by Toji's gl-matrix lib, mat4 rotation
*/
-p5.Matrix.prototype.rotate = function(a, axis){
- var x, y, z, _a, len;
+p5.Matrix.prototype.rotate = function(a, x, y, z) {
+ var _a = this.p5 ? this.p5._toRadians(a) : a;
- if (this.p5) {
- if (this.p5._angleMode === constants.DEGREES) {
- _a = polarGeometry.degreesToRadians(a);
- }
- }
- else {
- _a = a;
- }
- if (axis instanceof p5.Vector) {
- x = axis.x;
- y = axis.y;
- z = axis.z;
- }
- else if (axis instanceof Array) {
- x = axis[0];
- y = axis[1];
- z = axis[2];
+ if (x instanceof p5.Vector) {
+ // x is a vector, extract the components from it.
+ y = x.y;
+ z = x.z;
+ x = x.x; //must be last
+ } else if (x instanceof Array) {
+ // x is an array, extract the components from it.
+ y = x[1];
+ z = x[2];
+ x = x[0]; //must be last
}
- len = Math.sqrt(x * x + y * y + z * z);
- x *= (1/len);
- y *= (1/len);
- z *= (1/len);
+ var len = Math.sqrt(x * x + y * y + z * z);
+ x *= 1 / len;
+ y *= 1 / len;
+ z *= 1 / len;
var a00 = this.mat4[0];
var a01 = this.mat4[1];
@@ -68422,43 +77972,40 @@ p5.Matrix.prototype.rotate = function(a, axis){
/**
* @todo finish implementing this method!
* translates
+ * @method translate
* @param {Number[]} v vector to translate by
* @chainable
*/
-p5.Matrix.prototype.translate = function(v){
+p5.Matrix.prototype.translate = function(v) {
var x = v[0],
y = v[1],
z = v[2] || 0;
- this.mat4[12] +=
- this.mat4[0] * x +this.mat4[4] * y +this.mat4[8] * z;
- this.mat4[13] +=
- this.mat4[1] * x +this.mat4[5] * y +this.mat4[9] * z;
- this.mat4[14] +=
- this.mat4[2] * x +this.mat4[6] * y +this.mat4[10] * z;
- this.mat4[15] +=
- this.mat4[3] * x +this.mat4[7] * y +this.mat4[11] * z;
+ this.mat4[12] += this.mat4[0] * x + this.mat4[4] * y + this.mat4[8] * z;
+ this.mat4[13] += this.mat4[1] * x + this.mat4[5] * y + this.mat4[9] * z;
+ this.mat4[14] += this.mat4[2] * x + this.mat4[6] * y + this.mat4[10] * z;
+ this.mat4[15] += this.mat4[3] * x + this.mat4[7] * y + this.mat4[11] * z;
};
-p5.Matrix.prototype.rotateX = function(a){
- this.rotate(a, [1,0,0]);
+p5.Matrix.prototype.rotateX = function(a) {
+ this.rotate(a, 1, 0, 0);
};
-p5.Matrix.prototype.rotateY = function(a){
- this.rotate(a, [0,1,0]);
+p5.Matrix.prototype.rotateY = function(a) {
+ this.rotate(a, 0, 1, 0);
};
-p5.Matrix.prototype.rotateZ = function(a){
- this.rotate(a, [0,0,1]);
+p5.Matrix.prototype.rotateZ = function(a) {
+ this.rotate(a, 0, 0, 1);
};
/**
* sets the perspective matrix
+ * @method perspective
* @param {Number} fovy [description]
* @param {Number} aspect [description]
* @param {Number} near near clipping plane
* @param {Number} far far clipping plane
* @chainable
*/
-p5.Matrix.prototype.perspective = function(fovy,aspect,near,far){
-
+p5.Matrix.prototype.perspective = function(fovy, aspect, near, far) {
var f = 1.0 / Math.tan(fovy / 2),
nf = 1 / (near - far);
@@ -68476,15 +78023,15 @@ p5.Matrix.prototype.perspective = function(fovy,aspect,near,far){
this.mat4[11] = -1;
this.mat4[12] = 0;
this.mat4[13] = 0;
- this.mat4[14] = (2 * far * near) * nf;
+ this.mat4[14] = 2 * far * near * nf;
this.mat4[15] = 0;
return this;
-
};
/**
* sets the ortho matrix
+ * @method ortho
* @param {Number} left [description]
* @param {Number} right [description]
* @param {Number} bottom [description]
@@ -68493,8 +78040,7 @@ p5.Matrix.prototype.perspective = function(fovy,aspect,near,far){
* @param {Number} far far clipping plane
* @chainable
*/
-p5.Matrix.prototype.ortho = function(left,right,bottom,top,near,far){
-
+p5.Matrix.prototype.ortho = function(left, right, bottom, top, near, far) {
var lr = 1 / (left - right),
bt = 1 / (bottom - top),
nf = 1 / (near - far);
@@ -68566,12 +78112,12 @@ p5.Matrix.prototype.ortho = function(left,right,bottom,top,near,far){
module.exports = p5.Matrix;
-},{"../core/constants":54,"../core/core":55,"../math/polargeometry":87}],104:[function(_dereq_,module,exports){
+},{"../core/main":25}],73:[function(_dereq_,module,exports){
/**
* Welcome to RendererGL Immediate Mode.
* Immediate mode is used for drawing custom shapes
* from a set of vertices. Immediate Mode is activated
- * when you call beginShape() & de-activated when you call endShape().
+ * when you call beginShape() & de-activated when you call endShape().
* Immediate mode is a style of programming borrowed
* from OpenGL's (now-deprecated) immediate mode.
* It differs from p5.js' default, Retained Mode, which caches
@@ -68582,28 +78128,30 @@ module.exports = p5.Matrix;
*/
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
/**
* Begin shape drawing. This is a helpful way of generating
* custom shapes quickly. However in WEBGL mode, application
* performance will likely drop as a result of too many calls to
- * beginShape() / endShape(). As a high performance alternative,
+ * beginShape() / endShape(). As a high performance alternative,
* please use p5.js geometry primitives.
+ * @private
+ * @method beginShape
* @param {Number} mode webgl primitives mode. beginShape supports the
* following modes:
* POINTS,LINES,LINE_STRIP,LINE_LOOP,TRIANGLES,
* TRIANGLE_STRIP,and TRIANGLE_FAN.
* @chainable
*/
-p5.RendererGL.prototype.beginShape = function(mode){
+p5.RendererGL.prototype.beginShape = function(mode) {
//default shape mode is line_strip
- this.immediateMode.shapeMode = (mode !== undefined ) ?
- mode : constants.LINE_STRIP;
+ this.immediateMode.shapeMode =
+ mode !== undefined ? mode : constants.LINE_STRIP;
//if we haven't yet initialized our
//immediateMode vertices & buffers, create them now!
- if(this.immediateMode.vertices === undefined){
+ if (this.immediateMode.vertices === undefined) {
this.immediateMode.vertices = [];
this.immediateMode.edges = [];
this.immediateMode.lineVertices = [];
@@ -68615,6 +78163,10 @@ p5.RendererGL.prototype.beginShape = function(mode){
this.immediateMode.uvBuffer = this.GL.createBuffer();
this.immediateMode.lineVertexBuffer = this.GL.createBuffer();
this.immediateMode.lineNormalBuffer = this.GL.createBuffer();
+ this.immediateMode.pointVertexBuffer = this.GL.createBuffer();
+ this.immediateMode._bezierVertex = [];
+ this.immediateMode._quadraticVertex = [];
+ this.immediateMode._curveVertex = [];
} else {
this.immediateMode.vertices.length = 0;
this.immediateMode.edges.length = 0;
@@ -68628,18 +78180,18 @@ p5.RendererGL.prototype.beginShape = function(mode){
};
/**
* adds a vertex to be drawn in a custom Shape.
+ * @private
+ * @method vertex
* @param {Number} x x-coordinate of vertex
* @param {Number} y y-coordinate of vertex
* @param {Number} z z-coordinate of vertex
* @chainable
- * @TODO implement handling of p5.Vector args
+ * @TODO implement handling of p5.Vector args
*/
-p5.RendererGL.prototype.vertex = function(){
- var x, y, z, u, v;
+p5.RendererGL.prototype.vertex = function(x, y) {
+ var z, u, v;
// default to (x, y) mode: all other arugments assumed to be 0.
- x = arguments[0];
- y = arguments[1];
z = u = v = 0;
if (arguments.length === 3) {
@@ -68662,10 +78214,19 @@ p5.RendererGL.prototype.vertex = function(){
vertexColor[0],
vertexColor[1],
vertexColor[2],
- vertexColor[3]);
+ vertexColor[3]
+ );
this.immediateMode.uvCoords.push(u, v);
+ this.immediateMode._bezierVertex[0] = x;
+ this.immediateMode._bezierVertex[1] = y;
+ this.immediateMode._bezierVertex[2] = z;
+
+ this.immediateMode._quadraticVertex[0] = x;
+ this.immediateMode._quadraticVertex[1] = y;
+ this.immediateMode._quadraticVertex[2] = z;
+
return this;
};
@@ -68673,29 +78234,68 @@ p5.RendererGL.prototype.vertex = function(){
* End shape drawing and render vertices to screen.
* @chainable
*/
-p5.RendererGL.prototype.endShape =
-function(mode, isCurve, isBezier,isQuadratic, isContour, shapeKind){
- if (this.curFillShader === this._getColorShader()) {
- // this is the fill/stroke shader for retain mode.
- // must switch to immediate mode shader before drawing!
- this.setFillShader(this._getImmediateModeShader());
- // note that if we're using the texture shader...
- // this shouldn't change. :)
- }
- if(this.curStrokeShader.active === true) {
- for(var i=0; i 1) {
+ this._useImmediateModeShader();
+
+ if (this._doStroke && this.drawMode !== constants.TEXTURE) {
+ for (var i = 0; i < this.immediateMode.vertices.length - 1; i++) {
+ this.immediateMode.edges.push([i, i + 1]);
+ }
+ if (mode === constants.CLOSE) {
+ this.immediateMode.edges.push([
+ this.immediateMode.vertices.length - 1,
+ 0
+ ]);
}
+
+ p5.Geometry.prototype._edgesToVertices.call(this.immediateMode);
+ this._drawStrokeImmediateMode();
+ }
+
+ if (this._doFill) {
+ if (this.isBezier || this.isQuadratic || this.isCurve) {
+ var contours = [
+ new Float32Array(this._vToNArray(this.immediateMode.vertices))
+ ];
+ var polyTriangles = this._triangulate(contours);
+ this.immediateMode.vertices = [];
+ for (
+ var j = 0, polyTriLength = polyTriangles.length;
+ j < polyTriLength;
+ j = j + 3
+ ) {
+ this.vertex(
+ polyTriangles[j],
+ polyTriangles[j + 1],
+ polyTriangles[j + 2]
+ );
+ }
+ }
+ this._drawFillImmediateMode(
+ mode,
+ isCurve,
+ isBezier,
+ isQuadratic,
+ isContour,
+ shapeKind
+ );
}
- this._edgesToVertices(this.immediateMode);
- this._drawStrokeImmediateMode();
- }
- if(this.curFillShader.active === true) {
- this._drawFillImmediateMode(mode, isCurve, isBezier,isQuadratic,
- isContour, shapeKind);
}
//clear out our vertexPositions & colors arrays
//after rendering
@@ -68703,70 +78303,138 @@ function(mode, isCurve, isBezier,isQuadratic, isContour, shapeKind){
this.immediateMode.vertexColors.length = 0;
this.immediateMode.uvCoords.length = 0;
this.isImmediateDrawing = false;
+ this.isBezier = false;
+ this.isQuadratic = false;
+ this.isCurve = false;
+ this.immediateMode._bezierVertex.length = 0;
+ this.immediateMode._quadraticVertex.length = 0;
+
+ this.immediateMode._curveVertex.length = 0;
return this;
};
-p5.RendererGL.prototype._drawFillImmediateMode = function(mode, isCurve, isBezier,
- isQuadratic, isContour, shapeKind) {
+p5.RendererGL.prototype._drawFillImmediateMode = function(
+ mode,
+ isCurve,
+ isBezier,
+ isQuadratic,
+ isContour,
+ shapeKind
+) {
var gl = this.GL;
this.curFillShader.bindShader();
- //vertex position Attribute
- this._bindBuffer(this.immediateMode.vertexBuffer, gl.ARRAY_BUFFER,
- this._vToNArray(this.immediateMode.vertices), Float32Array, gl.DYNAMIC_DRAW);
- this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,
- 3, gl.FLOAT, false, 0, 0);
- if (this.drawMode === constants.FILL) {
- this._bindBuffer(this.immediateMode.colorBuffer, gl.ARRAY_BUFFER,
- this.immediateMode.vertexColors, Float32Array, gl.DYNAMIC_DRAW);
+
+ // initialize the fill shader's 'aPosition' buffer
+ if (this.curFillShader.attributes.aPosition) {
+ //vertex position Attribute
+ this._bindBuffer(
+ this.immediateMode.vertexBuffer,
+ gl.ARRAY_BUFFER,
+ this._vToNArray(this.immediateMode.vertices),
+ Float32Array,
+ gl.DYNAMIC_DRAW
+ );
+
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // initialize the fill shader's 'aVertexColor' buffer
+ if (
+ this.drawMode === constants.FILL &&
+ this.curFillShader.attributes.aVertexColor
+ ) {
+ this._bindBuffer(
+ this.immediateMode.colorBuffer,
+ gl.ARRAY_BUFFER,
+ this.immediateMode.vertexColors,
+ Float32Array,
+ gl.DYNAMIC_DRAW
+ );
+
this.curFillShader.enableAttrib(
this.curFillShader.attributes.aVertexColor.location,
- 4, gl.FLOAT, false, 0, 0);
+ 4,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
}
- if (this.drawMode === constants.TEXTURE){
+
+ // initialize the fill shader's 'aTexCoord' buffer
+ if (
+ this.drawMode === constants.TEXTURE &&
+ this.curFillShader.attributes.aTexCoord
+ ) {
//texture coordinate Attribute
- this._bindBuffer(this.immediateMode.uvBuffer, gl.ARRAY_BUFFER,
- this.immediateMode.uvCoords, Float32Array, gl.DYNAMIC_DRAW);
+ this._bindBuffer(
+ this.immediateMode.uvBuffer,
+ gl.ARRAY_BUFFER,
+ this.immediateMode.uvCoords,
+ Float32Array,
+ gl.DYNAMIC_DRAW
+ );
+
this.curFillShader.enableAttrib(
this.curFillShader.attributes.aTexCoord.location,
- 2, gl.FLOAT, false, 0, 0);
+ 2,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
}
- if(mode){
- if(this.drawMode === constants.FILL || this.drawMode === constants.TEXTURE){
- switch(this.immediateMode.shapeMode){
- case constants.LINE_STRIP:
- this.immediateMode.shapeMode = constants.TRIANGLE_FAN;
- break;
- case constants.LINES:
- this.immediateMode.shapeMode = constants.TRIANGLE_FAN;
- break;
- case constants.TRIANGLES:
- this.immediateMode.shapeMode = constants.TRIANGLE_FAN;
- break;
- }
- } else {
- switch(this.immediateMode.shapeMode){
- case constants.LINE_STRIP:
- this.immediateMode.shapeMode = constants.LINE_LOOP;
- break;
- case constants.LINES:
- this.immediateMode.shapeMode = constants.LINE_LOOP;
- break;
- }
+ //if (true || mode) {
+ if (this.drawMode === constants.FILL || this.drawMode === constants.TEXTURE) {
+ switch (this.immediateMode.shapeMode) {
+ case constants.LINE_STRIP:
+ case constants.LINES:
+ case constants.TRIANGLES:
+ this.immediateMode.shapeMode =
+ this.isBezier || this.isQuadratic || this.isCurve
+ ? constants.TRIANGLES
+ : constants.TRIANGLE_FAN;
+ break;
+ }
+ } else {
+ switch (this.immediateMode.shapeMode) {
+ case constants.LINE_STRIP:
+ case constants.LINES:
+ this.immediateMode.shapeMode = constants.LINE_LOOP;
+ break;
}
}
+ //}
//QUADS & QUAD_STRIP are not supported primitives modes
//in webgl.
- if(this.immediateMode.shapeMode === constants.QUADS ||
- this.immediateMode.shapeMode === constants.QUAD_STRIP){
- throw new Error('sorry, ' + this.immediateMode.shapeMode+
- ' not yet implemented in webgl mode.');
- }
- else {
+ if (
+ this.immediateMode.shapeMode === constants.QUADS ||
+ this.immediateMode.shapeMode === constants.QUAD_STRIP
+ ) {
+ throw new Error(
+ 'sorry, ' +
+ this.immediateMode.shapeMode +
+ ' not yet implemented in webgl mode.'
+ );
+ } else {
+ this._applyColorBlend(this.curFillColor);
gl.enable(gl.BLEND);
- gl.drawArrays(this.immediateMode.shapeMode, 0,
- this.immediateMode.vertices.length);
+ gl.drawArrays(
+ this.immediateMode.shapeMode,
+ 0,
+ this.immediateMode.vertices.length
+ );
+
+ this._pInst._pixelsDirty = true;
}
// todo / optimizations? leave bound until another shader is set?
this.curFillShader.unbindShader();
@@ -68775,210 +78443,454 @@ p5.RendererGL.prototype._drawFillImmediateMode = function(mode, isCurve, isBezie
p5.RendererGL.prototype._drawStrokeImmediateMode = function() {
var gl = this.GL;
this.curStrokeShader.bindShader();
- this._bindBuffer(this.immediateMode.lineVertexBuffer, gl.ARRAY_BUFFER,
- this._flatten(this.immediateMode.lineVertices), Float32Array, gl.STATIC_DRAW);
- this.curStrokeShader.enableAttrib(
- this.curStrokeShader.attributes.aPosition.location,
- 3, gl.FLOAT, false, 0, 0);
- this._bindBuffer(this.immediateMode.lineNormalBuffer, gl.ARRAY_BUFFER,
- this._flatten(this.immediateMode.lineNormals), Float32Array, gl.STATIC_DRAW);
- this.curStrokeShader.enableAttrib(
- this.curStrokeShader.attributes.aDirection.location,
- 4, gl.FLOAT, false, 0, 0);
- gl.drawArrays(gl.TRIANGLES, 0,
- this.immediateMode.lineVertices.length);
+
+ // initialize the stroke shader's 'aPosition' buffer
+ if (this.curStrokeShader.attributes.aPosition) {
+ this._bindBuffer(
+ this.immediateMode.lineVertexBuffer,
+ gl.ARRAY_BUFFER,
+ this._flatten(this.immediateMode.lineVertices),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curStrokeShader.enableAttrib(
+ this.curStrokeShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // initialize the stroke shader's 'aDirection' buffer
+ if (this.curStrokeShader.attributes.aDirection) {
+ this._bindBuffer(
+ this.immediateMode.lineNormalBuffer,
+ gl.ARRAY_BUFFER,
+ this._flatten(this.immediateMode.lineNormals),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+ this.curStrokeShader.enableAttrib(
+ this.curStrokeShader.attributes.aDirection.location,
+ 4,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ this._applyColorBlend(this.curStrokeColor);
+ gl.drawArrays(gl.TRIANGLES, 0, this.immediateMode.lineVertices.length);
+
// todo / optimizations? leave bound until another shader is set?
this.curStrokeShader.unbindShader();
+
+ this._pInst._pixelsDirty = true;
};
module.exports = p5.RendererGL;
-},{"../core/constants":54,"../core/core":55}],105:[function(_dereq_,module,exports){
+
+},{"../core/constants":19,"../core/main":25}],74:[function(_dereq_,module,exports){
//Retained Mode. The default mode for rendering 3D primitives
//in WEBGL.
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var hashCount = 0;
/**
* _initBufferDefaults
+ * @private
* @description initializes buffer defaults. runs each time a new geometry is
* registered
* @param {String} gId key of the geometry object
*/
p5.RendererGL.prototype._initBufferDefaults = function(gId) {
+ this._freeBuffers(gId);
+
//@TODO remove this limit on hashes in gHash
- hashCount ++;
- if(hashCount > 1000){
+ hashCount++;
+ if (hashCount > 1000) {
var key = Object.keys(this.gHash)[0];
delete this.gHash[key];
- hashCount --;
+ hashCount--;
}
- var gl = this.GL;
+
//create a new entry in our gHash
this.gHash[gId] = {};
- this.gHash[gId].vertexBuffer = gl.createBuffer();
- this.gHash[gId].normalBuffer = gl.createBuffer();
- this.gHash[gId].lineNormalBuffer = gl.createBuffer();
- this.gHash[gId].uvBuffer = gl.createBuffer();
- this.gHash[gId].indexBuffer = gl.createBuffer();
- this.gHash[gId].lineVertexBuffer = gl.createBuffer();
};
+p5.RendererGL.prototype._freeBuffers = function(gId) {
+ var geometry = this.gHash[gId];
+ if (!geometry) {
+ return;
+ }
+
+ delete this.gHash[gId];
+ hashCount--;
+
+ var gl = this.GL;
+ geometry.vertexBuffer && gl.deleteBuffer(geometry.vertexBuffer);
+ geometry.normalBuffer && gl.deleteBuffer(geometry.normalBuffer);
+ geometry.lineNormalBuffer && gl.deleteBuffer(geometry.lineNormalBuffer);
+ geometry.uvBuffer && gl.deleteBuffer(geometry.uvBuffer);
+ geometry.indexBuffer && gl.deleteBuffer(geometry.indexBuffer);
+ geometry.lineVertexBuffer && gl.deleteBuffer(geometry.lineVertexBuffer);
+};
/**
* createBuffers description
+ * @private
* @param {String} gId key of the geometry object
* @param {p5.Geometry} obj contains geometry data
*/
p5.RendererGL.prototype.createBuffers = function(gId, obj) {
var gl = this.GL;
- this._setDefaultCamera();
//initialize the gl buffers for our geom groups
this._initBufferDefaults(gId);
- this.gHash[gId].numberOfItems = obj.faces.length * 3;
- this.gHash[gId].lineVertexCount = obj.lineVertices.length;
+ var geometry = this.gHash[gId];
- if (this.curFillShader === this._getImmediateModeShader()) {
- // there are different immediate mode and retain mode color shaders.
- // if we're using the immediate mode one, we need to switch to
- // one that works for retain mode.
- this.setFillShader(this._getColorShader());
+ geometry.numberOfItems = obj.faces.length * 3;
+ geometry.lineVertexCount = obj.lineVertices.length;
+
+ this._useColorShader();
+
+ // initialize the stroke shader's 'aPosition' buffer, if used
+ if (this.curStrokeShader.attributes.aPosition) {
+ geometry.lineVertexBuffer = gl.createBuffer();
+
+ this._bindBuffer(
+ geometry.lineVertexBuffer,
+ gl.ARRAY_BUFFER,
+ this._flatten(obj.lineVertices),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curStrokeShader.enableAttrib(
+ this.curStrokeShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // initialize the stroke shader's 'aDirection' buffer, if used
+ if (this.curStrokeShader.attributes.aDirection) {
+ geometry.lineNormalBuffer = gl.createBuffer();
+
+ this._bindBuffer(
+ geometry.lineNormalBuffer,
+ gl.ARRAY_BUFFER,
+ this._flatten(obj.lineNormals),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curStrokeShader.enableAttrib(
+ this.curStrokeShader.attributes.aDirection.location,
+ 4,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // initialize the fill shader's 'aPosition' buffer, if used
+ if (this.curFillShader.attributes.aPosition) {
+ geometry.vertexBuffer = gl.createBuffer();
+
+ // allocate space for vertex positions
+ this._bindBuffer(
+ geometry.vertexBuffer,
+ gl.ARRAY_BUFFER,
+ this._vToNArray(obj.vertices),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
}
- this._bindBuffer(this.gHash[gId].lineVertexBuffer, gl.ARRAY_BUFFER,
- this._flatten(obj.lineVertices), Float32Array, gl.STATIC_DRAW);
- this.curStrokeShader.enableAttrib(
- this.curStrokeShader.attributes.aPosition.location,
- 3, gl.FLOAT, false, 0, 0);
- this._bindBuffer(this.gHash[gId].lineNormalBuffer, gl.ARRAY_BUFFER,
- this._flatten(obj.lineNormals), Float32Array, gl.STATIC_DRAW);
- this.curStrokeShader.enableAttrib(
- this.curStrokeShader.attributes.aDirection.location,
- 4, gl.FLOAT, false, 0, 0);
- // allocate space for vertex positions
- this._bindBuffer(this.gHash[gId].vertexBuffer, gl.ARRAY_BUFFER,
- this._vToNArray(obj.vertices), Float32Array, gl.STATIC_DRAW);
- this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,
- 3, gl.FLOAT, false, 0, 0);
+
// allocate space for faces
- this._bindBuffer( this.gHash[gId].indexBuffer, gl.ELEMENT_ARRAY_BUFFER,
- this._flatten(obj.faces), Uint16Array, gl.STATIC_DRAW);
- // allocate space for normals
- this._bindBuffer(this.gHash[gId].normalBuffer, gl.ARRAY_BUFFER,
- this._vToNArray(obj.vertexNormals), Float32Array, gl.STATIC_DRAW);
- this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,
- 3, gl.FLOAT, false, 0, 0);
- // tex coords
- this._bindBuffer(this.gHash[gId].uvBuffer, gl.ARRAY_BUFFER,
- this._flatten(obj.uvs), Float32Array, gl.STATIC_DRAW);
- this.curFillShader.enableAttrib(this.curFillShader.attributes.aTexCoord.location,
- 2, gl.FLOAT, false, 0, 0);
+ geometry.indexBuffer = gl.createBuffer();
+ this._bindBuffer(
+ geometry.indexBuffer,
+ gl.ELEMENT_ARRAY_BUFFER,
+ this._flatten(obj.faces),
+ Uint16Array,
+ gl.STATIC_DRAW
+ );
+
+ // initialize the fill shader's 'aNormal' buffer, if used
+ if (this.curFillShader.attributes.aNormal) {
+ geometry.normalBuffer = gl.createBuffer();
+
+ // allocate space for normals
+ this._bindBuffer(
+ geometry.normalBuffer,
+ gl.ARRAY_BUFFER,
+ this._vToNArray(obj.vertexNormals),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aNormal.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // initialize the fill shader's 'aTexCoord' buffer, if used
+ if (this.curFillShader.attributes.aTexCoord) {
+ geometry.uvBuffer = gl.createBuffer();
+
+ // tex coords
+ this._bindBuffer(
+ geometry.uvBuffer,
+ gl.ARRAY_BUFFER,
+ this._flatten(obj.uvs),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aTexCoord.location,
+ 2,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
//}
+ return geometry;
};
/**
* Draws buffers given a geometry key ID
+ * @private
* @param {String} gId ID in our geom hash
* @chainable
*/
p5.RendererGL.prototype.drawBuffers = function(gId) {
- this._setDefaultCamera();
var gl = this.GL;
- if (this.curFillShader === this._getImmediateModeShader()) {
- // looking at the code within the glsl files, I'm not really
- // sure why these are two different shaders. but, they are,
- // and if we're drawing in retain mode but the shader is the
- // immediate mode one, we need to switch.
- this.setFillShader(this._getColorShader());
- }
- if(this.curStrokeShader.active !== false &&
- this.gHash[gId].lineVertexCount > 0) {
+ this._useColorShader();
+ var geometry = this.gHash[gId];
+
+ if (this._doStroke && geometry.lineVertexCount > 0) {
this.curStrokeShader.bindShader();
- this._bindBuffer(this.gHash[gId].lineVertexBuffer, gl.ARRAY_BUFFER);
- this.curStrokeShader.enableAttrib(
- this.curStrokeShader.attributes.aPosition.location,
- 3, gl.FLOAT, false, 0, 0);
- this._bindBuffer(this.gHash[gId].lineNormalBuffer, gl.ARRAY_BUFFER);
- this.curStrokeShader.enableAttrib(
- this.curStrokeShader.attributes.aDirection.location,
- 4, gl.FLOAT, false, 0, 0);
+
+ // bind the stroke shader's 'aPosition' buffer
+ if (geometry.lineVertexBuffer) {
+ this._bindBuffer(geometry.lineVertexBuffer, gl.ARRAY_BUFFER);
+ this.curStrokeShader.enableAttrib(
+ this.curStrokeShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // bind the stroke shader's 'aDirection' buffer
+ if (geometry.lineNormalBuffer) {
+ this._bindBuffer(geometry.lineNormalBuffer, gl.ARRAY_BUFFER);
+ this.curStrokeShader.enableAttrib(
+ this.curStrokeShader.attributes.aDirection.location,
+ 4,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ this._applyColorBlend(this.curStrokeColor);
this._drawArrays(gl.TRIANGLES, gId);
this.curStrokeShader.unbindShader();
}
- if(this.curFillShader.active !== false) {
+
+ if (this._doFill !== false) {
this.curFillShader.bindShader();
- //vertex position buffer
- this._bindBuffer(this.gHash[gId].vertexBuffer, gl.ARRAY_BUFFER);
- this.curFillShader.enableAttrib(
- this.curFillShader.attributes.aPosition.location,
- 3, gl.FLOAT, false, 0, 0);
- //vertex index buffer
- this._bindBuffer(this.gHash[gId].indexBuffer, gl.ELEMENT_ARRAY_BUFFER);
-
- this._bindBuffer(this.gHash[gId].normalBuffer, gl.ARRAY_BUFFER);
- this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,
- 3, gl.FLOAT, false, 0, 0);
- // uv buffer
- this._bindBuffer(this.gHash[gId].uvBuffer, gl.ARRAY_BUFFER);
- this.curFillShader.enableAttrib(
- this.curFillShader.attributes.aTexCoord.location, 2, gl.FLOAT, false, 0, 0);
+
+ // bind the fill shader's 'aPosition' buffer
+ if (geometry.vertexBuffer) {
+ //vertex position buffer
+ this._bindBuffer(geometry.vertexBuffer, gl.ARRAY_BUFFER);
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ if (geometry.indexBuffer) {
+ //vertex index buffer
+ this._bindBuffer(geometry.indexBuffer, gl.ELEMENT_ARRAY_BUFFER);
+ }
+
+ // bind the fill shader's 'aNormal' buffer
+ if (geometry.normalBuffer) {
+ this._bindBuffer(geometry.normalBuffer, gl.ARRAY_BUFFER);
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aNormal.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ // bind the fill shader's 'aTexCoord' buffer
+ if (geometry.uvBuffer) {
+ // uv buffer
+ this._bindBuffer(geometry.uvBuffer, gl.ARRAY_BUFFER);
+ this.curFillShader.enableAttrib(
+ this.curFillShader.attributes.aTexCoord.location,
+ 2,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+ }
+
+ this._applyColorBlend(this.curFillColor);
this._drawElements(gl.TRIANGLES, gId);
this.curFillShader.unbindShader();
}
return this;
};
+/**
+ * Calls drawBuffers() with a scaled model/view matrix.
+ *
+ * This is used by various 3d primitive methods (in primitives.js, eg. plane,
+ * box, torus, etc...) to allow caching of un-scaled geometries. Those
+ * geometries are generally created with unit-length dimensions, cached as
+ * such, and then scaled appropriately in this method prior to rendering.
+ *
+ * @private
+ * @method drawBuffersScaled
+ * @param {String} gId ID in our geom hash
+ * @param {Number} scaleX the amount to scale in the X direction
+ * @param {Number} scaleY the amount to scale in the Y direction
+ * @param {Number} scaleZ the amount to scale in the Z direction
+ */
+p5.RendererGL.prototype.drawBuffersScaled = function(
+ gId,
+ scaleX,
+ scaleY,
+ scaleZ
+) {
+ var uMVMatrix = this.uMVMatrix.copy();
+ try {
+ this.uMVMatrix.scale(scaleX, scaleY, scaleZ);
+ this.drawBuffers(gId);
+ } finally {
+ this.uMVMatrix = uMVMatrix;
+ }
+};
+
p5.RendererGL.prototype._drawArrays = function(drawMode, gId) {
this.GL.drawArrays(drawMode, 0, this.gHash[gId].lineVertexCount);
+ this._pInst._pixelsDirty = true;
return this;
};
-p5.RendererGL.prototype._drawElements = function (drawMode, gId) {
+p5.RendererGL.prototype._drawElements = function(drawMode, gId) {
this.GL.drawElements(
- drawMode, this.gHash[gId].numberOfItems,
- this.GL.UNSIGNED_SHORT, 0);
+ drawMode,
+ this.gHash[gId].numberOfItems,
+ this.GL.UNSIGNED_SHORT,
+ 0
+ );
+ this._pInst._pixelsDirty = true;
+};
+
+p5.RendererGL.prototype._drawPoints = function(vertices, vertexBuffer) {
+ var gl = this.GL;
+
+ this._bindBuffer(
+ vertexBuffer,
+ gl.ARRAY_BUFFER,
+ this._vToNArray(vertices),
+ Float32Array,
+ gl.STATIC_DRAW
+ );
+
+ this.curPointShader.enableAttrib(
+ this.curPointShader.attributes.aPosition.location,
+ 3,
+ gl.FLOAT,
+ false,
+ 0,
+ 0
+ );
+
+ gl.drawArrays(gl.Points, 0, vertices.length);
};
module.exports = p5.RendererGL;
-},{"../core/core":55}],106:[function(_dereq_,module,exports){
+},{"../core/main":25}],75:[function(_dereq_,module,exports){
'use strict';
-var p5 = _dereq_('../core/core');
+var p5 = _dereq_('../core/main');
var constants = _dereq_('../core/constants');
+var libtess = _dereq_('libtess');
_dereq_('./p5.Shader');
+_dereq_('./p5.Camera');
_dereq_('../core/p5.Renderer');
_dereq_('./p5.Matrix');
-var uMVMatrixStack = [];
-var cameraMatrixStack = [];
-
var defaultShaders = {
- immediateVert:
- "attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform float uResolution;\nuniform float uPointSize;\n\nvarying vec4 vColor;\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n gl_PointSize = uPointSize;\n}\n",
- vertexColorVert:
- "attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nvarying vec4 vColor;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n}\n",
- vertexColorFrag:
- "precision mediump float;\nvarying vec4 vColor;\nvoid main(void) {\n gl_FragColor = vColor;\n}",
- normalVert:
- "attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\n\nvarying vec3 vVertexNormal;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vVertexNormal = vec3( uNormalMatrix * aNormal );\n vVertTexCoord = aTexCoord;\n}\n",
- normalFrag:
- "precision mediump float;\nvarying vec3 vVertexNormal;\nvoid main(void) {\n gl_FragColor = vec4(vVertexNormal, 1.0);\n}",
- basicFrag:
- "precision mediump float;\nvarying vec3 vVertexNormal;\nuniform vec4 uMaterialColor;\nvoid main(void) {\n gl_FragColor = uMaterialColor;\n}",
- lightVert:
- "attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\nuniform int uAmbientLightCount;\nuniform int uDirectionalLightCount;\nuniform int uPointLightCount;\n\nuniform vec3 uAmbientColor[8];\nuniform vec3 uLightingDirection[8];\nuniform vec3 uDirectionalColor[8];\nuniform vec3 uPointLightLocation[8];\nuniform vec3 uPointLightColor[8];\nuniform bool uSpecular;\n\nvarying vec3 vVertexNormal;\nvarying vec2 vVertTexCoord;\nvarying vec3 vLightWeighting;\n\nvec3 ambientLightFactor = vec3(0.0, 0.0, 0.0);\nvec3 directionalLightFactor = vec3(0.0, 0.0, 0.0);\nvec3 pointLightFactor = vec3(0.0, 0.0, 0.0);\nvec3 pointLightFactor2 = vec3(0.0, 0.0, 0.0);\n\nvoid main(void){\n\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n\n vec3 vertexNormal = vec3( uNormalMatrix * aNormal );\n vVertexNormal = vertexNormal;\n vVertTexCoord = aTexCoord;\n\n vec4 mvPosition = uModelViewMatrix * vec4(aPosition, 1.0);\n vec3 eyeDirection = normalize(-mvPosition.xyz);\n\n float shininess = 32.0;\n float specularFactor = 2.0;\n float diffuseFactor = 0.3;\n\n for(int i = 0; i < 8; i++){\n if(uAmbientLightCount == i) break;\n ambientLightFactor += uAmbientColor[i];\n }\n\n for(int j = 0; j < 8; j++){\n if(uDirectionalLightCount == j) break;\n vec3 dir = uLightingDirection[j];\n float directionalLightWeighting = max(dot(vertexNormal, dir), 0.0);\n directionalLightFactor += uDirectionalColor[j] * directionalLightWeighting;\n }\n\n for(int k = 0; k < 8; k++){\n if(uPointLightCount == k) break;\n vec3 loc = uPointLightLocation[k];\n vec3 lightDirection = normalize(loc - mvPosition.xyz);\n\n float directionalLightWeighting = max(dot(vertexNormal, lightDirection), 0.0);\n pointLightFactor += uPointLightColor[k] * directionalLightWeighting;\n\n //factor2 for specular\n vec3 reflectionDirection = reflect(-lightDirection, vertexNormal);\n float specularLightWeighting = pow(max(dot(reflectionDirection, eyeDirection), 0.0), shininess);\n\n pointLightFactor2 += uPointLightColor[k] * (specularFactor * specularLightWeighting\n + directionalLightWeighting * diffuseFactor);\n }\n\n if(!uSpecular){\n vLightWeighting = ambientLightFactor + directionalLightFactor + pointLightFactor;\n }else{\n vLightWeighting = ambientLightFactor + directionalLightFactor + pointLightFactor2;\n }\n\n}\n",
- lightTextureFrag:
- "precision mediump float;\n\nuniform vec4 uMaterialColor;\nuniform sampler2D uSampler;\nuniform bool isTexture;\nuniform bool uUseLighting;\n\nvarying vec3 vLightWeighting;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n if(!isTexture){\n gl_FragColor = vec4(vec3(uMaterialColor.rgb * vLightWeighting), uMaterialColor.a);\n }else{\n vec4 textureColor = texture2D(uSampler, vVertTexCoord);\n if(!uUseLighting){\n gl_FragColor = textureColor;\n }else{\n gl_FragColor = vec4(vec3(textureColor.rgb * vLightWeighting), textureColor.a);\n }\n }\n}",
- lineVert:
- "uniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nuniform vec4 uViewport;\n\nuniform float uStrokeWeight;\n\nattribute vec4 aPosition;\nattribute vec4 aDirection;\n\n\nvec3 clipToWindow(vec4 clip, vec4 viewport) {\n vec3 post_div = clip.xyz / clip.w;\n vec2 xypos = (post_div.xy + vec2(1.0, 1.0)) * 0.5 * viewport.zw;\n return vec3(xypos, post_div.z * 0.5 + 0.5);\n}\n\nvec4 windowToClipVector(vec2 window, vec4 viewport, float clip_w) {\n vec2 xypos = (window / viewport.zw) * 2.0;\n return vec4(xypos, 0.0, 0.0) * clip_w;\n}\n\nvoid main() {\n vec4 posMV = uModelViewMatrix * aPosition;\n posMV.xyz = posMV.xyz * vec3(0.999,0.999,0.999);\n vec4 clipp = uProjectionMatrix * posMV;\n float displace = aDirection.w;\n\n vec4 posq = uModelViewMatrix * vec4(aDirection.xyz, 0.0);\n posq.xyz = posq.xyz * vec3(0.999,0.999,0.999);\n vec4 clipq = uProjectionMatrix * posq;\n clipq.w = 1.0;\n\n vec3 window_p = clipToWindow(clipp, uViewport);\n vec3 window_q = clipToWindow(clipq, uViewport);\n vec3 tangent = window_q - window_p;\n vec2 perp = normalize(vec2(-tangent.y, tangent.x));\n float halfStroke = uStrokeWeight/2.0;\n vec2 offset = vec2(halfStroke,halfStroke) * displace * perp;\n gl_Position.xy = clipp.xy + offset.xy;\n gl_Position.zw = clipp.zw;\n}\n",
- lineFrag:
- "precision mediump float;\nprecision mediump int;\n\nuniform vec4 uMaterialColor;\n\nvoid main() {\n gl_FragColor = uMaterialColor;\n}"
+ immediateVert: "attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform float uResolution;\nuniform float uPointSize;\n\nvarying vec4 vColor;\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n gl_PointSize = uPointSize;\n}\n",
+ vertexColorVert: "attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nvarying vec4 vColor;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n}\n",
+ vertexColorFrag: "precision mediump float;\nvarying vec4 vColor;\nvoid main(void) {\n gl_FragColor = vColor;\n}",
+ normalVert: "attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\n\nvarying vec3 vVertexNormal;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vVertexNormal = normalize(vec3( uNormalMatrix * aNormal ));\n vVertTexCoord = aTexCoord;\n}\n",
+ normalFrag: "precision mediump float;\nvarying vec3 vVertexNormal;\nvoid main(void) {\n gl_FragColor = vec4(vVertexNormal, 1.0);\n}",
+ basicFrag: "precision mediump float;\nvarying vec3 vVertexNormal;\nuniform vec4 uMaterialColor;\nvoid main(void) {\n gl_FragColor = uMaterialColor;\n}",
+ lightVert: "attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uViewMatrix;\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\nuniform int uAmbientLightCount;\nuniform int uDirectionalLightCount;\nuniform int uPointLightCount;\n\nuniform vec3 uAmbientColor[8];\nuniform vec3 uLightingDirection[8];\nuniform vec3 uDirectionalColor[8];\nuniform vec3 uPointLightLocation[8];\nuniform vec3 uPointLightColor[8];\nuniform bool uSpecular;\n\nvarying vec3 vVertexNormal;\nvarying vec2 vVertTexCoord;\nvarying vec3 vLightWeighting;\n\nvoid main(void){\n\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n\n vec3 vertexNormal = normalize(vec3( uNormalMatrix * aNormal ));\n vVertexNormal = vertexNormal;\n vVertTexCoord = aTexCoord;\n\n vec4 mvPosition = uModelViewMatrix * vec4(aPosition, 1.0);\n vec3 eyeDirection = normalize(-mvPosition.xyz);\n\n float shininess = 32.0;\n float specularFactor = 2.0;\n float diffuseFactor = 0.3;\n\n vec3 ambientLightFactor = vec3(0.0);\n\n for (int i = 0; i < 8; i++) {\n if (uAmbientLightCount == i) break;\n ambientLightFactor += uAmbientColor[i];\n }\n\n\n vec3 directionalLightFactor = vec3(0.0);\n\n for (int j = 0; j < 8; j++) {\n if (uDirectionalLightCount == j) break;\n vec3 dir = uLightingDirection[j];\n float directionalLightWeighting = max(dot(vertexNormal, -dir), 0.0);\n directionalLightFactor += uDirectionalColor[j] * directionalLightWeighting;\n }\n\n\n vec3 pointLightFactor = vec3(0.0);\n\n for (int k = 0; k < 8; k++) {\n if (uPointLightCount == k) break;\n vec3 loc = (uViewMatrix * vec4(uPointLightLocation[k], 1.0)).xyz;\n vec3 lightDirection = normalize(loc - mvPosition.xyz);\n\n float directionalLightWeighting = max(dot(vertexNormal, lightDirection), 0.0);\n\n float specularLightWeighting = 0.0;\n if (uSpecular ){\n vec3 reflectionDirection = reflect(-lightDirection, vertexNormal);\n specularLightWeighting = pow(max(dot(reflectionDirection, eyeDirection), 0.0), shininess);\n }\n\n pointLightFactor += uPointLightColor[k] * (specularFactor * specularLightWeighting\n + directionalLightWeighting * diffuseFactor);\n }\n\n vLightWeighting = ambientLightFactor + directionalLightFactor + pointLightFactor;\n}\n",
+ lightTextureFrag: "precision mediump float;\n\nuniform vec4 uMaterialColor;\nuniform sampler2D uSampler;\nuniform bool isTexture;\nuniform bool uUseLighting;\n\nvarying vec3 vLightWeighting;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n gl_FragColor = isTexture ? texture2D(uSampler, vVertTexCoord) : uMaterialColor;\n if (uUseLighting)\n gl_FragColor.rgb *= vLightWeighting;\n}",
+ phongVert: "precision mediump float;\n\nattribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform vec3 uAmbientColor[8];\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\nuniform int uAmbientLightCount;\n\nvarying vec3 vNormal;\nvarying vec2 vTexCoord;\nvarying vec3 vViewPosition;\nvarying vec3 vAmbientColor;\n\nvoid main(void){\n\n vec4 viewModelPosition = uModelViewMatrix * vec4(aPosition, 1.0);\n\n // Pass varyings to fragment shader\n vViewPosition = viewModelPosition.xyz;\n gl_Position = uProjectionMatrix * viewModelPosition; \n\n vNormal = normalize(uNormalMatrix * normalize(aNormal));\n vTexCoord = aTexCoord;\n\n vAmbientColor = vec3(0.0);\n for (int i = 0; i < 8; i++) {\n if (uAmbientLightCount == i) break;\n vAmbientColor += uAmbientColor[i];\n }\n}\n",
+ phongFrag: "precision mediump float;\n\n//uniform mat4 uModelViewMatrix;\nuniform mat4 uViewMatrix;\n\nuniform vec4 uMaterialColor;\nuniform sampler2D uSampler;\nuniform bool isTexture;\nuniform bool uUseLighting;\n\nuniform vec3 uLightingDirection[8];\nuniform vec3 uDirectionalColor[8];\nuniform vec3 uPointLightLocation[8];\nuniform vec3 uPointLightColor[8];\nuniform bool uSpecular;\n\nuniform int uDirectionalLightCount;\nuniform int uPointLightCount;\n\nvarying vec3 vNormal;\nvarying vec2 vTexCoord;\nvarying vec3 vViewPosition;\nvarying vec3 vAmbientColor;\n\nvec3 V;\nvec3 N;\n\nconst float shininess = 32.0;\nconst float specularFactor = 2.0;\nconst float diffuseFactor = 0.73;\n\nstruct LightResult {\n\tfloat specular;\n\tfloat diffuse;\n};\n\nfloat phongSpecular(\n vec3 lightDirection,\n vec3 viewDirection,\n vec3 surfaceNormal,\n float shininess) {\n\n vec3 R = normalize(reflect(-lightDirection, surfaceNormal)); \n return pow(max(0.0, dot(R, viewDirection)), shininess);\n}\n\nfloat lambertDiffuse(\n vec3 lightDirection,\n vec3 surfaceNormal) {\n return max(0.0, dot(-lightDirection, surfaceNormal));\n}\n\nLightResult light(vec3 lightVector) {\n\n vec3 L = normalize(lightVector);\n\n //compute our diffuse & specular terms\n LightResult lr;\n if (uSpecular)\n lr.specular = phongSpecular(L, V, N, shininess);\n lr.diffuse = lambertDiffuse(L, N);\n return lr;\n}\n\nvoid main(void) {\n\n V = normalize(vViewPosition);\n N = vNormal;\n\n vec3 diffuse = vec3(0.0);\n float specular = 0.0;\n\n for (int j = 0; j < 8; j++) {\n if (uDirectionalLightCount == j) break;\n\n LightResult result = light(uLightingDirection[j]);\n diffuse += result.diffuse * uDirectionalColor[j];\n specular += result.specular;\n }\n\n for (int k = 0; k < 8; k++) {\n if (uPointLightCount == k) break;\n\n vec3 lightPosition = (uViewMatrix * vec4(uPointLightLocation[k], 1.0)).xyz;\n vec3 lightVector = vViewPosition - lightPosition;\n\t\n //calculate attenuation\n float lightDistance = length(lightVector);\n float falloff = 500.0 / (lightDistance + 500.0);\n\n LightResult result = light(lightVector);\n diffuse += result.diffuse * falloff * uPointLightColor[k];\n specular += result.specular * falloff;\n }\n\n gl_FragColor = isTexture ? texture2D(uSampler, vTexCoord) : uMaterialColor;\n gl_FragColor.rgb = gl_FragColor.rgb * (diffuse * diffuseFactor + vAmbientColor) + specular * specularFactor;\n}",
+ fontVert: "precision mediump float;\n\nattribute vec3 aPosition;\nattribute vec2 aTexCoord;\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nuniform vec4 uGlyphRect;\nuniform float uGlyphOffset;\n\nvarying vec2 vTexCoord;\nvarying float w;\n\nvoid main() {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n\n // scale by the size of the glyph's rectangle\n positionVec4.xy *= uGlyphRect.zw - uGlyphRect.xy;\n\n // move to the corner of the glyph\n positionVec4.xy += uGlyphRect.xy;\n\n // move to the letter's line offset\n positionVec4.x += uGlyphOffset;\n \n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vTexCoord = aTexCoord;\n w = gl_Position.w;\n}\n",
+ fontFrag: "#extension GL_OES_standard_derivatives : enable\nprecision mediump float;\n\n#if 0\n // simulate integer math using floats\n\t#define int float\n\t#define ivec2 vec2\n\t#define INT(x) float(x)\n\n\tint ifloor(float v) { return floor(v); }\n\tivec2 ifloor(vec2 v) { return floor(v); }\n\n#else\n // use native integer math\n\tprecision mediump int;\n\t#define INT(x) x\n\n\tint ifloor(float v) { return int(v); }\n\tint ifloor(int v) { return v; }\n\tivec2 ifloor(vec2 v) { return ivec2(v); }\n\n#endif\n\nuniform sampler2D uSamplerStrokes;\nuniform sampler2D uSamplerRowStrokes;\nuniform sampler2D uSamplerRows;\nuniform sampler2D uSamplerColStrokes;\nuniform sampler2D uSamplerCols;\n\nuniform ivec2 uStrokeImageSize;\nuniform ivec2 uCellsImageSize;\nuniform ivec2 uGridImageSize;\n\nuniform ivec2 uGridOffset;\nuniform ivec2 uGridSize;\nuniform vec4 uMaterialColor;\n\nvarying vec2 vTexCoord;\n\n// some helper functions\nint round(float v) { return ifloor(v + 0.5); }\nivec2 round(vec2 v) { return ifloor(v + 0.5); }\nfloat saturate(float v) { return clamp(v, 0.0, 1.0); }\nvec2 saturate(vec2 v) { return clamp(v, 0.0, 1.0); }\n\nint mul(float v1, int v2) {\n return ifloor(v1 * float(v2));\n}\n\nivec2 mul(vec2 v1, ivec2 v2) {\n return ifloor(v1 * vec2(v2) + 0.5);\n}\n\n// unpack a 16-bit integer from a float vec2\nint getInt16(vec2 v) {\n ivec2 iv = round(v * 255.0);\n return iv.x * INT(128) + iv.y;\n}\n\nvec2 pixelScale;\nvec2 coverage = vec2(0.0);\nvec2 weight = vec2(0.5);\nconst float minDistance = 1.0/8192.0;\nconst float hardness = 1.05; // amount of antialias\n\n// the maximum number of curves in a glyph\nconst int N = INT(250);\n\n// retrieves an indexed pixel from a sampler\nvec4 getTexel(sampler2D sampler, int pos, ivec2 size) {\n int width = size.x;\n int y = ifloor(pos / width);\n int x = pos - y * width; // pos % width\n\n return texture2D(sampler, (vec2(x, y) + 0.5) / vec2(size));\n}\n\nvoid calulateCrossings(vec2 p0, vec2 p1, vec2 p2, out vec2 C1, out vec2 C2) {\n\n // get the coefficients of the quadratic in t\n vec2 a = p0 - p1 * 2.0 + p2;\n vec2 b = p0 - p1;\n vec2 c = p0 - vTexCoord;\n\n // found out which values of 't' it crosses the axes\n vec2 surd = sqrt(max(vec2(0.0), b * b - a * c));\n vec2 t1 = ((b - surd) / a).yx;\n vec2 t2 = ((b + surd) / a).yx;\n\n // approximate straight lines to avoid rounding errors\n if (abs(a.y) < 0.001)\n t1.x = t2.x = c.y / (2.0 * b.y);\n\n if (abs(a.x) < 0.001)\n t1.y = t2.y = c.x / (2.0 * b.x);\n\n // plug into quadratic formula to find the corrdinates of the crossings\n C1 = ((a * t1 - b * 2.0) * t1 + c) * pixelScale;\n C2 = ((a * t2 - b * 2.0) * t2 + c) * pixelScale;\n}\n\nvoid coverageX(vec2 p0, vec2 p1, vec2 p2) {\n\n vec2 C1, C2;\n calulateCrossings(p0, p1, p2, C1, C2);\n\n // determine on which side of the x-axis the points lie\n bool y0 = p0.y > vTexCoord.y;\n bool y1 = p1.y > vTexCoord.y;\n bool y2 = p2.y > vTexCoord.y;\n\n // could web be under the curve (after t1)?\n if (y1 ? !y2 : y0) {\n // add the coverage for t1\n coverage.x += saturate(C1.x + 0.5);\n // calculate the anti-aliasing for t1\n weight.x = min(weight.x, abs(C1.x));\n }\n\n // are we outside the curve (after t2)?\n if (y1 ? !y0 : y2) {\n // subtract the coverage for t2\n coverage.x -= saturate(C2.x + 0.5);\n // calculate the anti-aliasing for t2\n weight.x = min(weight.x, abs(C2.x));\n }\n}\n\n// this is essentially the same as coverageX, but with the axes swapped\nvoid coverageY(vec2 p0, vec2 p1, vec2 p2) {\n\n vec2 C1, C2;\n calulateCrossings(p0, p1, p2, C1, C2);\n\n bool x0 = p0.x > vTexCoord.x;\n bool x1 = p1.x > vTexCoord.x;\n bool x2 = p2.x > vTexCoord.x;\n\n if (x1 ? !x2 : x0) {\n coverage.y -= saturate(C1.y + 0.5);\n weight.y = min(weight.y, abs(C1.y));\n }\n\n if (x1 ? !x0 : x2) {\n coverage.y += saturate(C2.y + 0.5);\n weight.y = min(weight.y, abs(C2.y));\n }\n}\n\nvoid main() {\n\n // calculate the pixel scale based on screen-coordinates\n pixelScale = hardness / fwidth(vTexCoord);\n\n // which grid cell is this pixel in?\n ivec2 gridCoord = ifloor(vTexCoord * vec2(uGridSize));\n\n // intersect curves in this row\n {\n // the index into the row info bitmap\n int rowIndex = gridCoord.y + uGridOffset.y;\n // fetch the info texel\n vec4 rowInfo = getTexel(uSamplerRows, rowIndex, uGridImageSize);\n // unpack the rowInfo\n int rowStrokeIndex = getInt16(rowInfo.xy);\n int rowStrokeCount = getInt16(rowInfo.zw);\n\n for (int iRowStroke = INT(0); iRowStroke < N; iRowStroke++) {\n if (iRowStroke >= rowStrokeCount)\n break;\n\n // each stroke is made up of 3 points: the start and control point\n // and the start of the next curve.\n // fetch the indices of this pair of strokes:\n vec4 strokeIndices = getTexel(uSamplerRowStrokes, rowStrokeIndex++, uCellsImageSize);\n\n // unpack the stroke index\n int strokePos = getInt16(strokeIndices.xy);\n\n // fetch the two strokes\n vec4 stroke0 = getTexel(uSamplerStrokes, strokePos + INT(0), uStrokeImageSize);\n vec4 stroke1 = getTexel(uSamplerStrokes, strokePos + INT(1), uStrokeImageSize);\n\n // calculate the coverage\n coverageX(stroke0.xy, stroke0.zw, stroke1.xy);\n }\n }\n\n // intersect curves in this column\n {\n int colIndex = gridCoord.x + uGridOffset.x;\n vec4 colInfo = getTexel(uSamplerCols, colIndex, uGridImageSize);\n int colStrokeIndex = getInt16(colInfo.xy);\n int colStrokeCount = getInt16(colInfo.zw);\n \n for (int iColStroke = INT(0); iColStroke < N; iColStroke++) {\n if (iColStroke >= colStrokeCount)\n break;\n\n vec4 strokeIndices = getTexel(uSamplerColStrokes, colStrokeIndex++, uCellsImageSize);\n\n int strokePos = getInt16(strokeIndices.xy);\n vec4 stroke0 = getTexel(uSamplerStrokes, strokePos + INT(0), uStrokeImageSize);\n vec4 stroke1 = getTexel(uSamplerStrokes, strokePos + INT(1), uStrokeImageSize);\n coverageY(stroke0.xy, stroke0.zw, stroke1.xy);\n }\n }\n\n weight = saturate(1.0 - weight * 2.0);\n float distance = max(weight.x + weight.y, minDistance); // manhattan approx.\n float antialias = abs(dot(coverage, weight) / distance);\n float cover = min(abs(coverage.x), abs(coverage.y));\n gl_FragColor = uMaterialColor;\n gl_FragColor.a *= saturate(max(antialias, cover));\n}",
+ lineVert: "/*\n Part of the Processing project - http://processing.org\n Copyright (c) 2012-15 The Processing Foundation\n Copyright (c) 2004-12 Ben Fry and Casey Reas\n Copyright (c) 2001-04 Massachusetts Institute of Technology\n This library is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation, version 2.1.\n This library is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n Lesser General Public License for more details.\n You should have received a copy of the GNU Lesser General\n Public License along with this library; if not, write to the\n Free Software Foundation, Inc., 59 Temple Place, Suite 330,\n Boston, MA 02111-1307 USA\n*/\n\n#define PROCESSING_LINE_SHADER\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform float uStrokeWeight;\n\nuniform vec4 uViewport;\n\n// using a scale <1 moves the lines towards the camera\n// in order to prevent popping effects due to half of\n// the line disappearing behind the geometry faces.\nvec3 scale = vec3(0.9995);\n\nattribute vec4 aPosition;\nattribute vec4 aDirection;\n \nvoid main() {\n vec4 posp = uModelViewMatrix * aPosition;\n vec4 posq = uModelViewMatrix * (aPosition + vec4(aDirection.xyz, 0));\n\n // Moving vertices slightly toward the camera\n // to avoid depth-fighting with the fill triangles.\n // Discussed here:\n // http://www.opengl.org/discussion_boards/ubbthreads.php?ubb=showflat&Number=252848 \n posp.xyz = posp.xyz * scale;\n posq.xyz = posq.xyz * scale;\n\n vec4 p = uProjectionMatrix * posp;\n vec4 q = uProjectionMatrix * posq;\n\n // formula to convert from clip space (range -1..1) to screen space (range 0..[width or height])\n // screen_p = (p.xy/p.w + <1,1>) * 0.5 * uViewport.zw\n\n // prevent division by W by transforming the tangent formula (div by 0 causes\n // the line to disappear, see https://github.com/processing/processing/issues/5183)\n // t = screen_q - screen_p\n //\n // tangent is normalized and we don't care which aDirection it points to (+-)\n // t = +- normalize( screen_q - screen_p )\n // t = +- normalize( (q.xy/q.w+<1,1>)*0.5*uViewport.zw - (p.xy/p.w+<1,1>)*0.5*uViewport.zw )\n //\n // extract common factor, <1,1> - <1,1> cancels out\n // t = +- normalize( (q.xy/q.w - p.xy/p.w) * 0.5 * uViewport.zw )\n //\n // convert to common divisor\n // t = +- normalize( ((q.xy*p.w - p.xy*q.w) / (p.w*q.w)) * 0.5 * uViewport.zw )\n //\n // remove the common scalar divisor/factor, not needed due to normalize and +-\n // (keep uViewport - can't remove because it has different components for x and y\n // and corrects for aspect ratio, see https://github.com/processing/processing/issues/5181)\n // t = +- normalize( (q.xy*p.w - p.xy*q.w) * uViewport.zw )\n\n vec2 tangent = normalize((q.xy*p.w - p.xy*q.w) * uViewport.zw);\n\n // flip tangent to normal (it's already normalized)\n vec2 normal = vec2(-tangent.y, tangent.x);\n\n float thickness = aDirection.w * uStrokeWeight;\n vec2 offset = normal * thickness / 2.0;\n\n // Perspective ---\n // convert from world to clip by multiplying with projection scaling factor\n // to get the right thickness (see https://github.com/processing/processing/issues/5182)\n // invert Y, projections in Processing invert Y\n vec2 perspScale = (uProjectionMatrix * vec4(1, -1, 0, 0)).xy;\n\n // No Perspective ---\n // multiply by W (to cancel out division by W later in the pipeline) and\n // convert from screen to clip (derived from clip to screen above)\n vec2 noPerspScale = p.w / (0.5 * uViewport.zw);\n\n //gl_Position.xy = p.xy + offset.xy * mix(noPerspScale, perspScale, float(perspective > 0));\n gl_Position.xy = p.xy + offset.xy * perspScale;\n gl_Position.zw = p.zw;\n}\n",
+ lineFrag: "precision mediump float;\nprecision mediump int;\n\nuniform vec4 uMaterialColor;\n\nvoid main() {\n gl_FragColor = uMaterialColor;\n}",
+ pointVert: "attribute vec3 aPosition;\nuniform float uPointSize;\nvarying float vStrokeWeight;\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nvoid main() {\n\tvec4 positionVec4 = vec4(aPosition, 1.0);\n\tgl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n\tgl_PointSize = uPointSize;\n\tvStrokeWeight = uPointSize;\n}",
+ pointFrag: "precision mediump float;\nprecision mediump int;\nuniform vec4 uMaterialColor;\nvarying float vStrokeWeight;\n\nvoid main(){\n\tfloat mask = 0.0;\n\n\t// make a circular mask using the gl_PointCoord (goes from 0 - 1 on a point)\n // might be able to get a nicer edge on big strokeweights with smoothstep but slightly less performant\n\n\tmask = step(0.98, length(gl_PointCoord * 2.0 - 1.0));\n\n\t// if strokeWeight is 1 or less lets just draw a square\n\t// this prevents weird artifacting from carving circles when our points are really small\n\t// if strokeWeight is larger than 1, we just use it as is\n\n\tmask = mix(0.0, mask, clamp(floor(vStrokeWeight - 0.5),0.0,1.0));\n\n\t// throw away the borders of the mask\n // otherwise we get weird alpha blending issues\n\n\tif(mask > 0.98){\n discard;\n \t}\n\n \tgl_FragColor = vec4(uMaterialColor.rgb * (1.0 - mask), uMaterialColor.a) ;\n}"
};
/**
* 3D graphics class
+ * @private
* @class p5.RendererGL
* @constructor
* @extends p5.Renderer
@@ -68990,47 +78902,44 @@ p5.RendererGL = function(elt, pInst, isMainCanvas, attr) {
p5.Renderer.call(this, elt, pInst, isMainCanvas);
this.attributes = {};
attr = attr || {};
- this.attributes.alpha = attr.alpha ===
- undefined ? true : attr.alpha;
- this.attributes.depth = attr.depth ===
- undefined ? true : attr.depth;
- this.attributes.stencil = attr.stencil ===
- undefined ? true : attr.stencil;
- this.attributes.antialias = attr.antialias ===
- undefined ? false : attr.antialias;
- this.attributes.premultipliedAlpha = attr.premultipliedAlpha ===
- undefined ? false : attr.premultipliedAlpha;
- this.attributes.preserveDrawingBuffer = attr.preserveDrawingBuffer ===
- undefined ? true : attr.preserveDrawingBuffer;
+ this.attributes.alpha = attr.alpha === undefined ? true : attr.alpha;
+ this.attributes.depth = attr.depth === undefined ? true : attr.depth;
+ this.attributes.stencil = attr.stencil === undefined ? true : attr.stencil;
+ this.attributes.antialias =
+ attr.antialias === undefined ? false : attr.antialias;
+ this.attributes.premultipliedAlpha =
+ attr.premultipliedAlpha === undefined ? false : attr.premultipliedAlpha;
+ this.attributes.preserveDrawingBuffer =
+ attr.preserveDrawingBuffer === undefined
+ ? true
+ : attr.preserveDrawingBuffer;
+ this.attributes.perPixelLighting =
+ attr.perPixelLighting === undefined ? false : attr.perPixelLighting;
this._initContext();
this.isP3D = true; //lets us know we're in 3d mode
this.GL = this.drawingContext;
+
// lights
- this.ambientLightCount = 0;
- this.directionalLightCount = 0;
- this.pointLightCount = 0;
+
+ this.ambientLightColors = [];
+ this.directionalLightDirections = [];
+ this.directionalLightColors = [];
+
+ this.pointLightPositions = [];
+ this.pointLightColors = [];
/**
* model view, projection, & normal
* matrices
*/
this.uMVMatrix = new p5.Matrix();
- this.uPMatrix = new p5.Matrix();
+ this.uPMatrix = new p5.Matrix();
this.uNMatrix = new p5.Matrix('mat3');
// Camera
- this._curCamera = null;
- // default camera settings, then use those to populate camera fields.
- this._computeCameraDefaultSettings();
- this.cameraFOV = this.defaultCameraFOV;
- this.cameraAspect = this.defaultAspect;
- this.cameraX = this.defaultCameraX;
- this.cameraY = this.defaultCameraY;
- this.cameraZ = this.defaultCameraZ;
- this.cameraNear = this.defaultCameraNear;
- this.cameraFar = this.defaultCameraFar;
- this.cameraMatrix = new p5.Matrix();
- this.camera(); // set default camera matrices
+ this._curCamera = new p5.Camera(this);
+ this._curCamera._computeCameraDefaultSettings();
+ this._curCamera._setDefaultCamera();
//Geometry & Material hashes
this.gHash = {};
@@ -69039,12 +78948,17 @@ p5.RendererGL = function(elt, pInst, isMainCanvas, attr) {
this._defaultImmediateModeShader = undefined;
this._defaultNormalShader = undefined;
this._defaultColorShader = undefined;
+ this._defaultPointShader = undefined;
- this.curFillShader = {};
- this.curStrokeShader = {};
+ this.curFillShader = undefined;
+ this.curStrokeShader = undefined;
+ this.curPointShader = undefined;
- this.setFillShader(this._getColorShader());
+ this._useColorShader();
this.setStrokeShader(this._getLineShader());
+ this._usePointShader();
+
+ this._pointVertexBuffer = this.GL.createBuffer();
//Imediate Mode
//default drawing is done in Retained Mode
@@ -69055,15 +78969,27 @@ p5.RendererGL = function(elt, pInst, isMainCanvas, attr) {
// default shader has been set.
this.fill(255, 255, 255, 255);
//this.stroke(0, 0, 0, 255);
- this.pointSize = 5.0;//default point size
- this.curStrokeWeight = 2; //default stroke weight
- this.curStrokeColor = [0,0,0,1];
- this._setStrokeWeight();
- this._setStrokeColor();
+ this.pointSize = 5.0; //default point size
+ this.strokeWeight(1);
+ this.stroke(0, 0, 0);
// array of textures created in this gl context via this.getTexture(src)
this.textures = [];
- this.name = 'p5.RendererGL'; // for friendly debugger system
+ this._curveTightness = 6;
+
+ // lookUpTable for coefficients needed to be calculated for bezierVertex, same are used for curveVertex
+ this._lookUpTableBezier = [];
+ // lookUpTable for coefficients needed to be calculated for quadraticVertex
+ this._lookUpTableQuadratic = [];
+
+ // current curveDetail in the Bezier lookUpTable
+ this._lutBezierDetail = 0;
+ // current curveDetail in the Quadratic lookUpTable
+ this._lutQuadraticDetail = 0;
+
+ this._tessy = this._initTessy();
+
+ this.fontInfos = {};
return this;
};
@@ -69075,7 +79001,8 @@ p5.RendererGL.prototype = Object.create(p5.Renderer.prototype);
p5.RendererGL.prototype._initContext = function() {
try {
- this.drawingContext = this.canvas.getContext('webgl', this.attributes) ||
+ this.drawingContext =
+ this.canvas.getContext('webgl', this.attributes) ||
this.canvas.getContext('experimental-webgl', this.attributes);
if (this.drawingContext === null) {
throw new Error('Error creating webgl context');
@@ -69085,9 +79012,12 @@ p5.RendererGL.prototype._initContext = function() {
gl.enable(gl.DEPTH_TEST);
gl.depthFunc(gl.LEQUAL);
gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
+ this._viewport = this.drawingContext.getParameter(
+ this.drawingContext.VIEWPORT
+ );
}
} catch (er) {
- throw new Error(er);
+ throw er;
}
};
@@ -69099,7 +79029,7 @@ p5.RendererGL.prototype._resetContext = function(attr, options, callback) {
var h = this.height;
var defaultId = this.canvas.id;
var c = this.canvas;
- if(c){
+ if (c) {
c.parentNode.removeChild(c);
}
c = document.createElement('canvas');
@@ -69110,12 +79040,14 @@ p5.RendererGL.prototype._resetContext = function(attr, options, callback) {
document.body.appendChild(c);
}
this._pInst.canvas = c;
- this._pInst._setProperty('_renderer', new p5.RendererGL(this._pInst.canvas,
- this._pInst, true, attr));
- this._pInst._renderer.resize(w, h);
- this._pInst._renderer._applyDefaults();
- this._pInst._elements.push(this._renderer);
- if(typeof callback === 'function') {
+
+ var renderer = new p5.RendererGL(this._pInst.canvas, this._pInst, true, attr);
+ this._pInst._setProperty('_renderer', renderer);
+ renderer.resize(w, h);
+ renderer._applyDefaults();
+ this._pInst._elements.push(renderer);
+
+ if (typeof callback === 'function') {
//setTimeout with 0 forces the task to the back of the queue, this ensures that
//we finish switching out the renderer
setTimeout(function() {
@@ -69123,10 +79055,12 @@ p5.RendererGL.prototype._resetContext = function(attr, options, callback) {
}, 0);
}
};
-
-
/**
- *
+ * @module Rendering
+ * @submodule Rendering
+ * @for p5
+ */
+/**
* Set attributes for the WebGL Drawing context.
* This is a way of adjusting ways that the WebGL
* renderer works to fine-tune the display and performance.
@@ -69154,23 +79088,31 @@ p5.RendererGL.prototype._resetContext = function(attr, options, callback) {
* (note that p5 clears automatically on draw loop)
* default is true
*
- *
+ * perPixelLighting - if true, per-pixel lighting will be used in the
+ * lighting shader.
+ * default is false
+ *
+ * @method setAttributes
+ * @for p5
+ * @param {String} key Name of attribute
+ * @param {Boolean} value New value of named attribute
+ * @example
*
*
- * function setup() {
- * createCanvas(150,150,WEBGL);
- * }
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * }
*
- * function draw() {
+ * function draw() {
* background(255);
* push();
* rotateZ(frameCount * 0.02);
* rotateX(frameCount * 0.02);
* rotateY(frameCount * 0.02);
- * fill(0,0,0);
+ * fill(0, 0, 0);
* box(50);
* pop();
- * }
+ * }
*
*
*
@@ -69178,98 +79120,134 @@ p5.RendererGL.prototype._resetContext = function(attr, options, callback) {
*
*
*
- * function setup() {
- * createCanvas(150,150,WEBGL);
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
* setAttributes('antialias', true);
- * }
+ * }
*
- * function draw() {
+ * function draw() {
* background(255);
* push();
* rotateZ(frameCount * 0.02);
* rotateX(frameCount * 0.02);
* rotateY(frameCount * 0.02);
- * fill(0,0,0);
+ * fill(0, 0, 0);
* box(50);
* pop();
- * }
+ * }
*
*
*
- * @method setAttributes
- * @param {String|Object} String name of attribute or object with key-value pairs
- * @param {Boolean} New value of named attribute
+ *
+ *
+ * // press the mouse button to enable perPixelLighting
+ * function setup() {
+ * createCanvas(100, 100, WEBGL);
+ * noStroke();
+ * fill(255);
+ * }
+ *
+ * var lights = [
+ * { c: '#f00', t: 1.12, p: 1.91, r: 0.2 },
+ * { c: '#0f0', t: 1.21, p: 1.31, r: 0.2 },
+ * { c: '#00f', t: 1.37, p: 1.57, r: 0.2 },
+ * { c: '#ff0', t: 1.12, p: 1.91, r: 0.7 },
+ * { c: '#0ff', t: 1.21, p: 1.31, r: 0.7 },
+ * { c: '#f0f', t: 1.37, p: 1.57, r: 0.7 }
+ * ];
+ *
+ * function draw() {
+ * var t = millis() / 1000 + 1000;
+ * background(0);
+ * directionalLight(color('#222'), 1, 1, 1);
+ *
+ * for (var i = 0; i < lights.length; i++) {
+ * var light = lights[i];
+ * pointLight(
+ * color(light.c),
+ * p5.Vector.fromAngles(t * light.t, t * light.p, width * light.r)
+ * );
+ * }
+ *
+ * specularMaterial(255);
+ * sphere(width * 0.1);
*
+ * rotateX(t * 0.77);
+ * rotateY(t * 0.83);
+ * rotateZ(t * 0.91);
+ * torus(width * 0.3, width * 0.07, 30, 10);
+ * }
+ *
+ * function mousePressed() {
+ * setAttributes('perPixelLighting', true);
+ * noStroke();
+ * fill(255);
+ * }
+ * function mouseReleased() {
+ * setAttributes('perPixelLighting', false);
+ * noStroke();
+ * fill(255);
+ * }
+ *
+ *
+ *
+ * @alt a rotating cube with smoother edges
+ */
+/**
+ * @method setAttributes
+ * @for p5
+ * @param {Object} obj object with key-value pairs
*/
-p5.prototype.setAttributes = function() {
+p5.prototype.setAttributes = function(key, value) {
+ this._assert3d('setAttributes');
//@todo_FES
- var attr = {};
- if(arguments.length === 2) {
- attr[arguments[0]] = arguments[1];
- }
- else if (arguments.length === 1) {
- attr = arguments[0];
- }
+ var attr;
+ if (typeof value !== 'undefined') {
+ attr = {};
+ attr[key] = value;
+ } else if (key instanceof Object) {
+ attr = key;
+ }
+ this.push();
this._renderer._resetContext(attr);
+ this.pop();
};
-p5.RendererGL.prototype._computeCameraDefaultSettings = function () {
- this.defaultCameraFOV = 60 / 180 * Math.PI;
- this.defaultCameraAspect = this.width / this.height;
- this.defaultCameraX = 0;
- this.defaultCameraY = 0;
- this.defaultCameraZ =
- (this.height / 2.0) / Math.tan(this.defaultCameraFOV / 2.0);
- this.defaultCameraNear = this.defaultCameraZ * 0.1;
- this.defaultCameraFar = this.defaultCameraZ * 10;
-};
-
-//detect if user didn't set the camera
-//then call this function below
-p5.RendererGL.prototype._setDefaultCamera = function(){
- if(this._curCamera === null){
-
- this._computeCameraDefaultSettings();
- this.cameraFOV = this.defaultCameraFOV;
- this.cameraAspect = this.defaultAspect;
- this.cameraX = this.defaultCameraX;
- this.cameraY = this.defaultCameraY;
- this.cameraZ = this.defaultCameraZ;
- this.cameraNear = this.defaultCameraNear;
- this.cameraFar = this.defaultCameraFar;
-
- this.perspective();
- this.camera();
- this._curCamera = 'default';
- }
-};
+/**
+ * @class p5.RendererGL
+ */
p5.RendererGL.prototype._update = function() {
// reset model view and apply initial camera transform
// (containing only look at info; no projection).
- this.uMVMatrix.set(this.cameraMatrix.mat4[0],
- this.cameraMatrix.mat4[1],
- this.cameraMatrix.mat4[2],
- this.cameraMatrix.mat4[3],
- this.cameraMatrix.mat4[4],
- this.cameraMatrix.mat4[5],
- this.cameraMatrix.mat4[6],
- this.cameraMatrix.mat4[7],
- this.cameraMatrix.mat4[8],
- this.cameraMatrix.mat4[9],
- this.cameraMatrix.mat4[10],
- this.cameraMatrix.mat4[11],
- this.cameraMatrix.mat4[12],
- this.cameraMatrix.mat4[13],
- this.cameraMatrix.mat4[14],
- this.cameraMatrix.mat4[15]
- );
-
- // reset light counters for new frame.
- this.ambientLightCount = 0;
- this.directionalLightCount = 0;
- this.pointLightCount = 0;
+ this.uMVMatrix.set(
+ this._curCamera.cameraMatrix.mat4[0],
+ this._curCamera.cameraMatrix.mat4[1],
+ this._curCamera.cameraMatrix.mat4[2],
+ this._curCamera.cameraMatrix.mat4[3],
+ this._curCamera.cameraMatrix.mat4[4],
+ this._curCamera.cameraMatrix.mat4[5],
+ this._curCamera.cameraMatrix.mat4[6],
+ this._curCamera.cameraMatrix.mat4[7],
+ this._curCamera.cameraMatrix.mat4[8],
+ this._curCamera.cameraMatrix.mat4[9],
+ this._curCamera.cameraMatrix.mat4[10],
+ this._curCamera.cameraMatrix.mat4[11],
+ this._curCamera.cameraMatrix.mat4[12],
+ this._curCamera.cameraMatrix.mat4[13],
+ this._curCamera.cameraMatrix.mat4[14],
+ this._curCamera.cameraMatrix.mat4[15]
+ );
+
+ // reset light data for new frame.
+
+ this.ambientLightColors.length = 0;
+ this.directionalLightDirections.length = 0;
+ this.directionalLightColors.length = 0;
+
+ this.pointLightPositions.length = 0;
+ this.pointLightColors.length = 0;
};
/**
@@ -69277,11 +79255,12 @@ p5.RendererGL.prototype._update = function() {
*/
p5.RendererGL.prototype.background = function() {
var _col = this._pInst.color.apply(this._pInst, arguments);
- var _r = (_col.levels[0]) / 255;
- var _g = (_col.levels[1]) / 255;
- var _b = (_col.levels[2]) / 255;
- var _a = (_col.levels[3]) / 255;
+ var _r = _col.levels[0] / 255;
+ var _g = _col.levels[1] / 255;
+ var _b = _col.levels[2] / 255;
+ var _a = _col.levels[3] / 255;
this.GL.clearColor(_r, _g, _b, _a);
+ this.GL.depthMask(true);
this.GL.clear(this.GL.COLOR_BUFFER_BIT | this.GL.DEPTH_BUFFER_BIT);
};
@@ -69296,27 +79275,28 @@ p5.RendererGL.prototype.background = function() {
/**
* Basic fill material for geometry with a given color
* @method fill
- * @param {Number|Array|String|p5.Color} v1 gray value,
+ * @class p5.RendererGL
+ * @param {Number|Number[]|String|p5.Color} v1 gray value,
* red or hue value (depending on the current color mode),
* or color Array, or CSS color string
* @param {Number} [v2] green or saturation value
* @param {Number} [v3] blue or brightness value
* @param {Number} [a] opacity
- * @return {p5} the p5 object
+ * @chainable
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(200, 200, WEBGL);
* }
*
- * function draw(){
- * background(0);
- * noStroke();
- * fill(100, 100, 240);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * box(75, 75, 75);
+ * function draw() {
+ * background(0);
+ * noStroke();
+ * fill(100, 100, 240);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * box(75, 75, 75);
* }
*
*
@@ -69327,84 +79307,22 @@ p5.RendererGL.prototype.background = function() {
*/
p5.RendererGL.prototype.fill = function(v1, v2, v3, a) {
//see material.js for more info on color blending in webgl
- var colors = this._applyColorBlend.apply(this, arguments);
- this.curFillColor = colors;
- if(this.curFillShader.active === false) {
- this.curFillShader.active = true;
- }
- if (this.isImmediateDrawing){
+ var color = p5.prototype.color.apply(this._pInst, arguments);
+ this.curFillColor = color._array;
+
+ if (this.isImmediateDrawing) {
this.setFillShader(this._getImmediateModeShader());
} else {
this.setFillShader(this._getColorShader());
}
this.drawMode = constants.FILL;
- this.curFillShader.setUniform('uMaterialColor', colors);
-};
-
-/**
- * Does not render fill material
- * @method noFill
- * @example
- *
- *
- * function setup(){
- * createCanvas(200, 200, WEBGL);
- * }
- *
- * function draw(){
- * background(0);
- * noFill();
- * stroke(100, 100, 240);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * box(75, 75, 75);
- * }
- *
- *
- *
- * @alt
- * black canvas with purple cube wireframe spinning
- *
- */
-
-
-p5.RendererGL.prototype.noFill = function() {
- this.curFillShader.active = false;
-};
-
-/**
- * Does not render stroke
- * @method noStroke
- * @example
- *
- *
- * function setup(){
- * createCanvas(200, 200, WEBGL);
- * }
- *
- * function draw(){
- * background(0);
- * noStroke();
- * fill(240, 150, 150);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * box(75, 75, 75);
- * }
- *
- *
- *
- * @alt
- * black canvas with pink cube spinning
- *
- */
-p5.RendererGL.prototype.noStroke = function() {
- this.curStrokeShader.active = false;
+ this.curFillShader.setUniform('uMaterialColor', this.curFillColor);
};
/**
* Basic stroke material for geometry with a given color
* @method stroke
- * @param {Number|Array|String|p5.Color} v1 gray value,
+ * @param {Number|Number[]|String|p5.Color} v1 gray value,
* red or hue value (depending on the current color mode),
* or color Array, or CSS color string
* @param {Number} [v2] green or saturation value
@@ -69413,17 +79331,17 @@ p5.RendererGL.prototype.noStroke = function() {
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(200, 200, WEBGL);
* }
*
- * function draw(){
- * background(0);
- * stroke(240, 150, 150);
- * fill(100, 100, 240);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * box(75, 75, 75);
+ * function draw() {
+ * background(0);
+ * stroke(240, 150, 150);
+ * fill(100, 100, 240);
+ * rotateX(frameCount * 0.01);
+ * rotateY(frameCount * 0.01);
+ * box(75, 75, 75);
* }
*
*
@@ -69433,17 +79351,13 @@ p5.RendererGL.prototype.noStroke = function() {
*
*/
p5.RendererGL.prototype.stroke = function(r, g, b, a) {
- if(this.curStrokeShader.active === false) {
- this.curStrokeShader.active = true;
- }
//@todo allow transparency in stroking currently doesn't have
//any impact and causes problems with specularMaterial
arguments[3] = 255;
- var colors = this._applyColorBlend.apply(this, arguments);
- if(this.curStrokeColor !== colors) {
- this.curStrokeColor = colors;
- this._setStrokeColor();
- }
+ var color = p5.prototype.color.apply(this._pInst, arguments);
+ this.curStrokeColor = color._array;
+ this.curStrokeShader.setUniform('uMaterialColor', this.curStrokeColor);
+ this.curPointShader.setUniform('uMaterialColor', color._array);
};
/**
@@ -69453,17 +79367,17 @@ p5.RendererGL.prototype.stroke = function(r, g, b, a) {
* @example
*
*
- * function setup(){
+ * function setup() {
* createCanvas(200, 400, WEBGL);
* setAttributes('antialias', true);
* }
*
- * function draw(){
+ * function draw() {
* background(0);
* noStroke();
- * translate(0,-100,0);
- * stroke(240,150,150);
- * fill(100,100,240);
+ * translate(0, -100, 0);
+ * stroke(240, 150, 150);
+ * fill(100, 100, 240);
* push();
* strokeWeight(8);
* rotateX(frameCount * 0.01);
@@ -69471,14 +79385,13 @@ p5.RendererGL.prototype.stroke = function(r, g, b, a) {
* sphere(75);
* pop();
* push();
- * translate(0,200,0);
+ * translate(0, 200, 0);
* strokeWeight(1);
* rotateX(frameCount * 0.01);
* rotateY(frameCount * 0.01);
* sphere(75);
* pop();
* }
- *
*
*
*
@@ -69488,28 +79401,14 @@ p5.RendererGL.prototype.stroke = function(r, g, b, a) {
*
*/
p5.RendererGL.prototype.strokeWeight = function(w) {
- if(this.curStrokeShader.active === false) {
- this.curStrokeShader.active = true;
- }
- if(this.curStrokeWeight !== w) {
+ if (this.curStrokeWeight !== w) {
this.pointSize = w;
this.curStrokeWeight = w;
this.curStrokeShader.setUniform('uStrokeWeight', w);
+ this.curPointShader.setUniform('uPointSize', w);
}
};
-p5.RendererGL.prototype._setStrokeWeight = function() {
- // this should only be called after an appropriate call
- // to shader() internally....
- this.curStrokeShader.setUniform('uStrokeWeight', this.curStrokeWeight);
-};
-
-p5.RendererGL.prototype._setStrokeColor = function() {
- // this should only be called after an appropriate call
- // to shader() internally....
- this.curStrokeShader.setUniform('uMaterialColor', this.curStrokeColor);
-};
-
/**
* Returns an array of [R,G,B,A] values for any pixel or grabs a section of
* an image. If no parameters are specified, the entire image is returned.
@@ -69525,14 +79424,14 @@ p5.RendererGL.prototype._setStrokeColor = function() {
* as grabbing the data directly from pixels[]. The equivalent statement to
* get(x, y) is using pixels[] with pixel density d
*
- *
+ * @private
* @method get
* @param {Number} [x] x-coordinate of the pixel
* @param {Number} [y] y-coordinate of the pixel
* @param {Number} [w] width
* @param {Number} [h] height
- * @return {Array|Color|p5.Image} color of pixel at x,y in array format
- * [R, G, B, A] or p5.Image
+ * @return {Number[]|Color|p5.Image} color of pixel at x,y in array format
+ * [R, G, B, A] or p5.Image
*/
p5.RendererGL.prototype.get = function(x, y, w, h) {
return p5.Renderer2D.prototype.get.apply(this, [x, y, w, h]);
@@ -69543,81 +79442,100 @@ p5.RendererGL.prototype.get = function(x, y, w, h) {
* Note that updatePixels() and set() do not work.
* Any pixel manipulation must be done directly to the pixels[] array.
*
+ * @private
* @method loadPixels
- * @param {Number} [x] starting pixel x position, defaults to 0
- * @param {Number} [y] starting pixel y position, defaults to 0
- * @param {Number} [w] width of pixels to load, defaults to sketch width
- * @param {Number} [h] height of pixels to load, defaults to sketch height
*
*/
p5.RendererGL.prototype.loadPixels = function() {
//@todo_FES
- if(this.attributes.preserveDrawingBuffer !== true) {
- console.log('loadPixels only works in WebGL when preserveDrawingBuffer ' +
- 'is true.');
+ if (this.attributes.preserveDrawingBuffer !== true) {
+ console.log(
+ 'loadPixels only works in WebGL when preserveDrawingBuffer ' + 'is true.'
+ );
return;
}
var pd = this._pInst._pixelDensity;
- var x = arguments[0] || 0;
- var y = arguments[1] || 0;
- var w = arguments[2] || this.width;
- var h = arguments[3] || this.height;
+ var x = 0;
+ var y = 0;
+ var w = this.width;
+ var h = this.height;
w *= pd;
h *= pd;
- var pixels = new Uint8Array(this.GL.drawingBufferWidth *
- this.GL.drawingBufferHeight * 4);
- this.GL.readPixels(x, y, w, h, this.GL.RGBA, this.GL.UNSIGNED_BYTE, pixels);
- this._pInst._setProperty('pixels', pixels);
+ //if there isn't a renderer-level temporary pixels buffer
+ //make a new one
+ if (typeof this.pixels === 'undefined') {
+ this.pixels = new Uint8Array(
+ this.GL.drawingBufferWidth * this.GL.drawingBufferHeight * 4
+ );
+ }
+ this.GL.readPixels(
+ x,
+ y,
+ w,
+ h,
+ this.GL.RGBA,
+ this.GL.UNSIGNED_BYTE,
+ this.pixels
+ );
+ this._pInst._setProperty('pixels', this.pixels);
};
-
-
//////////////////////////////////////////////
// HASH | for geometry
//////////////////////////////////////////////
-p5.RendererGL.prototype.geometryInHash = function(gId){
+p5.RendererGL.prototype.geometryInHash = function(gId) {
return this.gHash[gId] !== undefined;
};
-
-
/**
* [resize description]
+ * @private
* @param {Number} w [description]
* @param {Number} h [description]
*/
-p5.RendererGL.prototype.resize = function(w,h) {
+p5.RendererGL.prototype.resize = function(w, h) {
p5.Renderer.prototype.resize.call(this, w, h);
- this.GL.viewport(0, 0, this.GL.drawingBufferWidth, this.GL.drawingBufferHeight);
- // If we're using the default camera, update the aspect ratio
- if(this._curCamera === null || this._curCamera === 'default') {
- this._curCamera = null;
- // camera defaults are dependent on the width & height of the screen,
- // so we'll want to update them if the size of the screen changes.
- this._setDefaultCamera();
+ this.GL.viewport(
+ 0,
+ 0,
+ this.GL.drawingBufferWidth,
+ this.GL.drawingBufferHeight
+ );
+ this._viewport = this.GL.getParameter(this.GL.VIEWPORT);
+
+ this._curCamera._resize();
+
+ //resize pixels buffer
+ if (typeof this.pixels !== 'undefined') {
+ this.pixels = new Uint8Array(
+ this.GL.drawingBufferWidth * this.GL.drawingBufferHeight * 4
+ );
}
};
/**
* clears color and depth buffers
* with r,g,b,a
+ * @private
* @param {Number} r normalized red val.
* @param {Number} g normalized green val.
* @param {Number} b normalized blue val.
* @param {Number} a normalized alpha val.
*/
p5.RendererGL.prototype.clear = function() {
- this.GL.clearColor(arguments[0],
- arguments[1],
- arguments[2],
- arguments[3]);
+ var _r = arguments[0] || 0;
+ var _g = arguments[1] || 0;
+ var _b = arguments[2] || 0;
+ var _a = arguments[3] || 0;
+ this.GL.clearColor(_r, _g, _b, _a);
this.GL.clear(this.GL.COLOR_BUFFER_BIT | this.GL.DEPTH_BUFFER_BIT);
};
/**
* [translate description]
+ * @private
* @param {Number} x [description]
* @param {Number} y [description]
* @param {Number} z [description]
@@ -69625,84 +79543,75 @@ p5.RendererGL.prototype.clear = function() {
* @todo implement handle for components or vector as args
*/
p5.RendererGL.prototype.translate = function(x, y, z) {
- if(x instanceof p5.Vector) {
+ if (x instanceof p5.Vector) {
z = x.z;
y = x.y;
x = x.x;
}
- this.uMVMatrix.translate([x,y,z]);
+ this.uMVMatrix.translate([x, y, z]);
return this;
};
/**
* Scales the Model View Matrix by a vector
+ * @private
* @param {Number | p5.Vector | Array} x [description]
* @param {Number} [y] y-axis scalar
* @param {Number} [z] z-axis scalar
* @chainable
*/
-p5.RendererGL.prototype.scale = function(x,y,z) {
- this.uMVMatrix.scale([x,y,z]);
+p5.RendererGL.prototype.scale = function(x, y, z) {
+ this.uMVMatrix.scale(x, y, z);
return this;
};
-p5.RendererGL.prototype.rotate = function(rad, axis){
- this.uMVMatrix.rotate(rad, axis);
+p5.RendererGL.prototype.rotate = function(rad, axis) {
+ if (typeof axis === 'undefined') {
+ return this.rotateZ(rad);
+ }
+ arguments[0] = this._pInst._fromRadians(rad);
+ p5.Matrix.prototype.rotate.apply(this.uMVMatrix, arguments);
return this;
};
p5.RendererGL.prototype.rotateX = function(rad) {
- this.rotate(rad, [1,0,0]);
+ this.rotate(rad, 1, 0, 0);
return this;
};
p5.RendererGL.prototype.rotateY = function(rad) {
- this.rotate(rad, [0,1,0]);
+ this.rotate(rad, 0, 1, 0);
return this;
};
p5.RendererGL.prototype.rotateZ = function(rad) {
- this.rotate(rad, [0,0,1]);
+ this.rotate(rad, 0, 0, 1);
return this;
};
-/**
- * pushes a copy of the model view matrix onto the
- * MV Matrix stack.
- */
p5.RendererGL.prototype.push = function() {
- uMVMatrixStack.push(this.uMVMatrix.copy());
- cameraMatrixStack.push(this.cameraMatrix.copy());
-};
+ // get the base renderer style
+ var style = p5.Renderer.prototype.push.apply(this);
-/**
- * [pop description]
- */
-p5.RendererGL.prototype.pop = function() {
- if (uMVMatrixStack.length === 0) {
- throw new Error('Invalid popMatrix!');
- }
- this.uMVMatrix = uMVMatrixStack.pop();
- if (cameraMatrixStack.length === 0) {
- throw new Error('Invalid popMatrix!');
- }
- this.cameraMatrix = cameraMatrixStack.pop();
+ // add webgl-specific style properties
+ var properties = style.properties;
+
+ properties.uMVMatrix = this.uMVMatrix.copy();
+ properties.uPMatrix = this.uPMatrix.copy();
+ properties._curCamera = this._curCamera;
+
+ // make a copy of the current camera for the push state
+ // this preserves any references stored using 'createCamera'
+ this._curCamera = this._curCamera.copy();
+
+ return style;
};
p5.RendererGL.prototype.resetMatrix = function() {
- this.uMVMatrix = p5.Matrix.identity();
+ this.uMVMatrix = p5.Matrix.identity(this._pInst);
return this;
};
-// Text/Typography
-// @TODO:
-p5.RendererGL.prototype._applyTextProperties = function() {
- //@TODO finish implementation
- console.error('text commands not yet implemented in webgl');
-};
-
-
-
//////////////////////////////////////////////
// SHADER
//////////////////////////////////////////////
@@ -69718,7 +79627,7 @@ p5.RendererGL.prototype._applyTextProperties = function() {
* @param {p5.Shader} [s] a p5.Shader object
* @return {p5.Shader} the current, updated fill shader
*/
-p5.RendererGL.prototype.setFillShader = function (s) {
+p5.RendererGL.prototype.setFillShader = function(s) {
if (this.curFillShader !== s) {
// only do setup etc. if shader is actually new.
this.curFillShader = s;
@@ -69726,28 +79635,37 @@ p5.RendererGL.prototype.setFillShader = function (s) {
// safe to do this multiple times;
// init() will bail early if has already been run.
this.curFillShader.init();
- this.curFillShader.useProgram();
- this.curFillShader.active = true;
+ //this.curFillShader.useProgram();
}
// always return this.curFillShader, even if no change was made.
return this.curFillShader;
};
+p5.RendererGL.prototype.setPointShader = function(s) {
+ if (this.curPointShader !== s) {
+ // only do setup etc. if shader is actually new.
+ this.curPointShader = s;
+
+ // safe to do this multiple times;
+ // init() will bail early if has already been run.
+ this.curPointShader.init();
+ }
+ return this.curPointShader;
+};
/*
* @method setStrokeShader
* @param {p5.Shader} [s] a p5.Shader object
* @return {p5.Shader} the current, updated stroke shader
*/
-p5.RendererGL.prototype.setStrokeShader = function (s) {
+p5.RendererGL.prototype.setStrokeShader = function(s) {
if (this.curStrokeShader !== s) {
// only do setup etc. if shader is actually new.
this.curStrokeShader = s;
// safe to do this multiple times;
// init() will bail early if has already been run.
this.curStrokeShader.init();
- this.curStrokeShader.useProgram();
- this.curStrokeShader.active = true;
+ //this.curStrokeShader.useProgram();
}
// always return this.curLineShader, even if no change was made.
return this.curStrokeShader;
@@ -69761,53 +79679,144 @@ p5.RendererGL.prototype.setStrokeShader = function (s) {
*
*/
-p5.RendererGL.prototype._getLightShader = function () {
- if (this._defaultLightShader === undefined) {
- this._defaultLightShader = new p5.Shader(this,
- defaultShaders.lightVert, defaultShaders.lightTextureFrag);
+p5.RendererGL.prototype._useLightShader = function() {
+ if (!this.curFillShader || !this.curFillShader.isLightShader()) {
+ this.setFillShader(this._getLightShader());
+ }
+ return this.curFillShader;
+};
+
+p5.RendererGL.prototype._useColorShader = function() {
+ // looking at the code within the glsl files, I'm not really
+ // sure why these are two different shaders. but, they are,
+ // and if we're drawing in retain mode but the shader is the
+ // immediate mode one, we need to switch.
+
+ // TODO: what if curFillShader is _any_ other shader?
+ if (
+ !this.curFillShader ||
+ this.curFillShader === this._defaultImmediateModeShader
+ ) {
+ // there are different immediate mode and retain mode color shaders.
+ // if we're using the immediate mode one, we need to switch to
+ // one that works for retain mode.
+ this.setFillShader(this._getColorShader());
+ }
+ return this.curFillShader;
+};
+
+p5.RendererGL.prototype._usePointShader = function() {
+ if (!this.curPointShader) {
+ this.setPointShader(this._getPointShader());
+ }
+ return this.curPointShader;
+};
+
+p5.RendererGL.prototype._useImmediateModeShader = function() {
+ // TODO: what if curFillShader is _any_ other shader?
+ if (!this.curFillShader || this.curFillShader === this._defaultColorShader) {
+ // this is the fill/stroke shader for retain mode.
+ // must switch to immediate mode shader before drawing!
+ this.setFillShader(this._getImmediateModeShader());
+ // note that if we're using the texture shader...
+ // this shouldn't change. :)
+ }
+ return this.curFillShader;
+};
+
+p5.RendererGL.prototype._getLightShader = function() {
+ if (!this._defaultLightShader) {
+ if (this.attributes.perPixelLighting) {
+ this._defaultLightShader = new p5.Shader(
+ this,
+ defaultShaders.phongVert,
+ defaultShaders.phongFrag
+ );
+ } else {
+ this._defaultLightShader = new p5.Shader(
+ this,
+ defaultShaders.lightVert,
+ defaultShaders.lightTextureFrag
+ );
+ }
}
//this.drawMode = constants.FILL;
return this._defaultLightShader;
};
-p5.RendererGL.prototype._getImmediateModeShader = function () {
- if (this._defaultImmediateModeShader === undefined) {
- this._defaultImmediateModeShader = new p5.Shader(this,
- defaultShaders.immediateVert, defaultShaders.vertexColorFrag);
+p5.RendererGL.prototype._getImmediateModeShader = function() {
+ if (!this._defaultImmediateModeShader) {
+ this._defaultImmediateModeShader = new p5.Shader(
+ this,
+ defaultShaders.immediateVert,
+ defaultShaders.vertexColorFrag
+ );
}
//this.drawMode = constants.FILL;
return this._defaultImmediateModeShader;
};
-p5.RendererGL.prototype._getNormalShader = function () {
- if (this._defaultNormalShader === undefined) {
- this._defaultNormalShader = new p5.Shader(this,
- defaultShaders.normalVert, defaultShaders.normalFrag);
+p5.RendererGL.prototype._getNormalShader = function() {
+ if (!this._defaultNormalShader) {
+ this._defaultNormalShader = new p5.Shader(
+ this,
+ defaultShaders.normalVert,
+ defaultShaders.normalFrag
+ );
}
//this.drawMode = constants.FILL;
return this._defaultNormalShader;
};
-p5.RendererGL.prototype._getColorShader = function () {
- if (this._defaultColorShader === undefined) {
- this._defaultColorShader = new p5.Shader(this,
- defaultShaders.normalVert, defaultShaders.basicFrag);
+p5.RendererGL.prototype._getColorShader = function() {
+ if (!this._defaultColorShader) {
+ this._defaultColorShader = new p5.Shader(
+ this,
+ defaultShaders.normalVert,
+ defaultShaders.basicFrag
+ );
}
//this.drawMode = constants.FILL;
return this._defaultColorShader;
};
-p5.RendererGL.prototype._getLineShader = function () {
- if (this._defaultLineShader === undefined) {
- this._defaultLineShader = new p5.Shader(this,
- defaultShaders.lineVert, defaultShaders.lineFrag);
+p5.RendererGL.prototype._getPointShader = function() {
+ if (!this._defaultPointShader) {
+ this._defaultPointShader = new p5.Shader(
+ this,
+ defaultShaders.pointVert,
+ defaultShaders.pointFrag
+ );
+ }
+ return this._defaultPointShader;
+};
+
+p5.RendererGL.prototype._getLineShader = function() {
+ if (!this._defaultLineShader) {
+ this._defaultLineShader = new p5.Shader(
+ this,
+ defaultShaders.lineVert,
+ defaultShaders.lineFrag
+ );
}
//this.drawMode = constants.STROKE;
return this._defaultLineShader;
};
-p5.RendererGL.prototype._getEmptyTexture = function () {
- if (this._emptyTexture === undefined) {
+p5.RendererGL.prototype._getFontShader = function() {
+ if (!this._defaultFontShader) {
+ this.GL.getExtension('OES_standard_derivatives');
+ this._defaultFontShader = new p5.Shader(
+ this,
+ defaultShaders.fontVert,
+ defaultShaders.fontFrag
+ );
+ }
+ return this._defaultFontShader;
+};
+
+p5.RendererGL.prototype._getEmptyTexture = function() {
+ if (!this._emptyTexture) {
// a plain white texture RGBA, full alpha, single pixel.
var im = new p5.Image(1, 1);
im.set(0, 0, 255);
@@ -69816,65 +79825,213 @@ p5.RendererGL.prototype._getEmptyTexture = function () {
return this._emptyTexture;
};
-p5.RendererGL.prototype.getTexture = function (img) {
- var checkSource = function(element) {
- return element.src === img;
- };
- //this.drawMode = constants.TEXTURE;
- var tex = this.textures.find(checkSource);
- if (tex === undefined) {
- tex = new p5.Texture(this, img);
- this.textures.push(tex);
+p5.RendererGL.prototype.getTexture = function(img) {
+ var textures = this.textures;
+ for (var it = 0; it < textures.length; ++it) {
+ var texture = textures[it];
+ if (texture.src === img) return texture;
}
+ var tex = new p5.Texture(this, img);
+ this.textures.push(tex);
return tex;
};
//Binds a buffer to the drawing context
//when passed more than two arguments it also updates or initializes
//the data associated with the buffer
-p5.RendererGL.prototype._bindBuffer = function( buffer, target,
- values, type, usage) {
+p5.RendererGL.prototype._bindBuffer = function(
+ buffer,
+ target,
+ values,
+ type,
+ usage
+) {
this.GL.bindBuffer(target, buffer);
- if(values !== undefined) {
+ if (values !== undefined) {
var data = new type(values);
this.GL.bufferData(target, data, usage);
}
};
+//////////////////////////
+//// SMOOTHING
+/////////////////////////
+
+p5.RendererGL.prototype.smooth = function() {
+ if (this.attributes.antialias === false) {
+ this._pInst.setAttributes('antialias', true);
+ }
+};
+
+p5.RendererGL.prototype.noSmooth = function() {
+ if (this.attributes.antialias === true) {
+ this._pInst.setAttributes('antialias', false);
+ }
+};
+
///////////////////////////////
//// UTILITY FUNCTIONS
//////////////////////////////
/**
* turn a two dimensional array into one dimensional array
+ * @private
* @param {Array} arr 2-dimensional array
* @return {Array} 1-dimensional array
* [[1, 2, 3],[4, 5, 6]] -> [1, 2, 3, 4, 5, 6]
*/
-p5.RendererGL.prototype._flatten = function(arr){
- if (arr.length>0){
- return ([].concat.apply([], arr));
- } else {
+p5.RendererGL.prototype._flatten = function(arr) {
+ //when empty, return empty
+ if (arr.length === 0) {
return [];
+ } else if (arr.length > 20000) {
+ //big models , load slower to avoid stack overflow
+ //faster non-recursive flatten via axelduch
+ //stackoverflow.com/questions/27266550/how-to-flatten-nested-array-in-javascript
+ var toString = Object.prototype.toString;
+ var arrayTypeStr = '[object Array]';
+ var result = [];
+ var nodes = arr.slice();
+ var node;
+ node = nodes.pop();
+ do {
+ if (toString.call(node) === arrayTypeStr) {
+ nodes.push.apply(nodes, node);
+ } else {
+ result.push(node);
+ }
+ } while (nodes.length && (node = nodes.pop()) !== undefined);
+ result.reverse(); // we reverse result to restore the original order
+ return result;
+ } else {
+ //otherwise if model within limits for browser
+ //use faster recursive loading
+ return [].concat.apply([], arr);
}
};
/**
* turn a p5.Vector Array into a one dimensional number array
- * @param {Array} arr an array of p5.Vector
- * @return {Array]} a one dimensional array of numbers
+ * @private
+ * @param {p5.Vector[]} arr an array of p5.Vector
+ * @return {Number[]} a one dimensional array of numbers
* [p5.Vector(1, 2, 3), p5.Vector(4, 5, 6)] ->
* [1, 2, 3, 4, 5, 6]
*/
-p5.RendererGL.prototype._vToNArray = function(arr){
- return this._flatten(arr.map(function(item){
- return [item.x, item.y, item.z];
- }));
+p5.RendererGL.prototype._vToNArray = function(arr) {
+ return this._flatten(
+ arr.map(function(item) {
+ return [item.x, item.y, item.z];
+ })
+ );
+};
+
+/**
+ * ensures that p5 is using a 3d renderer. throws an error if not.
+ */
+p5.prototype._assert3d = function(name) {
+ if (!this._renderer.isP3D)
+ throw new Error(
+ name +
+ "() is only supported in WEBGL mode. If you'd like to use 3D graphics" +
+ ' and WebGL, see https://p5js.org/examples/form-3d-primitives.html' +
+ ' for more information.'
+ );
+};
+
+// function to initialize GLU Tesselator
+
+p5.RendererGL.prototype._initTessy = function initTesselator() {
+ // function called for each vertex of tesselator output
+ function vertexCallback(data, polyVertArray) {
+ polyVertArray[polyVertArray.length] = data[0];
+ polyVertArray[polyVertArray.length] = data[1];
+ polyVertArray[polyVertArray.length] = data[2];
+ }
+ function begincallback(type) {
+ if (type !== libtess.primitiveType.GL_TRIANGLES) {
+ console.log('expected TRIANGLES but got type: ' + type);
+ }
+ }
+ function errorcallback(errno) {
+ console.log('error callback');
+ console.log('error number: ' + errno);
+ }
+ // callback for when segments intersect and must be split
+ function combinecallback(coords, data, weight) {
+ return [coords[0], coords[1], coords[2]];
+ }
+ function edgeCallback(flag) {
+ // don't really care about the flag, but need no-strip/no-fan behavior
+ }
+
+ var tessy = new libtess.GluTesselator();
+ tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_VERTEX_DATA, vertexCallback);
+ tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_BEGIN, begincallback);
+ tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_ERROR, errorcallback);
+ tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_COMBINE, combinecallback);
+ tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_EDGE_FLAG, edgeCallback);
+
+ return tessy;
+};
+
+p5.RendererGL.prototype._triangulate = function(contours) {
+ // libtess will take 3d verts and flatten to a plane for tesselation
+ // since only doing 2d tesselation here, provide z=1 normal to skip
+ // iterating over verts only to get the same answer.
+ // comment out to test normal-generation code
+ this._tessy.gluTessNormal(0, 0, 1);
+
+ var triangleVerts = [];
+ this._tessy.gluTessBeginPolygon(triangleVerts);
+
+ for (var i = 0; i < contours.length; i++) {
+ this._tessy.gluTessBeginContour();
+ var contour = contours[i];
+ for (var j = 0; j < contour.length; j += 3) {
+ var coords = [contour[j], contour[j + 1], contour[j + 2]];
+ this._tessy.gluTessVertex(coords, coords);
+ }
+ this._tessy.gluTessEndContour();
+ }
+
+ // finish polygon
+ this._tessy.gluTessEndPolygon();
+
+ return triangleVerts;
+};
+
+// function to calculate BezierVertex Coefficients
+p5.RendererGL.prototype._bezierCoefficients = function(t) {
+ var t2 = t * t;
+ var t3 = t2 * t;
+ var mt = 1 - t;
+ var mt2 = mt * mt;
+ var mt3 = mt2 * mt;
+ return [mt3, 3 * mt2 * t, 3 * mt * t2, t3];
+};
+
+// function to calculate QuadraticVertex Coefficients
+p5.RendererGL.prototype._quadraticCoefficients = function(t) {
+ var t2 = t * t;
+ var mt = 1 - t;
+ var mt2 = mt * mt;
+ return [mt2, 2 * mt * t, t2];
+};
+
+// function to convert Bezier coordinates to Catmull Rom Splines
+p5.RendererGL.prototype._bezierToCatmull = function(w) {
+ var p1 = w[1];
+ var p2 = w[1] + (w[2] - w[0]) / this._curveTightness;
+ var p3 = w[2] - (w[3] - w[1]) / this._curveTightness;
+ var p4 = w[2];
+ var p = [p1, p2, p3, p4];
+ return p;
};
module.exports = p5.RendererGL;
-},{"../core/constants":54,"../core/core":55,"../core/p5.Renderer":62,"./p5.Matrix":103,"./p5.Shader":107}],107:[function(_dereq_,module,exports){
+},{"../core/constants":19,"../core/main":25,"../core/p5.Renderer":28,"./p5.Camera":70,"./p5.Matrix":72,"./p5.Shader":76,"libtess":10}],76:[function(_dereq_,module,exports){
/**
* This module defines the p5.Shader class
* @module Lights, Camera
@@ -69883,12 +80040,13 @@ module.exports = p5.RendererGL;
* @requires core
*/
-var p5 = _dereq_('../core/core');
+'use strict';
+
+var p5 = _dereq_('../core/main');
/**
* Shader class for WEBGL Mode
* @class p5.Shader
- * @constructor
* @param {p5.RendererGL} renderer an instance of p5.RendererGL that
* will provide the GL context for this new p5.Shader
* @param {String} vertSrc source code for the vertex shader (as a string)
@@ -69910,8 +80068,6 @@ p5.Shader = function(renderer, vertSrc, fragSrc) {
this.uniforms = {};
this._bound = false;
this.samplers = [];
-
- return this;
};
/**
@@ -69941,8 +80097,10 @@ p5.Shader.prototype.init = function() {
gl.compileShader(this._vertShader);
// if our vertex shader failed compilation?
if (!gl.getShaderParameter(this._vertShader, gl.COMPILE_STATUS)) {
- console.error('Yikes! An error occurred compiling the vertex shader:' +
- gl.getShaderInfoLog(this._vertShader));
+ console.error(
+ 'Yikes! An error occurred compiling the vertex shader:' +
+ gl.getShaderInfoLog(this._vertShader)
+ );
return null;
}
@@ -69952,8 +80110,10 @@ p5.Shader.prototype.init = function() {
gl.compileShader(this._fragShader);
// if our frag shader failed compilation?
if (!gl.getShaderParameter(this._fragShader, gl.COMPILE_STATUS)) {
- console.error('Darn! An error occurred compiling the fragment shader:' +
- gl.getShaderInfoLog(this._fragShader));
+ console.error(
+ 'Darn! An error occurred compiling the fragment shader:' +
+ gl.getShaderInfoLog(this._fragShader)
+ );
return null;
}
@@ -69962,8 +80122,10 @@ p5.Shader.prototype.init = function() {
gl.attachShader(this._glProgram, this._fragShader);
gl.linkProgram(this._glProgram);
if (!gl.getProgramParameter(this._glProgram, gl.LINK_STATUS)) {
- console.error('Snap! Error linking shader program: ' +
- gl.getProgramInfoLog(this._glProgram));
+ console.error(
+ 'Snap! Error linking shader program: ' +
+ gl.getProgramInfoLog(this._glProgram)
+ );
}
this._loadAttributes();
@@ -69987,9 +80149,11 @@ p5.Shader.prototype._loadAttributes = function() {
var gl = this._renderer.GL;
- var numAttributes = gl.getProgramParameter(this._glProgram,
- gl.ACTIVE_ATTRIBUTES);
- for(var i = 0; i < numAttributes; ++i){
+ var numAttributes = gl.getProgramParameter(
+ this._glProgram,
+ gl.ACTIVE_ATTRIBUTES
+ );
+ for (var i = 0; i < numAttributes; ++i) {
var attributeInfo = gl.getActiveAttrib(this._glProgram, i);
var name = attributeInfo.name;
var location = gl.getAttribLocation(this._glProgram, name);
@@ -70018,11 +80182,10 @@ p5.Shader.prototype._loadUniforms = function() {
var gl = this._renderer.GL;
// Inspect shader and cache uniform info
- var numUniforms = gl.getProgramParameter(this._glProgram,
- gl.ACTIVE_UNIFORMS);
+ var numUniforms = gl.getProgramParameter(this._glProgram, gl.ACTIVE_UNIFORMS);
var samplerIndex = 0;
- for(var i = 0; i < numUniforms; ++i){
+ for (var i = 0; i < numUniforms; ++i) {
var uniformInfo = gl.getActiveUniform(this._glProgram, i);
var uniform = {};
uniform.location = gl.getUniformLocation(this._glProgram, uniformInfo.name);
@@ -70032,13 +80195,12 @@ p5.Shader.prototype._loadUniforms = function() {
//someUniform[0] which is a bit silly so we trim it
//off here. The size property tells us that its an array
//so we dont lose any information by doing this
- if(uniformInfo.size > 1) {
- uniformName = uniformName.substring(0,
- uniformName.indexOf('[0]'));
+ if (uniformInfo.size > 1) {
+ uniformName = uniformName.substring(0, uniformName.indexOf('[0]'));
}
uniform.name = uniformName;
uniform.type = uniformInfo.type;
- if(uniform.type === gl.SAMPLER_2D) {
+ if (uniform.type === gl.SAMPLER_2D) {
uniform.samplerIndex = samplerIndex;
samplerIndex++;
this.samplers.push(uniform);
@@ -70052,25 +80214,20 @@ p5.Shader.prototype.compile = function() {
// TODO
};
-
/**
* initializes (if needed) and binds the shader program.
* @method bindShader
* @private
*/
-p5.Shader.prototype.bindShader = function () {
+p5.Shader.prototype.bindShader = function() {
this.init();
if (!this._bound) {
this.useProgram();
this._bound = true;
this.bindTextures();
- this._loadAttributes();
- this._loadUniforms();
-
- this._renderer._setDefaultCamera();
this._setMatrixUniforms();
- if(this === this._renderer.curStrokeShader) {
+ if (this === this._renderer.curStrokeShader) {
this._setViewportUniform();
}
}
@@ -70081,7 +80238,7 @@ p5.Shader.prototype.bindShader = function () {
* @chainable
* @private
*/
-p5.Shader.prototype.unbindShader = function () {
+p5.Shader.prototype.unbindShader = function() {
if (this._bound) {
this.unbindTextures();
//this._renderer.GL.useProgram(0); ??
@@ -70090,9 +80247,9 @@ p5.Shader.prototype.unbindShader = function () {
return this;
};
-p5.Shader.prototype.bindTextures = function () {
+p5.Shader.prototype.bindTextures = function() {
var gl = this._renderer.GL;
- for (var i = 0; i < this.samplers.length; i++) {
+ for (var i = 0; i < this.samplers.length; i++) {
var uniform = this.samplers[i];
var tex = uniform.texture;
if (tex === undefined) {
@@ -70108,7 +80265,17 @@ p5.Shader.prototype.bindTextures = function () {
}
};
-p5.Shader.prototype.unbindTextures = function () {
+p5.Shader.prototype.updateTextures = function() {
+ for (var i = 0; i < this.samplers.length; i++) {
+ var uniform = this.samplers[i];
+ var tex = uniform.texture;
+ if (tex) {
+ tex.update();
+ }
+ }
+};
+
+p5.Shader.prototype.unbindTextures = function() {
// TODO: migrate stuff from material.js here
// - OR - have material.js define this function
};
@@ -70116,15 +80283,15 @@ p5.Shader.prototype.unbindTextures = function () {
p5.Shader.prototype._setMatrixUniforms = function() {
this.setUniform('uProjectionMatrix', this._renderer.uPMatrix.mat4);
this.setUniform('uModelViewMatrix', this._renderer.uMVMatrix.mat4);
- if(this === this._renderer.curFillShader) {
+ this.setUniform('uViewMatrix', this._renderer._curCamera.cameraMatrix.mat4);
+ if (this === this._renderer.curFillShader) {
this._renderer.uNMatrix.inverseTranspose(this._renderer.uMVMatrix);
this.setUniform('uNormalMatrix', this._renderer.uNMatrix.mat3);
}
};
p5.Shader.prototype._setViewportUniform = function() {
- this.setUniform('uViewport',
- this._renderer.GL.getParameter(this._renderer.GL.VIEWPORT));
+ this.setUniform('uViewport', this._renderer._viewport);
};
/**
@@ -70132,7 +80299,7 @@ p5.Shader.prototype._setViewportUniform = function() {
* @chainable
* @private
*/
-p5.Shader.prototype.useProgram = function () {
+p5.Shader.prototype.useProgram = function() {
var gl = this._renderer.GL;
gl.useProgram(this._glProgram);
return this;
@@ -70147,44 +80314,46 @@ p5.Shader.prototype.useProgram = function () {
* @chainable
* @param {String} uniformName the name of the uniform in the
* shader program
- * @param {Object} data the data to be associated with that uniform; type
- * varies (could be a single numerical value, array, matrix, or
- * texture / sampler reference)
+ * @param {Object|Number|Boolean|Number[]} data the data to be associated
+ * with that uniform; type varies (could be a single numerical value, array,
+ * matrix, or texture / sampler reference)
*/
-p5.Shader.prototype.setUniform = function(uniformName, data)
-{
+p5.Shader.prototype.setUniform = function(uniformName, data) {
//@todo update all current gl.uniformXX calls
+ var uniform = this.uniforms[uniformName];
+ if (!uniform) {
+ //@todo warning?
+ return;
+ }
+ var location = uniform.location;
+
var gl = this._renderer.GL;
// todo: is this safe to do here?
// todo: store the values another way?
this.useProgram();
// TODO BIND?
- var uniform = this.uniforms[uniformName];
- if(!uniform) {
- //@todo warning?
- return;
- }
- var location = uniform.location;
- switch(uniform.type){
+ switch (uniform.type) {
case gl.BOOL:
- if(data === true) {
+ if (data === true) {
gl.uniform1i(location, 1);
- }
- else {
+ } else {
gl.uniform1i(location, 0);
}
break;
case gl.INT:
- gl.uniform1i(location, data);
+ if (uniform.size > 1) {
+ data.length && gl.uniform1iv(location, data);
+ } else {
+ gl.uniform1i(location, data);
+ }
break;
case gl.FLOAT:
- if(uniform.size > 1){
- gl.uniform1fv(location, data);
- }
- else{
+ if (uniform.size > 1) {
+ data.length && gl.uniform1fv(location, data);
+ } else {
gl.uniform1f(location, data);
}
break;
@@ -70195,29 +80364,47 @@ p5.Shader.prototype.setUniform = function(uniformName, data)
gl.uniformMatrix4fv(location, false, data);
break;
case gl.FLOAT_VEC2:
- if(uniform.size > 1){
- gl.uniform2fv(location, data);
- }
- else{
+ if (uniform.size > 1) {
+ data.length && gl.uniform2fv(location, data);
+ } else {
gl.uniform2f(location, data[0], data[1]);
}
break;
case gl.FLOAT_VEC3:
- if(uniform.size > 1){
- gl.uniform3fv(location, data);
- }
- else{
+ if (uniform.size > 1) {
+ data.length && gl.uniform3fv(location, data);
+ } else {
gl.uniform3f(location, data[0], data[1], data[2]);
}
break;
case gl.FLOAT_VEC4:
- if(uniform.size > 1){
- gl.uniform4fv(location, data);
- }
- else{
+ if (uniform.size > 1) {
+ data.length && gl.uniform4fv(location, data);
+ } else {
gl.uniform4f(location, data[0], data[1], data[2], data[3]);
}
break;
+ case gl.INT_VEC2:
+ if (uniform.size > 1) {
+ data.length && gl.uniform2iv(location, data);
+ } else {
+ gl.uniform2i(location, data[0], data[1]);
+ }
+ break;
+ case gl.INT_VEC3:
+ if (uniform.size > 1) {
+ data.length && gl.uniform3iv(location, data);
+ } else {
+ gl.uniform3i(location, data[0], data[1], data[2]);
+ }
+ break;
+ case gl.INT_VEC4:
+ if (uniform.size > 1) {
+ data.length && gl.uniform4iv(location, data);
+ } else {
+ gl.uniform4i(location, data[0], data[1], data[2], data[3]);
+ }
+ break;
case gl.SAMPLER_2D:
gl.activeTexture(gl.TEXTURE0 + uniform.samplerIndex);
uniform.texture = this._renderer.getTexture(data);
@@ -70238,8 +80425,9 @@ p5.Shader.prototype.setUniform = function(uniformName, data)
*
**/
-p5.Shader.prototype.isLightShader = function () {
- return this.uniforms.uUseLighting !== undefined ||
+p5.Shader.prototype.isLightShader = function() {
+ return (
+ this.uniforms.uUseLighting !== undefined ||
this.uniforms.uAmbientLightCount !== undefined ||
this.uniforms.uDirectionalLightCount !== undefined ||
this.uniforms.uPointLightCount !== undefined ||
@@ -70248,23 +80436,26 @@ p5.Shader.prototype.isLightShader = function () {
this.uniforms.uPointLightLocation !== undefined ||
this.uniforms.uPointLightColor !== undefined ||
this.uniforms.uLightingDirection !== undefined ||
- this.uniforms.uSpecular !== undefined;
+ this.uniforms.uSpecular !== undefined
+ );
};
-p5.Shader.prototype.isTextureShader = function () {
+p5.Shader.prototype.isTextureShader = function() {
return this.samplerIndex > 0;
};
-p5.Shader.prototype.isColorShader = function () {
- return this.attributes.aVertexColor !== undefined ||
- this.uniforms.uMaterialColor !== undefined;
+p5.Shader.prototype.isColorShader = function() {
+ return (
+ this.attributes.aVertexColor !== undefined ||
+ this.uniforms.uMaterialColor !== undefined
+ );
};
-p5.Shader.prototype.isTexLightShader = function () {
+p5.Shader.prototype.isTexLightShader = function() {
return this.isLightShader() && this.isTextureShader();
};
-p5.Shader.prototype.isStrokeShader = function () {
+p5.Shader.prototype.isStrokeShader = function() {
return this.uniforms.uStrokeWeight !== undefined;
};
@@ -70273,10 +80464,16 @@ p5.Shader.prototype.isStrokeShader = function () {
* @chainable
* @private
*/
-p5.Shader.prototype.enableAttrib = function(loc, size,
- type, normalized, stride, offset) {
+p5.Shader.prototype.enableAttrib = function(
+ loc,
+ size,
+ type,
+ normalized,
+ stride,
+ offset
+) {
var gl = this._renderer.GL;
- if(loc !== -1) {
+ if (loc !== -1) {
gl.enableVertexAttribArray(loc);
gl.vertexAttribPointer(loc, size, type, normalized, stride, offset);
}
@@ -70285,7 +80482,7 @@ p5.Shader.prototype.enableAttrib = function(loc, size,
module.exports = p5.Shader;
-},{"../core/core":55}],108:[function(_dereq_,module,exports){
+},{"../core/main":25}],77:[function(_dereq_,module,exports){
/**
* This module defines the p5.Texture class
* @module Lights, Camera
@@ -70294,15 +80491,18 @@ module.exports = p5.Shader;
* @requires core
*/
-var p5 = _dereq_('../core/core');
+'use strict';
+
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
/**
* Texture class for WEBGL Mode
+ * @private
* @class p5.Texture
- * @constructor
* @param {p5.RendererGL} renderer an instance of p5.RendererGL that
* will provide the GL context for this new p5.Texture
- * @param {p5.Image|p5.Graphics|p5.Element|p5.MediaElement} [obj] the
+ * @param {p5.Image|p5.Graphics|p5.Element|p5.MediaElement|ImageData} [obj] the
* object containing the image data to store in the texture.
*/
p5.Texture = function(renderer, obj) {
@@ -70322,31 +80522,40 @@ p5.Texture = function(renderer, obj) {
// used to determine if this texture might need constant updating
// because it is a video or gif.
- this.isSrcMediaElement = typeof p5.MediaElement !== 'undefined' &&
- obj instanceof p5.MediaElement;
+ this.isSrcMediaElement =
+ typeof p5.MediaElement !== 'undefined' && obj instanceof p5.MediaElement;
this._videoPrevUpdateTime = 0;
- this.isSrcHTMLElement = typeof p5.Element !== 'undefined' &&
- obj instanceof p5.Element;
+ this.isSrcHTMLElement =
+ typeof p5.Element !== 'undefined' &&
+ obj instanceof p5.Element &&
+ !(obj instanceof p5.Graphics);
this.isSrcP5Image = obj instanceof p5.Image;
this.isSrcP5Graphics = obj instanceof p5.Graphics;
+ this.isImageData =
+ typeof ImageData !== 'undefined' && obj instanceof ImageData;
var textureData = this._getTextureDataFromSource();
- this.height = textureData.width;
- this.width = textureData.height;
+ this.width = textureData.width;
+ this.height = textureData.height;
this.init(textureData);
return this;
};
-p5.Texture.prototype._getTextureDataFromSource = function () {
+p5.Texture.prototype._getTextureDataFromSource = function() {
var textureData;
if (this.isSrcP5Image) {
// param is a p5.Image
textureData = this.src.canvas;
- } else if (this.isSrcMediaElement || this.isSrcP5Graphics ||
- this.isSrcHTMLElement){
+ } else if (
+ this.isSrcMediaElement ||
+ this.isSrcP5Graphics ||
+ this.isSrcHTMLElement
+ ) {
// if param is a video HTML element
textureData = this.src.elt;
+ } else if (this.isImageData) {
+ textureData = this.src;
}
return textureData;
};
@@ -70369,17 +80578,35 @@ p5.Texture.prototype.init = function(data) {
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, this.glWrapS);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, this.glWrapT);
- if (this.width === 0 || this.height === 0 ||
- (this.isSrcMediaElement && !this.src.loadedmetadata)) {
+ if (
+ this.width === 0 ||
+ this.height === 0 ||
+ (this.isSrcMediaElement && !this.src.loadedmetadata)
+ ) {
// assign a 1x1 empty texture initially, because data is not yet ready,
// so that no errors occur in gl console!
- var tmpdata = new Uint8Array([1,1,1,1]);
- gl.texImage2D(this.glTarget, 0, gl.RGBA, 1, 1, 0,
- this.glFormat, gl.UNSIGNED_BYTE, tmpdata);
+ var tmpdata = new Uint8Array([1, 1, 1, 1]);
+ gl.texImage2D(
+ this.glTarget,
+ 0,
+ gl.RGBA,
+ 1,
+ 1,
+ 0,
+ this.glFormat,
+ gl.UNSIGNED_BYTE,
+ tmpdata
+ );
} else {
// data is ready: just push the texture!
- gl.texImage2D(this.glTarget, 0,
- this.glFormat, this.glFormat, gl.UNSIGNED_BYTE, data);
+ gl.texImage2D(
+ this.glTarget,
+ 0,
+ this.glFormat,
+ this.glFormat,
+ gl.UNSIGNED_BYTE,
+ data
+ );
}
};
@@ -70393,24 +80620,22 @@ p5.Texture.prototype.init = function(data) {
p5.Texture.prototype.update = function() {
var data = this.src;
if (data.width === 0 || data.height === 0) {
- return; // nothing to do!
+ return false; // nothing to do!
}
var textureData = this._getTextureDataFromSource();
+ var updated = false;
var gl = this._renderer.GL;
// pull texture from data, make sure width & height are appropriate
- if (textureData.width !== this.width ||
- textureData.height !== this.height) {
+ if (textureData.width !== this.width || textureData.height !== this.height) {
+ updated = true;
+
// make sure that if the width and height of this.src have changed
// for some reason, we update our metadata and upload the texture again
this.width = textureData.width;
this.height = textureData.height;
- this.bindTexture();
- gl.texImage2D(this.glTarget, 0,
- this.glFormat, this.glFormat, gl.UNSIGNED_BYTE, textureData);
-
if (this.isSrcP5Image) {
data.setModified(false);
} else if (this.isSrcMediaElement || this.isSrcHTMLElement) {
@@ -70425,15 +80650,10 @@ p5.Texture.prototype.update = function() {
// for an image, we only update if the modified field has been set,
// for example, by a call to p5.Image.set
if (data.isModified()) {
- this.bindTexture();
- gl.texImage2D(this.glTarget, 0,
- this.glFormat, this.glFormat, gl.UNSIGNED_BYTE, textureData);
+ updated = true;
data.setModified(false);
}
} else if (this.isSrcMediaElement) {
-
- var shouldUpdate = false;
-
// for a media element (video), we'll check if the current time in
// the video frame matches the last time. if it doesn't match, the
// video has advanced or otherwise been taken to a new frame,
@@ -70442,7 +80662,7 @@ p5.Texture.prototype.update = function() {
// p5.MediaElement may have also had set/updatePixels, etc. called
// on it and should be updated, or may have been set for the first
// time!
- shouldUpdate = true;
+ updated = true;
data.setModified(false);
} else if (data.loadedmetadata) {
// if the meta data has been loaded, we can ask the video
@@ -70452,955 +80672,907 @@ p5.Texture.prototype.update = function() {
// video timestamp does not match the timestamp of the last
// time we uploaded this texture (and update the time we
// last uploaded, too)
- this._videoPrevUpdateTime = data.time();
- shouldUpdate = true;
- }
- }
-
- if (shouldUpdate) {
- this.bindTexture();
- gl.texImage2D(this.glTarget, 0,
- this.glFormat, this.glFormat, gl.UNSIGNED_BYTE, textureData);
- }
- } else /* data instanceof p5.Graphics, probably */ {
- // there is not enough information to tell if the texture can be
- // conditionally updated; so to be safe, we just go ahead and upload it.
- gl.texImage2D(this.glTarget, 0,
- this.glFormat, this.glFormat, gl.UNSIGNED_BYTE, textureData);
- }
-};
-
-/**
- * Binds the texture to the appropriate GL target.
- * @method bindTexture
- */
-p5.Texture.prototype.bindTexture = function () {
-
- // bind texture using gl context + glTarget and
- // generated gl texture object
- var gl = this._renderer.GL;
- gl.bindTexture(this.glTarget, this.glTex);
-
- return this;
-};
-
-/**
- * Unbinds the texture from the appropriate GL target.
- * @method unbindTexture
- */
-p5.Texture.prototype.unbindTexture = function () {
- // unbind per above, disable texturing on glTarget
- var gl = this._renderer.GL;
- gl.bindTexture(this.glTarget, null);
-};
-
-module.exports = p5.Texture;
-
-},{"../core/core":55}],109:[function(_dereq_,module,exports){
-/**
- * @module Shape
- * @submodule 3D Primitives
- * @for p5
- * @requires core
- * @requires p5.Geometry
- */
-
-'use strict';
-
-var p5 = _dereq_('../core/core');
-_dereq_('./p5.Geometry');
-/**
- * Draw a plane with given a width and height
- * @method plane
- * @param {Number} width width of the plane
- * @param {Number} height height of the plane
- * @param {Number} [detailX] Optional number of triangle
- * subdivisions in x-dimension
- * @param {Number} [detailY] Optional number of triangle
- * subdivisions in y-dimension
- * @return {p5} the p5 object
- * @example
- *
- *
- * //draw a plane with width 200 and height 200
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- *
- * function draw(){
- * background(200);
- * plane(50, 50);
- * }
- *
- *
- *
- * @alt
- * Nothing displayed on canvas
- * Rotating interior view of a box with sides that change color.
- * 3d red and green gradient.
- * Rotating interior view of a cylinder with sides that change color.
- * Rotating view of a cylinder with sides that change color.
- * 3d red and green gradient.
- * rotating view of a multi-colored cylinder with concave sides.
- */
-p5.prototype.plane = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- var width = args[0] || 50;
- var height = args[1] || width;
- var detailX = typeof args[2] === 'number' ? args[2] : 1;
- var detailY = typeof args[3] === 'number' ? args[3] : 1;
-
- var gId = 'plane|'+width+'|'+height+'|'+detailX+'|'+detailY;
-
- if(!this._renderer.geometryInHash(gId)){
- var _plane = function(){
- var u,v,p;
- for (var i = 0; i <= this.detailY; i++){
- v = i / this.detailY;
- for (var j = 0; j <= this.detailX; j++){
- u = j / this.detailX;
- p = new p5.Vector(width * u - width/2,
- height * v - height/2,
- 0);
- this.vertices.push(p);
- this.uvs.push([u,v]);
- }
- }
- };
- var planeGeom =
- new p5.Geometry(detailX, detailY, _plane);
- planeGeom
- .computeFaces()
- .computeNormals();
- if(detailX <= 1 && detailY <= 1) {
- planeGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(planeGeom);
- } else {
- console.log('Cannot draw stroke on plane objects with more'+
- ' than 1 detailX or 1 detailY');
- }
- this._renderer.createBuffers(gId, planeGeom);
- }
-
- this._renderer.drawBuffers(gId);
-
-};
-
-/**
- * Draw a box with given width, height and depth
- * @method box
- * @param {Number} width width of the box
- * @param {Number} [Height] height of the box
- * @param {Number} [depth] depth of the box
- * @param {Number} [detailX] Optional number of triangle
- * subdivisions in x-dimension
- * @param {Number} [detailY] Optional number of triangle
- * subdivisions in y-dimension
- * @chainable
- * @example
- *
- *
- * //draw a spinning box with width, height and depth 200
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- *
- * function draw(){
- * background(200);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * box(200, 200, 200);
- * }
- *
- *
- */
-p5.prototype.box = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- var width = args[0] || 50;
- var height = args[1] || width;
- var depth = args[2] || width;
-
- var detailX = typeof args[3] === 'number' ? args[3] : 4;
- var detailY = typeof args[4] === 'number' ? args[4] : 4;
- var gId = 'box|'+width+'|'+height+'|'+depth+'|'+detailX+'|'+detailY;
- if(!this._renderer.geometryInHash(gId)){
- var _box = function(){
- var cubeIndices = [
- [0, 4, 2, 6],// -1, 0, 0],// -x
- [1, 3, 5, 7],// +1, 0, 0],// +x
- [0, 1, 4, 5],// 0, -1, 0],// -y
- [2, 6, 3, 7],// 0, +1, 0],// +y
- [0, 2, 1, 3],// 0, 0, -1],// -z
- [4, 5, 6, 7]// 0, 0, +1] // +z
- ];
- //using strokeIndices instead of faces for strokes
- //to avoid diagonal stroke lines across face of box
- this.strokeIndices = [
- [0,1],[1,3],[3,2],[6,7],[8,9],[9,11],[14,15],
- [16,17],[17,19],[18,19],[20,21],[22,23]
- ];
- var id=0;
- for (var i = 0; i < cubeIndices.length; i++) {
- var cubeIndex = cubeIndices[i];
- var v = i * 4;
- for (var j = 0; j < 4; j++) {
- var d = cubeIndex[j];
- //inspired by lightgl:
- //https://github.com/evanw/lightgl.js
- //octants:https://en.wikipedia.org/wiki/Octant_(solid_geometry)
- var octant = new p5.Vector(
- ((d & 1) * 2 - 1)*width/2,
- ((d & 2) - 1) *height/2,
- ((d & 4) / 2 - 1) * depth/2);
- this.vertices.push( octant );
- this.uvs.push([j & 1, (j & 2) / 2]);
- id++;
- }
- this.faces.push([v, v + 1, v + 2]);
- this.faces.push([v + 2, v + 1, v + 3]);
+ this._videoPrevUpdateTime = data.time();
+ updated = true;
}
- };
- var boxGeom = new p5.Geometry(detailX,detailY, _box);
- boxGeom.computeNormals();
- if(detailX <= 4 && detailY <= 4) {
- boxGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(boxGeom);
- } else {
- console.log('Cannot draw stroke on box objects with more'+
- ' than 4 detailX or 4 detailY');
}
- //initialize our geometry buffer with
- //the key val pair:
- //geometry Id, Geom object
- this._renderer.createBuffers(gId, boxGeom);
+ } else if (this.isImageData) {
+ if (data._dirty) {
+ data._dirty = false;
+ updated = true;
+ }
+ } else {
+ /* data instanceof p5.Graphics, probably */
+ // there is not enough information to tell if the texture can be
+ // conditionally updated; so to be safe, we just go ahead and upload it.
+ updated = true;
}
- this._renderer.drawBuffers(gId);
- return this;
+ if (updated) {
+ this.bindTexture();
+ gl.texImage2D(
+ this.glTarget,
+ 0,
+ this.glFormat,
+ this.glFormat,
+ gl.UNSIGNED_BYTE,
+ textureData
+ );
+ }
+ return updated;
};
/**
- * Draw a sphere with given radius
- * @method sphere
- * @param {Number} radius radius of circle
- * @param {Number} [detailX] number of segments,
- * the more segments the smoother geometry
- * default is 24
- * @param {Number} [detailY] number of segments,
- * the more segments the smoother geometry
- * default is 16
- * @chainable
- * @example
- *
- *
- * // draw a sphere with radius 200
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- *
- * function draw(){
- * background(200);
- * sphere(50);
- * }
- *
- *
+ * Binds the texture to the appropriate GL target.
+ * @method bindTexture
*/
-p5.prototype.sphere = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- var radius = args[0] || 50;
- var detailX = typeof args[1] === 'number' ? args[1] : 24;
- var detailY = typeof args[2] === 'number' ? args[2] : 16;
-
- var gId = 'sphere|'+radius+'|'+detailX+'|'+detailY;
- if(!this._renderer.geometryInHash(gId)){
- var _sphere = function(){
- var u,v,p;
- for (var i = 0; i <= this.detailY; i++){
- v = i / this.detailY;
- for (var j = 0; j <= this.detailX; j++){
- u = j / this.detailX;
- var theta = 2 * Math.PI * u;
- var phi = Math.PI * v - Math.PI / 2;
- p = new p5.Vector(radius * Math.cos(phi) * Math.sin(theta),
- radius * Math.sin(phi),
- radius * Math.cos(phi) * Math.cos(theta));
- this.vertices.push(p);
- this.uvs.push([u,v]);
- }
- }
- };
- var sphereGeom = new p5.Geometry(detailX, detailY, _sphere);
- sphereGeom
- .computeFaces()
- .computeNormals()
- .averageNormals()
- .averagePoleNormals();
- if(detailX <= 24 && detailY <= 16) {
- sphereGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(sphereGeom);
- } else {
- console.log('Cannot draw stroke on sphere objects with more'+
- ' than 24 detailX or 16 detailY');
- }
-
- this._renderer.createBuffers(gId, sphereGeom);
- }
- this._renderer.drawBuffers(gId);
+p5.Texture.prototype.bindTexture = function() {
+ // bind texture using gl context + glTarget and
+ // generated gl texture object
+ var gl = this._renderer.GL;
+ gl.bindTexture(this.glTarget, this.glTex);
return this;
};
-
/**
-* @private
-* helper function for creating both cones and cyllinders
-*/
-var _truncatedCone = function(
- bottomRadius,
- topRadius,
- height,
- detailX,
- detailY,
- topCap,
- bottomCap) {
- detailX = (detailX < 3) ? 3 : detailX;
- detailY = (detailY < 1) ? 1 : detailY;
- topCap = (topCap === undefined) ? true : topCap;
- bottomCap = (bottomCap === undefined) ? true : bottomCap;
- var extra = (topCap ? 2 : 0) + (bottomCap ? 2 : 0);
- var vertsAroundEdge = detailX + 1;
-
- // ensure constant slant
- var slant = Math.atan2(bottomRadius - topRadius, height);
- var start = topCap ? -2 : 0;
- var end = detailY + (bottomCap ? 2 : 0);
- var yy, ii;
- for (yy = start; yy <= end; ++yy) {
- var v = yy / detailY;
- var y = height * v;
- var ringRadius;
- if (yy < 0) {
- y = 0;
- v = 1;
- ringRadius = bottomRadius;
- } else if (yy > detailY) {
- y = height;
- v = 1;
- ringRadius = topRadius;
- } else {
- ringRadius = bottomRadius +
- (topRadius - bottomRadius) * (yy / detailY);
- }
- if (yy === -2 || yy === detailY + 2) {
- ringRadius = 0;
- v = 0;
- }
- y -= height / 2;
- for (ii = 0; ii < vertsAroundEdge; ++ii) {
- //VERTICES
- this.vertices.push(
- new p5.Vector(
- Math.sin(ii*Math.PI * 2 /detailX) * ringRadius,
- y,
- Math.cos(ii*Math.PI * 2 /detailX) * ringRadius)
- );
- //VERTEX NORMALS
- this.vertexNormals.push(
- new p5.Vector(
- (yy < 0 || yy > detailY) ? 0 :
- (Math.sin(ii * Math.PI * 2 / detailX) * Math.cos(slant)),
- (yy < 0) ? -1 : (yy > detailY ? 1 : Math.sin(slant)),
- (yy < 0 || yy > detailY) ? 0 :
- (Math.cos(ii * Math.PI * 2 / detailX) * Math.cos(slant)))
- );
- //UVs
- this.uvs.push([(ii / detailX), v]);
- }
- }
- for (yy = 0; yy < detailY + extra; ++yy) {
- for (ii = 0; ii < detailX; ++ii) {
- this.faces.push([vertsAroundEdge * (yy + 0) + 0 + ii,
- vertsAroundEdge * (yy + 0) + 1 + ii,
- vertsAroundEdge * (yy + 1) + 1 + ii]);
- this.faces.push([vertsAroundEdge * (yy + 0) + 0 + ii,
- vertsAroundEdge * (yy + 1) + 1 + ii,
- vertsAroundEdge * (yy + 1) + 0 + ii]);
- }
- }
+ * Unbinds the texture from the appropriate GL target.
+ * @method unbindTexture
+ */
+p5.Texture.prototype.unbindTexture = function() {
+ // unbind per above, disable texturing on glTarget
+ var gl = this._renderer.GL;
+ gl.bindTexture(this.glTarget, null);
};
/**
- * Draw a cylinder with given radius and height
- * @method cylinder
- * @param {Number} radius radius of the surface
- * @param {Number} height height of the cylinder
- * @param {Number} [detailX] number of segments,
- * the more segments the smoother geometry
- * default is 24
- * @param {Number} [detailY] number of segments in y-dimension,
- * the more segments the smoother geometry
- * default is 16
- * @chainable
- * @example
- *
- *
- * //draw a spinning cylinder with radius 200 and height 200
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- *
- * function draw(){
- * background(200);
- * rotateX(frameCount * 0.01);
- * rotateZ(frameCount * 0.01);
- * cylinder(200, 200);
- * }
- *
- *
+ * Sets how a texture is be interpolated when upscaled or downscaled.
+ * Nearest filtering uses nearest neighbor scaling when interpolating
+ * Linear filtering uses WebGL's linear scaling when interpolating
+ * @method setInterpolation
+ * @param {String} downScale Specifies the texture filtering when
+ * textures are shrunk. Options are LINEAR or NEAREST
+ * @param {String} upScale Specifies the texture filtering when
+ * textures are magnified. Options are LINEAR or NEAREST
+ * @todo implement mipmapping filters
*/
-p5.prototype.cylinder = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- var radius = args[0] || 50;
- var height = args[1] || radius;
- var detailX = typeof args[2] === 'number' ? args[2] : 24;
- var detailY = typeof args[3] === 'number' ? args[3] : 16;
- var gId = 'cylinder|'+radius+'|'+height+'|'+detailX+'|'+detailY;
- if(!this._renderer.geometryInHash(gId)){
- var cylinderGeom = new p5.Geometry(detailX, detailY);
- _truncatedCone.call(
- cylinderGeom,
- radius,
- radius,
- height,
- detailX,
- detailY,
- true,true);
- cylinderGeom.computeNormals();
- if(detailX <= 24 && detailY <= 16) {
- cylinderGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(cylinderGeom);
- } else {
- console.log('Cannot draw stroke on cylinder objects with more'+
- ' than 24 detailX or 16 detailY');
- }
- this._renderer.createBuffers(gId, cylinderGeom);
+p5.Texture.prototype.setInterpolation = function(downScale, upScale) {
+ var gl = this._renderer.GL;
+
+ if (downScale === constants.NEAREST) {
+ this.glMinFilter = gl.NEAREST;
+ } else {
+ this.glMinFilter = gl.LINEAR;
}
- this._renderer.drawBuffers(gId);
+ if (upScale === constants.NEAREST) {
+ this.glMagFilter = gl.NEAREST;
+ } else {
+ this.glMagFilter = gl.LINEAR;
+ }
- return this;
+ this.bindTexture();
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, this.glMinFilter);
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, this.glMagFilter);
+ this.unbindTexture();
};
-
/**
- * Draw a cone with given radius and height
- * @method cone
- * @param {Number} radius radius of the bottom surface
- * @param {Number} height height of the cone
- * @param {Number} [detailX] number of segments,
- * the more segments the smoother geometry
- * default is 24
- * @param {Number} [detailY] number of segments,
- * the more segments the smoother geometry
- * default is 16
- * @chainable
- * @example
- *
- *
- * //draw a spinning cone with radius 200 and height 200
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- *
- * function draw(){
- * background(200);
- * rotateX(frameCount * 0.01);
- * rotateZ(frameCount * 0.01);
- * cone(200, 200);
- * }
- *
- *
+ * Sets the texture wrapping mode. This controls how textures behave
+ * when their uv's go outside of the 0 - 1 range. There are three options:
+ * CLAMP, REPEAT, and MIRROR. REPEAT & MIRROR are only available if the texture
+ * is a power of two size (128, 256, 512, 1024, etc.).
+ * @method setWrapMode
+ * @param {String} wrapX Controls the horizontal texture wrapping behavior
+ * @param {String} wrapY Controls the vertical texture wrapping behavior
*/
-p5.prototype.cone = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
+p5.Texture.prototype.setWrapMode = function(wrapX, wrapY) {
+ var gl = this._renderer.GL;
+
+ // for webgl 1 we need to check if the texture is power of two
+ // if it isn't we will set the wrap mode to CLAMP
+ // webgl2 will support npot REPEAT and MIRROR but we don't check for it yet
+ var isPowerOfTwo = function(x) {
+ return (x & (x - 1)) === 0;
+ };
+
+ var widthPowerOfTwo = isPowerOfTwo(this.width);
+ var heightPowerOfTwo = isPowerOfTwo(this.width);
+
+ if (wrapX === constants.REPEAT) {
+ if (widthPowerOfTwo && heightPowerOfTwo) {
+ this.glWrapS = gl.REPEAT;
+ } else {
+ console.warn(
+ 'You tried to set the wrap mode to REPEAT but the texture size is not a power of two. Setting to CLAMP instead'
+ );
+ this.glWrapS = gl.CLAMP_TO_EDGE;
+ }
+ } else if (wrapX === constants.MIRROR) {
+ if (widthPowerOfTwo && heightPowerOfTwo) {
+ this.glWrapS = gl.MIRRORED_REPEAT;
+ } else {
+ console.warn(
+ 'You tried to set the wrap mode to MIRROR but the texture size is not a power of two. Setting to CLAMP instead'
+ );
+ this.glWrapS = gl.CLAMP_TO_EDGE;
+ }
+ } else {
+ // falling back to default if didn't get a proper mode
+ this.glWrapS = gl.CLAMP_TO_EDGE;
}
- var baseRadius = args[0] || 50;
- var height = args[1] || baseRadius;
- var detailX = typeof args[2] === 'number' ? args[2] : 24;
- var detailY = typeof args[3] === 'number' ? args[3] : 16;
- var gId = 'cone|'+baseRadius+'|'+height+'|'+detailX+'|'+detailY;
- if(!this._renderer.geometryInHash(gId)){
- var coneGeom = new p5.Geometry(detailX, detailY);
- _truncatedCone.call(coneGeom,
- baseRadius,
- 0,//top radius 0
- height,
- detailX,
- detailY,
- true,
- true);
- //for cones we need to average Normals
- coneGeom.computeNormals();
- if(detailX <= 24 && detailY <= 16) {
- coneGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(coneGeom);
+
+ if (wrapY === constants.REPEAT) {
+ if (widthPowerOfTwo && heightPowerOfTwo) {
+ this.glWrapT = gl.REPEAT;
} else {
- console.log('Cannot draw stroke on cone objects with more'+
- ' than 24 detailX or 16 detailY');
+ console.warn(
+ 'You tried to set the wrap mode to REPEAT but the texture size is not a power of two. Setting to CLAMP instead'
+ );
+ this.glWrapT = gl.CLAMP_TO_EDGE;
+ }
+ } else if (wrapY === constants.MIRROR) {
+ if (widthPowerOfTwo && heightPowerOfTwo) {
+ this.glWrapT = gl.MIRRORED_REPEAT;
+ } else {
+ console.warn(
+ 'You tried to set the wrap mode to MIRROR but the texture size is not a power of two. Setting to CLAMP instead'
+ );
+ this.glWrapT = gl.CLAMP_TO_EDGE;
}
- this._renderer.createBuffers(gId, coneGeom);
+ } else {
+ // falling back to default if didn't get a proper mode
+ this.glWrapT = gl.CLAMP_TO_EDGE;
}
- this._renderer.drawBuffers(gId);
+ this.bindTexture();
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, this.glWrapS);
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, this.glWrapT);
+ this.unbindTexture();
+};
- return this;
+module.exports = p5.Texture;
+
+},{"../core/constants":19,"../core/main":25}],78:[function(_dereq_,module,exports){
+'use strict';
+
+var p5 = _dereq_('../core/main');
+var constants = _dereq_('../core/constants');
+_dereq_('./p5.Shader');
+_dereq_('./p5.RendererGL');
+
+// Text/Typography
+// @TODO:
+p5.RendererGL.prototype._applyTextProperties = function() {
+ //@TODO finish implementation
+ //console.error('text commands not yet implemented in webgl');
+};
+
+p5.RendererGL.prototype.textWidth = function(s) {
+ if (this._isOpenType()) {
+ return this._textFont._textWidth(s, this._textSize);
+ }
+
+ return 0; // TODO: error
};
+// rendering constants
+
+// the number of rows/columns dividing each glyph
+var charGridWidth = 9;
+var charGridHeight = charGridWidth;
+
+// size of the image holding the bezier stroke info
+var strokeImageWidth = 64;
+var strokeImageHeight = 64;
+
+// size of the image holding the stroke indices for each row/col
+var gridImageWidth = 64;
+var gridImageHeight = 64;
+
+// size of the image holding the offset/length of each row/col stripe
+var cellImageWidth = 64;
+var cellImageHeight = 64;
+
/**
- * Draw an ellipsoid with given radius
- * @method ellipsoid
- * @param {Number} radiusx xradius of circle
- * @param {Number} radiusy yradius of circle
- * @param {Number} radiusz zradius of circle
- * @param {Number} [detailX] number of segments,
- * the more segments the smoother geometry
- * default is 24. Avoid detail number above
- * 150, it may crash the browser.
- * @param {Number} [detailY] number of segments,
- * the more segments the smoother geometry
- * default is 16. Avoid detail number above
- * 150, it may crash the browser.
- * @chainable
- * @example
- *
- *
- * // draw an ellipsoid with radius 20, 30 and 40.
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
+ * @private
+ * @class ImageInfos
+ * @param {Integer} width
+ * @param {Integer} height
*
- * function draw(){
- * background(200);
- * ellipsoid(20, 30, 40);
- * }
- *
- *
+ * the ImageInfos class holds a list of ImageDatas of a given size.
*/
-p5.prototype.ellipsoid = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- var detailX = typeof args[3] === 'number' ? args[3] : 24;
- var detailY = typeof args[4] === 'number' ? args[4] : 24;
- var radiusX = args[0] || 50;
- var radiusY = args[1] || radiusX;
- var radiusZ = args[2] || radiusX;
-
- var gId = 'ellipsoid|'+radiusX+'|'+radiusY+
- '|'+radiusZ+'|'+detailX+'|'+detailY;
+function ImageInfos(width, height) {
+ this.width = width;
+ this.height = height;
+ this.infos = []; // the list of images
+ /**
+ *
+ * @method findImage
+ * @param {Integer} space
+ * @return {Object} contains the ImageData, and pixel index into that
+ * ImageData where the free space was allocated.
+ *
+ * finds free space of a given size in the ImageData list
+ */
+ this.findImage = function(space) {
+ var imageSize = this.width * this.height;
+ if (space > imageSize)
+ throw new Error('font is too complex to render in 3D');
+
+ // search through the list of images, looking for one with
+ // anough unused space.
+ var imageInfo, imageData;
+ for (var ii = this.infos.length - 1; ii >= 0; --ii) {
+ var imageInfoTest = this.infos[ii];
+ if (imageInfoTest.index + space < imageSize) {
+ // found one
+ imageInfo = imageInfoTest;
+ imageData = imageInfoTest.imageData;
+ break;
+ }
+ }
- if(!this._renderer.geometryInHash(gId)){
- var _ellipsoid = function(){
- var u,v,p;
- for (var i = 0; i <= this.detailY; i++){
- v = i / this.detailY;
- for (var j = 0; j <= this.detailX; j++){
- u = j / this.detailX;
- var theta = 2 * Math.PI * u;
- var phi = Math.PI * v - Math.PI / 2;
- p = new p5.Vector(radiusX * Math.cos(phi) * Math.sin(theta),
- radiusY * Math.sin(phi),
- radiusZ * Math.cos(phi) * Math.cos(theta));
- this.vertices.push(p);
- this.uvs.push([u,v]);
+ if (!imageInfo) {
+ try {
+ // create a new image
+ imageData = new ImageData(this.width, this.height);
+ } catch (err) {
+ // for browsers that don't support ImageData constructors (ie IE11)
+ // create an ImageData using the old method
+ var canvas = document.getElementsByTagName('canvas')[0];
+ var created = !canvas;
+ if (!canvas) {
+ // create a temporary canvas
+ canvas = document.createElement('canvas');
+ canvas.style.display = 'none';
+ document.body.appendChild(canvas);
+ }
+ var ctx = canvas.getContext('2d');
+ if (ctx) {
+ imageData = ctx.createImageData(this.width, this.height);
+ }
+ if (created) {
+ // distroy the temporary canvas, if necessary
+ document.body.removeChild(canvas);
}
}
- };
- var ellipsoidGeom = new p5.Geometry(detailX, detailY,_ellipsoid);
- ellipsoidGeom
- .computeFaces()
- .computeNormals();
- if(detailX <= 24 && detailY <= 24) {
- ellipsoidGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(ellipsoidGeom);
- } else {
- console.log('Cannot draw stroke on ellipsoids with more'+
- ' than 24 detailX or 24 detailY');
+ // construct & dd the new image info
+ imageInfo = { index: 0, imageData: imageData };
+ this.infos.push(imageInfo);
}
- this._renderer.createBuffers(gId, ellipsoidGeom);
- }
- this._renderer.drawBuffers(gId);
+ var index = imageInfo.index;
+ imageInfo.index += space; // move to the start of the next image
+ imageData._dirty = true;
+ return { imageData: imageData, index: index };
+ };
+}
- return this;
-};
+/**
+ * @function setPixel
+ * @param {Object} imageInfo
+ * @param {Number} r
+ * @param {Number} g
+ * @param {Number} b
+ * @param {Number} a
+ *
+ * writes the next pixel into an indexed ImageData
+ */
+function setPixel(imageInfo, r, g, b, a) {
+ var imageData = imageInfo.imageData;
+ var pixels = imageData.data;
+ var index = imageInfo.index++ * 4;
+ pixels[index++] = r;
+ pixels[index++] = g;
+ pixels[index++] = b;
+ pixels[index++] = a;
+}
+
+var SQRT3 = Math.sqrt(3);
/**
- * Draw a torus with given radius and tube radius
- * @method torus
- * @param {Number} radius radius of the whole ring
- * @param {Number} tubeRadius radius of the tube
- * @param {Number} [detailX] number of segments in x-dimension,
- * the more segments the smoother geometry
- * default is 24
- * @param {Number} [detailY] number of segments in y-dimension,
- * the more segments the smoother geometry
- * default is 16
- * @chainable
- * @example
- *
- *
- * //draw a spinning torus with radius 200 and tube radius 60
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
+ * @private
+ * @class FontInfo
+ * @param {Object} font an opentype.js font object
*
- * function draw(){
- * background(200);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * torus(200, 60);
- * }
- *
- *
+ * contains cached images and glyph information for an opentype font
*/
-p5.prototype.torus = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
- }
- var detailX = typeof args[2] === 'number' ? args[2] : 24;
- var detailY = typeof args[3] === 'number' ? args[3] : 16;
+var FontInfo = function(font) {
+ this.font = font;
+ // the bezier curve coordinates
+ this.strokeImageInfos = new ImageInfos(strokeImageWidth, strokeImageHeight);
+ // lists of curve indices for each row/column slice
+ this.colDimImageInfos = new ImageInfos(gridImageWidth, gridImageHeight);
+ this.rowDimImageInfos = new ImageInfos(gridImageWidth, gridImageHeight);
+ // the offset & length of each row/col slice in the glyph
+ this.colCellImageInfos = new ImageInfos(cellImageWidth, cellImageHeight);
+ this.rowCellImageInfos = new ImageInfos(cellImageWidth, cellImageHeight);
+
+ // the cached information for each glyph
+ this.glyphInfos = {};
+
+ /**
+ * @method getGlyphInfo
+ * @param {Glyph} glyph the x positions of points in the curve
+ * @returns {Object} the glyphInfo for that glyph
+ *
+ * calculates rendering info for a glyph, including the curve information,
+ * row & column stripes compiled into textures.
+ */
- var radius = args[0] || 50;
- var tubeRadius = args[1] || 10;
+ this.getGlyphInfo = function(glyph) {
+ // check the cache
+ var gi = this.glyphInfos[glyph.index];
+ if (gi) return gi;
- var gId = 'torus|'+radius+'|'+tubeRadius+'|'+detailX+'|'+detailY;
+ // get the bounding box of the glyph from opentype.js
+ var bb = glyph.getBoundingBox();
+ var xMin = bb.x1;
+ var yMin = bb.y1;
+ var gWidth = bb.x2 - xMin;
+ var gHeight = bb.y2 - yMin;
+ var cmds = glyph.path.commands;
+ // don't bother rendering invisible glyphs
+ if (gWidth === 0 || gHeight === 0 || !cmds.length) {
+ return (this.glyphInfos[glyph.index] = {});
+ }
- if(!this._renderer.geometryInHash(gId)){
- var _torus = function(){
- var u,v,p;
- for (var i = 0; i <= this.detailY; i++){
- v = i / this.detailY;
- for (var j = 0; j <= this.detailX; j++){
- u = j / this.detailX;
- var theta = 2 * Math.PI * u;
- var phi = 2 * Math.PI * v;
- p = new p5.Vector(
- (radius + tubeRadius * Math.cos(phi)) * Math.cos(theta),
- (radius + tubeRadius * Math.cos(phi)) * Math.sin(theta),
- tubeRadius * Math.sin(phi));
- this.vertices.push(p);
- this.uvs.push([u,v]);
+ var i;
+ var strokes = []; // the strokes in this glyph
+ var rows = []; // the indices of strokes in each row
+ var cols = []; // the indices of strokes in each column
+ for (i = charGridWidth - 1; i >= 0; --i) cols.push([]);
+ for (i = charGridHeight - 1; i >= 0; --i) rows.push([]);
+
+ /**
+ * @function push
+ * @param {Number[]} xs the x positions of points in the curve
+ * @param {Number[]} ys the y positions of points in the curve
+ * @param {Object} v the curve information
+ *
+ * adds a curve to the rows & columns that it intersects with
+ */
+ function push(xs, ys, v) {
+ var index = strokes.length; // the index of this stroke
+ strokes.push(v); // add this stroke to the list
+
+ /**
+ * @function minMax
+ * @param {Number[]} rg the list of values to compare
+ * @param {Number} min the initial minimum value
+ * @param {Number} max the initial maximum value
+ *
+ * find the minimum & maximum value in a list of values
+ */
+ function minMax(rg, min, max) {
+ for (var i = rg.length; i-- > 0; ) {
+ var v = rg[i];
+ if (min > v) min = v;
+ if (max < v) max = v;
}
+ return { min: min, max: max };
}
- };
- var torusGeom = new p5.Geometry(detailX, detailY, _torus);
- torusGeom
- .computeFaces()
- .computeNormals()
- .averageNormals();
- if(detailX <= 24 && detailY <= 16) {
- torusGeom._makeTriangleEdges();
- this._renderer._edgesToVertices(torusGeom);
- } else {
- console.log('Cannot draw strokes on torus object with more'+
- ' than 24 detailX or 16 detailY');
+
+ // loop through the rows & columns that the curve intersects
+ // adding the curve to those slices
+ var mmX = minMax(xs, 1, 0);
+ var ixMin = Math.max(Math.floor(mmX.min * charGridWidth), 0);
+ var ixMax = Math.min(Math.ceil(mmX.max * charGridWidth), charGridWidth);
+ for (var iCol = ixMin; iCol < ixMax; ++iCol) cols[iCol].push(index);
+
+ var mmY = minMax(ys, 1, 0);
+ var iyMin = Math.max(Math.floor(mmY.min * charGridHeight), 0);
+ var iyMax = Math.min(Math.ceil(mmY.max * charGridHeight), charGridHeight);
+ for (var iRow = iyMin; iRow < iyMax; ++iRow) rows[iRow].push(index);
}
- this._renderer.createBuffers(gId, torusGeom);
- }
- this._renderer.drawBuffers(gId);
- return this;
-};
+ /**
+ * @function clamp
+ * @param {Number} v the value to clamp
+ * @param {Number} min the minimum value
+ * @param {Number} max the maxmimum value
+ *
+ * clamps a value between a minimum & maximum value
+ */
+ function clamp(v, min, max) {
+ if (v < min) return min;
+ if (v > max) return max;
+ return v;
+ }
-///////////////////////
-/// 2D primitives
-/////////////////////////
+ /**
+ * @function byte
+ * @param {Number} v the value to scale
+ *
+ * converts a floating-point number in the range 0-1 to a byte 0-255
+ */
+ function byte(v) {
+ return clamp(255 * v, 0, 255);
+ }
-//@TODO
-p5.RendererGL.prototype.point = function(x, y, z){
- console.log('point not yet implemented in webgl');
- return this;
-};
+ /**
+ * @private
+ * @class Cubic
+ * @param {Number} p0 the start point of the curve
+ * @param {Number} c0 the first control point
+ * @param {Number} c1 the second control point
+ * @param {Number} p1 the end point
+ *
+ * a cubic curve
+ */
+ function Cubic(p0, c0, c1, p1) {
+ this.p0 = p0;
+ this.c0 = c0;
+ this.c1 = c1;
+ this.p1 = p1;
+
+ /**
+ * @method toQuadratic
+ * @return {Object} the quadratic approximation
+ *
+ * converts the cubic to a quadtratic approximation by
+ * picking an appropriate quadratic control point
+ */
+ this.toQuadratic = function() {
+ return {
+ x: this.p0.x,
+ y: this.p0.y,
+ x1: this.p1.x,
+ y1: this.p1.y,
+ cx: ((this.c0.x + this.c1.x) * 3 - (this.p0.x + this.p1.x)) / 4,
+ cy: ((this.c0.y + this.c1.y) * 3 - (this.p0.y + this.p1.y)) / 4
+ };
+ };
-p5.RendererGL.prototype.triangle = function
-(args){
- var x1=args[0], y1=args[1];
- var x2=args[2], y2=args[3];
- var x3=args[4], y3=args[5];
- var gId = 'tri|'+x1+'|'+y1+'|'+
- x2+'|'+y2+'|'+
- x3+'|'+y3;
- if(!this.geometryInHash(gId)){
- var _triangle = function(){
- var vertices = [];
- vertices.push(new p5.Vector(x1,y1,0));
- vertices.push(new p5.Vector(x2,y2,0));
- vertices.push(new p5.Vector(x3,y3,0));
- this.strokeIndices = [[0,1], [1,2], [2,0]];
- this.vertices = vertices;
- this.faces = [[0,1,2]];
- this.uvs = [[0,0],[0,1],[1,1]];
- };
- var triGeom = new p5.Geometry(1,1,_triangle);
- triGeom._makeTriangleEdges();
- this._edgesToVertices(triGeom);
- triGeom.computeNormals();
- this.createBuffers(gId, triGeom);
- }
+ /**
+ * @method quadError
+ * @return {Number} the error
+ *
+ * calculates the magnitude of error of this curve's
+ * quadratic approximation.
+ */
+ this.quadError = function() {
+ return (
+ p5.Vector.sub(
+ p5.Vector.sub(this.p1, this.p0),
+ p5.Vector.mult(p5.Vector.sub(this.c1, this.c0), 3)
+ ).mag() / 2
+ );
+ };
- this.drawBuffers(gId);
- return this;
-};
+ /**
+ * @method split
+ * @param {Number} t the value (0-1) at which to split
+ * @return {Cubic} the second part of the curve
+ *
+ * splits the cubic into two parts at a point 't' along the curve.
+ * this cubic keeps its start point and its end point becomes the
+ * point at 't'. the 'end half is returned.
+ */
+ this.split = function(t) {
+ var m1 = p5.Vector.lerp(this.p0, this.c0, t);
+ var m2 = p5.Vector.lerp(this.c0, this.c1, t);
+ var mm1 = p5.Vector.lerp(m1, m2, t);
+
+ this.c1 = p5.Vector.lerp(this.c1, this.p1, t);
+ this.c0 = p5.Vector.lerp(m2, this.c1, t);
+ var pt = p5.Vector.lerp(mm1, this.c0, t);
+ var part1 = new Cubic(this.p0, m1, mm1, pt);
+ this.p0 = pt;
+ return part1;
+ };
-p5.RendererGL.prototype.ellipse = function
-(args){
- var x = args[0];
- var y = args[1];
- var width = args[2];
- var height = args[3];
- //detailX and Y are optional 6th & 7th
- //arguments
- var detailX = args[4] || 24;
- var detailY = args[5] || 16;
- var gId = 'ellipse|'+args[0]+'|'+args[1]+'|'+args[2]+'|'+
- args[3];
- if(!this.geometryInHash(gId)){
- var _ellipse = function(){
- var u,v,p;
- var centerX = x+width*0.5;
- var centerY = y+height*0.5;
- for (var i = 0; i <= this.detailY; i++){
- v = i / this.detailY;
- for (var j = 0; j <= this.detailX; j++){
- u = j / this.detailX;
- var theta = 2 * Math.PI * u;
- if(v === 0){
- p = new p5.Vector(centerX, centerY, 0);
+ /**
+ * @method splitInflections
+ * @return {Cubic[]} the non-inflecting pieces of this cubic
+ *
+ * returns an array containing 0, 1 or 2 cubics split resulting
+ * from splitting this cubic at its inflection points.
+ * this cubic is (potentially) altered and returned in the list.
+ */
+ this.splitInflections = function() {
+ var a = p5.Vector.sub(this.c0, this.p0);
+ var b = p5.Vector.sub(p5.Vector.sub(this.c1, this.c0), a);
+ var c = p5.Vector.sub(
+ p5.Vector.sub(p5.Vector.sub(this.p1, this.c1), a),
+ p5.Vector.mult(b, 2)
+ );
+
+ var cubics = [];
+
+ // find the derivative coefficients
+ var A = b.x * c.y - b.y * c.x;
+ if (A !== 0) {
+ var B = a.x * c.y - a.y * c.x;
+ var C = a.x * b.y - a.y * b.x;
+ var disc = B * B - 4 * A * C;
+ if (disc >= 0) {
+ if (A < 0) {
+ A = -A;
+ B = -B;
+ C = -C;
+ }
+
+ var Q = Math.sqrt(disc);
+ var t0 = (-B - Q) / (2 * A); // the first inflection point
+ var t1 = (-B + Q) / (2 * A); // the second inflection point
+
+ // test if the first inflection point lies on the curve
+ if (t0 > 0 && t0 < 1) {
+ // split at the first inflection point
+ cubics.push(this.split(t0));
+ // scale t2 into the second part
+ t1 = 1 - (1 - t1) / (1 - t0);
+ }
+
+ // test if the second inflection point lies on the curve
+ if (t1 > 0 && t1 < 1) {
+ // split at the second inflection point
+ cubics.push(this.split(t1));
+ }
}
- else{
- var _x = centerX + width*0.5 * Math.cos(theta);
- var _y = centerY + height*0.5 * Math.sin(theta);
- p = new p5.Vector(_x, _y, 0);
+ }
+
+ cubics.push(this);
+ return cubics;
+ };
+ }
+
+ /**
+ * @function cubicToQuadratics
+ * @param {Number} x0
+ * @param {Number} y0
+ * @param {Number} cx0
+ * @param {Number} cy0
+ * @param {Number} cx1
+ * @param {Number} cy1
+ * @param {Number} x1
+ * @param {Number} y1
+ * @returns {Cubic[]} an array of cubics whose quadratic approximations
+ * closely match the civen cubic.
+ *
+ * converts a cubic curve to a list of quadratics.
+ */
+ function cubicToQuadratics(x0, y0, cx0, cy0, cx1, cy1, x1, y1) {
+ // create the Cubic object and split it at its inflections
+ var cubics = new Cubic(
+ new p5.Vector(x0, y0),
+ new p5.Vector(cx0, cy0),
+ new p5.Vector(cx1, cy1),
+ new p5.Vector(x1, y1)
+ ).splitInflections();
+
+ var qs = []; // the final list of quadratics
+ var precision = 30 / SQRT3;
+
+ // for each of the non-inflected pieces of the original cubic
+ for (var i = 0; i < cubics.length; i++) {
+ var cubic = cubics[i];
+
+ // the cubic is iteratively split in 3 pieces:
+ // the first piece is accumulated in 'qs', the result.
+ // the last piece is accumulated in 'tail', temporarily.
+ // the middle piece is repeatedly split again, while necessary.
+ var tail = [];
+
+ var t3;
+ for (;;) {
+ // calculate this cubic's precision
+ t3 = precision / cubic.quadError();
+ if (t3 >= 0.5 * 0.5 * 0.5) {
+ break; // not too bad, we're done
}
- this.vertices.push(p);
- this.uvs.push([u,v]);
+
+ // find a split point based on the error
+ var t = Math.pow(t3, 1.0 / 3.0);
+ // split the cubic in 3
+ var start = cubic.split(t);
+ var middle = cubic.split(1 - t / (1 - t));
+
+ qs.push(start); // the first part
+ tail.push(cubic); // the last part
+ cubic = middle; // iterate on the middle piece
+ }
+
+ if (t3 < 1) {
+ // a little excess error, split the middle in two
+ qs.push(cubic.split(0.5));
}
+ // add the middle piece to the result
+ qs.push(cubic);
+
+ // finally add the tail, reversed, onto the result
+ Array.prototype.push.apply(qs, tail.reverse());
}
- };
- var ellipseGeom = new p5.Geometry(detailX,detailY,_ellipse);
- ellipseGeom
- .computeFaces()
- .computeNormals();
- if(detailX <= 24 && detailY <= 16) {
- ellipseGeom._makeTriangleEdges();
- this._edgesToVertices(ellipseGeom);
- } else {
- console.log('Cannot stroke ellipse with more'+
- ' than 24 detailX or 16 detailY');
+
+ return qs;
}
- this.createBuffers(gId, ellipseGeom);
- }
- this.drawBuffers(gId);
- return this;
-};
+ /**
+ * @function pushLine
+ * @param {Number} x0
+ * @param {Number} y0
+ * @param {Number} x1
+ * @param {Number} y1
+ *
+ * add a straight line to the row/col grid of a glyph
+ */
+ function pushLine(x0, y0, x1, y1) {
+ var mx = (x0 + x1) / 2;
+ var my = (y0 + y1) / 2;
+ push([x0, x1], [y0, y1], { x: x0, y: y0, cx: mx, cy: my });
+ }
-p5.RendererGL.prototype.rect = function(args) {
- var gId = 'rect|'+args[0]+'|'+args[1]+'|'+args[2]+'|'+
- args[3];
- var x = args[0];
- var y = args[1];
- var width = args[2];
- var height = args[3];
- var detailX = args[4] || 24;
- var detailY = args[5] || 16;
- if(!this.geometryInHash(gId)){
- var _rect = function(){
- var u,v,p;
- for (var i = 0; i <= this.detailY; i++){
- v = i / this.detailY;
- for (var j = 0; j <= this.detailX; j++){
- u = j / this.detailX;
- // var _x = x-width/2;
- // var _y = y-height/2;
- p = new p5.Vector(
- x + (width*u),
- y + (height*v),
- 0
- );
- this.vertices.push(p);
- this.uvs.push([u,v]);
+ /**
+ * @function samePoint
+ * @param {Number} x0
+ * @param {Number} y0
+ * @param {Number} x1
+ * @param {Number} y1
+ * @return {Boolean} true if the two points are sufficiently close
+ *
+ * tests if two points are close enough to be considered the same
+ */
+ function samePoint(x0, y0, x1, y1) {
+ return Math.abs(x1 - x0) < 0.00001 && Math.abs(y1 - y0) < 0.00001;
+ }
+
+ var x0, y0, xs, ys;
+ for (var iCmd = 0; iCmd < cmds.length; ++iCmd) {
+ var cmd = cmds[iCmd];
+ // scale the coordinates to the range 0-1
+ var x1 = (cmd.x - xMin) / gWidth;
+ var y1 = (cmd.y - yMin) / gHeight;
+
+ // don't bother if this point is the same as the last
+ if (samePoint(x0, y0, x1, y1)) continue;
+
+ switch (cmd.type) {
+ case 'M': // move
+ xs = x1;
+ ys = y1;
+ break;
+ case 'L': // line
+ pushLine(x0, y0, x1, y1);
+ break;
+ case 'Q': // quadratic
+ var cx = (cmd.x1 - xMin) / gWidth;
+ var cy = (cmd.y1 - yMin) / gHeight;
+ push([x0, x1, cx], [y0, y1, cy], { x: x0, y: y0, cx: cx, cy: cy });
+ break;
+ case 'Z': // end
+ if (!samePoint(x0, y0, xs, ys)) {
+ // add an extra line closing the loop, if necessary
+ pushLine(x0, y0, xs, ys);
+ strokes.push({ x: xs, y: ys });
+ } else {
+ strokes.push({ x: x0, y: y0 });
+ }
+ break;
+ case 'C': // cubic
+ var cx1 = (cmd.x1 - xMin) / gWidth;
+ var cy1 = (cmd.y1 - yMin) / gHeight;
+ var cx2 = (cmd.x2 - xMin) / gWidth;
+ var cy2 = (cmd.y2 - yMin) / gHeight;
+ var qs = cubicToQuadratics(x0, y0, cx1, cy1, cx2, cy2, x1, y1);
+ for (var iq = 0; iq < qs.length; iq++) {
+ var q = qs[iq].toQuadratic();
+ push([q.x, q.x1, q.cx], [q.y, q.y1, q.cy], q);
+ }
+ break;
+ default:
+ throw new Error('unknown command type: ' + cmd.type);
+ }
+ x0 = x1;
+ y0 = y1;
+ }
+
+ // allocate space for the strokes
+ var strokeCount = strokes.length;
+ var strokeImageInfo = this.strokeImageInfos.findImage(strokeCount);
+ var strokeOffset = strokeImageInfo.index;
+
+ // fill the stroke image
+ for (var il = 0; il < strokeCount; ++il) {
+ var s = strokes[il];
+ setPixel(strokeImageInfo, byte(s.x), byte(s.y), byte(s.cx), byte(s.cy));
+ }
+
+ /**
+ * @function layout
+ * @param {Number[][]} dim
+ * @param {ImageInfo[]} dimImageInfos
+ * @param {ImageInfo[]} cellImageInfos
+ * @return {Object}
+ *
+ * lays out the curves in a dimension (row or col) into two
+ * images, one for the indices of the curves themselves, and
+ * one containing the offset and length of those index spans.
+ */
+ function layout(dim, dimImageInfos, cellImageInfos) {
+ var dimLength = dim.length; // the number of slices in this dimension
+ var dimImageInfo = dimImageInfos.findImage(dimLength);
+ var dimOffset = dimImageInfo.index;
+ // calculate the total number of stroke indices in this dimension
+ var totalStrokes = 0;
+ for (var id = 0; id < dimLength; ++id) {
+ totalStrokes += dim[id].length;
+ }
+
+ // allocate space for the stroke indices
+ var cellImageInfo = cellImageInfos.findImage(totalStrokes);
+
+ // for each slice in the glyph
+ for (var i = 0; i < dimLength; ++i) {
+ var strokeIndices = dim[i];
+ var strokeCount = strokeIndices.length;
+ var cellLineIndex = cellImageInfo.index;
+
+ // write the offset and count into the glyph slice image
+ setPixel(
+ dimImageInfo,
+ cellLineIndex >> 7,
+ cellLineIndex & 0x7f,
+ strokeCount >> 7,
+ strokeCount & 0x7f
+ );
+
+ // for each stroke index in that slice
+ for (var iil = 0; iil < strokeCount; ++iil) {
+ // write the stroke index into the slice's image
+ var strokeIndex = strokeIndices[iil] + strokeOffset;
+ setPixel(cellImageInfo, strokeIndex >> 7, strokeIndex & 0x7f, 0, 0);
}
}
+
+ return {
+ cellImageInfo: cellImageInfo,
+ dimOffset: dimOffset,
+ dimImageInfo: dimImageInfo
+ };
+ }
+
+ // initialize the info for this glyph
+ gi = this.glyphInfos[glyph.index] = {
+ glyph: glyph,
+ uGlyphRect: [bb.x1, -bb.y1, bb.x2, -bb.y2],
+ strokeImageInfo: strokeImageInfo,
+ strokes: strokes,
+ colInfo: layout(cols, this.colDimImageInfos, this.colCellImageInfos),
+ rowInfo: layout(rows, this.rowDimImageInfos, this.rowCellImageInfos)
};
- var rectGeom = new p5.Geometry(detailX,detailY,_rect);
- rectGeom
- .computeFaces()
- .computeNormals()
- ._makeTriangleEdges();
- this._edgesToVertices(rectGeom);
- this.createBuffers(gId, rectGeom);
- }
- this.drawBuffers(gId);
- return this;
+ gi.uGridOffset = [gi.colInfo.dimOffset, gi.rowInfo.dimOffset];
+ return gi;
+ };
};
-p5.RendererGL.prototype.quad = function(){
- var args = new Array(arguments.length);
- for (var i = 0; i < args.length; ++i) {
- args[i] = arguments[i];
+p5.RendererGL.prototype._renderText = function(p, line, x, y, maxY) {
+ if (y >= maxY || !this._doFill) {
+ return; // don't render lines beyond our maxY position
}
- var x1 = args[0],
- y1 = args[1],
- x2 = args[2],
- y2 = args[3],
- x3 = args[4],
- y3 = args[5],
- x4 = args[6],
- y4 = args[7];
- var gId = 'quad|'+x1+'|'+y1+'|'+
- x2+'|'+y2+'|'+
- x3+'|'+y3+'|'+
- x4+'|'+y4;
- if(!this.geometryInHash(gId)){
- var _quad = function(){
- this.vertices.push(new p5.Vector(x1,y1,0));
- this.vertices.push(new p5.Vector(x2,y2,0));
- this.vertices.push(new p5.Vector(x3,y3,0));
- this.vertices.push(new p5.Vector(x4,y4,0));
- this.uvs.push([0, 0], [1, 0], [1, 1], [0, 1]);
- this.strokeIndices = [[0,1], [1,2], [2,3], [3,0]];
- };
- var quadGeom = new p5.Geometry(2,2,_quad);
- quadGeom
- .computeNormals()
- ._makeTriangleEdges();
- this._edgesToVertices(quadGeom);
- quadGeom.faces = [[0,1,2],[2,3,0]];
- this.createBuffers(gId, quadGeom);
+
+ if (!this._isOpenType()) {
+ console.log('WEBGL: only opentype fonts are supported');
+ return p;
}
- this.drawBuffers(gId);
- return this;
-};
-//this implementation of bezier curve
-//is based on Bernstein polynomial
-p5.RendererGL.prototype.bezier = function
-(args){
- var bezierDetail=args[12] || 20;//value of Bezier detail
- this.beginShape();
- var coeff=[0,0,0,0];// Bernstein polynomial coeffecients
- var vertex=[0,0,0]; //(x,y,z) coordinates of points in bezier curve
- for(var i=0; i<=bezierDetail; i++){
- coeff[0]=Math.pow(1-(i/bezierDetail),3);
- coeff[1]=(3*(i/bezierDetail)) * (Math.pow(1-(i/bezierDetail),2));
- coeff[2]=(3*Math.pow(i/bezierDetail,2)) * (1-(i/bezierDetail));
- coeff[3]=Math.pow(i/bezierDetail,3);
- vertex[0]=args[0]*coeff[0] + args[3]*coeff[1] +
- args[6]*coeff[2] + args[9]*coeff[3];
- vertex[1]=args[1]*coeff[0] + args[4]*coeff[1] +
- args[7]*coeff[2] + args[10]*coeff[3];
- vertex[2]=args[2]*coeff[0] + args[5]*coeff[1] +
- args[8]*coeff[2] + args[11]*coeff[3];
- this.vertex(vertex[0],vertex[1],vertex[2]);
+ p.push(); // fix to #803
+
+ // remember this state, so it can be restored later
+ var curFillShader = this.curFillShader;
+ var doStroke = this._doStroke;
+ var drawMode = this.drawMode;
+
+ this.curFillShader = null;
+ this._doStroke = false;
+ this.drawMode = constants.TEXTURE;
+
+ // get the cached FontInfo object
+ var font = this._textFont.font;
+ var fontInfo = this._textFont._fontInfo;
+ if (!fontInfo) {
+ fontInfo = this._textFont._fontInfo = new FontInfo(font);
}
- this.endShape();
- return this;
-};
-p5.RendererGL.prototype.curve=function
-(args){
- var curveDetail=args[12];
- this.beginShape();
- var coeff=[0,0,0,0];//coeffecients of the equation
- var vertex=[0,0,0]; //(x,y,z) coordinates of points in bezier curve
- for(var i=0; i<=curveDetail; i++){
- coeff[0]=Math.pow((i/curveDetail),3) * 0.5;
- coeff[1]=Math.pow((i/curveDetail),2) * 0.5;
- coeff[2]=(i/curveDetail) * 0.5;
- coeff[3]=0.5;
- vertex[0]=coeff[0]*(-args[0] + (3*args[3]) - (3*args[6]) +args[9]) +
- coeff[1]*((2*args[0]) - (5*args[3]) + (4*args[6]) - args[9]) +
- coeff[2]*(-args[0] + args[6]) +
- coeff[3]*(2*args[3]);
- vertex[1]=coeff[0]*(-args[1] + (3*args[4]) - (3*args[7]) +args[10]) +
- coeff[1]*((2*args[1]) - (5*args[4]) + (4*args[7]) - args[10]) +
- coeff[2]*(-args[1] + args[7]) +
- coeff[3]*(2*args[4]);
- vertex[2]=coeff[0]*(-args[2] + (3*args[5]) - (3*args[8]) +args[11]) +
- coeff[1]*((2*args[2]) - (5*args[5]) + (4*args[8]) - args[11]) +
- coeff[2]*(-args[2] + args[8]) +
- coeff[3]*(2*args[5]);
- this.vertex(vertex[0],vertex[1],vertex[2]);
+ // calculate the alignment and move/scale the view accordingly
+ var pos = this._textFont._handleAlignment(this, line, x, y);
+ var fontSize = this._textSize;
+ var scale = fontSize / font.unitsPerEm;
+ this.translate(pos.x, pos.y, 0);
+ this.scale(scale, scale, 1);
+
+ // initialize the font shader
+ var gl = this.GL;
+ var initializeShader = !this._defaultFontShader;
+ var sh = this.setFillShader(this._getFontShader());
+ if (initializeShader) {
+ // these are constants, really. just initialize them one-time.
+ sh.setUniform('uGridImageSize', [gridImageWidth, gridImageHeight]);
+ sh.setUniform('uCellsImageSize', [cellImageWidth, cellImageHeight]);
+ sh.setUniform('uStrokeImageSize', [strokeImageWidth, strokeImageHeight]);
+ sh.setUniform('uGridSize', [charGridWidth, charGridHeight]);
+ }
+ this._applyColorBlend(this.curFillColor);
+
+ var g = this.gHash['glyph'];
+ if (!g) {
+ // create the geometry for rendering a quad
+ var geom = (this._textGeom = new p5.Geometry(1, 1, function() {
+ for (var i = 0; i <= 1; i++) {
+ for (var j = 0; j <= 1; j++) {
+ this.vertices.push(new p5.Vector(j, i, 0));
+ this.uvs.push(j, i);
+ }
+ }
+ }));
+ geom.computeFaces().computeNormals();
+ g = this.createBuffers('glyph', geom);
}
- this.endShape();
- return this;
-};
-/**
- * Draw a line given two points
- * @param {Number} x0 x-coordinate of first vertex
- * @param {Number} y0 y-coordinate of first vertex
- * @param {Number} z0 z-coordinate of first vertex
- * @param {Number} x1 x-coordinate of second vertex
- * @param {Number} y1 y-coordinate of second vertex
- * @param {Number} z1 z-coordinate of second vertex
- * @chainable
- * @example
- *
- *
- * //draw a line
- * function setup(){
- * createCanvas(100, 100, WEBGL);
- * }
- *
- * function draw(){
- * background(200);
- * rotateX(frameCount * 0.01);
- * rotateY(frameCount * 0.01);
- * // Use fill instead of stroke to change the color of shape.
- * fill(255, 0, 0);
- * line(10, 10, 0, 60, 60, 20);
- * }
- *
- *
- */
-p5.RendererGL.prototype.line = function(x0,y0,z0,x1,y1,z1) {
- if (typeof x0 !== 'undefined' ||
- typeof y0 !== 'undefined' ||
- typeof z0 !== 'undefined' ||
- typeof x1 !== 'undefined' ||
- typeof y1 !== 'undefined' ||
- typeof z1 !== 'undefined')
- {
- this.beginShape();
- this.vertex(x0, y0, z0);
- this.vertex(x1, y1, z1);
- this.endShape();
+ // bind the shader buffers
+ this._bindBuffer(g.vertexBuffer, gl.ARRAY_BUFFER);
+ sh.enableAttrib(sh.attributes.aPosition.location, 3, gl.FLOAT, false, 0, 0);
+ this._bindBuffer(g.indexBuffer, gl.ELEMENT_ARRAY_BUFFER);
+ this._bindBuffer(g.uvBuffer, gl.ARRAY_BUFFER);
+ sh.enableAttrib(sh.attributes.aTexCoord.location, 2, gl.FLOAT, false, 0, 0);
+
+ // this will have to do for now...
+ sh.setUniform('uMaterialColor', this.curFillColor);
+
+ try {
+ var dx = 0; // the x position in the line
+ var glyphPrev = null; // the previous glyph, used for kerning
+ var shaderBound = false;
+ // fetch the glyphs in the line of text
+ var glyphs = font.stringToGlyphs(line);
+ for (var ig = 0; ig < glyphs.length; ++ig) {
+ var glyph = glyphs[ig];
+ // kern
+ if (glyphPrev) dx += font.getKerningValue(glyphPrev, glyph);
+
+ var gi = fontInfo.getGlyphInfo(glyph);
+ if (gi.uGlyphRect) {
+ var rowInfo = gi.rowInfo;
+ var colInfo = gi.colInfo;
+ sh.setUniform('uSamplerStrokes', gi.strokeImageInfo.imageData);
+ sh.setUniform('uSamplerRowStrokes', rowInfo.cellImageInfo.imageData);
+ sh.setUniform('uSamplerRows', rowInfo.dimImageInfo.imageData);
+ sh.setUniform('uSamplerColStrokes', colInfo.cellImageInfo.imageData);
+ sh.setUniform('uSamplerCols', colInfo.dimImageInfo.imageData);
+ sh.setUniform('uGridOffset', gi.uGridOffset);
+ sh.setUniform('uGlyphRect', gi.uGlyphRect);
+ sh.setUniform('uGlyphOffset', dx);
+
+ if (!shaderBound) {
+ shaderBound = true;
+ sh.bindShader(); // first time around, bind the shader fully
+ } else {
+ sh.bindTextures(); // afterwards, only textures need updating
+ }
+
+ // draw it
+ gl.drawElements(gl.TRIANGLES, 6, this.GL.UNSIGNED_SHORT, 0);
+ }
+ dx += glyph.advanceWidth;
+ glyphPrev = glyph;
+ }
+ } finally {
+ // clean up
+ sh.unbindShader();
+
+ this.curFillShader = curFillShader;
+ this._doStroke = doStroke;
+ this.drawMode = drawMode;
+
+ p.pop();
}
- return this;
-};
-module.exports = p5;
+ this._pInst._pixelsDirty = true;
+ return p;
+};
-},{"../core/core":55,"./p5.Geometry":102}]},{},[46])(46)
+},{"../core/constants":19,"../core/main":25,"./p5.RendererGL":75,"./p5.Shader":76}]},{},[14])(14)
});
\ No newline at end of file
diff --git a/libraries/p5/p5.min.js b/libraries/p5/p5.min.js
index a7f8f5fa..0f512893 100644
--- a/libraries/p5/p5.min.js
+++ b/libraries/p5/p5.min.js
@@ -1,38 +1,15 @@
-/*! p5.js v0.5.16 October 11, 2017 */ !function(a){if("object"==typeof exports&&"undefined"!=typeof module)module.exports=a();else if("function"==typeof define&&define.amd)define([],a);else{var b;b="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:this,b.p5=a()}}(function(){var a;return function a(b,c,d){function e(g,h){if(!c[g]){if(!b[g]){var i="function"==typeof require&&require;if(!h&&i)return i(g,!0);if(f)return f(g,!0);var j=new Error("Cannot find module '"+g+"'");throw j.code="MODULE_NOT_FOUND",j}var k=c[g]={exports:{}};b[g][0].call(k.exports,function(a){var c=b[g][1][a];return e(c?c:a)},k,k.exports,a,b,c,d)}return c[g].exports}for(var f="function"==typeof require&&require,g=0;gEach color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.\nInternally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.
\nWe also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.
\n"},Setting:{name:"Setting",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Color",namespace:"",file:"src/color/setting.js",line:1,requires:["core","constants"]},Shape:{name:"Shape",submodules:{"2D Primitives":1,Curves:1,Vertex:1,"3D Models":1,"3D Primitives":1},elements:{},classes:{},fors:{p5:1},namespaces:{}},"2D Primitives":{name:"2D Primitives",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Shape",namespace:"",file:"src/core/2d_primitives.js",line:1,requires:["core","constants"]},Attributes:{name:"Attributes",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Typography",namespace:"",file:"src/core/attributes.js",line:1,requires:["core","constants"]},Constants:{name:"Constants",submodules:{},elements:{},classes:{},fors:{p5:1},namespaces:{},module:"Constants",file:"src/core/constants.js",line:1},Structure:{name:"Structure",submodules:{},elements:{},classes:{},fors:{p5:1},namespaces:{},module:"Structure",file:"src/core/core.js",line:1,requires:["constants"]},Curves:{name:"Curves",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Shape",namespace:"",file:"src/core/curves.js",line:1,requires:["core"]},Environment:{name:"Environment",submodules:{},elements:{},classes:{},fors:{p5:1},namespaces:{},module:"Environment",file:"src/core/environment.js",line:1,requires:["core","constants"]},DOM:{name:"DOM",submodules:{},elements:{},classes:{"p5.Element":1},fors:{"p5.Element":1},namespaces:{},module:"DOM",file:"src/core/p5.Element.js",line:9,description:'Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.
\n'},Rendering:{name:"Rendering",submodules:{},elements:{},classes:{"p5.Graphics":1,"p5.Renderer":1},fors:{p5:1},namespaces:{},module:"Rendering",file:"src/core/p5.Renderer.js",line:10,description:"Thin wrapper around a renderer, to be used for creating a\ngraphics buffer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels. The fields and methods for this class are\nextensive, but mirror the normal drawing API for p5.
\n"},Transform:{name:"Transform",submodules:{},elements:{},classes:{},fors:{p5:1},namespaces:{},module:"Transform",file:"src/core/transform.js",line:1,requires:["core","constants"]},Vertex:{name:"Vertex",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Shape",namespace:"",file:"src/core/vertex.js",line:1,requires:["core","constants"]},Data:{name:"Data",submodules:{Dictionary:1,"Array Functions":1,"String Functions":1},elements:{},classes:{"p5.TypedDict":1,"p5.StringDict":1,"p5.NumberDict":1},fors:{"p5.TypedDict":1,p5:1},namespaces:{},file:"src/data/p5.TypedDict.js",line:351},Dictionary:{name:"Dictionary",submodules:{},elements:{},classes:{"p5.TypedDict":1,"p5.StringDict":1,"p5.NumberDict":1},fors:{"p5.TypedDict":1},is_submodule:1,namespaces:{},module:"Data",namespace:"",file:"src/data/p5.TypedDict.js",line:351,requires:["core\n\nThis module defines the p5 methods for the p5 Dictionary classes\nthese classes StringDict and NumberDict are for storing and working\nwith key","value pairs"],description:"Base class for all p5.Dictionary types. More specifically\n typed Dictionary objects inherit from this
\n"},Events:{name:"Events",submodules:{Acceleration:1,Keyboard:1,Mouse:1,Touch:1},elements:{},classes:{},fors:{p5:1},namespaces:{}},Acceleration:{name:"Acceleration",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Events",namespace:"",file:"src/events/acceleration.js",line:1,requires:["core"]},Keyboard:{name:"Keyboard",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Events",namespace:"",file:"src/events/keyboard.js",line:1,requires:["core"]},Mouse:{name:"Mouse",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Events",namespace:"",file:"src/events/mouse.js",line:1,requires:["core","constants"]},Touch:{name:"Touch",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Events",namespace:"",file:"src/events/touch.js",line:1,requires:["core"]},Image:{name:"Image",submodules:{Pixels:1},elements:{},classes:{"p5.Image":1},fors:{p5:1},namespaces:{},module:"Image",file:"src/image/p5.Image.js",line:23,requires:["core"],description:"Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n
\np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n
\nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n
\nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.
\n"},"Loading & Displaying":{name:"Loading & Displaying",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Typography",namespace:"",file:"src/image/loading_displaying.js",line:1,requires:["core"]},Pixels:{name:"Pixels",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Image",namespace:"",file:"src/image/pixels.js",line:1,requires:["core"]},IO:{name:"IO",submodules:{"Color Conversion":1,Input:1,Output:1,Table:1,XML:1,"Time & Date":1},elements:{},classes:{p5:1,"p5.Table":1,"p5.TableRow":1,"p5.XML":1},fors:{p5:1},namespaces:{},file:"src/io/p5.XML.js",line:11},Input:{name:"Input",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"IO",namespace:"",file:"src/io/files.js",line:1,requires:["core"]},Output:{name:"Output",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"IO",namespace:"",file:"src/io/files.js",line:1012},Table:{name:"Table",submodules:{},elements:{},classes:{"p5.Table":1,"p5.TableRow":1},fors:{},is_submodule:1,namespaces:{},module:"IO",namespace:"",file:"src/io/p5.TableRow.js",line:11,requires:["core"],description:"Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.
\n"},XML:{name:"XML",submodules:{},elements:{},classes:{"p5.XML":1},fors:{},is_submodule:1,namespaces:{},module:"IO",namespace:"",file:"src/io/p5.XML.js",line:11,requires:["core"],description:"XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.
\n"},Math:{name:"Math",submodules:{Calculation:1,Noise:1,Random:1,Trigonometry:1},elements:{},classes:{"p5.Vector":1},fors:{p5:1},namespaces:{},module:"Math",file:"src/math/p5.Vector.js",line:13,requires:["core"],description:"A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n
\nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n
\nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.
\n"},Calculation:{name:"Calculation",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Math",namespace:"",file:"src/math/calculation.js",line:1,requires:["core"]},Noise:{name:"Noise",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Math",namespace:"",file:"src/math/noise.js",line:14,requires:["core"]},Random:{name:"Random",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Math",namespace:"",file:"src/math/random.js",line:1,requires:["core"]},Trigonometry:{name:"Trigonometry",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Math",namespace:"",file:"src/math/trigonometry.js",line:1,requires:["core","polargeometry","constants"]},Typography:{name:"Typography",submodules:{Attributes:1,"Loading & Displaying":1,Font:1},elements:{},classes:{"p5.Font":1},fors:{p5:1},namespaces:{},file:"src/typography/p5.Font.js",line:21},Font:{name:"Font",submodules:{},elements:{},classes:{"p5.Font":1},fors:{},is_submodule:1,namespaces:{},module:"Typography",namespace:"",file:"src/typography/p5.Font.js",line:21,description:"This module defines the p5.Font class and functions for\ndrawing text to the display canvas.
\n",requires:["core","constants"]},"Array Functions":{name:"Array Functions",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Data",namespace:"",file:"src/utilities/array_functions.js",line:1,requires:["core"]},"String Functions":{name:"String Functions",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Data",namespace:"",file:"src/utilities/string_functions.js",line:1,requires:["core"]},"Time & Date":{name:"Time & Date",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"IO",namespace:"",file:"src/utilities/time_date.js",line:1,requires:["core"]},"Lights, Camera":{name:"Lights, Camera",submodules:{Camera:1,Lights:1,Material:1,Shaders:1},elements:{},classes:{"p5.Geometry":1,"p5.RendererGL":1,"p5.Shader":1,"p5.Texture":1},fors:{p5:1},namespaces:{},file:"src/webgl/p5.Texture.js",line:11},Camera:{name:"Camera",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Lights, Camera",namespace:"",file:"src/webgl/camera.js",line:1,requires:["core"]},Lights:{name:"Lights",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Lights, Camera",namespace:"",file:"src/webgl/light.js",line:1,requires:["core"]},"3D Models":{name:"3D Models",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Shape",namespace:"",file:"src/webgl/loading.js",line:1,requires:["core","p5.Geometry"]},Material:{name:"Material",submodules:{},elements:{},classes:{"p5.Texture":1},fors:{p5:1},is_submodule:1,namespaces:{},module:"Lights, Camera",namespace:"",file:"src/webgl/p5.Texture.js",line:11,requires:["core"],description:"This module defines the p5.Texture class
\n"},Shaders:{name:"Shaders",submodules:{},elements:{},classes:{"p5.Shader":1},fors:{p5:1},is_submodule:1,namespaces:{},module:"Lights, Camera",namespace:"",file:"src/webgl/p5.Shader.js",line:11,description:"This module defines the p5.Shader class
\n",requires:["core"]},"3D Primitives":{name:"3D Primitives",submodules:{},elements:{},classes:{},fors:{p5:1},is_submodule:1,namespaces:{},module:"Shape",namespace:"",file:"src/webgl/primitives.js",line:1,requires:["core","p5.Geometry"]},"p5.dom":{name:"p5.dom",submodules:{},elements:{},classes:{"p5.dom":1,"p5.MediaElement":1,"p5.File":1},fors:{"p5.dom":1,"p5.Element":1},namespaces:{},module:"p5.dom",file:"lib/addons/p5.dom.js",line:2482,description:'The web is much more than just canvas and p5.dom makes it easy to interact\nwith other HTML5 objects, including text, hyperlink, image, input, video,\naudio, and webcam.
\nThere is a set of creation methods, DOM manipulation methods, and\nan extended p5.Element that supports a range of HTML elements. See the\n\nbeyond the canvas tutorial for a full overview of how this addon works.
\nMethods and properties shown in black are part of the p5.js core, items in\nblue are part of the p5.dom library. You will need to include an extra file\nin order to access the blue functions. See the\nusing a library\nsection for information on how to include this library. p5.dom comes with\np5 complete or you can download the single file\n\nhere.
\nSee tutorial: beyond the canvas\nfor more info on how to use this libary.
\n',tag:"main",itemtype:"main"},"p5.sound":{name:"p5.sound",submodules:{},elements:{},classes:{p5:1,"p5.sound":1,"p5.SoundFile":1,"p5.Amplitude":1,"p5.FFT":1,"p5.Signal":1,"p5.Oscillator":1,"p5.SinOsc":1,"p5.TriOsc":1,"p5.SawOsc":1,"p5.SqrOsc":1,"p5.Env":1,"p5.Pulse":1,"p5.Noise":1,"p5.AudioIn":1,"p5.Effect":1,"p5.Filter":1,"p5.LowPass":1,"p5.HighPass":1,BandPass:1,"p5.Delay":1,"p5.Reverb":1,"p5.Convolver":1,"p5.Phrase":1,"p5.Part":1,"p5.Score":1,"p5.Compressor":1,"p5.SoundRecorder":1,"p5.PeakDetect":1,"p5.Gain":1,"p5.Distortion":1},fors:{"p5.sound":1},namespaces:{},module:"p5.sound",file:"lib/addons/p5.sound.js",line:10410,description:'p5.sound extends p5 with Web Audio functionality including audio input,\nplayback, analysis and synthesis.\n
\np5.SoundFile: Load and play sound files.
\np5.Amplitude: Get the current volume of a sound.
\np5.AudioIn: Get sound from an input source, typically\n a computer microphone.
\np5.FFT: Analyze the frequency of sound. Returns\n results from the frequency spectrum or time domain (waveform).
\np5.Oscillator: Generate Sine,\n Triangle, Square and Sawtooth waveforms. Base class of\n p5.Noise and p5.Pulse.\n
\np5.Env: An Envelope is a series\n of fades over time. Often used to control an object's\n output gain level as an "ADSR Envelope" (Attack, Decay,\n Sustain, Release). Can also modulate other parameters.
\np5.Delay: A delay effect with\n parameters for feedback, delayTime, and lowpass filter.
\np5.Filter: Filter the frequency range of a\n sound.\n
\np5.Reverb: Add reverb to a sound by specifying\n duration and decay.
\np5.Convolver: Extends\np5.Reverb to simulate the sound of real\n physical spaces through convolution.
\np5.SoundRecorder: Record sound for playback\n / save the .wav file.\np5.Phrase, p5.Part and\np5.Score: Compose musical sequences.\n
\np5.sound is on GitHub.\nDownload the latest version\nhere.
\n',tag:"main",itemtype:"main"}},classes:{p5:{name:"p5",shortname:"p5",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:409},"p5.Color":{name:"p5.Color",shortname:"p5.Color",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Color",submodule:"Creating & Reading",namespace:"",file:"src/color/p5.Color.js",line:14,description:"Each color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.
\nInternally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.
\nWe also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.
\n",is_constructor:1},"p5.Element":{name:"p5.Element",shortname:"p5.Element",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"DOM",submodule:"DOM",namespace:"",file:"src/core/p5.Element.js",line:9,description:'Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.
\n',is_constructor:1,params:[{name:"elt",description:"DOM node that is wrapped
\n",type:"String"},{name:"pInst",description:"pointer to p5 instance
\n",type:"P5",optional:!0}]},"p5.Graphics":{name:"p5.Graphics",shortname:"p5.Graphics",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Rendering",submodule:"Rendering",namespace:"",file:"src/core/p5.Graphics.js",line:10,description:"Thin wrapper around a renderer, to be used for creating a\ngraphics buffer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels. The fields and methods for this class are\nextensive, but mirror the normal drawing API for p5.
\n",is_constructor:1,extends:"p5.Element",params:[{name:"w",description:"width
\n",type:"Number"},{name:"h",description:"height
\n",type:"Number"},{name:"renderer",description:"the renderer to use, either P2D or WEBGL
\n",type:"Constant"},{name:"pInst",description:"pointer to p5 instance
\n",type:"P5",optional:!0}]},"p5.Renderer":{name:"p5.Renderer",shortname:"p5.Renderer",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Rendering",submodule:"Rendering",namespace:"",file:"src/core/p5.Renderer.js",line:10,description:"Main graphics and rendering context, as well as the base API\nimplementation for p5.js "core". To be used as the superclass for\nRenderer2D and Renderer3D classes, respecitvely.
\n",is_constructor:1,extends:"p5.Element",params:[{name:"elt",description:"DOM node that is wrapped
\n",type:"String"},{name:"pInst",description:"pointer to p5 instance
\n",type:"P5",optional:!0},{name:"isMainCanvas",description:"whether we're using it as main canvas
\n",type:"Boolean",optional:!0}]},"p5.TypedDict":{name:"p5.TypedDict",shortname:"p5.TypedDict",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Data",submodule:"Dictionary",namespace:"",file:"src/data/p5.TypedDict.js",line:48,description:"Base class for all p5.Dictionary types. More specifically\n typed Dictionary objects inherit from this
\n",is_constructor:1},"p5.StringDict":{name:"p5.StringDict",shortname:"p5.StringDict",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Data",submodule:"Dictionary",namespace:"",file:"src/data/p5.TypedDict.js",line:330,description:"A Dictionary class for Strings.
\n",is_constructor:1,extends:"p5.TypedDict"},"p5.NumberDict":{name:"p5.NumberDict",shortname:"p5.NumberDict",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Data",submodule:"Dictionary",namespace:"",file:"src/data/p5.TypedDict.js",line:351,description:"A simple Dictionary class for Numbers.
\n",is_constructor:1,extends:"p5.TypedDict"},"p5.Image":{name:"p5.Image",shortname:"p5.Image",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Image",submodule:"Image",namespace:"",file:"src/image/p5.Image.js",line:23,
-description:"Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n
\np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n
\nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n
\nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.
\n",is_constructor:1,params:[{name:"width",description:"",type:"Number"},{name:"height",description:"",type:"Number"}]},"p5.Table":{name:"p5.Table",shortname:"p5.Table",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"IO",submodule:"Table",namespace:"",file:"src/io/p5.Table.js",line:36,description:"Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.
\n",is_constructor:1,params:[{name:"rows",description:"An array of p5.TableRow objects
\n",type:"p5.TableRow[]",optional:!0}]},"p5.TableRow":{name:"p5.TableRow",shortname:"p5.TableRow",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"IO",submodule:"Table",namespace:"",file:"src/io/p5.TableRow.js",line:11,description:"A TableRow object represents a single row of data values,\nstored in columns, from a table.
\nA Table Row contains both an ordered array, and an unordered\nJSON object.
\n",is_constructor:1,params:[{name:"str",description:"optional: populate the row with a\n string of values, separated by the\n separator
\n",type:"String",optional:!0},{name:"separator",description:"comma separated values (csv) by default
\n",type:"String",optional:!0}]},"p5.XML":{name:"p5.XML",shortname:"p5.XML",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"IO",submodule:"XML",namespace:"",file:"src/io/p5.XML.js",line:11,description:"XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.
\n",is_constructor:1,example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var children = xml.getChildren("animal");\n\n for (var i = 0; i < children.length; i++) {\n var id = children[i].getNum("id");\n var coloring = children[i].getString("species");\n var name = children[i].getContent();\n print(id + ", " + coloring + ", " + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n'],alt:"no image displayed"},"p5.Vector":{name:"p5.Vector",shortname:"p5.Vector",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Math",submodule:"Math",namespace:"",file:"src/math/p5.Vector.js",line:13,description:"A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n
\nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n
\nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.
\n",is_constructor:1,params:[{name:"x",description:"x component of the vector
\n",type:"Number",optional:!0},{name:"y",description:"y component of the vector
\n",type:"Number",optional:!0},{name:"z",description:"z component of the vector
\n",type:"Number",optional:!0}],example:["\n\n\nvar v1 = createVector(40, 50);\nvar v2 = createVector(40, 50);\n\nellipse(v1.x, v1.y, 50, 50);\nellipse(v2.x, v2.y, 50, 50);\nv1.add(v2);\nellipse(v1.x, v1.y, 50, 50);\n\n"],alt:"2 white ellipses. One center-left the other bottom right and off canvas"},"p5.Font":{name:"p5.Font",shortname:"p5.Font",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Typography",submodule:"Font",namespace:"",file:"src/typography/p5.Font.js",line:21,description:"Base class for font handling
\n",is_constructor:1,params:[{name:"pInst",description:"pointer to p5 instance
\n",type:"P5",optional:!0}]},"p5.Geometry":{name:"p5.Geometry",shortname:"p5.Geometry",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Lights, Camera",namespace:"",file:"src/webgl/p5.Geometry.js",line:6,description:"p5 Geometry class
\n",is_constructor:1,params:[{name:"vertData",description:"callback function or Object\n containing routine(s) for vertex data generation
\n",type:"Function | Object"},{name:"detailX",description:"number of vertices on horizontal surface
\n",type:"Number",optional:!0},{name:"detailY",description:"number of vertices on horizontal surface
\n",type:"Number",optional:!0},{name:"callback",description:"function to call upon object instantiation.
\n",type:"Function",optional:!0}]},"p5.RendererGL":{name:"p5.RendererGL",shortname:"p5.RendererGL",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Lights, Camera",namespace:"",file:"src/webgl/p5.RendererGL.js",line:36,description:"3D graphics class
\n",is_constructor:1,extends:"p5.Renderer",todo:["extend class to include public method for offscreen\nrendering (FBO)."]},"p5.Shader":{name:"p5.Shader",shortname:"p5.Shader",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Lights, Camera",submodule:"Shaders",namespace:"",file:"src/webgl/p5.Shader.js",line:11,description:"Shader class for WEBGL Mode
\n",is_constructor:1,params:[{name:"renderer",description:"an instance of p5.RendererGL that\nwill provide the GL context for this new p5.Shader
\n",type:"p5.RendererGL"},{name:"vertSrc",description:"source code for the vertex shader (as a string)
\n",type:"String"},{name:"fragSrc",description:"source code for the fragment shader (as a string)
\n",type:"String"}]},"p5.Texture":{name:"p5.Texture",shortname:"p5.Texture",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"Lights, Camera",submodule:"Material",namespace:"",file:"src/webgl/p5.Texture.js",line:11,description:"Texture class for WEBGL Mode
\n",is_constructor:1,params:[{name:"renderer",description:"an instance of p5.RendererGL that\nwill provide the GL context for this new p5.Texture
\n",type:"p5.RendererGL"},{name:"obj",description:"the\nobject containing the image data to store in the texture.
\n",type:"p5.Image|p5.Graphics|p5.Element|p5.MediaElement",optional:!0}]},"p5.dom":{name:"p5.dom",shortname:"p5.dom",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.dom",submodule:"p5.dom",namespace:""},"p5.MediaElement":{name:"p5.MediaElement",shortname:"p5.MediaElement",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.dom",submodule:"p5.dom",namespace:"",file:"lib/addons/p5.dom.js",line:1728,description:"Extends p5.Element to handle audio and video. In addition to the methods\nof p5.Element, it also contains methods for controlling media. It is not\ncalled directly, but p5.MediaElements are created by calling createVideo,\ncreateAudio, and createCapture.
\n",is_constructor:1,params:[{name:"elt",description:"DOM node that is wrapped
\n",type:"String"}]},"p5.File":{name:"p5.File",shortname:"p5.File",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.dom",submodule:"p5.dom",namespace:"",file:"lib/addons/p5.dom.js",line:2482,description:"Base class for a file\nUsing this for createFileInput
\n",is_constructor:1,params:[{name:"file",description:"File that is wrapped
\n",type:"File"}]},"p5.sound":{name:"p5.sound",shortname:"p5.sound",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:""},"p5.SoundFile":{name:"p5.SoundFile",shortname:"p5.SoundFile",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:754,description:"SoundFile object with a path to a file.
\n\nThe p5.SoundFile may not be available immediately because\nit loads the file information asynchronously.
\n\nTo do something with the sound as soon as it loads\npass the name of a function as the second parameter.
\n\nOnly one file path is required. However, audio file formats\n(i.e. mp3, ogg, wav and m4a/aac) are not supported by all\nweb browsers. If you want to ensure compatability, instead of a single\nfile path, you may include an Array of filepaths, and the browser will\nchoose a format that works.
",is_constructor:1,params:[{name:"path",description:"path to a sound file (String). Optionally,\n you may include multiple file formats in\n an array. Alternately, accepts an object\n from the HTML5 File API, or a p5.File.
\n",type:"String|Array"},{name:"successCallback",description:"Name of a function to call once file loads
\n",type:"Function",optional:!0},{name:"errorCallback",description:"Name of a function to call if file fails to\n load. This function will receive an error or\n XMLHttpRequest object with information\n about what went wrong.
\n",type:"Function",optional:!0},{name:"whileLoadingCallback",description:"Name of a function to call while file\n is loading. That function will\n receive progress of the request to\n load the sound file\n (between 0 and 1) as its first\n parameter. This progress\n does not account for the additional\n time needed to decode the audio data.
\n",type:"Function",optional:!0}],example:["\n\n\nfunction preload() {\n soundFormats('mp3', 'ogg');\n mySound = loadSound('assets/doorbell.mp3');\n}\n\nfunction setup() {\n mySound.setVolume(0.1);\n mySound.play();\n}\n\n "]},"p5.Amplitude":{name:"p5.Amplitude",shortname:"p5.Amplitude",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:2158,description:"Amplitude measures volume between 0.0 and 1.0.\nListens to all p5sound by default, or use setInput()\nto listen to a specific sound source. Accepts an optional\nsmoothing value, which defaults to 0.
\n",is_constructor:1,params:[{name:"smoothing",description:"between 0.0 and .999 to smooth\n amplitude readings (defaults to 0)
\n",type:"Number",optional:!0}],example:["\n\nvar sound, amplitude, cnv;\n\nfunction preload(){\n sound = loadSound('assets/beat.mp3');\n}\nfunction setup() {\n cnv = createCanvas(100,100);\n amplitude = new p5.Amplitude();\n\n // start / stop the sound when canvas is clicked\n cnv.mouseClicked(function() {\n if (sound.isPlaying() ){\n sound.stop();\n } else {\n sound.play();\n }\n });\n}\nfunction draw() {\n background(0);\n fill(255);\n var level = amplitude.getLevel();\n var size = map(level, 0, 1, 0, 200);\n ellipse(width/2, height/2, size, size);\n}\n\n"]},"p5.FFT":{name:"p5.FFT",shortname:"p5.FFT",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:2430,description:'FFT (Fast Fourier Transform) is an analysis algorithm that\nisolates individual\n\naudio frequencies within a waveform.
\n\nOnce instantiated, a p5.FFT object can return an array based on\ntwo types of analyses:
• FFT.waveform() computes\namplitude values along the time domain. The array indices correspond\nto samples across a brief moment in time. Each value represents\namplitude of the waveform at that sample of time.
\n• FFT.analyze() computes amplitude values along the\nfrequency domain. The array indices correspond to frequencies (i.e.\npitches), from the lowest to the highest that humans can hear. Each\nvalue represents amplitude at that slice of the frequency spectrum.\nUse with getEnergy() to measure amplitude at specific\nfrequencies, or within a range of frequencies.
\n\nFFT analyzes a very short snapshot of sound called a sample\nbuffer. It returns an array of amplitude measurements, referred\nto as bins. The array is 1024 bins long by default.\nYou can change the bin array length, but it must be a power of 2\nbetween 16 and 1024 in order for the FFT algorithm to function\ncorrectly. The actual size of the FFT buffer is twice the\nnumber of bins, so given a standard sample rate, the buffer is\n2048/44100 seconds long.
',is_constructor:1,params:[{name:"smoothing",description:"Smooth results of Freq Spectrum.\n 0.0 < smoothing < 1.0.\n Defaults to 0.8.
\n",type:"Number",optional:!0},{name:"bins",description:"Length of resulting array.\n Must be a power of two between\n 16 and 1024. Defaults to 1024.
\n",type:"Number",optional:!0}],example:["\n\nfunction preload(){\n sound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup(){\n var cnv = createCanvas(100,100);\n cnv.mouseClicked(togglePlay);\n fft = new p5.FFT();\n sound.amp(0.2);\n}\n\nfunction draw(){\n background(0);\n\n var spectrum = fft.analyze();\n noStroke();\n fill(0,255,0); // spectrum is green\n for (var i = 0; i< spectrum.length; i++){\n var x = map(i, 0, spectrum.length, 0, width);\n var h = -height + map(spectrum[i], 0, 255, height, 0);\n rect(x, height, width / spectrum.length, h )\n }\n\n var waveform = fft.waveform();\n noFill();\n beginShape();\n stroke(255,0,0); // waveform is red\n strokeWeight(1);\n for (var i = 0; i< waveform.length; i++){\n var x = map(i, 0, waveform.length, 0, width);\n var y = map( waveform[i], -1, 1, 0, height);\n vertex(x,y);\n }\n endShape();\n\n text('click to play/pause', 4, 10);\n}\n\n// fade sound if mouse is over canvas\nfunction togglePlay() {\n if (sound.isPlaying()) {\n sound.pause();\n } else {\n sound.loop();\n }\n}\n"]},"p5.Signal":{name:"p5.Signal",shortname:"p5.Signal",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:4274,description:"p5.Signal is a constant audio-rate signal used by p5.Oscillator\nand p5.Envelope for modulation math.
\n\nThis is necessary because Web Audio is processed on a seprate clock.\nFor example, the p5 draw loop runs about 60 times per second. But\nthe audio clock must process samples 44100 times per second. If we\nwant to add a value to each of those samples, we can't do it in the\ndraw loop, but we can do it by adding a constant-rate audio signal.This class mostly functions behind the scenes in p5.sound, and returns\na Tone.Signal from the Tone.js library by Yotam Mann.\nIf you want to work directly with audio signals for modular\nsynthesis, check out\ntone.js.
",is_constructor:1,return:{description:"A Signal object from the Tone.js library",type:"Tone.Signal"},example:["\n\nfunction setup() {\n carrier = new p5.Oscillator('sine');\n carrier.amp(1); // set amplitude\n carrier.freq(220); // set frequency\n carrier.start(); // start oscillating\n\n modulator = new p5.Oscillator('sawtooth');\n modulator.disconnect();\n modulator.amp(1);\n modulator.freq(4);\n modulator.start();\n\n // Modulator's default amplitude range is -1 to 1.\n // Multiply it by -200, so the range is -200 to 200\n // then add 220 so the range is 20 to 420\n carrier.freq( modulator.mult(-200).add(220) );\n}\n"]},"p5.Oscillator":{name:"p5.Oscillator",shortname:"p5.Oscillator",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:4419,description:'Creates a signal that oscillates between -1.0 and 1.0.\nBy default, the oscillation takes the form of a sinusoidal\nshape ('sine'). Additional types include 'triangle',\n'sawtooth' and 'square'. The frequency defaults to\n440 oscillations per second (440Hz, equal to the pitch of an\n'A' note).
\n\nSet the type of oscillation with setType(), or by instantiating a\nspecific oscillator: p5.SinOsc, p5.TriOsc, p5.SqrOsc, or p5.SawOsc.\n
',is_constructor:1,params:[{name:"freq",description:"frequency defaults to 440Hz
\n",type:"Number",optional:!0},{name:"type",description:"type of oscillator. Options:\n 'sine' (default), 'triangle',\n 'sawtooth', 'square'
\n",type:"String",optional:!0}],example:["\n\nvar osc;\nvar playing = false;\n\nfunction setup() {\n backgroundColor = color(255,0,255);\n textAlign(CENTER);\n\n osc = new p5.Oscillator();\n osc.setType('sine');\n osc.freq(240);\n osc.amp(0);\n osc.start();\n}\n\nfunction draw() {\n background(backgroundColor)\n text('click to play', width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {\n if (!playing) {\n // ramp amplitude to 0.5 over 0.1 seconds\n osc.amp(0.5, 0.05);\n playing = true;\n backgroundColor = color(0,255,255);\n } else {\n // ramp amplitude to 0 over 0.5 seconds\n osc.amp(0, 0.5);\n playing = false;\n backgroundColor = color(255,0,255);\n }\n }\n}\n "]},"p5.SinOsc":{name:"p5.SinOsc",shortname:"p5.SinOsc",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:4854,description:"Constructor: new p5.SinOsc().\nThis creates a Sine Wave Oscillator and is\nequivalent to new p5.Oscillator('sine')\n or creating a p5.Oscillator and then calling\nits method setType('sine').\nSee p5.Oscillator for methods.
\n",is_constructor:1,extends:"{p5.Oscillator}",params:[{name:"freq",description:"Set the frequency
\n",type:"Number",optional:!0}]},"p5.TriOsc":{name:"p5.TriOsc",shortname:"p5.TriOsc",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:4871,description:"Constructor: new p5.TriOsc().\nThis creates a Triangle Wave Oscillator and is\nequivalent to new p5.Oscillator('triangle')\n or creating a p5.Oscillator and then calling\nits method setType('triangle').\nSee p5.Oscillator for methods.
\n",is_constructor:1,extends:"{p5.Oscillator}",params:[{name:"freq",description:"Set the frequency
\n",type:"Number",optional:!0}]},"p5.SawOsc":{name:"p5.SawOsc",shortname:"p5.SawOsc",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:4888,description:"Constructor: new p5.SawOsc().\nThis creates a SawTooth Wave Oscillator and is\nequivalent to new p5.Oscillator('sawtooth')\n or creating a p5.Oscillator and then calling\nits method setType('sawtooth').\nSee p5.Oscillator for methods.
\n",is_constructor:1,extends:"{p5.Oscillator}",params:[{name:"freq",description:"Set the frequency
\n",type:"Number",optional:!0}]},"p5.SqrOsc":{name:"p5.SqrOsc",shortname:"p5.SqrOsc",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:4905,description:"Constructor: new p5.SqrOsc().\nThis creates a Square Wave Oscillator and is\nequivalent to new p5.Oscillator('square')\n or creating a p5.Oscillator and then calling\nits method setType('square').\nSee p5.Oscillator for methods.
\n",is_constructor:1,extends:"{p5.Oscillator}",params:[{name:"freq",description:"Set the frequency
\n",type:"Number",optional:!0}]},"p5.Env":{name:"p5.Env",shortname:"p5.Env",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:5280,description:'Envelopes are pre-defined amplitude distribution over time.\nTypically, envelopes are used to control the output volume\nof an object, a series of fades referred to as Attack, Decay,\nSustain and Release (\nADSR\n). Envelopes can also control other Web Audio Parameters—for example, a p5.Env can\ncontrol an Oscillator's frequency like this: osc.freq(env).
\nUse setRange to change the attack/release level.\nUse setADSR to change attackTime, decayTime, sustainPercent and releaseTime.
\nUse the play method to play the entire envelope,\nthe ramp method for a pingable trigger,\nor triggerAttack/\ntriggerRelease to trigger noteOn/noteOff.
',is_constructor:1,example:["\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"]},"p5.Pulse":{name:"p5.Pulse",shortname:"p5.Pulse",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:6076,description:'Creates a Pulse object, an oscillator that implements\nPulse Width Modulation.\nThe pulse is created with two oscillators.\nAccepts a parameter for frequency, and to set the\nwidth between the pulses. See \np5.Oscillator for a full list of methods.
\n',extends:"p5.Oscillator",is_constructor:1,params:[{name:"freq",description:"Frequency in oscillations per second (Hz)
\n",type:"Number",optional:!0},{name:"w",description:"Width between the pulses (0 to 1.0,\n defaults to 0)
\n",type:"Number",optional:!0}],example:["\n\nvar pulse;\nfunction setup() {\n background(0);\n\n // Create and start the pulse wave oscillator\n pulse = new p5.Pulse();\n pulse.amp(0.5);\n pulse.freq(220);\n pulse.start();\n}\n\nfunction draw() {\n var w = map(mouseX, 0, width, 0, 1);\n w = constrain(w, 0, 1);\n pulse.width(w)\n}\n"]},"p5.Noise":{name:"p5.Noise",shortname:"p5.Noise",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:6253,description:"Noise is a type of oscillator that generates a buffer with random values.
\n",extends:"p5.Oscillator",is_constructor:1,params:[{name:"type",description:"Type of noise can be 'white' (default),\n 'brown' or 'pink'.
\n",type:"String"}]},"p5.AudioIn":{name:"p5.AudioIn",shortname:"p5.AudioIn",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:6439,description:'Get audio from an input, i.e. your computer's microphone.
\n\nTurn the mic on/off with the start() and stop() methods. When the mic\nis on, its volume can be measured with getLevel or by connecting an\nFFT object.
\n\nIf you want to hear the AudioIn, use the .connect() method.\nAudioIn does not connect to p5.sound output by default to prevent\nfeedback.
\n\nNote: This uses the getUserMedia/\nStream API, which is not supported by certain browsers. Access in Chrome browser\nis limited to localhost and https, but access over http may be limited.
',is_constructor:1,params:[{name:"errorCallback",description:"A function to call if there is an error\n accessing the AudioIn. For example,\n Safari and iOS devices do not\n currently allow microphone access.
\n",type:"Function",optional:!0}],example:["\n\nvar mic;\nfunction setup(){\n mic = new p5.AudioIn()\n mic.start();\n}\nfunction draw(){\n background(0);\n micLevel = mic.getLevel();\n ellipse(width/2, constrain(height-micLevel*height*5, 0, height), 10, 10);\n}\n"]},"p5.Effect":{name:"p5.Effect",shortname:"p5.Effect",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:7694,description:'Effect is a base class for audio effects in p5.
\nThis module handles the nodes and methods that are \ncommon and useful for current and future effects.
\nThis class is extended by p5.Distortion, \np5.Compressor,\np5.Delay, \np5.Filter, \np5.Reverb.
\n',is_constructor:1,params:[{name:"ac",description:"Reference to the audio context of the p5 object
\n",type:"Object",optional:!0},{name:"input",description:"Gain Node effect wrapper
\n",type:"WebAudioNode",optional:!0},{name:"output",description:"Gain Node effect wrapper
\n",type:"WebAudioNode",optional:!0},{name:"_drywet",description:"Tone.JS CrossFade node (defaults to value: 1)
\n",type:"Object",optional:!0},{name:"wet",description:"Effects that extend this class should connect\n to the wet signal to this gain node, so that dry and wet \n signals are mixed properly.
\n",type:"WebAudioNode",optional:!0}]},"p5.Filter":{name:"p5.Filter",shortname:"p5.Filter",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:7825,description:'A p5.Filter uses a Web Audio Biquad Filter to filter\nthe frequency response of an input source. Subclasses\ninclude:
\n\np5.LowPass:\nAllows frequencies below the cutoff frequency to pass through,\nand attenuates frequencies above the cutoff.
p5.HighPass:\nThe opposite of a lowpass filter.
p5.BandPass:\nAllows a range of frequencies to pass through and attenuates\nthe frequencies below and above this frequency range.
\nThe .res() method controls either width of the\nbandpass, or resonance of the low/highpass cutoff frequency.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n',extends:"p5.Effect",is_constructor:1,params:[{name:"type",description:"'lowpass' (default), 'highpass', 'bandpass'
\n",type:"String",optional:!0}],example:["\n\nvar fft, noise, filter;\n\nfunction setup() {\n fill(255, 40, 255);\n\n filter = new p5.BandPass();\n\n noise = new p5.Noise();\n // disconnect unfiltered noise,\n // and connect to filter\n noise.disconnect();\n noise.connect(filter);\n noise.start();\n\n fft = new p5.FFT();\n}\n\nfunction draw() {\n background(30);\n\n // set the BandPass frequency based on mouseX\n var freq = map(mouseX, 0, width, 20, 10000);\n filter.freq(freq);\n // give the filter a narrow band (lower res = wider bandpass)\n filter.res(50);\n\n // draw filtered spectrum\n var spectrum = fft.analyze();\n noStroke();\n for (var i = 0; i < spectrum.length; i++) {\n var x = map(i, 0, spectrum.length, 0, width);\n var h = -height + map(spectrum[i], 0, 255, height, 0);\n rect(x, height, width/spectrum.length, h);\n }\n\n isMouseOverCanvas();\n}\n\nfunction isMouseOverCanvas() {\n var mX = mouseX, mY = mouseY;\n if (mX > 0 && mX < width && mY < height && mY > 0) {\n noise.amp(0.5, 0.2);\n } else {\n noise.amp(0, 0.2);\n }\n}\n"]},"p5.LowPass":{name:"p5.LowPass",shortname:"p5.LowPass",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:8015,
-description:"Constructor: new p5.LowPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('lowpass').\nSee p5.Filter for methods.
\n",is_constructor:1,extends:"{p5.Filter}"},"p5.HighPass":{name:"p5.HighPass",shortname:"p5.HighPass",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:8029,description:"Constructor: new p5.HighPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('highpass').\nSee p5.Filter for methods.
\n",is_constructor:1,extends:"{p5.Filter}"},BandPass:{name:"BandPass",shortname:"BandPass",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:8043,description:"Constructor: new p5.BandPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('bandpass').\nSee p5.Filter for methods.
\n",is_constructor:1,extends:"{p5.Filter}"},"p5.Delay":{name:"p5.Delay",shortname:"p5.Delay",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:8064,description:'Delay is an echo effect. It processes an existing sound source,\nand outputs a delayed version of that sound. The p5.Delay can\nproduce different effects depending on the delayTime, feedback,\nfilter, and type. In the example below, a feedback of 0.5 (the\ndefaul value) will produce a looping delay that decreases in\nvolume by 50% each repeat. A filter will cut out the high\nfrequencies so that the delay does not sound as piercing as the\noriginal source.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n',extends:"p5.Effect",is_constructor:1,example:["\n\nvar noise, env, delay;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n noise = new p5.Noise('brown');\n noise.amp(0);\n noise.start();\n\n delay = new p5.Delay();\n\n // delay.process() accepts 4 parameters:\n // source, delayTime, feedback, filter frequency\n // play with these numbers!!\n delay.process(noise, .12, .7, 2300);\n\n // play the noise with an envelope,\n // a series of fades ( time / value pairs )\n env = new p5.Env(.01, 0.2, .2, .1);\n}\n\n// mouseClick triggers envelope\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(noise);\n }\n}\n"]},"p5.Reverb":{name:"p5.Reverb",shortname:"p5.Reverb",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:8341,description:'Reverb adds depth to a sound through a large number of decaying\nechoes. It creates the perception that sound is occurring in a\nphysical space. The p5.Reverb has paramters for Time (how long does the\nreverb last) and decayRate (how much the sound decays with each echo)\nthat can be set with the .set() or .process() methods. The p5.Convolver\nextends p5.Reverb allowing you to recreate the sound of actual physical\nspaces through convolution.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n',extends:"p5.Effect",is_constructor:1,example:["\n\nvar soundFile, reverb;\nfunction preload() {\n soundFile = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n reverb = new p5.Reverb();\n soundFile.disconnect(); // so we'll only hear reverb...\n\n // connect soundFile to reverb, process w/\n // 3 second reverbTime, decayRate of 2%\n reverb.process(soundFile, 3, 2);\n soundFile.play();\n}\n"]},"p5.Convolver":{name:"p5.Convolver",shortname:"p5.Convolver",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:8501,description:'p5.Convolver extends p5.Reverb. It can emulate the sound of real\nphysical spaces through a process called \nconvolution.
\n\nConvolution multiplies any audio input by an "impulse response"\nto simulate the dispersion of sound over time. The impulse response is\ngenerated from an audio file that you provide. One way to\ngenerate an impulse response is to pop a balloon in a reverberant space\nand record the echo. Convolution can also be used to experiment with\nsound.
\n\nUse the method createConvolution(path) to instantiate a\np5.Convolver with a path to your impulse response audio file.
',extends:"p5.Effect",is_constructor:1,params:[{name:"path",description:"path to a sound file
\n",type:"String"},{name:"callback",description:"function to call when loading succeeds
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to call if loading fails.\n This function will receive an error or\n XMLHttpRequest object with information\n about what went wrong.
\n",type:"Function",optional:!0}],example:["\n\nvar cVerb, sound;\nfunction preload() {\n // We have both MP3 and OGG versions of all sound assets\n soundFormats('ogg', 'mp3');\n\n // Try replacing 'bx-spring' with other soundfiles like\n // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox'\n cVerb = createConvolver('assets/bx-spring.mp3');\n\n // Try replacing 'Damscray_DancingTiger' with\n // 'beat', 'doorbell', lucky_dragons_-_power_melody'\n sound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n // disconnect from master output...\n sound.disconnect();\n\n // ...and process with cVerb\n // so that we only hear the convolution\n cVerb.process(sound);\n\n sound.play();\n}\n"]},"p5.Phrase":{name:"p5.Phrase",shortname:"p5.Phrase",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:9074,description:"A phrase is a pattern of musical events over time, i.e.\na series of notes and rests.
\n\nPhrases must be added to a p5.Part for playback, and\neach part can play multiple phrases at the same time.\nFor example, one Phrase might be a kick drum, another\ncould be a snare, and another could be the bassline.
\n\nThe first parameter is a name so that the phrase can be\nmodified or deleted later. The callback is a a function that\nthis phrase will call at every step—for example it might be\ncalled playNote(value){}. The array determines\nwhich value is passed into the callback at each step of the\nphrase. It can be numbers, an object with multiple numbers,\nor a zero (0) indicates a rest so the callback won't be called).
",is_constructor:1,params:[{name:"name",description:"Name so that you can access the Phrase.
\n",type:"String"},{name:"callback",description:"The name of a function that this phrase\n will call. Typically it will play a sound,\n and accept two parameters: a time at which\n to play the sound (in seconds from now),\n and a value from the sequence array. The\n time should be passed into the play() or\n start() method to ensure precision.
\n",type:"Function"},{name:"sequence",description:"Array of values to pass into the callback\n at each step of the phrase.
\n",type:"Array"}],example:["\n\nvar mySound, myPhrase, myPart;\nvar pattern = [1,0,0,2,0,2,0,0];\nvar msg = 'click to play';\n\nfunction preload() {\n mySound = loadSound('assets/beatbox.mp3');\n}\n\nfunction setup() {\n noStroke();\n fill(255);\n textAlign(CENTER);\n masterVolume(0.1);\n\n myPhrase = new p5.Phrase('bbox', makeSound, pattern);\n myPart = new p5.Part();\n myPart.addPhrase(myPhrase);\n myPart.setBPM(60);\n}\n\nfunction draw() {\n background(0);\n text(msg, width/2, height/2);\n}\n\nfunction makeSound(time, playbackRate) {\n mySound.rate(playbackRate);\n mySound.play(time);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n myPart.start();\n msg = 'playing pattern';\n }\n}\n\n"]},"p5.Part":{name:"p5.Part",shortname:"p5.Part",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:9159,description:"A p5.Part plays back one or more p5.Phrases. Instantiate a part\nwith steps and tatums. By default, each step represents 1/16th note.
\n\nSee p5.Phrase for more about musical timing.
",is_constructor:1,params:[{name:"steps",description:"Steps in the part
\n",type:"Number",optional:!0},{name:"tatums",description:"Divisions of a beat (default is 1/16, a quarter note)
\n",type:"Number",optional:!0}],example:["\n\nvar box, drum, myPart;\nvar boxPat = [1,0,0,2,0,2,0,0];\nvar drumPat = [0,1,1,0,2,0,1,0];\nvar msg = 'click to play';\n\nfunction preload() {\n box = loadSound('assets/beatbox.mp3');\n drum = loadSound('assets/drum.mp3');\n}\n\nfunction setup() {\n noStroke();\n fill(255);\n textAlign(CENTER);\n masterVolume(0.1);\n\n var boxPhrase = new p5.Phrase('box', playBox, boxPat);\n var drumPhrase = new p5.Phrase('drum', playDrum, drumPat);\n myPart = new p5.Part();\n myPart.addPhrase(boxPhrase);\n myPart.addPhrase(drumPhrase);\n myPart.setBPM(60);\n masterVolume(0.1);\n}\n\nfunction draw() {\n background(0);\n text(msg, width/2, height/2);\n}\n\nfunction playBox(time, playbackRate) {\n box.rate(playbackRate);\n box.play(time);\n}\n\nfunction playDrum(time, playbackRate) {\n drum.rate(playbackRate);\n drum.play(time);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n myPart.start();\n msg = 'playing part';\n }\n}\n"]},"p5.Score":{name:"p5.Score",shortname:"p5.Score",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:9413,description:"A Score consists of a series of Parts. The parts will\nbe played back in order. For example, you could have an\nA part, a B part, and a C part, and play them back in this order\nnew p5.Score(a, a, b, a, c)
\n",is_constructor:1,params:[{name:"parts",description:"One or multiple parts, to be played in sequence.
\n",type:"p5.Part",optional:!0,multiple:!0}]},"p5.Compressor":{name:"p5.Compressor",shortname:"p5.Compressor",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:9544,description:'Compressor is an audio effect class that performs dynamics compression\non an audio input source. This is a very commonly used technique in music\nand sound production. Compression creates an overall louder, richer, \nand fuller sound by lowering the volume of louds and raising that of softs.\nCompression can be used to avoid clipping (sound distortion due to \npeaks in volume) and is especially useful when many sounds are played \nat once. Compression can be used on indivudal sound sources in addition\nto the master output.
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n',is_constructor:1,extends:"p5.Effect"},"p5.SoundRecorder":{name:"p5.SoundRecorder",shortname:"p5.SoundRecorder",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:9750,description:"Record sounds for playback and/or to save as a .wav file.\nThe p5.SoundRecorder records all sound output from your sketch,\nor can be assigned a specific source with setInput().
\nThe record() method accepts a p5.SoundFile as a parameter.\nWhen playback is stopped (either after the given amount of time,\nor with the stop() method), the p5.SoundRecorder will send its\nrecording to that p5.SoundFile for playback.
",is_constructor:1,example:["\n\nvar mic, recorder, soundFile;\nvar state = 0;\n\nfunction setup() {\n background(200);\n // create an audio in\n mic = new p5.AudioIn();\n\n // prompts user to enable their browser mic\n mic.start();\n\n // create a sound recorder\n recorder = new p5.SoundRecorder();\n\n // connect the mic to the recorder\n recorder.setInput(mic);\n\n // this sound file will be used to\n // playback & save the recording\n soundFile = new p5.SoundFile();\n\n text('keyPress to record', 20, 20);\n}\n\nfunction keyPressed() {\n // make sure user enabled the mic\n if (state === 0 && mic.enabled) {\n\n // record to our p5.SoundFile\n recorder.record(soundFile);\n\n background(255,0,0);\n text('Recording!', 20, 20);\n state++;\n }\n else if (state === 1) {\n background(0,255,0);\n\n // stop recorder and\n // send result to soundFile\n recorder.stop();\n\n text('Stopped', 20, 20);\n state++;\n }\n\n else if (state === 2) {\n soundFile.play(); // play the result!\n save(soundFile, 'mySound.wav');\n state++;\n }\n}\n"]},"p5.PeakDetect":{name:"p5.PeakDetect",shortname:"p5.PeakDetect",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:10039,description:'PeakDetect works in conjunction with p5.FFT to\nlook for onsets in some or all of the frequency spectrum.\n
\n\nTo use p5.PeakDetect, call update in the draw loop\nand pass in a p5.FFT object.\n
\n\nYou can listen for a specific part of the frequency spectrum by\nsetting the range between freq1 and freq2.\n
\n\nthreshold is the threshold for detecting a peak,\nscaled between 0 and 1. It is logarithmic, so 0.1 is half as loud\nas 1.0.
\n\n\nThe update method is meant to be run in the draw loop, and\nframes determines how many loops must pass before\nanother peak can be detected.\nFor example, if the frameRate() = 60, you could detect the beat of a\n120 beat-per-minute song with this equation:\n framesPerPeak = 60 / (estimatedBPM / 60 );\n
\n\n\nBased on example contribtued by @b2renger, and a simple beat detection\nexplanation by a\nhref="http://www.airtightinteractive.com/2013/10/making-audio-reactive-visuals/"\ntarget="_blank"Felix Turner.\n
',is_constructor:1,params:[{name:"freq1",description:"lowFrequency - defaults to 20Hz
\n",type:"Number",optional:!0},{name:"freq2",description:"highFrequency - defaults to 20000 Hz
\n",type:"Number",optional:!0},{name:"threshold",description:"Threshold for detecting a beat between 0 and 1\n scaled logarithmically where 0.1 is 1/2 the loudness\n of 1.0. Defaults to 0.35.
\n",type:"Number",optional:!0},{name:"framesPerPeak",description:"Defaults to 20.
\n",type:"Number",optional:!0}],example:["\n\n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 10;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n\n soundFile = loadSound('assets/beat.mp3');\n\n // p5.PeakDetect requires a p5.FFT\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n\n}\n\nfunction draw() {\n background(0);\n text('click to play/pause', width/2, height/2);\n\n // peakDetect accepts an fft post-analysis\n fft.analyze();\n peakDetect.update(fft);\n\n if ( peakDetect.isDetected ) {\n ellipseWidth = 50;\n } else {\n ellipseWidth *= 0.95;\n }\n\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// toggle play/stop when canvas is clicked\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n }\n}\n"]},"p5.Gain":{name:"p5.Gain",shortname:"p5.Gain",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:10259,description:"A gain node is usefull to set the relative volume of sound.\nIt's typically used to build mixers.
\n",is_constructor:1,example:["\n\n\n // load two soundfile and crossfade beetween them\n var sound1,sound2;\n var gain1, gain2, gain3;\n\n function preload(){\n soundFormats('ogg', 'mp3');\n sound1 = loadSound('../_files/Damscray_-_Dancing_Tiger_01');\n sound2 = loadSound('../_files/beat.mp3');\n }\n\n function setup() {\n createCanvas(400,200);\n\n // create a 'master' gain to which we will connect both soundfiles\n gain3 = new p5.Gain();\n gain3.connect();\n\n // setup first sound for playing\n sound1.rate(1);\n sound1.loop();\n sound1.disconnect(); // diconnect from p5 output\n\n gain1 = new p5.Gain(); // setup a gain node\n gain1.setInput(sound1); // connect the first sound to its input\n gain1.connect(gain3); // connect its output to the 'master'\n\n sound2.rate(1);\n sound2.disconnect();\n sound2.loop();\n\n gain2 = new p5.Gain();\n gain2.setInput(sound2);\n gain2.connect(gain3);\n\n }\n\n function draw(){\n background(180);\n\n // calculate the horizontal distance beetween the mouse and the right of the screen\n var d = dist(mouseX,0,width,0);\n\n // map the horizontal position of the mouse to values useable for volume control of sound1\n var vol1 = map(mouseX,0,width,0,1);\n var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa\n\n gain1.amp(vol1,0.5,0);\n gain2.amp(vol2,0.5,0);\n\n // map the vertical position of the mouse to values useable for 'master volume control'\n var vol3 = map(mouseY,0,height,0,1);\n gain3.amp(vol3,0.5,0);\n }\n\n"]},"p5.Distortion":{name:"p5.Distortion",shortname:"p5.Distortion",classitems:[],plugins:[],extensions:[],plugin_for:[],extension_for:[],module:"p5.sound",submodule:"p5.sound",namespace:"",file:"lib/addons/p5.sound.js",line:10410,description:'A Distortion effect created with a Waveshaper Node,\nwith an approach adapted from\nKevin Ennis
\nThis class extends p5.Effect.
Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.
\n',extends:"p5.Effect",is_constructor:1,params:[{name:"amount",description:"Unbounded distortion amount.\n Normal values range from 0-1.
\n",type:"Number",optional:!0,optdefault:"0.25"},{name:"oversample",description:"'none', '2x', or '4x'.
\n",type:"String",optional:!0,optdefault:"'none'"}]}},elements:{},classitems:[{file:"src/color/color_conversion.js",line:10,description:'Conversions adapted from http://www.easyrgb.com/math.html.
\nIn these functions, hue is always in the range [0,1); all other components\nare in the range [0,1]. 'Brightness' and 'value' are used interchangeably.
\n',class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/color_conversion.js",line:20,description:"Convert an HSBA array to HSLA.
\n",class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/color_conversion.js",line:46,description:"Convert an HSBA array to RGBA.
\n",class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/color_conversion.js",line:95,description:"Convert an HSLA array to HSBA.
\n",class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/color_conversion.js",line:118,description:"Convert an HSLA array to RGBA.
\nWe need to change basis from HSLA to something that can be more easily be\nprojected onto RGBA. We will choose hue and brightness as our first two\ncomponents, and pick a convenient third one ('zest') so that we don't need\nto calculate formal HSBA saturation.
\n",class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/color_conversion.js",line:176,description:"Convert an RGBA array to HSBA.
\n",class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/color_conversion.js",line:211,description:"Convert an RGBA array to HSLA.
\n",class:"p5",module:"Conversion",submodule:"Color Conversion"},{file:"src/color/creating_reading.js",line:16,description:"Extracts the alpha value from a color or pixel array.
\n",itemtype:"method",name:"alpha",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the alpha value",type:"Number"},example:["\n\n\nnoStroke();\nc = color(0, 126, 255, 102);\nfill(c);\nrect(15, 15, 35, 70);\nvalue = alpha(c); // Sets 'value' to 102\nfill(value);\nrect(50, 15, 35, 70);\n\n"],alt:"Left half of canvas light blue and right half light charcoal grey.\nLeft half of canvas light purple and right half a royal blue.\nLeft half of canvas salmon pink and the right half white.\nYellow rect in middle right of canvas, with 55 pixel width and height.\nYellow ellipse in top left canvas, black ellipse in bottom right,both 80x80.\nBright fuschia rect in middle of canvas, 60 pixel width and height.\nTwo bright green rects on opposite sides of the canvas, both 45x80.\nFour blue rects in each corner of the canvas, each are 35x35.\nBright sea green rect on left and darker rect on right of canvas, both 45x80.\nDark green rect on left and light green rect on right of canvas, both 45x80.\nDark blue rect on left and light teal rect on right of canvas, both 45x80.\nblue rect on left and green on right, both with black outlines & 35x60.\nsalmon pink rect on left and black on right, both 35x60.\n4 rects, tan, brown, brownish purple and purple, with white outlines & 20x60.\nlight pastel green rect on left and dark grey rect on right, both 35x60.\nyellow rect on left and red rect on right, both with black outlines & 35x60.\ngrey canvas\ndeep pink rect on left and grey rect on right, both 35x60.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:60,description:"Extracts the blue value from a color or pixel array.
\n",itemtype:"method",name:"blue",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the blue value",type:"Number"},example:["\n\n\nc = color(175, 100, 220); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nblueValue = blue(c); // Get blue in 'c'\nprint(blueValue); // Prints \"220.0\"\nfill(0, 0, blueValue); // Use 'blueValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n"],alt:"Left half of canvas light purple and right half a royal blue.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:89,description:"Extracts the HSB brightness value from a color or pixel array.
\n",itemtype:"method",name:"brightness",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the brightness value",type:"Number"},example:["\n\n\nnoStroke();\ncolorMode(HSB, 255);\nc = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = brightness(c); // Sets 'value' to 255\nfill(value);\nrect(50, 20, 35, 60);\n\n"],alt:"Left half of canvas salmon pink and the right half white.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:118,description:"Creates colors for storing in variables of the color datatype. The\nparameters are interpreted as RGB or HSB values depending on the\ncurrent colorMode(). The default mode is RGB values from 0 to 255\nand, therefore, the function call color(255, 204, 0) will return a\nbright yellow color.\n
\nNote that if only one value is provided to color(), it will be interpreted\nas a grayscale value. Add a second value, and it will be used for alpha\ntransparency. When three values are specified, they are interpreted as\neither RGB or HSB values. Adding a fourth value applies alpha\ntransparency.\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.
\n",itemtype:"method",name:"color",return:{description:"resulting color",type:"p5.Color"},example:["\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(30, 20, 55, 55); // Draw rectangle\n\n\n\n\n\nvar c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nellipse(25, 25, 80, 80); // Draw left circle\n\n// Using only one value with color()\n// generates a grayscale value.\nvar c = color(65); // Update 'c' with grayscale value\nfill(c); // Use updated 'c' as fill color\nellipse(75, 75, 80, 80); // Draw right circle\n\n\n\n\n\n// Named SVG & CSS colors may be used,\nvar c = color('magenta');\nfill(c); // Use 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(20, 20, 60, 60); // Draw rectangle\n\n\n\n\n\n// as can hex color codes:\nnoStroke(); // Don't draw a stroke around shapes\nvar c = color('#0f0');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('#00ff00');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\n// RGB and RGBA color strings are also supported:\n// these all set to the same color (solid blue)\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('rgb(0,0,255)');\nfill(c); // Use 'c' as fill color\nrect(10, 10, 35, 35); // Draw rectangle\n\nc = color('rgb(0%, 0%, 100%)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 35, 35); // Draw rectangle\n\nc = color('rgba(0, 0, 255, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(10, 55, 35, 35); // Draw rectangle\n\nc = color('rgba(0%, 0%, 100%, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 55, 35, 35); // Draw rectangle\n\n\n\n\n\n// HSL color is also supported and can be specified\n// by value\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsl(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsla(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\n// HSB color is also supported and can be specified\n// by value\nvar c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsb(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsba(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n\n\n\n\nvar c; // Declare color 'c'\nnoStroke(); // Don't draw a stroke around shapes\n\n// If no colorMode is specified, then the\n// default of RGB with scale of 0-255 is used.\nc = color(50, 55, 100); // Create a color for 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(0, 10, 45, 80); // Draw left rect\n\ncolorMode(HSB, 100); // Use HSB with scale of 0-100\nc = color(50, 55, 100); // Update 'c' with new color\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw right rect\n\n"],alt:"Yellow rect in middle right of canvas, with 55 pixel width and height.\nYellow ellipse in top left of canvas, black ellipse in bottom right,both 80x80.\nBright fuschia rect in middle of canvas, 60 pixel width and height.\nTwo bright green rects on opposite sides of the canvas, both 45x80.\nFour blue rects in each corner of the canvas, each are 35x35.\nBright sea green rect on left and darker rect on right of canvas, both 45x80.\nDark green rect on left and lighter green rect on right of canvas, both 45x80.\nDark blue rect on left and light teal rect on right of canvas, both 45x80.",class:"p5",module:"Color",submodule:"Creating & Reading",overloads:[{line:118,params:[{name:"gray",description:"number specifying value between white\n and black.
\n",type:"Number"},{name:"alpha",description:"alpha value relative to current color range\n (default is 0-255)
\n",type:"Number",optional:!0}],return:{description:"resulting color",type:"p5.Color"}},{line:277,params:[{name:"v1",description:"red or hue value relative to\n the current color range
\n",type:"Number"},{name:"v2",description:"green or saturation value\n relative to the current color range
\n",type:"Number"},{name:"v3",description:"blue or brightness value\n relative to the current color range
\n",type:"Number"},{name:"alpha",description:"",type:"Number",optional:!0}],return:{description:"",type:"p5.Color"}},{line:289,params:[{name:"value",description:"a color string
\n",type:"String"},{name:"alpha",description:"",type:"Number",optional:!0}],return:{description:"",type:"p5.Color"}},{line:295,params:[{name:"values",description:"an array containing the red,green,blue &\n and alpha components of the color
\n",type:"Array"}],return:{description:"",type:"p5.Color"}},{line:301,params:[{name:"color",description:"",type:"p5.Color"
-}],return:{description:"",type:"p5.Color"}}]},{file:"src/color/creating_reading.js",line:326,description:"Extracts the green value from a color or pixel array.
\n",itemtype:"method",name:"green",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the green value",type:"Number"},example:["\n\n\nc = color(20, 75, 200); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\ngreenValue = green(c); // Get green in 'c'\nprint(greenValue); // Print \"75.0\"\nfill(0, greenValue, 0); // Use 'greenValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n"],alt:"blue rect on left and green on right, both with black outlines & 35x60.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:356,description:"Extracts the hue value from a color or pixel array.
\nHue exists in both HSB and HSL. This function will return the\nHSB-normalized hue when supplied with an HSB color object (or when supplied\nwith a pixel array while the color mode is HSB), but will default to the\nHSL-normalized hue otherwise. (The values will only be different if the\nmaximum hue setting for each system is different.)
\n",itemtype:"method",name:"hue",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the hue",type:"Number"},example:["\n\n\nnoStroke();\ncolorMode(HSB, 255);\nc = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = hue(c); // Sets 'value' to \"0\"\nfill(value);\nrect(50, 20, 35, 60);\n\n"],alt:"salmon pink rect on left and black on right, both 35x60.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:392,description:"Blends two colors to find a third color somewhere between them. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first color, 0.1 is very near the first color, 0.5 is halfway\nin between, etc. An amount below 0 will be treated as 0. Likewise, amounts\nabove 1 will be capped at 1. This is different from the behavior of lerp(),\nbut necessary because otherwise numbers outside the range will produce\nstrange and unexpected colors.\n
\nThe way that colours are interpolated depends on the current color mode.
\n",itemtype:"method",name:"lerpColor",params:[{name:"c1",description:"interpolate from this color
\n",type:"p5.Color"},{name:"c2",description:"interpolate to this color
\n",type:"p5.Color"},{name:"amt",description:"number between 0 and 1
\n",type:"Number"}],return:{description:"interpolated color",type:"p5.Color"},example:["\n\n\ncolorMode(RGB);\nstroke(255);\nbackground(51);\nfrom = color(218, 165, 32);\nto = color(72, 61, 139);\ncolorMode(RGB); // Try changing to HSB.\ninterA = lerpColor(from, to, .33);\ninterB = lerpColor(from, to, .66);\nfill(from);\nrect(10, 20, 20, 60);\nfill(interA);\nrect(30, 20, 20, 60);\nfill(interB);\nrect(50, 20, 20, 60);\nfill(to);\nrect(70, 20, 20, 60);\n\n"],alt:"4 rects one tan, brown, brownish purple, purple, with white outlines & 20x60",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:489,description:"Extracts the HSL lightness value from a color or pixel array.
\n",itemtype:"method",name:"lightness",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the lightness",type:"Number"},example:["\n\n\nnoStroke();\ncolorMode(HSL);\nc = color(156, 100, 50, 1);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = lightness(c); // Sets 'value' to 50\nfill(value);\nrect(50, 20, 35, 60);\n\n"],alt:"light pastel green rect on left and dark grey rect on right, both 35x60.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:518,description:"Extracts the red value from a color or pixel array.
\n",itemtype:"method",name:"red",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the red value",type:"Number"},example:["\n\n\nc = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nredValue = red(c); // Get red in 'c'\nprint(redValue); // Print \"255.0\"\nfill(redValue, 0, 0); // Use 'redValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n\n\n\n\ncolorMode(RGB, 255);\nvar c = color(127, 255, 0);\ncolorMode(RGB, 1);\nvar myColor = red(c);\nprint(myColor);\n\n"],alt:"yellow rect on left and red rect on right, both with black outlines and 35x60.\ngrey canvas",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/creating_reading.js",line:557,description:"Extracts the saturation value from a color or pixel array.
\nSaturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object (or when supplied\nwith a pixel array while the color mode is HSB), but will default to the\nHSL saturation otherwise.
\n",itemtype:"method",name:"saturation",params:[{name:"color",description:"p5.Color object or pixel array
\n",type:"p5.Color|Array"}],return:{description:"the saturation value",type:"Number"},example:["\n\n\nnoStroke();\ncolorMode(HSB, 255);\nc = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nvalue = saturation(c); // Sets 'value' to 126\nfill(value);\nrect(50, 20, 35, 60);\n\n"],alt:"deep pink rect on left and grey rect on right, both 35x60.",class:"p5",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:118,description:"Hue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.
\n",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:149,description:"Saturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.
\n",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:168,description:"CSS named colors.
\n",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:321,description:"These regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.
\nNote that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.
\n",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:334,description:"Full color string patterns. The capture groups are necessary.
\n",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:447,description:"For a number of different inputs, returns a color formatted as [r, g, b, a]\narrays, with each component normalized between 0 and 1.
\n",params:[{name:"args",description:"An 'array-like' object that represents a list of\n arguments
\n",type:"Array",optional:!0,multiple:!0}],return:{description:"a color formatted as [r, g, b, a]\n Example:\n input ==> output\n g ==> [g, g, g, 255]\n g,a ==> [g, g, g, a]\n r, g, b ==> [r, g, b, 255]\n r, g, b, a ==> [r, g, b, a]\n [g] ==> [g, g, g, 255]\n [g, a] ==> [g, g, g, a]\n [r, g, b] ==> [r, g, b, 255]\n [r, g, b, a] ==> [r, g, b, a]",type:"Number[]"},example:["\n\n\n// todo\n\n"],alt:"//todo",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/p5.Color.js",line:638,description:"For HSB and HSL, interpret the gray level as a brightness/lightness\nvalue (they are equivalent when chroma is zero). For RGB, normalize the\ngray level according to the blue maximum.
\n",class:"p5.Color",module:"Color",submodule:"Creating & Reading"},{file:"src/color/setting.js",line:15,description:"The background() function sets the color used for the background of the\np5.js canvas. The default background is light gray. This function is\ntypically used within draw() to clear the display window at the beginning\nof each frame, but it can be used inside setup() to set the background on\nthe first frame of animation or if the background need only be set once.\n
\nThe color is either specified in terms of the RGB, HSB, or HSL color\ndepending on the current colorMode. (The default color space is RGB, with\neach value in the range from 0 to 255).\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n
\nA p5.Color object can also be provided to set the background color.\n
\nA p5.Image can also be provided to set the background iamge.
\n",itemtype:"method",name:"background",chainable:1,example:["\n\n\n// Grayscale integer value\nbackground(51);\n\n\n\n\n\n// R, G & B integer values\nbackground(255, 204, 0);\n\n\n\n\n\n// H, S & B integer values\ncolorMode(HSB);\nbackground(255, 204, 100);\n\n\n\n\n\n// Named SVG/CSS color string\nbackground('red');\n\n\n\n\n\n// three-digit hexadecimal RGB notation\nbackground('#fae');\n\n\n\n\n\n// six-digit hexadecimal RGB notation\nbackground('#222222');\n\n\n\n\n\n// integer RGB notation\nbackground('rgb(0,255,0)');\n\n\n\n\n\n// integer RGBA notation\nbackground('rgba(0,255,0, 0.25)');\n\n\n\n\n\n// percentage RGB notation\nbackground('rgb(100%,0%,10%)');\n\n\n\n\n\n// percentage RGBA notation\nbackground('rgba(100%,0%,100%,0.5)');\n\n\n\n\n\n// p5 Color object\nbackground(color(0, 0, 255));\n\n"],alt:"canvas with darkest charcoal grey background.\ncanvas with yellow background.\ncanvas with royal blue background.\ncanvas with red background.\ncanvas with pink background.\ncanvas with black background.\ncanvas with bright green background.\ncanvas with soft green background.\ncanvas with red background.\ncanvas with light purple background.\ncanvas with blue background.",class:"p5",module:"Color",submodule:"Setting",overloads:[{line:15,params:[{name:"color",description:"any value created by the color() function
\n",type:"p5.Color"},{name:"a",description:"opacity of the background relative to current\n color range (default is 0-100)
\n",type:"Number",optional:!0}],chainable:1},{line:133,params:[{name:"colorstring",description:"color string, possible formats include: integer\n rgb() or rgba(), percentage rgb() or rgba(),\n 3-digit hex, 6-digit hex
\n",type:"String"},{name:"a",description:"",type:"Number",optional:!0}],chainable:1},{line:142,params:[{name:"gray",description:"specifies a value between white and black
\n",type:"Number"},{name:"a",description:"",type:"Number",optional:!0}],chainable:1},{line:149,params:[{name:"v1",description:"red or hue value (depending on the current color\n mode)
\n",type:"Number"},{name:"v2",description:"green or saturation value (depending on the current\n color mode)
\n",type:"Number"},{name:"v3",description:"blue or brightness value (depending on the current\n color mode)
\n",type:"Number"},{name:"a",description:"",type:"Number",optional:!0}],chainable:1},{line:161,params:[{name:"image",description:"image created with loadImage() or createImage(),\n to set as background\n (must be same size as the sketch window)
\n",type:"p5.Image"},{name:"a",description:"",type:"Number",optional:!0}],chainable:1}]},{file:"src/color/setting.js",line:178,description:"Clears the pixels within a buffer. This function only works on p5.Canvas\nobjects created with the createCanvas() function; it won't work with the\nmain display window. Unlike the main graphics context, pixels in\nadditional graphics areas created with createGraphics() can be entirely\nor partially transparent. This function clears everything to make all of\nthe pixels 100% transparent.
\n",itemtype:"method",name:"clear",chainable:1,example:["\n\n\n// Clear the screen on mouse press.\nfunction setup() {\n createCanvas(100, 100);\n}\n\nfunction draw() {\n ellipse(mouseX, mouseY, 20, 20);\n}\n\nfunction mousePressed() {\n clear();\n}\n\n"],alt:"20x20 white ellipses are continually drawn at mouse x and y coordinates.",class:"p5",module:"Color",submodule:"Setting"},{file:"src/color/setting.js",line:216,description:"colorMode() changes the way p5.js interprets color data. By default, the\nparameters for fill(), stroke(), background(), and color() are defined by\nvalues between 0 and 255 using the RGB color model. This is equivalent to\nsetting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB\nsystem instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You\ncan also use HSL.\n
\nNote: existing color objects remember the mode that they were created in,\nso you can change modes as you like without affecting their appearance.
\n",itemtype:"method",name:"colorMode",chainable:1,class:"p5",module:"Color",submodule:"Setting",overloads:[{line:216,params:[{name:"mode",description:"either RGB, HSB or HSL, corresponding to\n Red/Green/Blue and Hue/Saturation/Brightness\n (or Lightness)
\n",type:"Constant"},{name:"max",description:"range for all values
\n",type:"Number",optional:!0}],chainable:1},{line:235,params:[{name:"mode",description:"",type:"Constant"},{name:"max1",description:"range for the red or hue depending on the\n current color mode
\n",type:"Number"},{name:"max2",description:"range for the green or saturation depending\n on the current color mode
\n",type:"Number"},{name:"max3",description:"range for the blue or brightness/lighntess\n depending on the current color mode
\n",type:"Number"},{name:"maxA",description:"range for the alpha
\n",type:"Number",optional:!0}],chainable:1}]},{file:"src/color/setting.js",line:335,description:"Sets the color used to fill shapes. For example, if you run\nfill(204, 102, 0), all subsequent shapes will be filled with orange. This\ncolor is either specified in terms of the RGB or HSB color depending on\nthe current colorMode(). (The default color space is RGB, with each value\nin the range from 0 to 255).\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n
\nA p5 Color object can also be provided to set the fill color.
\n",itemtype:"method",name:"fill",chainable:1,class:"p5",module:"Color",submodule:"Setting",overloads:[{line:335,params:[{name:"v1",description:"red or hue value relative to\n the current color range
\n",type:"Number"},{name:"v2",description:"green or saturation value\n relative to the current color range
\n",type:"Number"},{name:"v3",description:"blue or brightness value\n relative to the current color range
\n",type:"Number"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1},{line:359,params:[{name:"value",description:"a color string
\n",type:"String"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1},{line:366,params:[{name:"values",description:"an array containing the red,green,blue &\n and alpha components of the color
\n",type:"Number[]"}],chainable:1},{line:373,params:[{name:"color",description:"the fill color
\n",type:"p5.Color"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1}]},{file:"src/color/setting.js",line:489,description:"Disables filling geometry. If both noStroke() and noFill() are called,\nnothing will be drawn to the screen.
\n",itemtype:"method",name:"noFill",chainable:1,example:["\n\n\nrect(15, 10, 55, 55);\nnoFill();\nrect(20, 20, 60, 60);\n\n"],alt:"white rect top middle and noFill rect center. Both 60x60 with black outlines.",class:"p5",module:"Color",submodule:"Setting"},{file:"src/color/setting.js",line:514,description:"Disables drawing the stroke (outline). If both noStroke() and noFill()\nare called, nothing will be drawn to the screen.
\n",itemtype:"method",name:"noStroke",chainable:1,example:["\n\n\nnoStroke();\nrect(20, 20, 60, 60);\n\n"],alt:"60x60 white rect at center. no outline.",class:"p5",module:"Color",submodule:"Setting"},{file:"src/color/setting.js",line:542,description:"Sets the color used to draw lines and borders around shapes. This color\nis either specified in terms of the RGB or HSB color depending on the\ncurrent colorMode() (the default color space is RGB, with each value in\nthe range from 0 to 255).\n
\nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.\n
\nA p5 Color object can also be provided to set the stroke color.
\n",itemtype:"method",name:"stroke",chainable:1,class:"p5",module:"Color",submodule:"Setting",overloads:[{line:542,params:[{name:"v1",description:"red or hue value relative to\n the current color range
\n",type:"Number"},{name:"v2",description:"green or saturation value\n relative to the current color range
\n",type:"Number"},{name:"v3",description:"blue or brightness value\n relative to the current color range
\n",type:"Number"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1},{line:567,params:[{name:"value",description:"a color string
\n",type:"String"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1},{line:574,params:[{name:"values",description:"an array containing the red,green,blue &\n and alpha components of the color
\n",type:"Number[]"}],chainable:1},{line:581,params:[{name:"color",description:"the stroke color
\n",type:"p5.Color"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1}]},{file:"src/core/2d_primitives.js",line:16,description:"Draw an arc to the screen. If called with only a, b, c, d, start, and\nstop, the arc will be drawn as an open pie. If mode is provided, the arc\nwill be drawn either open, as a chord, or as a pie as specified. The\norigin may be changed with the ellipseMode() function.
\nNote that drawing a full circle (ex: 0 to TWO_PI) will appear blank\nbecause 0 and TWO_PI are the same position on the unit circle. The\nbest way to handle this is by using the ellipse() function instead\nto create a closed ellipse, and to use the arc() function\nonly to draw parts of an ellipse.
\n",itemtype:"method",name:"arc",params:[{name:"a",description:"x-coordinate of the arc's ellipse
\n",type:"Number"},{name:"b",description:"y-coordinate of the arc's ellipse
\n",type:"Number"},{name:"c",description:"width of the arc's ellipse by default
\n",type:"Number"},{name:"d",description:"height of the arc's ellipse by default
\n",type:"Number"},{name:"start",description:"angle to start the arc, specified in radians
\n",type:"Number"},{name:"stop",description:"angle to stop the arc, specified in radians
\n",type:"Number"},{name:"mode",description:"optional parameter to determine the way of drawing\n the arc. either CHORD or PIE
\n",type:"Constant",optional:!0}],chainable:1,example:["\n\n\narc(50, 55, 50, 50, 0, HALF_PI);\nnoFill();\narc(50, 55, 60, 60, HALF_PI, PI);\narc(50, 55, 70, 70, PI, PI+QUARTER_PI);\narc(50, 55, 80, 80, PI+QUARTER_PI, TWO_PI);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI+QUARTER_PI, OPEN);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI+QUARTER_PI, CHORD);\n\n\n\n\n\narc(50, 50, 80, 80, 0, PI+QUARTER_PI, PIE);\n\n"],alt:"shattered outline of an ellipse with a quarter of a white circle bottom-right.\nwhite ellipse with black outline with top right missing.\nwhite ellipse with top right missing with black outline around shape.\nwhite ellipse with top right quarter missing with black outline around the shape.",class:"p5",module:"Shape",submodule:"2D Primitives"},{file:"src/core/2d_primitives.js",line:132,description:"Draws an ellipse (oval) to the screen. An ellipse with equal width and\nheight is a circle. By default, the first two parameters set the location,\nand the third and fourth parameters set the shape's width and height. If\nno height is specified, the value of width is used for both the width and\nheight. If a negative height or width is specified, the absolute value is taken.\nThe origin may be changed with the ellipseMode() function.
\n",itemtype:"method",name:"ellipse",params:[{name:"x",description:"x-coordinate of the ellipse.
\n",type:"Number"},{name:"y",description:"y-coordinate of the ellipse.
\n",type:"Number"},{name:"w",description:"width of the ellipse.
\n",type:"Number"},{name:"h",description:"height of the ellipse.
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\nellipse(56, 46, 55, 55);\n\n"],alt:"white ellipse with black outline in middle-right of canvas that is 55x55.",class:"p5",module:"Shape",submodule:"2D Primitives"},{file:"src/core/2d_primitives.js",line:187,description:"Draws a line (a direct path between two points) to the screen. The version\nof line() with four parameters draws the line in 2D. To color a line, use\nthe stroke() function. A line cannot be filled, therefore the fill()\nfunction will not affect the color of a line. 2D lines are drawn with a\nwidth of one pixel by default, but this can be changed with the\nstrokeWeight() function.
\n",itemtype:"method",name:"line",params:[{name:"x1",description:"the x-coordinate of the first point
\n",type:"Number"},{name:"y1",description:"the y-coordinate of the first point
\n",type:"Number"},{name:"x2",description:"the x-coordinate of the second point
\n",type:"Number"},{name:"y2",description:"the y-coordinate of the second point
\n",type:"Number"}],chainable:1,example:["\n\n\nline(30, 20, 85, 75);\n\n\n\n\n\nline(30, 20, 85, 20);\nstroke(126);\nline(85, 20, 85, 75);\nstroke(255);\nline(85, 75, 30, 75);\n\n"],alt:"line 78 pixels long running from mid-top to bottom-right of canvas.\n3 lines of various stroke sizes. Form top, bottom and right sides of a square.",class:"p5",module:"Shape",submodule:"2D Primitives"},{file:"src/core/2d_primitives.js",line:262,description:"Draws a point, a coordinate in space at the dimension of one pixel.\nThe first parameter is the horizontal value for the point, the second\nvalue is the vertical value for the point. The color of the point is\ndetermined by the current stroke.
\n",itemtype:"method",name:"point",params:[{name:"x",description:"the x-coordinate
\n",type:"Number"},{name:"y",description:"the y-coordinate
\n",type:"Number"}],chainable:1,example:["\n\n\npoint(30, 20);\npoint(85, 20);\npoint(85, 75);\npoint(30, 75);\n\n"],alt:"4 points centered in the middle-right of the canvas.",class:"p5",module:"Shape",submodule:"2D Primitives"},{file:"src/core/2d_primitives.js",line:313,description:"Draw a quad. A quad is a quadrilateral, a four sided polygon. It is\nsimilar to a rectangle, but the angles between its edges are not\nconstrained to ninety degrees. The first pair of parameters (x1,y1)\nsets the first vertex and the subsequent pairs should proceed\nclockwise or counter-clockwise around the defined shape.
\n",itemtype:"method",name:"quad",chainable:1,example:["\n\n\nquad(38, 31, 86, 20, 69, 63, 30, 76);\n\n"],alt:"irregular white quadrilateral shape with black outline mid-right of canvas.",class:"p5",module:"Shape",submodule:"2D Primitives",overloads:[{line:313,params:[{name:"x1",description:"the x-coordinate of the first point
\n",type:"Number"},{name:"y1",description:"the y-coordinate of the first point
\n",type:"Number"},{name:"x2",description:"the x-coordinate of the second point
\n",type:"Number"},{name:"y2",description:"the y-coordinate of the second point
\n",type:"Number"},{name:"x3",description:"the x-coordinate of the third point
\n",type:"Number"},{name:"y3",description:"the y-coordinate of the third point
\n",type:"Number"},{name:"x4",description:"the x-coordinate of the fourth point
\n",type:"Number"},{name:"y4",description:"the y-coordinate of the fourth point
\n",type:"Number"}],chainable:1},{line:341,params:[{name:"x1",description:"",type:"Number"},{name:"y1",description:"",type:"Number"},{name:"x2",description:"",type:"Number"},{name:"y2",description:"",type:"Number"},{name:"x3",description:"",type:"Number"},{name:"y3",description:"",type:"Number"},{name:"x4",description:"",type:"Number"},{name:"y4",description:"",type:"Number"}],chainable:1}]},{file:"src/core/2d_primitives.js",line:393,description:"Draws a rectangle to the screen. A rectangle is a four-sided shape with\nevery angle at ninety degrees. By default, the first two parameters set\nthe location of the upper-left corner, the third sets the width, and the\nfourth sets the height. The way these parameters are interpreted, however,\nmay be changed with the rectMode() function.\n
\nThe fifth, sixth, seventh and eighth parameters, if specified,\ndetermine corner radius for the top-right, top-left, lower-right and\nlower-left corners, respectively. An omitted corner radius parameter is set\nto the value of the previously specified radius value in the parameter list.
\n",itemtype:"method",name:"rect",return:{description:"the p5 object.",type:"P5"},example:["\n\n\n// Draw a rectangle at location (30, 20) with a width and height of 55.\nrect(30, 20, 55, 55);\n\n\n\n\n\n// Draw a rectangle with rounded corners, each having a radius of 20.\nrect(30, 20, 55, 55, 20);\n\n\n\n\n\n// Draw a rectangle with rounded corners having the following radii:\n// top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5.\nrect(30, 20, 55, 55, 20, 15, 10, 5);\n\n"],alt:"55x55 white rect with black outline in mid-right of canvas.\n55x55 white rect with black outline and rounded edges in mid-right of canvas.\n55x55 white rect with black outline and rounded edges of different radii.",class:"p5",module:"Shape",submodule:"2D Primitives",overloads:[{line:393,params:[{name:"x",description:"x-coordinate of the rectangle.
\n",type:"Number"},{name:"y",description:"y-coordinate of the rectangle.
\n",type:"Number"},{name:"w",description:"width of the rectangle.
\n",type:"Number"},{name:"h",description:"height of the rectangle.
\n",type:"Number"},{name:"tl",description:"optional radius of top-left corner.
\n",type:"Number",optional:!0},{name:"tr",description:"optional radius of top-right corner.
\n",type:"Number",optional:!0},{name:"br",description:"optional radius of bottom-right corner.
\n",type:"Number",optional:!0},{name:"bl",description:"optional radius of bottom-left corner.
\n",type:"Number",optional:!0}],return:{description:"the p5 object.",type:"P5"}},{line:443,params:[{name:"x",description:"",type:"Number"},{name:"y",description:"",type:"Number"},{name:"w",description:"",type:"Number"},{name:"h",description:"",type:"Number"},{name:"detailX",description:"",type:"Number",optional:!0},{name:"detailY",description:"",type:"Number",optional:!0}],chainable:1}]},{file:"src/core/2d_primitives.js",line:477,description:"A triangle is a plane created by connecting three points. The first two\narguments specify the first point, the middle two arguments specify the\nsecond point, and the last two arguments specify the third point.
\n",itemtype:"method",name:"triangle",params:[{name:"x1",description:"x-coordinate of the first point
\n",type:"Number"},{name:"y1",description:"y-coordinate of the first point
\n",type:"Number"},{name:"x2",description:"x-coordinate of the second point
\n",type:"Number"},{name:"y2",description:"y-coordinate of the second point
\n",type:"Number"},{name:"x3",description:"x-coordinate of the third point
\n",type:"Number"},{name:"y3",description:"y-coordinate of the third point
\n",type:"Number"}],chainable:1,example:["\n\n\ntriangle(30, 75, 58, 20, 86, 75);\n\n"],alt:"white triangle with black outline in mid-right of canvas.",class:"p5",module:"Shape",submodule:"2D Primitives"},{file:"src/core/attributes.js",line:14,description:"Modifies the location from which ellipses are drawn by changing the way\nin which parameters given to ellipse() are interpreted.\n
\nThe default mode is ellipseMode(CENTER), which interprets the first two\nparameters of ellipse() as the shape's center point, while the third and\nfourth parameters are its width and height.\n
\nellipseMode(RADIUS) also uses the first two parameters of ellipse() as\nthe shape's center point, but uses the third and fourth parameters to\nspecify half of the shapes's width and height.\n
\nellipseMode(CORNER) interprets the first two parameters of ellipse() as\nthe upper-left corner of the shape, while the third and fourth parameters\nare its width and height.\n
\nellipseMode(CORNERS) interprets the first two parameters of ellipse() as\nthe location of one corner of the ellipse's bounding box, and the third\nand fourth parameters as the location of the opposite corner.\n
\nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.
\n",itemtype:"method",name:"ellipseMode",params:[{name:"mode",description:"either CENTER, RADIUS, CORNER, or CORNERS
\n",type:"Constant"}],chainable:1,
-example:["\n\n\nellipseMode(RADIUS); // Set ellipseMode to RADIUS\nfill(255); // Set fill to white\nellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode\n\nellipseMode(CENTER); // Set ellipseMode to CENTER\nfill(100); // Set fill to gray\nellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode\n\n\n\n\n\nellipseMode(CORNER); // Set ellipseMode is CORNER\nfill(255); // Set fill to white\nellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode\n\nellipseMode(CORNERS); // Set ellipseMode to CORNERS\nfill(100); // Set fill to gray\nellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode\n\n"],alt:"60x60 white ellipse and 30x30 grey ellipse with black outlines at center.\n60x60 white ellipse @center and 30x30 grey ellipse top-right, black outlines.",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/attributes.js",line:80,description:"Draws all geometry with jagged (aliased) edges. Note that smooth() is\nactive by default, so it is necessary to call noSmooth() to disable\nsmoothing of geometry, images, and fonts.
\n",itemtype:"method",name:"noSmooth",chainable:1,example:["\n\n\nbackground(0);\nnoStroke();\nsmooth();\nellipse(30, 48, 36, 36);\nnoSmooth();\nellipse(70, 48, 36, 36);\n\n"],alt:"2 pixelated 36x36 white ellipses to left & right of center, black background",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/attributes.js",line:108,description:"Modifies the location from which rectangles are drawn by changing the way\nin which parameters given to rect() are interpreted.\n
\nThe default mode is rectMode(CORNER), which interprets the first two\nparameters of rect() as the upper-left corner of the shape, while the\nthird and fourth parameters are its width and height.\n
\nrectMode(CORNERS) interprets the first two parameters of rect() as the\nlocation of one corner, and the third and fourth parameters as the\nlocation of the opposite corner.\n
\nrectMode(CENTER) interprets the first two parameters of rect() as the\nshape's center point, while the third and fourth parameters are its\nwidth and height.\n
\nrectMode(RADIUS) also uses the first two parameters of rect() as the\nshape's center point, but uses the third and fourth parameters to specify\nhalf of the shapes's width and height.\n
\nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.
\n",itemtype:"method",name:"rectMode",params:[{name:"mode",description:"either CORNER, CORNERS, CENTER, or RADIUS
\n",type:"Constant"}],chainable:1,example:["\n\n\nrectMode(CORNER); // Default rectMode is CORNER\nfill(255); // Set fill to white\nrect(25, 25, 50, 50); // Draw white rect using CORNER mode\n\nrectMode(CORNERS); // Set rectMode to CORNERS\nfill(100); // Set fill to gray\nrect(25, 25, 50, 50); // Draw gray rect using CORNERS mode\n\n\n\n\n\nrectMode(RADIUS); // Set rectMode to RADIUS\nfill(255); // Set fill to white\nrect(50, 50, 30, 30); // Draw white rect using RADIUS mode\n\nrectMode(CENTER); // Set rectMode to CENTER\nfill(100); // Set fill to gray\nrect(50, 50, 30, 30); // Draw gray rect using CENTER mode\n\n"],alt:"50x50 white rect at center and 25x25 grey rect in the top left of the other.\n50x50 white rect at center and 25x25 grey rect in the center of the other.",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/attributes.js",line:174,description:"Draws all geometry with smooth (anti-aliased) edges. smooth() will also\nimprove image quality of resized images. Note that smooth() is active by\ndefault; noSmooth() can be used to disable smoothing of geometry,\nimages, and fonts.
\n",itemtype:"method",name:"smooth",chainable:1,example:["\n\n\nbackground(0);\nnoStroke();\nsmooth();\nellipse(30, 48, 36, 36);\nnoSmooth();\nellipse(70, 48, 36, 36);\n\n"],alt:"2 pixelated 36x36 white ellipses one left one right of center. On black.",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/attributes.js",line:203,description:"Sets the style for rendering line endings. These ends are either squared,\nextended, or rounded, each of which specified with the corresponding\nparameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND.
\n",itemtype:"method",name:"strokeCap",params:[{name:"cap",description:"either SQUARE, PROJECT, or ROUND
\n",type:"Constant"}],chainable:1,example:["\n\n\nstrokeWeight(12.0);\nstrokeCap(ROUND);\nline(20, 30, 80, 30);\nstrokeCap(SQUARE);\nline(20, 50, 80, 50);\nstrokeCap(PROJECT);\nline(20, 70, 80, 70);\n\n"],alt:"3 lines. Top line: rounded ends, mid: squared, bottom:longer squared ends.",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/attributes.js",line:237,description:"Sets the style of the joints which connect line segments. These joints\nare either mitered, beveled, or rounded and specified with the\ncorresponding parameters MITER, BEVEL, and ROUND. The default joint is\nMITER.
\n",itemtype:"method",name:"strokeJoin",params:[{name:"join",description:"either MITER, BEVEL, ROUND
\n",type:"Constant"}],chainable:1,example:["\n\n\nnoFill();\nstrokeWeight(10.0);\nstrokeJoin(MITER);\nbeginShape();\nvertex(35, 20);\nvertex(65, 50);\nvertex(35, 80);\nendShape();\n\n\n\n\n\nnoFill();\nstrokeWeight(10.0);\nstrokeJoin(BEVEL);\nbeginShape();\nvertex(35, 20);\nvertex(65, 50);\nvertex(35, 80);\nendShape();\n\n\n\n\n\nnoFill();\nstrokeWeight(10.0);\nstrokeJoin(ROUND);\nbeginShape();\nvertex(35, 20);\nvertex(65, 50);\nvertex(35, 80);\nendShape();\n\n"],alt:"Right-facing arrowhead shape with pointed tip in center of canvas.\nRight-facing arrowhead shape with flat tip in center of canvas.\nRight-facing arrowhead shape with rounded tip in center of canvas.",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/attributes.js",line:301,description:"Sets the width of the stroke used for lines, points, and the border\naround shapes. All widths are set in units of pixels.
\n",itemtype:"method",name:"strokeWeight",params:[{name:"weight",description:"the weight (in pixels) of the stroke
\n",type:"Number"}],return:{description:"the p5 object",type:"P5"},example:["\n\n\nstrokeWeight(1); // Default\nline(20, 20, 80, 20);\nstrokeWeight(4); // Thicker\nline(20, 40, 80, 40);\nstrokeWeight(10); // Beastly\nline(20, 70, 80, 70);\n\n"],alt:"3 horizontal black lines. Top line: thin, mid: medium, bottom:thick.",class:"p5",module:"Shape",submodule:"Attributes"},{file:"src/core/canvas.js",line:1,requires:["constants"],class:"p5",module:"Shape"},{file:"src/core/constants.js",line:12,itemtype:"property",name:"P2D",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:17,itemtype:"property",name:"WEBGL",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:33,description:"HALF_PI is a mathematical constant with the value\n1.57079632679489661923. It is half the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",itemtype:"property",name:"HALF_PI",type:"Number",final:1,example:["\n\narc(50, 50, 80, 80, 0, HALF_PI);\n"],alt:"80x80 white quarter-circle with curve toward bottom right of canvas.",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:52,description:"PI is a mathematical constant with the value\n3.14159265358979323846. It is the ratio of the circumference\nof a circle to its diameter. It is useful in combination with\nthe trigonometric functions sin() and cos().
\n",itemtype:"property",name:"PI",type:"Number",final:1,example:["\n\narc(50, 50, 80, 80, 0, PI);\n"],alt:"white half-circle with curve toward bottom of canvas.",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:71,description:"QUARTER_PI is a mathematical constant with the value 0.7853982.\nIt is one quarter the ratio of the circumference of a circle to\nits diameter. It is useful in combination with the trigonometric\nfunctions sin() and cos().
\n",itemtype:"property",name:"QUARTER_PI",type:"Number",final:1,example:["\n\narc(50, 50, 80, 80, 0, QUARTER_PI);\n"],alt:"white eighth-circle rotated about 40 degrees with curve bottom right canvas.",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:90,description:"TAU is an alias for TWO_PI, a mathematical constant with the\nvalue 6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",itemtype:"property",name:"TAU",type:"Number",final:1,example:["\n\narc(50, 50, 80, 80, 0, TAU);\n"],alt:"80x80 white ellipse shape in center of canvas.",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:109,description:"TWO_PI is a mathematical constant with the value\n6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().
\n",itemtype:"property",name:"TWO_PI",type:"Number",final:1,example:["\n\narc(50, 50, 80, 80, 0, TWO_PI);\n"],alt:"80x80 white ellipse shape in center of canvas.",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:128,itemtype:"property",name:"DEGREES",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:133,itemtype:"property",name:"RADIANS",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:142,itemtype:"property",name:"CORNER",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:147,itemtype:"property",name:"CORNERS",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:152,itemtype:"property",name:"RADIUS",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:157,itemtype:"property",name:"RIGHT",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:162,itemtype:"property",name:"LEFT",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:167,itemtype:"property",name:"CENTER",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:172,itemtype:"property",name:"TOP",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:177,itemtype:"property",name:"BOTTOM",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:182,itemtype:"property",name:"BASELINE",type:"String",final:1,default:"alphabetic",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:188,itemtype:"property",name:"POINTS",type:"Number",final:1,default:"0x0000",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:194,itemtype:"property",name:"LINES",type:"Number",final:1,default:"0x0001",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:200,itemtype:"property",name:"LINE_STRIP",type:"Number",final:1,default:"0x0003",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:206,itemtype:"property",name:"LINE_LOOP",type:"Number",final:1,default:"0x0002",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:212,itemtype:"property",name:"TRIANGLES",type:"Number",final:1,default:"0x0004",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:218,itemtype:"property",name:"TRIANGLE_FAN",type:"Number",final:1,default:"0x0006",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:224,itemtype:"property",name:"TRIANGLE_STRIP",type:"Number",final:1,default:"0x0005",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:230,itemtype:"property",name:"QUADS",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:235,itemtype:"property",name:"QUAD_STRIP",type:"String",final:1,default:"quad_strip",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:241,itemtype:"property",name:"CLOSE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:246,itemtype:"property",name:"OPEN",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:251,itemtype:"property",name:"CHORD",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:256,itemtype:"property",name:"PIE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:261,itemtype:"property",name:"PROJECT",type:"String",final:1,default:"square",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:267,itemtype:"property",name:"SQUARE",type:"String",final:1,default:"butt",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:273,itemtype:"property",name:"ROUND",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:278,itemtype:"property",name:"BEVEL",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:283,itemtype:"property",name:"MITER",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:290,itemtype:"property",name:"RGB",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:295,itemtype:"property",name:"HSB",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:300,itemtype:"property",name:"HSL",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:326,itemtype:"property",name:"BLEND",type:"String",final:1,default:"source-over",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:332,itemtype:"property",name:"ADD",type:"String",final:1,default:"lighter",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:340,itemtype:"property",name:"DARKEST",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:345,itemtype:"property",name:"LIGHTEST",type:"String",final:1,default:"lighten",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:351,itemtype:"property",name:"DIFFERENCE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:356,itemtype:"property",name:"EXCLUSION",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:361,itemtype:"property",name:"MULTIPLY",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:366,itemtype:"property",name:"SCREEN",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:371,itemtype:"property",name:"REPLACE",type:"String",final:1,default:"copy",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:377,itemtype:"property",name:"OVERLAY",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:382,itemtype:"property",name:"HARD_LIGHT",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:387,itemtype:"property",name:"SOFT_LIGHT",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:392,itemtype:"property",name:"DODGE",type:"String",final:1,default:"color-dodge",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:398,itemtype:"property",name:"BURN",type:"String",final:1,default:"color-burn",class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:406,itemtype:"property",name:"THRESHOLD",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:411,itemtype:"property",name:"GRAY",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:416,itemtype:"property",name:"OPAQUE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:421,itemtype:"property",name:"INVERT",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:426,itemtype:"property",name:"POSTERIZE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:431,itemtype:"property",name:"DILATE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:436,itemtype:"property",name:"ERODE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:441,itemtype:"property",name:"BLUR",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:448,itemtype:"property",name:"NORMAL",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:453,itemtype:"property",name:"ITALIC",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:458,itemtype:"property",name:"BOLD",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:482,itemtype:"property",name:"LANDSCAPE",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/constants.js",line:487,itemtype:"property",name:"PORTRAIT",type:"String",final:1,class:"p5",module:"Constants",submodule:"Constants"},{file:"src/core/core.js",line:15,description:"This is the p5 instance constructor.
\nA p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.
\nA p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object
\n",params:[{name:"sketch",description:"a closure that can set optional preload(),\n setup(), and/or draw() properties on the\n given p5 instance
\n",type:"Function"},{name:"node",description:"element to attach canvas to, if a\n boolean is passed in use it as sync
\n",type:"HTMLElement|boolean",optional:!0},{name:"sync",description:"start synchronously (optional)
\n",type:"Boolean",optional:!0}],return:{description:"a p5 instance",type:"P5"},class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/core.js",line:49,description:'Called directly before setup(), the preload() function is used to handle\nasynchronous loading of external files. If a preload function is\ndefined, setup() will wait until any load calls within have finished.\nNothing besides load calls should be inside preload (loadImage,\nloadJSON, loadFont, loadStrings, etc).
\nBy default the text "loading..." will be displayed. To make your own\nloading page, include an HTML element with id "p5_loading" in your\npage. More information here.
\n',itemtype:"method",name:"preload",example:["\n\nvar img;\nvar c;\nfunction preload() { // preload() runs once\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() { // setup() waits until preload() is done\n img.loadPixels();\n // get color of middle pixel\n c = img.get(img.width/2, img.height/2);\n}\n\nfunction draw() {\n background(c);\n image(img, 25, 25, 50, 50);\n}\n"],alt:"nothing displayed",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/core.js",line:85,description:"The setup() function is called once when the program starts. It's used to\ndefine initial environment properties such as screen size and background\ncolor and to load media such as images and fonts as the program starts.\nThere can only be one setup() function for each program and it shouldn't\nbe called again after its initial execution.\n
\nNote: Variables declared within setup() are not accessible within other\nfunctions, including draw().
\n",itemtype:"method",name:"setup",example:["\n\nvar a = 0;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(102);\n}\n\nfunction draw() {\n rect(a++%width, 10, 2, 80);\n}\n"],alt:"nothing displayed",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/core.js",line:116,description:"Called directly after setup(), the draw() function continuously executes\nthe lines of code contained inside its block until the program is stopped\nor noLoop() is called. Note if noLoop() is called in setup(), draw() will\nstill be executed once before stopping. draw() is called automatically and\nshould never be called explicitly.\n
\nIt should always be controlled with noLoop(), redraw() and loop(). After\nnoLoop() stops the code in draw() from executing, redraw() causes the\ncode inside draw() to execute once, and loop() will cause the code\ninside draw() to resume executing continuously.\n
\nThe number of times draw() executes in each second may be controlled with\nthe frameRate() function.\n
\nThere can only be one draw() function for each sketch, and draw() must\nexist if you want the code to run continuously, or to process events such\nas mousePressed(). Sometimes, you might have an empty call to draw() in\nyour program, as shown in the above example.\n
\nIt is important to note that the drawing coordinate system will be reset\nat the beginning of each draw() call. If any transformations are performed\nwithin draw() (ex: scale, rotate, translate, their effects will be\nundone at the beginning of draw(), so transformations will not accumulate\nover time. On the other hand, styling applied (ex: fill, stroke, etc) will\nremain in effect.
\n",itemtype:"method",name:"draw",example:["\n\nvar yPos = 0;\nfunction setup() { // setup() runs once\n frameRate(30);\n}\nfunction draw() { // draw() loops forever, until stopped\n background(204);\n yPos = yPos - 1;\n if (yPos < 0) {\n yPos = height;\n }\n line(0, yPos, width, yPos);\n}\n"],alt:"nothing displayed",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/core.js",line:393,description:"Removes the entire p5 sketch. This will remove the canvas and any\nelements created by p5.js. It will also stop the draw loop and unbind\nany properties or methods from the window global scope. It will\nleave a variable p5 in case you wanted to create a new p5 sketch.\nIf you like, you can set p5 = null to erase it. While all functions and\nvariables and objects created by the p5 library will be removed, any\nother global variables created by your code will remain.
\n",itemtype:"method",name:"remove",example:["\n\nfunction draw() {\n ellipse(50, 50, 10, 10);\n}\n\nfunction mousePressed() {\n remove(); // remove whole sketch on mouse press\n}\n"],alt:"nothing displayed",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/curves.js",line:16,description:"Draws a cubic Bezier curve on the screen. These curves are defined by a\nseries of anchor and control points. The first two parameters specify\nthe first anchor point and the last two parameters specify the other\nanchor point, which become the first and last points on the curve. The\nmiddle parameters specify the two control points which define the shape\nof the curve. Approximately speaking, control points "pull" the curve\ntowards them.
Bezier curves were developed by French\nautomotive engineer Pierre Bezier, and are commonly used in computer\ngraphics to define gently sloping curves. See also curve().
\n",itemtype:"method",name:"bezier",return:{description:"the p5 object",type:"P5"},example:["\n\n\nnoFill();\nstroke(255, 102, 0);\nline(85, 20, 10, 10);\nline(90, 90, 15, 80);\nstroke(0, 0, 0);\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\n\n"],alt:"stretched black s-shape in center with orange lines extending from end points.\nstretched black s-shape with 10 5x5 white ellipses along the shape.\nstretched black s-shape with 7 5x5 ellipses and orange lines along the shape.\nstretched black s-shape with 17 small orange lines extending from under shape.\nhorseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.\nLine shaped like right-facing arrow,points move with mouse-x and warp shape.\nhorizontal line that hooks downward on the right and 13 5x5 ellipses along it.\nright curving line mid-right of canvas with 7 short lines radiating from it.",class:"p5",module:"Shape",submodule:"Curves",overloads:[{line:16,params:[{name:"x1",description:"x-coordinate for the first anchor point
\n",type:"Number"},{name:"y1",description:"y-coordinate for the first anchor point
\n",type:"Number"},{name:"x2",description:"x-coordinate for the first control point
\n",type:"Number"},{name:"y2",description:"y-coordinate for the first control point
\n",type:"Number"},{name:"x3",description:"x-coordinate for the second control point
\n",type:"Number"},{name:"y3",description:"y-coordinate for the second control point
\n",type:"Number"},{name:"x4",description:"x-coordinate for the second anchor point
\n",type:"Number"},{name:"y4",description:"y-coordinate for the second anchor point
\n",type:"Number"}],return:{description:"the p5 object",type:"P5"}},{line:59,params:[{name:"z1",description:"z-coordinate for the first anchor point
\n",type:"Number"},{name:"z2",description:"z-coordinate for the first control point
\n",type:"Number"},{name:"z3",description:"z-coordinate for the first anchor point
\n",type:"Number"},{name:"z4",description:"z-coordinate for the first control point
\n",type:"Number"}],chainable:1}]},{file:"src/core/curves.js",line:99,description:"Sets the resolution at which Beziers display.
\nThe default value is 20.
\n",params:[{name:"detail",description:"resolution of the curves
\n",type:"Number"}],chainable:1,example:["\n\n\nbackground(204);\nbezierDetail(50);\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\n\n"],alt:"stretched black s-shape with 7 5x5 ellipses and orange lines along the shape.",class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/curves.js",line:124,description:"Evaluates the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a bezier curve at t.
\n",itemtype:"method",name:"bezierPoint",params:[{name:"a",description:"coordinate of first point on the curve
\n",type:"Number"},{name:"b",description:"coordinate of first control point
\n",type:"Number"},{name:"c",description:"coordinate of second control point
\n",type:"Number"},{name:"d",description:"coordinate of second point on the curve
\n",type:"Number"},{name:"t",description:"value between 0 and 1
\n",type:"Number"}],return:{description:"the value of the Bezier at position t",type:"Number"},example:["\n\n\nnoFill();\nx1 = 85, x2 = 10, x3 = 90, x4 = 15;\ny1 = 20, y2 = 10, y3 = 90, y4 = 80;\nbezier(x1, y1, x2, y2, x3, y3, x4, y4);\nfill(255);\nsteps = 10;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = bezierPoint(x1, x2, x3, x4, t);\n y = bezierPoint(y1, y2, y3, y4, t);\n ellipse(x, y, 5, 5);\n}\n\n"],alt:"stretched black s-shape with 17 small orange lines extending from under shape.",class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/curves.js",line:175,description:"Evaluates the tangent to the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.
\n",itemtype:"method",name:"bezierTangent",params:[{name:"a",description:"coordinate of first point on the curve
\n",type:"Number"},{name:"b",description:"coordinate of first control point
\n",type:"Number"},{name:"c",description:"coordinate of second control point
\n",type:"Number"},{name:"d",description:"coordinate of second point on the curve
\n",type:"Number"},{name:"t",description:"value between 0 and 1
\n",type:"Number"}],return:{description:"the tangent at position t",type:"Number"},example:["\n\n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nsteps = 6;\nfill(255);\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n // Get the location of the point\n x = bezierPoint(85, 10, 90, 15, t);\n y = bezierPoint(20, 10, 90, 80, t);\n // Get the tangent points\n tx = bezierTangent(85, 10, 90, 15, t);\n ty = bezierTangent(20, 10, 90, 80, t);\n // Calculate an angle from the tangent points\n a = atan2(ty, tx);\n a += PI;\n stroke(255, 102, 0);\n line(x, y, cos(a)*30 + x, sin(a)*30 + y);\n // The following line of code makes a line\n // inverse of the above line\n //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y);\n stroke(0);\n ellipse(x, y, 5, 5);\n}\n\n\n\n\n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nstroke(255, 102, 0);\nsteps = 16;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = bezierPoint(85, 10, 90, 15, t);\n y = bezierPoint(20, 10, 90, 80, t);\n tx = bezierTangent(85, 10, 90, 15, t);\n ty = bezierTangent(20, 10, 90, 80, t);\n a = atan2(ty, tx);\n a -= HALF_PI;\n line(x, y, cos(a)*8 + x, sin(a)*8 + y);\n}\n\n"],alt:"s-shaped line with 17 short orange lines extending from underside of shape",class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/curves.js",line:256,
-description:"Draws a curved line on the screen between two points, given as the\nmiddle four parameters. The first two parameters are a control point, as\nif the curve came from this point even though it's not drawn. The last\ntwo parameters similarly describe the other control point.
\nLonger curves can be created by putting a series of curve() functions\ntogether or using curveVertex(). An additional function called\ncurveTightness() provides control for the visual quality of the curve.\nThe curve() function is an implementation of Catmull-Rom splines.
\n",itemtype:"method",name:"curve",return:{description:"the p5 object",type:"P5"},example:["\n\n\nnoFill();\nstroke(255, 102, 0);\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\nstroke(0);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nstroke(255, 102, 0);\ncurve(73, 24, 73, 61, 15, 65, 15, 65);\n\n\n\n\n// Define the curve points as JavaScript objects\np1 = {x: 5, y: 26}, p2 = {x: 73, y: 24}\np3 = {x: 73, y: 61}, p4 = {x: 15, y: 65}\nnoFill();\nstroke(255, 102, 0);\ncurve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y)\nstroke(0);\ncurve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y)\nstroke(255, 102, 0);\ncurve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y)\n\n"],alt:"horseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.",class:"p5",module:"Shape",submodule:"Curves",overloads:[{line:256,params:[{name:"x1",description:"x-coordinate for the beginning control point
\n",type:"Number"},{name:"y1",description:"y-coordinate for the beginning control point
\n",type:"Number"},{name:"x2",description:"x-coordinate for the first point
\n",type:"Number"},{name:"y2",description:"y-coordinate for the first point
\n",type:"Number"},{name:"x3",description:"x-coordinate for the second point
\n",type:"Number"},{name:"y3",description:"y-coordinate for the second point
\n",type:"Number"},{name:"x4",description:"x-coordinate for the ending control point
\n",type:"Number"},{name:"y4",description:"y-coordinate for the ending control point
\n",type:"Number"}],return:{description:"the p5 object",type:"P5"}},{line:308,params:[{name:"z1",description:"z-coordinate for the beginning control point
\n",type:"Number"},{name:"z2",description:"z-coordinate for the first point
\n",type:"Number"},{name:"z3",description:"z-coordinate for the second point
\n",type:"Number"},{name:"z4",description:"z-coordinate for the ending control point
\n",type:"Number"}],chainable:1}]},{file:"src/core/curves.js",line:353,description:"Sets the resolution at which curves display.
\nThe default value is 20.
\n",params:[{name:"resolution",description:"of the curves
\n",type:"Number"}],chainable:1,example:["\n\n\nbackground(204);\ncurveDetail(20);\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\n\n"],alt:"white arch shape in top-mid canvas.",class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/curves.js",line:378,description:"Modifies the quality of forms created with curve() and curveVertex().\nThe parameter tightness determines how the curve fits to the vertex\npoints. The value 0.0 is the default value for tightness (this value\ndefines the curves to be Catmull-Rom splines) and the value 1.0 connects\nall the points with straight lines. Values within the range -5.0 and 5.0\nwill deform the curves but will leave them recognizable and as values\nincrease in magnitude, they will continue to deform.
\n",itemtype:"method",name:"curveTightness",params:[{name:"amount",description:"of deformation from the original vertices
\n",type:"Number"}],chainable:1,example:["\n\n\n// Move the mouse left and right to see the curve change\n\nfunction setup() {\n createCanvas(100, 100);\n noFill();\n}\n\nfunction draw() {\n background(204);\n var t = map(mouseX, 0, width, -5, 5);\n curveTightness(t);\n beginShape();\n curveVertex(10, 26);\n curveVertex(10, 26);\n curveVertex(83, 24);\n curveVertex(83, 61);\n curveVertex(25, 65);\n curveVertex(25, 65);\n endShape();\n}\n\n"],alt:"Line shaped like right-facing arrow,points move with mouse-x and warp shape.",class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/curves.js",line:423,description:"Evaluates the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are points\non the curve, and b and c are the control points.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a curve at t.
\n",itemtype:"method",name:"curvePoint",params:[{name:"a",description:"coordinate of first point on the curve
\n",type:"Number"},{name:"b",description:"coordinate of first control point
\n",type:"Number"},{name:"c",description:"coordinate of second control point
\n",type:"Number"},{name:"d",description:"coordinate of second point on the curve
\n",type:"Number"},{name:"t",description:"value between 0 and 1
\n",type:"Number"}],return:{description:"bezier value at position t",type:"Number"},example:["\n\n\nnoFill();\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nfill(255);\nellipseMode(CENTER);\nsteps = 6;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = curvePoint(5, 5, 73, 73, t);\n y = curvePoint(26, 26, 24, 61, t);\n ellipse(x, y, 5, 5);\n x = curvePoint(5, 73, 73, 15, t);\n y = curvePoint(26, 24, 61, 65, t);\n ellipse(x, y, 5, 5);\n}\n\n\n\nline hooking down to right-bottom with 13 5x5 white ellipse points"],class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/curves.js",line:476,description:"Evaluates the tangent to the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are points on the curve,\nand b and c are the control points.
\n",itemtype:"method",name:"curveTangent",params:[{name:"a",description:"coordinate of first point on the curve
\n",type:"Number"},{name:"b",description:"coordinate of first control point
\n",type:"Number"},{name:"c",description:"coordinate of second control point
\n",type:"Number"},{name:"d",description:"coordinate of second point on the curve
\n",type:"Number"},{name:"t",description:"value between 0 and 1
\n",type:"Number"}],return:{description:"the tangent at position t",type:"Number"},example:["\n\n\nnoFill();\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nsteps = 6;\nfor (i = 0; i <= steps; i++) {\n t = i / steps;\n x = curvePoint(5, 73, 73, 15, t);\n y = curvePoint(26, 24, 61, 65, t);\n //ellipse(x, y, 5, 5);\n tx = curveTangent(5, 73, 73, 15, t);\n ty = curveTangent(26, 24, 61, 65, t);\n a = atan2(ty, tx);\n a -= PI/2.0;\n line(x, y, cos(a)*8 + x, sin(a)*8 + y);\n}\n\n"],alt:"right curving line mid-right of canvas with 7 short lines radiating from it.",class:"p5",module:"Shape",submodule:"Curves"},{file:"src/core/environment.js",line:22,description:"The print() function writes to the console area of your browser.\nThis function is often helpful for looking at the data a program is\nproducing. This function creates a new line of text for each call to\nthe function. Individual elements can be\nseparated with quotes ("") and joined with the addition operator (+).
\n",itemtype:"method",name:"print",params:[{name:"contents",description:"any combination of Number, String, Object, Boolean,\n Array to print
\n",type:"Any"}],example:['\n\nvar x = 10;\nprint("The value of x is " + x);\n// prints "The value of x is 10"\n'],alt:"default grey canvas",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:51,description:"The system variable frameCount contains the number of frames that have\nbeen displayed since the program started. Inside setup() the value is 0,\nafter the first iteration of draw it is 1, etc.
\n",itemtype:"property",name:"frameCount",type:"Number",readonly:"",example:["\n \n function setup() {\n frameRate(30);\n textSize(20);\n textSize(30);\n textAlign(CENTER);\n }\n\n function draw() {\n background(200);\n text(frameCount, width/2, height/2);\n }\n "],alt:"numbers rapidly counting upward with frame count set to 30.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:79,description:"Confirms if the window a p5.js program is in is "focused," meaning that\nthe sketch will accept mouse or keyboard input. This variable is\n"true" if the window is focused and "false" if not.
\n",itemtype:"property",name:"focused",type:"Boolean",readonly:"",example:['\n\n// To demonstrate, put two windows side by side.\n// Click on the window that the p5 sketch isn\'t in!\nfunction draw() {\n background(200);\n noStroke();\n fill(0, 200, 0);\n ellipse(25, 25, 50, 50);\n\n if (!focused) { // or "if (focused === false)"\n stroke(200,0,0);\n line(0, 0, 100, 100);\n line(100, 0, 0, 100);\n }\n}\n'],alt:"green 50x50 ellipse at top left. Red X covers canvas when page focus changes",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:110,description:"Sets the cursor to a predefined symbol or an image, or makes it visible\nif already hidden. If you are trying to set an image as the cursor, the\nrecommended size is 16x16 or 32x32 pixels. It is not possible to load an\nimage as the cursor if you are exporting your program for the Web, and not\nall MODES work with all browsers. The values for parameters x and y must\nbe less than the dimensions of the image.
\n",itemtype:"method",name:"cursor",params:[{name:"type",description:"either ARROW, CROSS, HAND, MOVE, TEXT, or\n WAIT, or path for image
\n",type:"String|Constant"},{name:"x",description:"the horizontal active spot of the cursor
\n",type:"Number",optional:!0},{name:"y",description:"the vertical active spot of the cursor
\n",type:"Number",optional:!0}],example:["\n\n// Move the mouse left and right across the image\n// to see the cursor change from a cross to a hand\nfunction draw() {\n line(width/2, 0, width/2, height);\n if (mouseX < 50) {\n cursor(CROSS);\n } else {\n cursor(HAND);\n }\n}\n"],alt:"horizontal line divides canvas. cursor on left is a cross, right is hand.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:169,description:"Specifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second. This is the same as\nsetFrameRate(val).\n
\nCalling frameRate() with no arguments returns the current framerate. The\ndraw function must run at least once before it will return a value. This\nis the same as getFrameRate().\n
\nCalling frameRate() with arguments that are not of the type numbers\nor are non positive also returns current framerate.
\n",itemtype:"method",name:"frameRate",chainable:1,class:"p5",module:"Environment",submodule:"Environment",overloads:[{line:169,params:[{name:"fps",description:"number of frames to be displayed every second
\n",type:"Number"}],chainable:1},{line:188,params:[],return:{description:"current frameRate",type:"Number"}}]},{file:"src/core/environment.js",line:238,description:"Returns the current framerate.
\n",return:{description:"current frameRate",type:"Number"},class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:247,description:"Specifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second.
\nCalling frameRate() with no arguments returns the current framerate.
\n",params:[{name:"fps",description:"number of frames to be displayed every second
\n",type:"Number",optional:!0}],class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:262,description:"Hides the cursor from view.
\n",itemtype:"method",name:"noCursor",example:["\n\nfunction setup() {\n noCursor();\n}\n\nfunction draw() {\n background(200);\n ellipse(mouseX, mouseY, 10, 10);\n}\n"],alt:"cursor becomes 10x 10 white ellipse the moves with mouse x and y.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:288,description:"System variable that stores the width of the entire screen display. This\nis used to run a full-screen program on any display size.
\n",itemtype:"property",name:"displayWidth",type:"Number",readonly:"",example:['\n\ncreateCanvas(displayWidth, displayHeight);\n'],alt:"cursor becomes 10x 10 white ellipse the moves with mouse x and y.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:305,description:"System variable that stores the height of the entire screen display. This\nis used to run a full-screen program on any display size.
\n",itemtype:"property",name:"displayHeight",type:"Number",readonly:"",example:['\n\ncreateCanvas(displayWidth, displayHeight);\n'],alt:"no display.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:322,description:"System variable that stores the width of the inner window, it maps to\nwindow.innerWidth.
\n",itemtype:"property",name:"windowWidth",type:"Number",readonly:"",example:['\n\ncreateCanvas(windowWidth, windowHeight);\n'],alt:"no display.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:338,description:"System variable that stores the height of the inner window, it maps to\nwindow.innerHeight.
\n",itemtype:"property",name:"windowHeight",type:"Number",readonly:"",example:['\n\ncreateCanvas(windowWidth, windowHeight);\n'],alt:"no display.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:354,description:"The windowResized() function is called once every time the browser window\nis resized. This is a good place to resize the canvas or do any other\nadjustments to accommodate the new window size.
\n",itemtype:"method",name:"windowResized",example:['\n\nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n'],alt:"no display.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:404,description:"System variable that stores the width of the drawing canvas. This value\nis set by the first parameter of the createCanvas() function.\nFor example, the function call createCanvas(320, 240) sets the width\nvariable to the value 320. The value of width defaults to 100 if\ncreateCanvas() is not used in a program.
\n",itemtype:"property",name:"width",type:"Number",readonly:"",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:416,description:"System variable that stores the height of the drawing canvas. This value\nis set by the second parameter of the createCanvas() function. For\nexample, the function call createCanvas(320, 240) sets the height\nvariable to the value 240. The value of height defaults to 100 if\ncreateCanvas() is not used in a program.
\n",itemtype:"property",name:"height",type:"Number",readonly:"",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:428,description:"If argument is given, sets the sketch to fullscreen or not based on the\nvalue of the argument. If no argument is given, returns the current\nfullscreen state. Note that due to browser restrictions this can only\nbe called on user input, for example, on mouse press like the example\nbelow.
\n",itemtype:"method",name:"fullscreen",params:[{name:"val",description:"whether the sketch should be in fullscreen mode\nor not
\n",type:"Boolean",optional:!0}],return:{description:"current fullscreen state",type:"Boolean"},example:["\n\n\n// Clicking in the box toggles fullscreen on and off.\nfunction setup() {\n background(200);\n}\nfunction mousePressed() {\n if (mouseX > 0 && mouseX < 100 && mouseY > 0 && mouseY < 100) {\n var fs = fullscreen();\n fullscreen(!fs);\n }\n}\n\n"],alt:"no display.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:475,description:"Sets the pixel scaling for high pixel density displays. By default\npixel density is set to match display density, call pixelDensity(1)\nto turn this off. Calling pixelDensity() with no arguments returns\nthe current pixel density of the sketch.
\n",itemtype:"method",name:"pixelDensity",params:[{name:"val",description:"whether or how much the sketch should scale
\n",type:"Number",optional:!0}],return:{description:"current pixel density of the sketch",type:"Number"},example:["\n\n\nfunction setup() {\n pixelDensity(1);\n createCanvas(100, 100);\n background(200);\n ellipse(width/2, height/2, 50, 50);\n}\n\n\n\n\nfunction setup() {\n pixelDensity(3.0);\n createCanvas(100, 100);\n background(200);\n ellipse(width/2, height/2, 50, 50);\n}\n\n"],alt:"fuzzy 50x50 white ellipse with black outline in center of canvas.\nsharp 50x50 white ellipse with black outline in center of canvas.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:520,description:"Returns the pixel density of the current display the sketch is running on.
\n",itemtype:"method",name:"displayDensity",return:{description:"current pixel density of the display",type:"Number"},example:["\n\n\nfunction setup() {\n var density = displayDensity();\n pixelDensity(density);\n createCanvas(100, 100);\n background(200);\n ellipse(width/2, height/2, 50, 50);\n}\n\n"],alt:"50x50 white ellipse with black outline in center of canvas.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:577,description:"Gets the current URL.
\n",itemtype:"method",name:"getURL",return:{description:"url",type:"String"},example:["\n\n\nvar url;\nvar x = 100;\n\nfunction setup() {\n fill(0);\n noStroke();\n url = getURL();\n}\n\nfunction draw() {\n background(200);\n text(url, x, height/2);\n x--;\n}\n\n"],alt:"current url (http://p5js.org/reference/#/p5/getURL) moves right to left.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:608,description:"Gets the current URL path as an array.
\n",itemtype:"method",name:"getURLPath",return:{description:"path components",type:"String[]"},example:["\n\nfunction setup() {\n var urlPath = getURLPath();\n for (var i=0; i<urlPath.length; i++) {\n text(urlPath[i], 10, i*20+20);\n }\n}\n"],alt:"no display",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/environment.js",line:629,description:"Gets the current URL params as an Object.
\n",itemtype:"method",name:"getURLParams",return:{description:"URL params",type:"Object"},example:["\n\n\n// Example: http://p5js.org?year=2014&month=May&day=15\n\nfunction setup() {\n var params = getURLParams();\n text(params.day, 10, 20);\n text(params.month, 10, 40);\n text(params.year, 10, 60);\n}\n\n"],alt:"no display.",class:"p5",module:"Environment",submodule:"Environment"},{file:"src/core/error_helpers.js",line:1,requires:["core"],class:"p5",module:"Environment"},{file:"src/core/error_helpers.js",line:34,description:"Prints out a fancy, colorful message to the console log
\n",params:[{name:"message",description:"the words to be said
\n",type:"String"},{name:"func",description:"the name of the function to link
\n",type:"String"},{name:"color",description:"CSS color string or error type
\n",type:"Number|String"}],return:{description:"console logs"},class:"p5",module:"Environment"},{file:"src/core/error_helpers.js",line:106,description:"Validates parameters\nparam {String} func the name of the function\nparam {Array} args user input arguments
\nexample:\n var a;\n ellipse(10,10,a,5);\nconsole ouput:\n "It looks like ellipse received an empty variable in spot #2."
\nexample:\n ellipse(10,"foo",5,5);\nconsole output:\n "ellipse was expecting a number for parameter #1,\n received "foo" instead."
\n",class:"p5",module:"Environment"},{file:"src/core/error_helpers.js",line:273,description:"Prints out all the colors in the color pallete with white text.\nFor color blindness testing.
\n",class:"p5",module:"Environment"},{file:"src/core/init.js",line:5,description:"_globalInit
\nTODO: ???\nif sketch is on window\nassume "global" mode\nand instantiate p5 automatically\notherwise do nothing
\n",return:{description:"",type:"Undefined"},class:"p5.Element",module:"Environment"},{file:"src/core/p5.Element.js",line:25,description:"Underlying HTML element. All normal HTML methods can be called on this.
\n",itemtype:"property",name:"elt",readonly:"",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:39,description:"Attaches the element to the parent specified. A way of setting\n the container for the element. Accepts either a string ID, DOM\n node, or p5.Element. If no arguments given, parent node is returned.\n For more ways to position the canvas, see the\n \n positioning the canvas wiki page.
\n",itemtype:"method",name:"parent",chainable:1,class:"p5.Element",module:"DOM",submodule:"DOM",overloads:[{line:39,params:[{name:"parent",description:"the ID, DOM node, or p5.Element\n of desired parent element
\n",type:"String|p5.Element|Object"}],chainable:1},{line:53,params:[],return:{description:"",type:"p5.Element"}}]},{file:"src/core/p5.Element.js",line:103,description:"Sets the ID of the element. If no ID argument is passed in, it instead\n returns the current ID of the element.
\n",itemtype:"method",name:"id",chainable:1,class:"p5.Element",module:"DOM",submodule:"DOM",overloads:[{line:103,params:[{name:"id",description:"ID of the element
\n",type:"String"}],chainable:1},{line:112,params:[],return:{description:"the id of the element",type:"String"}}]},{file:"src/core/p5.Element.js",line:141,description:"Adds given class to the element. If no class argument is passed in, it\n instead returns a string containing the current class(es) of the element.
\n",itemtype:"method",name:"class",chainable:1,class:"p5.Element",module:"DOM",submodule:"DOM",overloads:[{line:141,params:[{name:"class",description:"class to add
\n",type:"String"}],chainable:1},{line:150,params:[],return:{description:"the class of the element",type:"String"}}]},{file:"src/core/p5.Element.js",line:163,description:"The .mousePressed() function is called once after every time a\nmouse button is pressed over the element. This can be used to\nattach element specific event listeners.
\n",itemtype:"method",name:"mousePressed",params:[{name:"fxn",description:"function to be fired when mouse is\n pressed over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mousePressed(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any click anywhere\nfunction mousePressed() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:213,description:"The .doubleClicked() function is called once after every time a\nmouse button is pressed twice over the element. This can be used to\nattach element and action specific event listeners.
\n",itemtype:"method",name:"doubleClicked",params:[{name:"fxn",description:"function to be fired when mouse is\n double clicked over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],return:{description:"",type:"p5.Element"},example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.doubleClicked(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any double click anywhere\nfunction doubleClicked() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:263,description:"The .mouseWheel() function is called once after every time a\nmouse wheel is scrolled over the element. This can be used to\nattach element specific event listeners.\n
\nThe function accepts a callback function as argument which will be executed\nwhen the wheel event is triggered on the element, the callback function is\npassed one argument event. The event.deltaY property returns negative\nvalues if the mouse wheel is rotated up or away from the user and positive\nin the other direction. The event.deltaX does the same as event.deltaY\nexcept it reads the horizontal wheel scroll of the mouse wheel.\n
\nOn OS X with "natural" scrolling enabled, the event.deltaY values are\nreversed.
\n",itemtype:"method",name:"mouseWheel",params:[{name:"fxn",description:"function to be fired when mouse is\n scrolled over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseWheel(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with mousewheel movement\n// anywhere on screen\nfunction mouseWheel() {\n g = g + 10;\n}\n\n// this function fires with mousewheel movement\n// over canvas only\nfunction changeSize(event) {\n if (event.deltaY > 0) {\n d = d + 10;\n } else {\n d = d - 10;\n }\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:329,description:"The .mouseReleased() function is called once after every time a\nmouse button is released over the element. This can be used to\nattach element specific event listeners.
\n",itemtype:"method",name:"mouseReleased",params:[{name:"fxn",description:"function to be fired when mouse is\n released over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseReleased(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires after the mouse has been\n// released\nfunction mouseReleased() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// released while on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:383,description:"The .mouseClicked() function is called once after a mouse button is\npressed and released over the element. This can be used to\nattach element specific event listeners.
\n",itemtype:"method",name:"mouseClicked",params:[{name:"fxn",description:"function to be fired when mouse is\n clicked over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:['\n\n\nvar cnv;\nvar d;\nvar g;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseClicked(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires after the mouse has been\n// clicked anywhere\nfunction mouseClicked() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// clicked on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n\n'],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:437,description:"The .mouseMoved() function is called once every time a\nmouse moves over the element. This can be used to attach an\nelement specific event listener.
\n",itemtype:"method",name:"mouseMoved",params:[{name:"fxn",description:"function to be fired when a mouse moves\n over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,
-example:["\n\nvar cnv;\nvar d = 30;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseMoved(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n fill(200);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires when mouse moves anywhere on\n// page\nfunction mouseMoved() {\n g = g + 5;\n if (g > 255) {\n g = 0;\n }\n}\n\n// this function fires when mouse moves over canvas\nfunction changeSize() {\n d = d + 2;\n if (d > 100) {\n d = 0;\n }\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:496,description:"The .mouseOver() function is called once after every time a\nmouse moves onto the element. This can be used to attach an\nelement specific event listener.
\n",itemtype:"method",name:"mouseOver",params:[{name:"fxn",description:"function to be fired when a mouse moves\n onto the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOver(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width/2, height/2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:541,description:"The .changed() function is called when the value of an\nelement changes.\nThis can be used to attach an element specific event listener.
\n",itemtype:"method",name:"changed",params:[{name:"fxn",description:"function to be fired when the value of\n an element changes.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text(\"it's a \"+item+\"!\", 50, 50);\n}\n\n\nvar checkbox;\nvar cnv;\n\nfunction setup() {\n checkbox = createCheckbox(\" fill\");\n checkbox.changed(changeFill);\n cnv = createCanvas(100, 100);\n cnv.position(0, 30);\n noFill();\n}\n\nfunction draw() {\n background(200);\n ellipse(50, 50, 50, 50);\n}\n\nfunction changeFill() {\n if (checkbox.checked()) {\n fill(0);\n } else {\n noFill();\n }\n}\n"],alt:'dropdown: pear, kiwi, grape. When selected text "its a" + selection shown.',class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:608,description:"The .input() function is called when any user input is\ndetected with an element. The input event is often used\nto detect keystrokes in a input element, or changes on a\nslider element. This can be used to attach an element specific\nevent listener.
\n",itemtype:"method",name:"input",params:[{name:"fxn",description:"function to be fired when any user input is\n detected within the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\n// Open your console to see the output\nfunction setup() {\n var inp = createInput('');\n inp.input(myInputEvent);\n}\n\nfunction myInputEvent() {\n console.log('you are typing: ', this.value());\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:643,description:"The .mouseOut() function is called once after every time a\nmouse moves off the element. This can be used to attach an\nelement specific event listener.
\n",itemtype:"method",name:"mouseOut",params:[{name:"fxn",description:"function to be fired when a mouse\n moves off of an element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOut(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width/2, height/2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:686,description:"The .touchStarted() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.
\n",itemtype:"method",name:"touchStarted",params:[{name:"fxn",description:"function to be fired when a touch\n starts over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchStarted(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchStarted() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:735,description:"The .touchMoved() function is called once after every time a touch move is\nregistered. This can be used to attach element specific event listeners.
\n",itemtype:"method",name:"touchMoved",params:[{name:"fxn",description:"function to be fired when a touch moves over\n the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchMoved(changeGray); // attach listener for\n // canvas click only\n g = 100;\n}\n\nfunction draw() {\n background(g);\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:776,description:"The .touchEnded() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.
\n",itemtype:"method",name:"touchEnded",params:[{name:"fxn",description:"function to be fired when a touch ends\n over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nvar cnv;\nvar d;\nvar g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchEnded(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width/2, height/2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchEnded() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n"],alt:"no display.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:828,description:"The .dragOver() function is called once after every time a\nfile is dragged over the element. This can be used to attach an\nelement specific event listener.
\n",itemtype:"method",name:"dragOver",params:[{name:"fxn",description:"function to be fired when a file is\n dragged over the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\n// To test this sketch, simply drag a\n// file over the canvas\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width/2, height/2);\n c.dragOver(dragOverCallback);\n}\n\n// This function will be called whenever\n// a file is dragged over the canvas\nfunction dragOverCallback() {\n background(240);\n text('Dragged over', width/2, height/2);\n}\n"],alt:"nothing displayed",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:866,description:"The .dragLeave() function is called once after every time a\ndragged file leaves the element area. This can be used to attach an\nelement specific event listener.
\n",itemtype:"method",name:"dragLeave",params:[{name:"fxn",description:"function to be fired when a file is\n dragged off the element.\n if false is passed instead, the previously\n firing function will no longer fire.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\n// To test this sketch, simply drag a file\n// over and then out of the canvas area\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width/2, height/2);\n c.dragLeave(dragLeaveCallback);\n}\n\n// This function will be called whenever\n// a file is dragged out of the canvas\nfunction dragLeaveCallback() {\n background(240);\n text('Dragged off', width/2, height/2);\n}\n"],alt:"nothing displayed",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:904,description:"The .drop() function is called for each file dropped on the element.\nIt requires a callback that is passed a p5.File object. You can\noptionally pass two callbacks, the first one (required) is triggered\nfor each file dropped when the file is loaded. The second (optional)\nis triggered just once when a file (or files) are dropped.
\n",itemtype:"method",name:"drop",params:[{name:"callback",description:"callback triggered when files are dropped.
\n",type:"Function|Boolean"},{name:"fxn",description:"callback to receive loaded file.
\n",type:"Function|Boolean"}],chainable:1,example:["\n\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('drop image', width/2, height/2);\n c.drop(gotFile);\n}\n\nfunction gotFile(file) {\n var img = createImg(file.data).hide();\n // Draw the image onto the canvas\n image(img, 0, 0, width, height);\n}\n"],alt:"Canvas turns into whatever image is dragged/dropped onto it.",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Element.js",line:1031,description:"Helper fxn for sharing pixel methods
\n",class:"p5.Element",module:"DOM",submodule:"DOM"},{file:"src/core/p5.Renderer.js",line:72,description:"Resize our canvas element.
\n",class:"p5.Renderer",module:"Rendering",submodule:"Rendering"},{file:"src/core/p5.Renderer.js",line:146,description:"Helper fxn to check font type (system or otf)
\n",class:"p5.Renderer",module:"Rendering",submodule:"Rendering"},{file:"src/core/p5.Renderer.js",line:202,description:'Helper fxn to measure ascent and descent.\nAdapted from http://stackoverflow.com/a/25355178
\n',class:"p5.Renderer",module:"Rendering",submodule:"Rendering"},{file:"src/core/p5.Renderer2D.js",line:9,description:"p5.Renderer2D\nThe 2D graphics canvas renderer class.\nextends p5.Renderer
\n",class:"p5",module:"Rendering"},{file:"src/core/p5.Renderer2D.js",line:356,description:"Generate a cubic Bezier representing an arc on the unit circle of total\nangle size radians, beginning start radians above the x-axis. Up to\nfour of these curves are combined to make a full arc.
\nSee www.joecridge.me/bezier.pdf for an explanation of the method.
\n",class:"p5",module:"Rendering"},{file:"src/core/rendering.js",line:14,description:"Creates a canvas element in the document, and sets the dimensions of it\nin pixels. This method should be called only once at the start of setup.\nCalling createCanvas more than once in a sketch will result in very\nunpredicable behavior. If you want more than one drawing canvas\nyou could use createGraphics (hidden by default but it can be shown).\n
\nThe system variables width and height are set by the parameters passed\nto this function. If createCanvas() is not used, the window will be\ngiven a default size of 100x100 pixels.\n
\nFor more ways to position the canvas, see the\n\npositioning the canvas wiki page.
\n",itemtype:"method",name:"createCanvas",params:[{name:"w",description:"width of the canvas
\n",type:"Number"},{name:"h",description:"height of the canvas
\n",type:"Number"},{name:"renderer",description:"either P2D or WEBGL
\n",type:"Constant",optional:!0}],return:{description:"canvas generated",type:"HTMLCanvasElement"},example:["\n\n\nfunction setup() {\n createCanvas(100, 50);\n background(153);\n line(0, 0, width, height);\n}\n\n"],alt:"Black line extending from top-left of canvas to bottom right.",class:"p5",module:"Rendering",submodule:"Rendering"},{file:"src/core/rendering.js",line:112,description:"Resizes the canvas to given width and height. The canvas will be cleared\nand draw will be called immediately, allowing the sketch to re-render itself\nin the resized canvas.
\n",itemtype:"method",name:"resizeCanvas",params:[{name:"w",description:"width of the canvas
\n",type:"Number"},{name:"h",description:"height of the canvas
\n",type:"Number"},{name:"noRedraw",description:"don't redraw the canvas immediately
\n",type:"Boolean",optional:!0}],example:['\n\nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n'],alt:"No image displayed.",class:"p5",module:"Rendering",submodule:"Rendering"},{file:"src/core/rendering.js",line:162,description:"Removes the default canvas for a p5 sketch that doesn't\nrequire a canvas
\n",itemtype:"method",name:"noCanvas",example:["\n\n\nfunction setup() {\n noCanvas();\n}\n\n"],alt:"no image displayed",class:"p5",module:"Rendering",submodule:"Rendering"},{file:"src/core/rendering.js",line:185,description:"Creates and returns a new p5.Renderer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels.
\n",itemtype:"method",name:"createGraphics",params:[{name:"w",description:"width of the offscreen graphics buffer
\n",type:"Number"},{name:"h",description:"height of the offscreen graphics buffer
\n",type:"Number"},{name:"renderer",description:"either P2D or WEBGL\nundefined defaults to p2d
\n",type:"Constant",optional:!0}],return:{description:"offscreen graphics buffer",type:"p5.Graphics"},example:["\n\n\nvar pg;\nfunction setup() {\n createCanvas(100, 100);\n pg = createGraphics(100, 100);\n}\nfunction draw() {\n background(200);\n pg.background(100);\n pg.noStroke();\n pg.ellipse(pg.width/2, pg.height/2, 50, 50);\n image(pg, 50, 50);\n image(pg, 0, 0, 50, 50);\n}\n\n"],alt:"4 grey squares alternating light and dark grey. White quarter circle mid-left.",class:"p5",module:"Rendering",submodule:"Rendering"},{file:"src/core/rendering.js",line:223,description:"Blends the pixels in the display window according to the defined mode.\nThere is a choice of the following modes to blend the source pixels (A)\nwith the ones of pixels already in the display window (B):
\n\nBLEND - linear interpolation of colours: C =\nAfactor + B. This is the default blending mode.ADD - sum of A and BDARKEST - only the darkest colour succeeds: C =\nmin(Afactor, B).LIGHTEST - only the lightest colour succeeds: C =\nmax(A*factor, B).DIFFERENCE - subtract colors from underlying image.EXCLUSION - similar to DIFFERENCE, but less\nextreme.MULTIPLY - multiply the colors, result will always be\ndarker.SCREEN - opposite multiply, uses inverse values of the\ncolors.REPLACE - the pixels entirely replace the others and\ndon't utilize alpha (transparency) values.OVERLAY - mix of MULTIPLY and SCREEN\n. Multiplies dark values, and screens light values.HARD_LIGHT - SCREEN when greater than 50%\ngray, MULTIPLY when lower.SOFT_LIGHT - mix of DARKEST and\nLIGHTEST. Works like OVERLAY, but not as harsh.\nDODGE - lightens light tones and increases contrast,\nignores darks.BURN - darker areas are applied, increasing contrast,\nignores lights.
",itemtype:"method",name:"blendMode",params:[{name:"mode",description:"blend mode to set for canvas.\n either BLEND, DARKEST, LIGHTEST, DIFFERENCE, MULTIPLY,\n EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,\n SOFT_LIGHT, DODGE, BURN, ADD or NORMAL
\n",type:"Constant"}],example:["\n\n\nblendMode(LIGHTEST);\nstrokeWeight(30);\nstroke(80, 150, 255);\nline(25, 25, 75, 75);\nstroke(255, 50, 50);\nline(75, 25, 25, 75);\n\n\n\n\nblendMode(MULTIPLY);\nstrokeWeight(30);\nstroke(80, 150, 255);\nline(25, 25, 75, 75);\nstroke(255, 50, 50);\nline(75, 25, 25, 75);\n\n"],alt:"translucent image thick red & blue diagonal rounded lines intersecting center\nThick red & blue diagonal rounded lines intersecting center. dark at overlap",class:"p5",module:"Rendering",submodule:"Rendering"},{file:"src/core/shim.js",line:65,description:'shim for Uint8ClampedArray.slice\n(allows arrayCopy to work with pixels[])\nwith thanks to http://halfpapstudios.com/blog/tag/html5-canvas/\nEnumerable set to false to protect for...in from\nUint8ClampedArray.prototype pollution.
\n',class:"p5",module:"Rendering"},{file:"src/core/structure.js",line:15,description:"Stops p5.js from continuously executing the code within draw().\nIf loop() is called, the code in draw() begins to run continuously again.\nIf using noLoop() in setup(), it should be the last line inside the block.\n
\nWhen noLoop() is used, it's not possible to manipulate or access the\nscreen inside event handling functions such as mousePressed() or\nkeyPressed(). Instead, use those functions to call redraw() or loop(),\nwhich will run draw(), which can update the screen properly. This means\nthat when noLoop() has been called, no drawing can happen, and functions\nlike saveFrame() or loadPixels() may not be used.\n
\nNote that if the sketch is resized, redraw() will be called to update\nthe sketch, even after noLoop() has been specified. Otherwise, the sketch\nwould enter an odd state until loop() was called.
\n",itemtype:"method",name:"noLoop",example:["\n\nfunction setup() {\n createCanvas(100, 100);\n background(200);\n noLoop();\n}\n\nfunction draw() {\n line(10, 10, 90, 90);\n}\n\n\n\nvar x = 0;\nfunction setup() {\n createCanvas(100, 100);\n}\n\nfunction draw() {\n background(204);\n x = x + 0.1;\n if (x > width) {\n x = 0;\n }\n line(x, 0, x, height);\n}\n\nfunction mousePressed() {\n noLoop();\n}\n\nfunction mouseReleased() {\n loop();\n}\n"],alt:"113 pixel long line extending from top-left to bottom right of canvas.\nhorizontal line moves slowly from left. Loops but stops on mouse press.",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/structure.js",line:77,description:"By default, p5.js loops through draw() continuously, executing the code\nwithin it. However, the draw() loop may be stopped by calling noLoop().\nIn that case, the draw() loop can be resumed with loop().
\n",itemtype:"method",name:"loop",example:["\n\nvar x = 0;\nfunction setup() {\n createCanvas(100, 100);\n noLoop();\n}\n\nfunction draw() {\n background(204);\n x = x + 0.1;\n if (x > width) {\n x = 0;\n }\n line(x, 0, x, height);\n}\n\nfunction mousePressed() {\n loop();\n}\n\nfunction mouseReleased() {\n noLoop();\n}\n"],alt:"horizontal line moves slowly from left. Loops but stops on mouse press.",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/structure.js",line:119,description:"The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n
\npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textMode(), textSize(), textLeading().
\n",itemtype:"method",name:"push",example:["\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\ntranslate(50, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n"],alt:"Gold ellipse + thick black outline @center 2 white ellipses on left and right.\n2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/structure.js",line:194,description:"The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n
\npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textMode(), textSize(), textLeading().
\n",itemtype:"method",name:"pop",example:["\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\ntranslate(50, 0);\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n\n\n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n"],alt:"Gold ellipse + thick black outline @center 2 white ellipses on left and right.\n2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/structure.js",line:266,description:"Executes the code within draw() one time. This functions allows the\n program to update the display window only when necessary, for example\n when an event registered by mousePressed() or keyPressed() occurs.\n
\n In structuring a program, it only makes sense to call redraw() within\n events such as mousePressed(). This is because redraw() does not run\n draw() immediately (it only sets a flag that indicates an update is\n needed).\n
\n The redraw() function does not work properly when called inside draw().\n To enable/disable animations, use loop() and noLoop().\n
\n In addition you can set the number of redraws per method call. Just\n add an integer as single parameter for the number of redraws.
\n",itemtype:"method",name:"redraw",params:[{name:"n",description:"Redraw for n-times. The default value is 1.
\n",type:"Integer",optional:!0}],example:["\n \n var x = 0;\nfunction setup() {\n createCanvas(100, 100);\n noLoop();\n }\nfunction draw() {\n background(204);\n line(x, 0, x, height);\n }\nfunction mousePressed() {\n x += 1;\n redraw();\n }\n \n\n var x = 0;\nfunction setup() {\n createCanvas(100, 100);\n noLoop();\n }\nfunction draw() {\n background(204);\n x += 1;\n line(x, 0, x, height);\n }\nfunction mousePressed() {\n redraw(5);\n }\n "],alt:"black line on far left of canvas\n black line on far left of canvas",class:"p5",module:"Structure",submodule:"Structure"},{file:"src/core/transform.js",line:15,description:'Multiplies the current matrix by the one specified through the parameters.\nThis is a powerful operation that can perform the equivalent of translate,\nscale, shear and rotate all at once. You can learn more about transformation\nmatrices on \nWikipedia.
\nThe naming of the arguments here follows the naming of the \nWHATWG specification and corresponds to a\ntransformation matrix of the\nform:
\n\n
\n
\n',itemtype:"method",name:"applyMatrix",params:[{name:"a",description:"numbers which define the 2x3 matrix to be multiplied
\n",type:"Number"},{name:"b",description:"numbers which define the 2x3 matrix to be multiplied
\n",type:"Number"},{name:"c",description:"numbers which define the 2x3 matrix to be multiplied
\n",type:"Number"},{name:"d",description:"numbers which define the 2x3 matrix to be multiplied
\n",type:"Number"},{name:"e",description:"numbers which define the 2x3 matrix to be multiplied
\n",type:"Number"},{name:"f",description:"numbers which define the 2x3 matrix to be multiplied
\n",type:"Number"}],chainable:1,example:["\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n // Equivalent to translate(x, y);\n applyMatrix(1, 0, 0, 1, 40 + step, 50);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n translate(50, 50);\n // Equivalent to scale(x, y);\n applyMatrix(1 / step, 0, 0, 1 / step, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20\n var angle = map(step, 0, 20, 0, TWO_PI);\n var cos_a = cos(angle);\n var sin_a = sin(angle);\n background(200);\n translate(50, 50);\n // Equivalent to rotate(angle);\n applyMatrix(cos_a, sin_a, -sin_a, cos_a, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n\n\n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20\n var angle = map(step, 0, 20, -PI/4, PI/4);\n background(200);\n translate(50, 50);\n // equivalent to shearX(angle);\n var shear_factor = 1 / tan(PI/2 - angle);\n applyMatrix(1, 0, shear_factor, 1, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n"],alt:"A rectangle translating to the right\nA rectangle shrinking to the center\nA rectangle rotating clockwise about the center\nA rectangle shearing",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:137,description:"Replaces the current matrix with the identity matrix.
\n",itemtype:"method",name:"resetMatrix",chainable:1,example:["\n\n\ntranslate(50, 50);\napplyMatrix(0.5, 0.5, -0.5, 0.5, 0, 0);\nrect(0, 0, 20, 20);\n// Note that the translate is also reset.\nresetMatrix();\nrect(0, 0, 20, 20);\n\n"],alt:"A rotated retangle in the center with another at the top left corner",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:163,description:"Rotates a shape the amount specified by the angle parameter. This\nfunction accounts for angleMode, so angles can be entered in either\nRADIANS or DEGREES.\n
\nObjects are always rotated around their relative position to the\norigin and positive numbers rotate objects in a clockwise direction.\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nrotate(HALF_PI) and then rotate(HALF_PI) is the same as rotate(PI).\nAll tranformations are reset when draw() begins again.\n
\nTechnically, rotate() multiplies the current transformation matrix\nby a rotation matrix. This function can be further controlled by\nthe push() and pop().
\n",itemtype:"method",name:"rotate",params:[{name:"angle",
-description:"the angle of rotation, specified in radians\n or degrees, depending on current angleMode
\n",type:"Number"},{name:"axis",description:"(in 3d) the axis to rotate around
\n",type:"p5.Vector|Array",optional:!0}],chainable:1,example:["\n\n\ntranslate(width/2, height/2);\nrotate(PI/3.0);\nrect(-26, -26, 52, 52);\n\n"],alt:"white 52x52 rect with black outline at center rotated counter 45 degrees",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:218,description:"Rotates around X axis.
\n",itemtype:"method",name:"rotateX",params:[{name:"rad",description:"angles in radians
\n",type:"Number"}],chainable:1,class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:233,description:"Rotates around Y axis.
\n",itemtype:"method",name:"rotateY",params:[{name:"rad",description:"angles in radians
\n",type:"Number"}],chainable:1,class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:248,description:"Rotates around Z axis. Webgl mode only.
\n",itemtype:"method",name:"rotateZ",params:[{name:"rad",description:"angles in radians
\n",type:"Number"}],chainable:1,class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:263,description:"Increases or decreases the size of a shape by expanding and contracting\nvertices. Objects always scale from their relative origin to the\ncoordinate system. Scale values are specified as decimal percentages.\nFor example, the function call scale(2.0) increases the dimension of a\nshape by 200%.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function multiply the effect. For example, calling scale(2.0)\nand then scale(1.5) is the same as scale(3.0). If scale() is called\nwithin draw(), the transformation is reset when the loop begins again.\n
\nUsing this function with the z parameter is only available in WEBGL mode.\nThis function can be further controlled with push() and pop().
\n",itemtype:"method",name:"scale",params:[{name:"s",description:"percent to scale the object, or percentage to\n scale the object in the x-axis if multiple arguments\n are given
\n",type:"Number|p5.Vector|Array"},{name:"y",description:"percent to scale the object in the y-axis
\n",type:"Number",optional:!0},{name:"z",description:"percent to scale the object in the z-axis (webgl only)
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\ntranslate(width/2, height/2);\nrotate(PI/3.0);\nrect(-26, -26, 52, 52);\n\n\n\n\n\nrect(30, 20, 50, 50);\nscale(0.5, 1.3);\nrect(30, 20, 50, 50);\n\n"],alt:"white 52x52 rect with black outline at center rotated counter 45 degrees\n2 white rects with black outline- 1 50x50 at center. other 25x65 bottom left",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:345,description:"Shears a shape around the x-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode.\nObjects are always sheared around their relative position to the origin\nand positive numbers shear objects in a clockwise direction.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearX(PI/2) and then shearX(PI/2) is the same as shearX(PI).\nIf shearX() is called within the draw(), the transformation is reset when\nthe loop begins again.\n
\nTechnically, shearX() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.
\n",itemtype:"method",name:"shearX",params:[{name:"angle",description:"angle of shear specified in radians or degrees,\n depending on current angleMode
\n",type:"Number"}],chainable:1,example:["\n\n\ntranslate(width/4, height/4);\nshearX(PI/4.0);\nrect(0, 0, 30, 30);\n\n"],alt:"white irregular quadrilateral with black outline at top middle.",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:386,description:"Shears a shape around the y-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode. Objects\nare always sheared around their relative position to the origin and\npositive numbers shear objects in a clockwise direction.\n
\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If\nshearY() is called within the draw(), the transformation is reset when\nthe loop begins again.\n
\nTechnically, shearY() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.
\n",itemtype:"method",name:"shearY",params:[{name:"angle",description:"angle of shear specified in radians or degrees,\n depending on current angleMode
\n",type:"Number"}],chainable:1,example:["\n\n\ntranslate(width/4, height/4);\nshearY(PI/4.0);\nrect(0, 0, 30, 30);\n\n"],alt:"white irregular quadrilateral with black outline at middle bottom.",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/transform.js",line:427,description:"Specifies an amount to displace objects within the display window.\nThe x parameter specifies left/right translation, the y parameter\nspecifies up/down translation.\n
\nTransformations are cumulative and apply to everything that happens after\nand subsequent calls to the function accumulates the effect. For example,\ncalling translate(50, 0) and then translate(20, 0) is the same as\ntranslate(70, 0). If translate() is called within draw(), the\ntransformation is reset when the loop begins again. This function can be\nfurther controlled by using push() and pop().
\n",itemtype:"method",name:"translate",params:[{name:"x",description:"left/right translation
\n",type:"Number"},{name:"y",description:"up/down translation
\n",type:"Number"},{name:"z",description:"forward/backward translation (webgl only)
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\ntranslate(30, 20);\nrect(0, 0, 55, 55);\n\n\n\n\n\nrect(0, 0, 55, 55); // Draw rect at original 0,0\ntranslate(30, 20);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\ntranslate(14, 14);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\n\n"],alt:"white 55x55 rect with black outline at center right.\n3 white 55x55 rects with black outlines at top-l, center-r and bottom-r.",class:"p5",module:"Transform",submodule:"Transform"},{file:"src/core/vertex.js",line:22,description:"Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n
\nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.
\n",itemtype:"method",name:"beginContour",chainable:1,example:["\n\n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n"],alt:"white rect and smaller grey rect with red outlines in center of canvas.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:70,description:"Using the beginShape() and endShape() functions allow creating more\ncomplex forms. beginShape() begins recording vertices for a shape and\nendShape() stops recording. The value of the kind parameter tells it which\ntypes of shapes to create from the provided vertices. With no mode\nspecified, the shape can be any irregular polygon.\n
\nThe parameters available for beginShape() are POINTS, LINES, TRIANGLES,\nTRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the\nbeginShape() function, a series of vertex() commands must follow. To stop\ndrawing the shape, call endShape(). Each shape will be outlined with the\ncurrent stroke color and filled with the fill color.\n
\nTransformations such as translate(), rotate(), and scale() do not work\nwithin beginShape(). It is also not possible to use other shapes, such as\nellipse() or rect() within beginShape().
\n",itemtype:"method",name:"beginShape",params:[{name:"kind",description:"either POINTS, LINES, TRIANGLES, TRIANGLE_FAN\n TRIANGLE_STRIP, QUADS, or QUAD_STRIP
\n",type:"Constant",optional:!0}],chainable:1,example:["\n\n\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n\n\n\n\n// currently not working\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nbeginShape(LINES);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n\n\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n\n\n\n\nbeginShape(TRIANGLES);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nendShape();\n\n\n\n\n\nbeginShape(TRIANGLE_STRIP);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nvertex(90, 75);\nendShape();\n\n\n\n\n\nbeginShape(TRIANGLE_FAN);\nvertex(57.5, 50);\nvertex(57.5, 15);\nvertex(92, 50);\nvertex(57.5, 85);\nvertex(22, 50);\nvertex(57.5, 15);\nendShape();\n\n\n\n\n\nbeginShape(QUADS);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 75);\nvertex(50, 20);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 75);\nvertex(85, 20);\nendShape();\n\n\n\n\n\nbeginShape(QUAD_STRIP);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 20);\nvertex(50, 75);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 20);\nvertex(85, 75);\nendShape();\n\n\n\n\n\nbeginShape();\nvertex(20, 20);\nvertex(40, 20);\nvertex(40, 40);\nvertex(60, 40);\nvertex(60, 60);\nvertex(20, 60);\nendShape(CLOSE);\n\n"],alt:"white square-shape with black outline in middle-right of canvas.\n4 black points in a square shape in middle-right of canvas.\n2 horizontal black lines. In the top-right and bottom-right of canvas.\n3 line shape with horizontal on top, vertical in middle and horizontal bottom.\nsquare line shape in middle-right of canvas.\n2 white triangle shapes mid-right canvas. left one pointing up and right down.\n5 horizontal interlocking and alternating white triangles in mid-right canvas.\n4 interlocking white triangles in 45 degree rotated square-shape.\n2 white rectangle shapes in mid-right canvas. Both 20x55.\n3 side-by-side white rectangles center rect is smaller in mid-right canvas.\nThick white l-shape with black outline mid-top-left of canvas.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:267,description:"Specifies vertex coordinates for Bezier curves. Each call to\nbezierVertex() defines the position of two control points and\none anchor point of a Bezier curve, adding a new segment to a\nline or shape.\n
\nThe first time bezierVertex() is used within a\nbeginShape() call, it must be prefaced with a call to vertex()\nto set the first anchor point. This function must be used between\nbeginShape() and endShape() and only when there is no MODE\nparameter specified to beginShape().
\n",itemtype:"method",name:"bezierVertex",params:[{name:"x2",description:"x-coordinate for the first control point
\n",type:"Number"},{name:"y2",description:"y-coordinate for the first control point
\n",type:"Number"},{name:"x3",description:"x-coordinate for the second control point
\n",type:"Number"},{name:"y3",description:"y-coordinate for the second control point
\n",type:"Number"},{name:"x4",description:"x-coordinate for the anchor point
\n",type:"Number"},{name:"y4",description:"y-coordinate for the anchor point
\n",type:"Number"}],chainable:1,example:["\n\n\nnoFill();\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nendShape();\n\n\n\n\n\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nbezierVertex(50, 80, 60, 25, 30, 20);\nendShape();\n\n"],alt:"crescent-shaped line in middle of canvas. Points facing left.\nwhite crescent shape in middle of canvas. Points facing left.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:332,description:"Specifies vertex coordinates for curves. This function may only\nbe used between beginShape() and endShape() and only when there\nis no MODE parameter specified to beginShape().\n
\nThe first and last points in a series of curveVertex() lines will be used to\nguide the beginning and end of a the curve. A minimum of four\npoints is required to draw a tiny curve between the second and\nthird points. Adding a fifth point with curveVertex() will draw\nthe curve between the second, third, and fourth points. The\ncurveVertex() function is an implementation of Catmull-Rom\nsplines.
\n",itemtype:"method",name:"curveVertex",params:[{name:"x",description:"x-coordinate of the vertex
\n",type:"Number"},{name:"y",description:"y-coordinate of the vertex
\n",type:"Number"}],chainable:1,example:["\n\n\nnoFill();\nbeginShape();\ncurveVertex(84, 91);\ncurveVertex(84, 91);\ncurveVertex(68, 19);\ncurveVertex(21, 17);\ncurveVertex(32, 100);\ncurveVertex(32, 100);\nendShape();\n\n"],alt:"Upside-down u-shape line, mid canvas. left point extends beyond canvas view.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:374,description:"Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n
\nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.
\n",itemtype:"method",name:"endContour",chainable:1,example:["\n\n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n"],alt:"white rect and smaller grey rect with red outlines in center of canvas.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:434,description:"The endShape() function is the companion to beginShape() and may only be\ncalled after beginShape(). When endshape() is called, all of image data\ndefined since the previous call to beginShape() is written into the image\nbuffer. The constant CLOSE as the value for the MODE parameter to close\nthe shape (to connect the beginning and the end).
\n",itemtype:"method",name:"endShape",params:[{name:"mode",description:"use CLOSE to close the shape
\n",type:"Constant",optional:!0}],chainable:1,example:["\n\n\nnoFill();\n\nbeginShape();\nvertex(20, 20);\nvertex(45, 20);\nvertex(45, 80);\nendShape(CLOSE);\n\nbeginShape();\nvertex(50, 20);\nvertex(75, 20);\nvertex(75, 80);\nendShape();\n\n"],alt:"Triangle line shape with smallest interior angle on bottom and upside-down L.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:502,description:"Specifies vertex coordinates for quadratic Bezier curves. Each call to\nquadraticVertex() defines the position of one control points and one\nanchor point of a Bezier curve, adding a new segment to a line or shape.\nThe first time quadraticVertex() is used within a beginShape() call, it\nmust be prefaced with a call to vertex() to set the first anchor point.\nThis function must be used between beginShape() and endShape() and only\nwhen there is no MODE parameter specified to beginShape().
\n",itemtype:"method",name:"quadraticVertex",params:[{name:"cx",description:"x-coordinate for the control point
\n",type:"Number"},{name:"cy",description:"y-coordinate for the control point
\n",type:"Number"},{name:"x3",description:"x-coordinate for the anchor point
\n",type:"Number"},{name:"y3",description:"y-coordinate for the anchor point
\n",type:"Number"}],chainable:1,example:["\n\n\nnoFill();\nstrokeWeight(4);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nendShape();\n\n\n\n\n\nnoFill();\nstrokeWeight(4);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nquadraticVertex(20, 80, 80, 80);\nvertex(80, 60);\nendShape();\n\n"],alt:"arched-shaped black line with 4 pixel thick stroke weight.\nbackwards s-shaped black line with 4 pixel thick stroke weight.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/core/vertex.js",line:579,description:"All shapes are constructed by connecting a series of vertices. vertex()\nis used to specify the vertex coordinates for points, lines, triangles,\nquads, and polygons. It is used exclusively within the beginShape() and\nendShape() functions.
\n",itemtype:"method",name:"vertex",params:[{name:"x",description:"x-coordinate of the vertex
\n",type:"Number"},{name:"y",description:"y-coordinate of the vertex
\n",type:"Number"},{name:"z",description:"z-coordinate of the vertex
\n",type:"Number|Boolean",optional:!0}],chainable:1,example:["\n\n\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n"],alt:"4 black points in a square shape in middle-right of canvas.",class:"p5",module:"Shape",submodule:"Vertex"},{file:"src/data/p5.TypedDict.js",line:16,description:"Creates a new instance of p5.StringDict using the key, value pair\n or object you provide.
\n",itemtype:"method",name:"createStringDict",params:[{name:"key",description:"or object
\n",type:"String|Object"},{name:"value",description:"",type:"String"}],return:{description:"",type:"p5.StringDict"},class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:32,description:"Creates a new instance of p5.NumberDict using the key, value pair\n or object you provide.
\n",itemtype:"method",name:"createNumberDict",params:[{name:"key",description:"or object
\n",type:"Number|Object"},{name:"value",description:"",type:"Number"}],return:{description:"",type:"p5.NumberDict"},class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:68,description:"Returns the number of key-value pairs currently in Dictionary object
\n",itemtype:"method",name:"size",return:{description:"the number of key-value pairs in Dictionary object",type:"Number"},example:['\n\n\n\nfunction setup() {\n var myDictionary = createNumberDict(1, 10);\n myDictionary.create(2, 20);\n myDictionary.create(3, 30);\n var amt = myDictionary.size(); // value of amt is 3\n}\n\n\n'],class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:92,description:"Returns true if key exists in Dictionary\notherwise returns false
\n",itemtype:"method",name:"hasKey",params:[{name:"key",description:"that you want to access
\n",type:"Number|String"}],return:{description:"whether that key exists in Dictionary",type:"Boolean"},example:["\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // logs true to console\n}\n\n\n"],class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:117,description:"Returns value stored at supplied key.
\n",itemtype:"method",name:"get",params:[{name:"key",description:"that you want to access
\n",type:"Number|String"}],return:{description:"the value stored at that key",type:"Number|String"},example:["\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n var myValue = myDictionary.get('p5');\n print(myValue === 'js'); // logs true to console\n}\n\n\n"],class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:146,description:"Changes the value of key if in it already exists in\nin the Dictionary otherwise makes a new key-value pair
\n",itemtype:"method",name:"set",params:[{name:"key",description:"",type:"Number|String"},{name:"value",description:"",type:"Number|String"}],example:["\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.set('p5', 'JS');\n myDictionary.print()\n // above logs \"key: p5 - value: JS\" to console\n}\n\n\n"],class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:179,description:"private helper function to handle the user passing objects in\nduring construction or calls to create()
\n",class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:194,description:"Removes a key-value pair in the Dictionary
\n",itemtype:"method",name:"create",class:"p5.TypedDict",module:"Data",submodule:"Dictionary",overloads:[{line:194,params:[{name:"key",description:"",type:"Number|String"},{name:"value",description:"",type:"Number|String"}]},{line:201,params:[{name:"obj",description:"key/value pair
\n",type:"Object"}]}]},{file:"src/data/p5.TypedDict.js",line:234,description:"Empties Dictionary of all key-value pairs
\n",itemtype:"method",name:"clear",class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:245,description:"Removes a key-value pair in the Dictionary
\n",itemtype:"method",name:"remove",params:[{name:"key",description:"for the pair to remove
\n",type:"Number|String"}],example:["\n\n\n\nfunction setup() {\n var myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print()\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n myDictionary.remove('p5');\n myDictionary.print();\n // above logs \"key: happy value: coding\" to console\n}\n\n\n"],class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:277,description:"Logs the list of items currently in the Dictionary to the console
\n",itemtype:"method",name:"print",class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:289,description:"Converts the Dictionary into a CSV file for local\nstorage.
\n",itemtype:"method",name:"saveTable",class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:310,description:"Converts the Dictionary into a JSON file for local\nstorage.
\n",itemtype:"method",name:"saveJSON",class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:321,description:"private helper function to ensure that the user passed in valid\nvalues for the Dictionary type
\n",class:"p5.TypedDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:368,description:"private helper function to ensure that the user passed in valid\nvalues for the Dictionary type
\n",class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:377,description:"Add to a value stored at a certain key\nThe sum is stored in that location in the Dictionary.
\n",itemtype:"method",name:"add",params:[{name:"Key",description:"for value you wish to add to
\n",type:"Number"},{name:"Amount",description:"to add to the value
\n",type:"Number"}],example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 5);\n myDictionary.add(2, 2);\n console.log(myDictionary.get(2)); // logs 7 to console.\n}\n\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:405,description:"Subtract from a value stored at a certain key\nThe difference is stored in that location in the Dictionary.
\n",itemtype:"method",name:"sub",params:[{name:"Key",description:"for value you wish to subtract from
\n",type:"Number"},{name:"Amount",description:"to subtract from the value
\n",type:"Number"}],example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 5);\n myDictionary.sub(2, 2);\n console.log(myDictionary.get(2)); // logs 3 to console.\n}\n\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:429,description:"Multiply a value stored at a certain key\nThe product is stored in that location in the Dictionary.
\n",itemtype:"method",name:"mult",params:[{name:"Key",description:"for value you wish to multiply
\n",type:"Number"},{name:"Amount",description:"to multiply the value by
\n",type:"Number"}],example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 4);\n myDictionary.mult(2, 2);\n console.log(myDictionary.get(2)); // logs 8 to console.\n}\n\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:457,description:"Divide a value stored at a certain key\nThe quotient is stored in that location in the Dictionary.
\n",itemtype:"method",name:"div",params:[{name:"Key",description:"for value you wish to divide
\n",type:"Number"},{name:"Amount",description:"to divide the value by
\n",type:"Number"}],example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict(2, 8);\n myDictionary.div(2, 2);\n console.log(myDictionary.get(2)); // logs 4 to console.\n}\n\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:485,description:"private helper function for finding lowest or highest value\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'
\n",class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:508,description:"Return the lowest value.
\n",itemtype:"method",name:"minValue",return:{description:"",type:"Number"},example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict({2 : -10, 4 : 0.65, 1.2 : 3});\n var lowestValue = myDictionary.minValue(); // value is -10\n}\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:528,description:"Return the highest value.
\n",itemtype:"method",name:"maxValue",return:{description:"",type:"Number"},example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict({2 : -10, 4 : 0.65, 1.2 : 3});\n var highestValue = myDictionary.maxValue(); // value is 3\n}\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:548,description:"private helper function for finding lowest or highest key\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'
\n",class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:571,description:"Return the lowest key.
\n",itemtype:"method",name:"minKey",return:{description:"",type:"Number"},example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict({2 : 4, 4 : 6, 1.2 : 3});\n var lowestKey = myDictionary.minKey(); // value is 1.2\n}\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/data/p5.TypedDict.js",line:591,description:"Return the highest key.
\n",itemtype:"method",name:"maxKey",return:{description:"",type:"Number"},example:["\n\n\nfunction setup() {\n var myDictionary = createNumberDict({ 2 : 4, 4 : 6, 1.2 : 3});\n var highestKey = myDictionary.maxKey(); // value is 4\n}\n\n"],class:"p5.NumberDict",module:"Data",submodule:"Dictionary"},{file:"src/events/acceleration.js",line:12,description:"The system variable deviceOrientation always contains the orientation of\nthe device. The value of this variable will either be set 'landscape'\nor 'portrait'. If no data is available it will be set to 'undefined'.\neither LANDSCAPE or PORTRAIT.
\n",itemtype:"property",name:"deviceOrientation",type:"Constant",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:23,description:"The system variable accelerationX always contains the acceleration of the\ndevice along the x axis. Value is represented as meters per second squared.
\n",itemtype:"property",name:"accelerationX",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:32,description:"The system variable accelerationY always contains the acceleration of the\ndevice along the y axis. Value is represented as meters per second squared.
\n",itemtype:"property",name:"accelerationY",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:41,description:"The system variable accelerationZ always contains the acceleration of the\ndevice along the z axis. Value is represented as meters per second squared.
\n",itemtype:"property",name:"accelerationZ",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:50,
-description:"The system variable pAccelerationX always contains the acceleration of the\ndevice along the x axis in the frame previous to the current frame. Value\nis represented as meters per second squared.
\n",itemtype:"property",name:"pAccelerationX",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:60,description:"The system variable pAccelerationY always contains the acceleration of the\ndevice along the y axis in the frame previous to the current frame. Value\nis represented as meters per second squared.
\n",itemtype:"property",name:"pAccelerationY",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:70,description:"The system variable pAccelerationZ always contains the acceleration of the\ndevice along the z axis in the frame previous to the current frame. Value\nis represented as meters per second squared.
\n",itemtype:"property",name:"pAccelerationZ",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:80,description:"_updatePAccelerations updates the pAcceleration values
\n",access:"private",tagname:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:91,description:"The system variable rotationX always contains the rotation of the\ndevice along the x axis. Value is represented as 0 to +/-180 degrees.\n
\nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.
\n",example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n //rotateZ(radians(rotationZ));\n rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"],itemtype:"property",name:"rotationX",type:"Number",readonly:"",alt:"red horizontal line right, green vertical line bottom. black background.",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:125,description:"The system variable rotationY always contains the rotation of the\ndevice along the y axis. Value is represented as 0 to +/-90 degrees.\n
\nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.
\n",example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n //rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"],itemtype:"property",name:"rotationY",type:"Number",readonly:"",alt:"red horizontal line right, green vertical line bottom. black background.",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:158,description:"The system variable rotationZ always contains the rotation of the\ndevice along the z axis. Value is represented as 0 to 359 degrees.\n
\nUnlike rotationX and rotationY, this variable is available for devices\nwith a built-in compass only.\n
\nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.
\n",example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n"],itemtype:"property",name:"rotationZ",type:"Number",readonly:"",alt:"red horizontal line right, green vertical line bottom. black background.",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:194,description:"The system variable pRotationX always contains the rotation of the\ndevice along the x axis in the frame previous to the current frame. Value\nis represented as 0 to +/-180 degrees.\n
\npRotationX can also be used with rotationX to determine the rotate\ndirection of the device along the X-axis.
\n",example:["\n\n\n// A simple if statement looking at whether\n// rotationX - pRotationX < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely neccessary but the logic\n// will be different in that case.\n\nvar rX = rotationX + 180;\nvar pRX = pRotationX + 180;\n\nif ((rX - pRX > 0 && rX - pRX < 270)|| rX - pRX < -270){\n rotateDirection = 'clockwise';\n} else if (rX - pRX < 0 || rX - pRX > 270){\n rotateDirection = 'counter-clockwise';\n}\n\n"],alt:"no image to display.",itemtype:"property",name:"pRotationX",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:237,description:"The system variable pRotationY always contains the rotation of the\ndevice along the y axis in the frame previous to the current frame. Value\nis represented as 0 to +/-90 degrees.\n
\npRotationY can also be used with rotationY to determine the rotate\ndirection of the device along the Y-axis.
\n",example:["\n\n\n// A simple if statement looking at whether\n// rotationY - pRotationY < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely neccessary but the logic\n// will be different in that case.\n\nvar rY = rotationY + 180;\nvar pRY = pRotationY + 180;\n\nif ((rY - pRY > 0 && rY - pRY < 270)|| rY - pRY < -270){\n rotateDirection = 'clockwise';\n} else if (rY - pRY < 0 || rY - pRY > 270){\n rotateDirection = 'counter-clockwise';\n}\n\n"],alt:"no image to display.",itemtype:"property",name:"pRotationY",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:280,description:"The system variable pRotationZ always contains the rotation of the\ndevice along the z axis in the frame previous to the current frame. Value\nis represented as 0 to 359 degrees.\n
\npRotationZ can also be used with rotationZ to determine the rotate\ndirection of the device along the Z-axis.
\n",example:["\n\n\n// A simple if statement looking at whether\n// rotationZ - pRotationZ < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nvar rotateDirection = 'clockwise';\n\nif ((rotationZ - pRotationZ > 0 &&\n rotationZ - pRotationZ < 270)||\n rotationZ - pRotationZ < -270){\n\n rotateDirection = 'clockwise';\n\n} else if (rotationZ - pRotationZ < 0 ||\n rotationZ - pRotationZ > 270){\n\n rotateDirection = 'counter-clockwise';\n\n}\n\n"],alt:"no image to display.",itemtype:"property",name:"pRotationZ",type:"Number",readonly:"",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:346,description:"The setMoveThreshold() function is used to set the movement threshold for\nthe deviceMoved() function. The default threshold is set to 0.5.
\n",itemtype:"method",name:"setMoveThreshold",params:[{name:"value",description:"The threshold value
\n",type:"Number"}],class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:359,description:"The setShakeThreshold() function is used to set the movement threshold for\nthe deviceShaken() function. The default threshold is set to 30.
\n",itemtype:"method",name:"setShakeThreshold",params:[{name:"value",description:"The threshold value
\n",type:"Number"}],class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:372,description:"The deviceMoved() function is called when the device is moved by more than\nthe threshold value along X, Y or Z axis. The default threshold is set to\n0.5.
\n",itemtype:"method",name:"deviceMoved",example:['\n\n\n// Run this example on a mobile device\n// Move the device around\n// to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceMoved() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n'],alt:"50x50 black rect in center of canvas. turns white on mobile when device moves",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:403,description:"The deviceTurned() function is called when the device rotates by\nmore than 90 degrees continuously.\n
\nThe axis that triggers the deviceTurned() method is stored in the turnAxis\nvariable. The deviceTurned() method can be locked to trigger on any axis:\nX, Y or Z by comparing the turnAxis variable to 'X', 'Y' or 'Z'.
\n",itemtype:"method",name:"deviceTurned",example:["\n\n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees\n// to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (value == 0){\n value = 255\n } else if (value == 255) {\n value = 0;\n }\n}\n\n\n\n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees in the\n// X-axis to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (turnAxis == 'X'){\n if (value == 0){\n value = 255\n } else if (value == 255) {\n value = 0;\n }\n }\n}\n\n"],alt:"50x50 black rect in center of canvas. turns white on mobile when device turns\n50x50 black rect in center of canvas. turns white on mobile when x-axis turns",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/acceleration.js",line:462,description:"The deviceShaken() function is called when the device total acceleration\nchanges of accelerationX and accelerationY values is more than\nthe threshold value. The default threshold is set to 30.
\n",itemtype:"method",name:"deviceShaken",example:['\n\n\n// Run this example on a mobile device\n// Shake the device to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceShaken() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n'],alt:"50x50 black rect in center of canvas. turns white on mobile when device shakes",class:"p5",module:"Events",submodule:"Acceleration"},{file:"src/events/keyboard.js",line:12,description:"Holds the key codes of currently pressed keys.
\n",access:"private",tagname:"",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:18,description:"The boolean system variable keyIsPressed is true if any key is pressed\nand false if no keys are pressed.
\n",itemtype:"property",name:"keyIsPressed",type:"Boolean",readonly:"",example:["\n\n\nvar value = 0;\nfunction draw() {\n if (keyIsPressed === true) {\n fill(0);\n } else {\n fill(255);\n }\n rect(25, 25, 50, 50);\n}\n\n"],alt:"50x50 white rect that turns black on keypress.",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:46,description:"The system variable key always contains the value of the most recent\nkey on the keyboard that was typed. To get the proper capitalization, it\nis best to use it within keyTyped(). For non-ASCII keys, use the keyCode\nvariable.
\n",itemtype:"property",name:"key",type:"String",readonly:"",example:["\n\n// Click any key to display it!\n// (Not Guaranteed to be Case Sensitive)\nfunction setup() {\n fill(245, 123, 158);\n textSize(50);\n}\n\nfunction draw() {\n background(200);\n text(key, 33,65); // Display last key pressed.\n}\n"],alt:"canvas displays any key value that is pressed in pink font.",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:75,description:'The variable keyCode is used to detect special keys such as BACKSPACE,\nDELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL, OPTION, ALT, UP_ARROW,\nDOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\nYou can also check for custom keys by looking up the keyCode of any key\non a site like this: keycode.info.
\n',itemtype:"property",name:"keyCode",type:"Number",readonly:"",example:["\n\nvar fillVal = 126;\nfunction draw() {\n fill(fillVal);\n rect(25, 25, 50, 50);\n}\n\nfunction keyPressed() {\n if (keyCode == UP_ARROW) {\n fillVal = 255;\n } else if (keyCode == DOWN_ARROW) {\n fillVal = 0;\n }\n return false; // prevent default\n}\n"],alt:"Grey rect center. turns white when up arrow pressed and black when down",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:108,description:"The keyPressed() function is called once every time a key is pressed. The\nkeyCode for the key that was pressed is stored in the keyCode variable.\n
\nFor non-ASCII keys, use the keyCode variable. You can check if the keyCode\nequals BACKSPACE, DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL,\nOPTION, ALT, UP_ARROW, DOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\n
\nFor ASCII keys that was pressed is stored in the key variable. However, it\ndoes not distinguish between uppercase and lowercase. For this reason, it\nis recommended to use keyTyped() to read the key variable, in which the\ncase of the variable will be distinguished.\n
\nBecause of how operating systems handle key repeats, holding down a key\nmay cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.
\nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"keyPressed",example:['\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (keyCode === LEFT_ARROW) {\n value = 255;\n } else if (keyCode === RIGHT_ARROW) {\n value = 0;\n }\n}\n\n\n\n\nfunction keyPressed(){\n // Do something\n return false; // prevent any default behaviour\n}\n\n'],alt:"black rect center. turns white when key pressed and black when released\nblack rect center. turns white when left arrow pressed and black when right.",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:198,description:"The keyReleased() function is called once every time a key is released.\nSee key and keyCode for more information.
\nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"keyReleased",example:["\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyReleased() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n return false; // prevent any default behavior\n}\n\n"],alt:"black rect center. turns white when key pressed and black when pressed again",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:254,description:"The keyTyped() function is called once every time a key is pressed, but\naction keys such as Ctrl, Shift, and Alt are ignored. The most recent\nkey pressed will be stored in the key variable.\n
\nBecause of how operating systems handle key repeats, holding down a key\nwill cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.
\nBrowsers may have different default behaviors attached to various key\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",itemtype:"method",name:"keyTyped",example:["\n\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyTyped() {\n if (key === 'a') {\n value = 255;\n } else if (key === 'b') {\n value = 0;\n }\n // uncomment to prevent any default behavior\n // return false;\n}\n\n"],alt:"black rect center. turns white when 'a' key typed and black when 'b' pressed",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:307,description:"The onblur function is called when the user is no longer focused\non the p5 element. Because the keyup events will not fire if the user is\nnot focused on the element we must assume all keys currently down have\nbeen released.
\n",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:317,description:'The keyIsDown() function checks if the key is currently down, i.e. pressed.\nIt can be used if you have an object that moves, and you want several keys\nto be able to affect its behaviour simultaneously, such as moving a\nsprite diagonally. You can put in any number representing the keyCode of\nthe key, or use any of the variable keyCode names listed\nhere.
\n',itemtype:"method",name:"keyIsDown",params:[{name:"code",description:"The key to check for.
\n",type:"Number"}],return:{description:"whether key is down or not",type:"Boolean"},example:["\n\nvar x = 100;\nvar y = 100;\n\nfunction setup() {\n createCanvas(512, 512);\n}\n\nfunction draw() {\n if (keyIsDown(LEFT_ARROW))\n x-=5;\n\n if (keyIsDown(RIGHT_ARROW))\n x+=5;\n\n if (keyIsDown(UP_ARROW))\n y-=5;\n\n if (keyIsDown(DOWN_ARROW))\n y+=5;\n\n clear();\n fill(255, 0, 0);\n ellipse(x, y, 50, 50);\n}\n"],alt:"50x50 red ellipse moves left, right, up and down with arrow presses.",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/keyboard.js",line:364,description:"The checkDownKeys function returns a boolean true if any keys pressed\nand a false if no keys are currently pressed.
\nHelps avoid instances where a multiple keys are pressed simultaneously and\nreleasing a single key will then switch the\nkeyIsPressed property to true.
\n",access:"private",tagname:"",class:"p5",module:"Events",submodule:"Keyboard"},{file:"src/events/mouse.js",line:23,description:"The system variable mouseX always contains the current horizontal\nposition of the mouse, relative to (0, 0) of the canvas. If touch is\nused instead of mouse input, mouseX will hold the x value of the most\nrecent touch point.
\n",itemtype:"property",name:"mouseX",type:"Number",readonly:"",example:["\n\n\n// Move the mouse across the canvas\nfunction draw() {\n background(244, 248, 252);\n line(mouseX, 0, mouseX, 100);\n}\n\n"],alt:"horizontal black line moves left and right with mouse x-position",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:49,description:"The system variable mouseY always contains the current vertical position\nof the mouse, relative to (0, 0) of the canvas. If touch is\nused instead of mouse input, mouseY will hold the y value of the most\nrecent touch point.
\n",itemtype:"property",name:"mouseY",type:"Number",readonly:"",example:["\n\n\n// Move the mouse across the canvas\nfunction draw() {\n background(244, 248, 252);\n line(0, mouseY, 100, mouseY);\n}\n\n"],alt:"vertical black line moves up and down with mouse y-position",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:75,description:"The system variable pmouseX always contains the horizontal position of\nthe mouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas.
\n",itemtype:"property",name:"pmouseX",type:"Number",readonly:"",example:['\n\n\n// Move the mouse across the canvas to leave a trail\nfunction setup() {\n //slow down the frameRate to make it more visible\n frameRate(10);\n}\n\nfunction draw() {\n background(244, 248, 252);\n line(mouseX, mouseY, pmouseX, pmouseY);\n print(pmouseX + " -> " + mouseX);\n}\n\n\n'],alt:"line trail is created from cursor movements. faster movement make longer line.",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:107,description:"The system variable pmouseY always contains the vertical position of the\nmouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas.
\n",itemtype:"property",name:"pmouseY",type:"Number",readonly:"",example:['\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n //draw a square only if the mouse is not moving\n if(mouseY == pmouseY && mouseX == pmouseX)\n rect(20,20,60,60);\n\n print(pmouseY + " -> " + mouseY);\n}\n\n\n'],alt:"60x60 black rect center, fuschia background. rect flickers on mouse movement",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:137,description:"The system variable winMouseX always contains the current horizontal\nposition of the mouse, relative to (0, 0) of the window.
\n",itemtype:"property",name:"winMouseX",type:"Number",readonly:"",example:["\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the horizontal mouse position\n //relative to the window\n myCanvas.position(winMouseX+1, windowHeight/2);\n\n //the y of the square is relative to the canvas\n rect(20,mouseY,60,60);\n}\n\n\n"],alt:"60x60 black rect y moves with mouse y and fuschia canvas moves with mouse x",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:175,description:"The system variable winMouseY always contains the current vertical\nposition of the mouse, relative to (0, 0) of the window.
\n",itemtype:"property",name:"winMouseY",type:"Number",readonly:"",example:["\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the vertical mouse position\n //relative to the window\n myCanvas.position(windowWidth/2, winMouseY+1);\n\n //the x of the square is relative to the canvas\n rect(mouseX,20,60,60);\n}\n\n\n"],alt:"60x60 black rect x moves with mouse x and fuschia canvas y moves with mouse y",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:213,description:"The system variable pwinMouseX always contains the horizontal position\nof the mouse in the frame previous to the current frame, relative to\n(0, 0) of the window.
\n",itemtype:"property",name:"pwinMouseX",type:"Number",readonly:"",example:["\n\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n }\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current x position is the horizontal mouse speed\n var speed = abs(winMouseX-pwinMouseX);\n //change the size of the circle\n //according to the horizontal speed\n ellipse(50, 50, 10+speed*5, 10+speed*5);\n //move the canvas to the mouse position\n myCanvas.position( winMouseX+1, winMouseY+1);\n}\n\n\n"],alt:"fuschia ellipse moves with mouse x and y. Grows and shrinks with mouse speed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:255,description:"The system variable pwinMouseY always contains the vertical position of\nthe mouse in the frame previous to the current frame, relative to (0, 0)\nof the window.
\n",itemtype:"property",name:"pwinMouseY",type:"Number",readonly:"",example:["\n\n\n\nvar myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n }\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current y position is the vertical mouse speed\n var speed = abs(winMouseY-pwinMouseY);\n //change the size of the circle\n //according to the vertical speed\n ellipse(50, 50, 10+speed*5, 10+speed*5);\n //move the canvas to the mouse position\n myCanvas.position( winMouseX+1, winMouseY+1);\n}\n\n\n"],alt:"fuschia ellipse moves with mouse x and y. Grows and shrinks with mouse speed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:298,description:"Processing automatically tracks if the mouse button is pressed and which\nbutton is pressed. The value of the system variable mouseButton is either\nLEFT, RIGHT, or CENTER depending on which button was pressed last.\nWarning: different browsers may track mouseButton differently.
\n",itemtype:"property",name:"mouseButton",type:"Constant",readonly:"",example:["\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed) {\n if (mouseButton == LEFT)\n ellipse(50, 50, 50, 50);\n if (mouseButton == RIGHT)\n rect(25, 25, 50, 50);\n if (mouseButton == CENTER)\n triangle(23, 75, 50, 20, 78, 75);\n }\n\n print(mouseButton);\n}\n\n"],alt:"50x50 black ellipse appears on center of fuschia canvas on mouse click/press.",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:334,description:"The boolean system variable mouseIsPressed is true if the mouse is pressed\nand false if not.
\n",itemtype:"property",name:"mouseIsPressed",type:"Boolean",readonly:"",example:["\n\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed)\n ellipse(50, 50, 50, 50);\n else\n rect(25, 25, 50, 50);\n\n print(mouseIsPressed);\n}\n\n"],alt:"black 50x50 rect becomes ellipse with mouse click/press. fuschia background.",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:416,description:"The mouseMoved() function is called every time the mouse moves and a mouse\nbutton is not pressed.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"mouseMoved",example:['\n\n\n// Move the mouse across the page\n// to change its value\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseMoved() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseMoved() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"black 50x50 rect becomes lighter with mouse movements until white then resets\nno image displayed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:460,description:"The mouseDragged() function is called once every time the mouse moves and\na mouse button is pressed. If no mouseDragged() function is defined, the\ntouchMoved() function will be called instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"mouseDragged",example:['\n\n\n// Drag the mouse across the page\n// to change its value\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseDragged() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseDragged() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"black 50x50 rect turns lighter with mouse click and drag until white, resets\nno image displayed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:531,description:"The mousePressed() function is called once after every time a mouse button\nis pressed. The mouseButton variable (see the related reference entry)\ncan be used to determine which button has been pressed. If no\nmousePressed() function is defined, the touchStarted() function will be\ncalled instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"mousePressed",example:['\n\n\n// Click within the image to change\n// the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mousePressed() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mousePressed() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"black 50x50 rect turns white with mouse click/press.\nno image displayed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:597,description:"The mouseReleased() function is called every time a mouse button is\nreleased. If no mouseReleased() function is defined, the touchEnded()\nfunction will be called instead if it is defined.
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"mouseReleased",example:['\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseReleased() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseReleased() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"black 50x50 rect turns white with mouse click/press.\nno image displayed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:664,
-description:"The mouseClicked() function is called once after a mouse button has been\npressed and then released.
\nBrowsers handle clicks differently, so this function is only guaranteed to be\nrun when the left mouse button is clicked. To handle other mouse buttons\nbeing pressed or released, see mousePressed() or mouseReleased().
\nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.
\n",itemtype:"method",name:"mouseClicked",example:['\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction mouseClicked() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction mouseClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"black 50x50 rect turns white with mouse click/press.\nno image displayed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:723,description:'The doubleClicked() function is executed every time a event\nlistener has detected a dblclick event which is a part of the\nDOM L3 specification. The doubleClicked event is fired when a\npointing device button (usually a mouse's primary button)\nis clicked twice on a single element. For more info on the\ndblclick event refer to mozilla's documentation here:\nhttps://developer.mozilla.org/en-US/docs/Web/Events/dblclick
\n',itemtype:"method",name:"doubleClicked",example:['\n\n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been double clicked\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction doubleClicked() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction doubleClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"black 50x50 rect turns white with mouse doubleClick/press.\nno image displayed",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/mouse.js",line:781,description:"The function mouseWheel() is executed every time a vertical mouse wheel\nevent is detected either triggered by an actual mouse wheel or by a\ntouchpad.
\nThe event.delta property returns the amount the mouse wheel\nhave scrolled. The values can be positive or negative depending on the\nscroll direction (on OS X with "natural" scrolling enabled, the signs\nare inverted).
\nBrowsers may have different default behaviors attached to various\nmouse events. To prevent any default behavior for this event, add\n"return false" to the end of the method.
\nDue to the current support of the "wheel" event on Safari, the function\nmay only work as expected if "return false" is included while using Safari.
\n",itemtype:"method",name:"mouseWheel",example:["\n\n\nvar pos = 25;\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n rect(25, pos, 50, 50);\n}\n\nfunction mouseWheel(event) {\n print(event.delta);\n //move the square according to the vertical scroll amount\n pos += event.delta;\n //uncomment to block page scrolling\n //return false;\n}\n\n"],alt:"black 50x50 rect moves up and down with vertical scroll. fuschia background",class:"p5",module:"Events",submodule:"Mouse"},{file:"src/events/touch.js",line:12,description:"The system variable touches[] contains an array of the positions of all\ncurrent touch points, relative to (0, 0) of the canvas, and IDs identifying a\nunique touch as it moves. Each element in the array is an object with x, y,\nand id properties.
\nThe touches[] array is not supported on Safari and IE on touch-based\ndesktops (laptops).
\n",itemtype:"property",name:"touches",type:"Object[]",readonly:"",class:"p5",module:"Events",submodule:"Touch"},{file:"src/events/touch.js",line:53,description:"The touchStarted() function is called once after every time a touch is\nregistered. If no touchStarted() function is defined, the mousePressed()\nfunction will be called instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",itemtype:"method",name:"touchStarted",example:['\n\n\n// Touch within the image to change\n// the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchStarted() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchStarted() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"50x50 black rect turns white with touch event.\nno image displayed",class:"p5",module:"Events",submodule:"Touch"},{file:"src/events/touch.js",line:116,description:"The touchMoved() function is called every time a touch move is registered.\nIf no touchMoved() function is defined, the mouseDragged() function will\nbe called instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",itemtype:"method",name:"touchMoved",example:['\n\n\n// Move your finger across the page\n// to change its value\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchMoved() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchMoved() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"50x50 black rect turns lighter with touch until white. resets\nno image displayed",class:"p5",module:"Events",submodule:"Touch"},{file:"src/events/touch.js",line:178,description:"The touchEnded() function is called every time a touch ends. If no\ntouchEnded() function is defined, the mouseReleased() function will be\ncalled instead if it is defined.
\nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.
\n",itemtype:"method",name:"touchEnded",example:['\n\n\n// Release touch within the image to\n// change the value of the rectangle\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchEnded() {\n if (value == 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n\n\n\n\nfunction touchEnded() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n'],alt:"50x50 black rect turns white with touch.\nno image displayed",class:"p5",module:"Events",submodule:"Touch"},{file:"src/image/filters.js",line:3,description:'This module defines the filters for use with image buffers.
\nThis module is basically a collection of functions stored in an object\nas opposed to modules. The functions are destructive, modifying\nthe passed in canvas rather than creating a copy.
\nGenerally speaking users of this module will use the Filters.apply method\non a canvas to create an effect.
\nA number of functions are borrowed/adapted from\nhttp://www.html5rocks.com/en/tutorials/canvas/imagefilters/\nor the java processing implementation.
\n',class:"p5",module:"Events"},{file:"src/image/filters.js",line:28,description:"Returns the pixel buffer for a canvas
\n",access:"private",tagname:"",params:[{name:"canvas",description:"the canvas to get pixels from
\n",type:"Canvas|ImageData"}],return:{description:"a one-dimensional array containing\n the data in thc RGBA order, with integer\n values between 0 and 255",type:"Uint8ClampedArray"},class:"p5",module:"Events"},{file:"src/image/filters.js",line:51,description:"Returns a 32 bit number containing ARGB data at ith pixel in the\n1D array containing pixels data.
\n",access:"private",tagname:"",params:[{name:"data",description:"array returned by _toPixels()
\n",type:"Uint8ClampedArray"},{name:"i",description:"index of a 1D Image Array
\n",type:"Integer"}],return:{description:"32 bit integer value representing\n ARGB value.",type:"Integer"},class:"p5",module:"Events"},{file:"src/image/filters.js",line:70,description:"Modifies pixels RGBA values to values contained in the data object.
\n",access:"private",tagname:"",params:[{name:"pixels",description:"array returned by _toPixels()
\n",type:"Uint8ClampedArray"},{name:"data",description:"source 1D array where each value\n represents ARGB values
\n",type:"Int32Array"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:90,description:'Returns the ImageData object for a canvas\nhttps://developer.mozilla.org/en-US/docs/Web/API/ImageData
\n',access:"private",tagname:"",params:[{name:"canvas",description:"canvas to get image data from
\n",type:"Canvas|ImageData"}],return:{description:"Holder of pixel data (and width and\n height) for a canvas",type:"ImageData"},class:"p5",module:"Events"},{file:"src/image/filters.js",line:113,description:"Returns a blank ImageData object.
\n",access:"private",tagname:"",params:[{name:"width",description:"",type:"Integer"},{name:"height",description:"",type:"Integer"}],return:{description:"",type:"ImageData"},class:"p5",module:"Events"},{file:"src/image/filters.js",line:129,description:"Applys a filter function to a canvas.
\nThe difference between this and the actual filter functions defined below\nis that the filter functions generally modify the pixel buffer but do\nnot actually put that data back to the canvas (where it would actually\nupdate what is visible). By contrast this method does make the changes\nactually visible in the canvas.
\nThe apply method is the method that callers of this module would generally\nuse. It has been separated from the actual filters to support an advanced\nuse case of creating a filter chain that executes without actually updating\nthe canvas in between everystep.
\n",params:[{name:"canvas",description:"[description]
\n",type:"HTMLCanvasElement"},{name:"func",description:"[description]
\n",type:"Function(ImageData,Object)"},{name:"filterParam",description:"[description]
\n",type:"Object"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:167,description:'Converts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.
\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/
\n',params:[{name:"canvas",description:"",type:"Canvas"},{name:"level",description:"",type:"Float"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:202,description:'Converts any colors in the image to grayscale equivalents.\nNo parameter is used.
\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/
\n',params:[{name:"canvas",description:"",type:"Canvas"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:224,description:"Sets the alpha channel to entirely opaque. No parameter is used.
\n",params:[{name:"canvas",description:"",type:"Canvas"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:239,description:"Sets each pixel to its inverse value. No parameter is used.
\n",params:[{name:"canvas",description:"",type:"Canvas"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:255,description:"Limits each channel of the image to the number of colors specified as\nthe parameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.
\nAdapted from java based processing implementation
\n",params:[{name:"canvas",description:"",type:"Canvas"},{name:"level",description:"",type:"Integer"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:286,description:"reduces the bright areas in an image
\n",params:[{name:"canvas",description:"",type:"Canvas"}],class:"p5",module:"Events"},{file:"src/image/filters.js",line:367,description:"increases the bright areas in an image
\n",params:[{name:"canvas",description:"",type:"Canvas"}],class:"p5",module:"Events"},{file:"src/image/image.js",line:8,description:"This module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.
\n",class:"p5",module:"Image",submodule:"Image"},{file:"src/image/image.js",line:24,description:"Creates a new p5.Image (the datatype for storing images). This provides a\nfresh buffer of pixels to play with. Set the size of the buffer with the\nwidth and height parameters.\n
\n.pixels gives access to an array containing the values for all the pixels\nin the display window.\nThese values are numbers. This array is the size (including an appropriate\nfactor for the pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. See .pixels for\nmore info. It may also be simpler to use set() or get().\n
\nBefore accessing the pixels of an image, the data must loaded with the\nloadPixels() function. After the array data has been modified, the\nupdatePixels() function must be run to update the changes.
\n",itemtype:"method",name:"createImage",params:[{name:"width",description:"width in pixels
\n",type:"Integer"},{name:"height",description:"height in pixels
\n",type:"Integer"}],return:{description:"the p5.Image object",type:"p5.Image"},example:["\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n\n\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, i % img.width * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n\n\n\n\nvar pink = color(255, 102, 204);\nimg = createImage(66, 66);\nimg.loadPixels();\nvar d = pixelDensity();\nvar halfImage = 4 * (width * d) * (height/2 * d);\nfor (var i = 0; i < halfImage; i+=4) {\n img.pixels[i] = red(pink);\n img.pixels[i+1] = green(pink);\n img.pixels[i+2] = blue(pink);\n img.pixels[i+3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n"],alt:"66x66 dark turquoise rect in center of canvas.\n2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas\nno image displayed",class:"p5",module:"Image",submodule:"Image"},{file:"src/image/image.js",line:103,description:"Save the current canvas as an image. In Safari, this will open the\nimage in the window and the user must provide their own\nfilename on save-as. Other browsers will either save the\nfile immediately, or prompt the user with a dialogue window.
\n",itemtype:"method",name:"saveCanvas",class:"p5",module:"Image",submodule:"Image",overloads:[{line:103,params:[{name:"selectedCanvas",description:"a variable\n representing a specific html5 canvas (optional)
\n",type:"p5.Element|HTMLCanvasElement"},{name:"filename",description:"",type:"String",optional:!0},{name:"extension",description:"'jpg' or 'png'
\n",type:"String",optional:!0}]},{line:115,params:[{name:"filename",description:"",type:"String",optional:!0},{name:"extension",description:"",type:"String",optional:!0}]}]},{file:"src/image/image.js",line:233,description:'Capture a sequence of frames that can be used to create a movie.\nAccepts a callback. For example, you may wish to send the frames\nto a server where they can be stored or converted into a movie.\nIf no callback is provided, the browser will pop up save dialogues in an\nattempt to download all of the images that have just been created. With the\ncallback provided the image data isn't saved by default but instead passed\nas an argument to the callback function as an array of objects, with the\nsize of array equal to the total number of frames.
\nNote that saveFrames() will only save the first 15 frames of an animation.\nTo export longer animations, you might look into a library like\nccapture.js.
\n',itemtype:"method",name:"saveFrames",params:[{name:"filename",description:"",type:"String"},{name:"extension",description:"'jpg' or 'png'
\n",type:"String"},{name:"duration",description:"Duration in seconds to save the frames for.
\n",type:"Number"},{name:"framerate",description:"Framerate to save the frames in.
\n",type:"Number"},{name:"callback",description:"A callback function that will be executed\n to handle the image data. This function\n should accept an array as argument. The\n array will contain the specified number of\n frames of objects. Each object has three\n properties: imageData - an\n image/octet-stream, filename and extension.
\n",type:"Function(Array)",optional:!0}],example:['\n\nfunction draw() {\n background(mouseX);\n}\n\nfunction mousePressed() {\n saveFrames("out", "png", 1, 25, function(data){\n print(data);\n });\n}\n'],alt:"canvas background goes from light to dark with mouse x.",class:"p5",module:"Image",submodule:"Image"},{file:"src/image/loading_displaying.js",line:17,description:"Loads an image from a path and creates a p5.Image from it.\n
\nThe image may not be immediately available for rendering\nIf you want to ensure that the image is ready before doing\nanything with it, place the loadImage() call in preload().\nYou may also supply a callback function to handle the image when it's ready.\n
\nThe path to the image should be relative to the HTML file\nthat links in your sketch. Loading an image from a URL or other\nremote location may be blocked due to your browser's built-in\nsecurity.
\n",itemtype:"method",name:"loadImage",params:[{name:"path",description:"Path of the image to be loaded
\n",type:"String"},{name:"successCallback",description:"Function to be called once\n the image is loaded. Will be passed the\n p5.Image.
\n",type:"function(p5.Image)",optional:!0},{name:"failureCallback",description:"called with event error if\n the image fails to load.
\n",type:"Function(Event)",optional:!0}],return:{description:"the p5.Image object",type:"p5.Image"},example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/laDefense.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n}\n\n\n\n\nfunction setup() {\n // here we use a callback to display the image after loading\n loadImage("assets/laDefense.jpg", function(img) {\n image(img, 0, 0);\n });\n}\n\n'],alt:"image of the underside of a white umbrella and grided ceililng above\nimage of the underside of a white umbrella and grided ceililng above",class:"p5",module:"Image",submodule:"Loading & Displaying"},{file:"src/image/loading_displaying.js",line:107,description:"Validates clipping params. Per drawImage spec sWidth and sHight cannot be\nnegative or greater than image intrinsic width and height
\n",access:"private",tagname:"",params:[{name:"sVal",description:"",type:"Number"},{name:"iVal",description:"",type:"Number"}],return:{description:"",type:"Number"},class:"p5",module:"Image",submodule:"Loading & Displaying"},{file:"src/image/loading_displaying.js",line:125,description:'Draw an image to the p5.js canvas.
\nThis function can be used with different numbers of parameters. The\nsimplest use requires only three parameters: img, x, and y—where (x, y) is\nthe position of the image. Two more parameters can optionally be added to\nspecify the width and height of the image.
\nThis function can also be used with all eight Number parameters. To\ndifferentiate between all these parameters, p5.js uses the language of\n"destination rectangle" (which corresponds to "dx", "dy", etc.) and "source\nimage" (which corresponds to "sx", "sy", etc.) below. Specifying the\n"source image" dimensions can be useful when you want to display a\nsubsection of the source image instead of the whole thing. Here's a diagram\nto explain further:\n
\n',itemtype:"method",name:"image",example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/laDefense.jpg");\n}\nfunction setup() {\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img\'s original width and height\n image(img, 0, 0);\n}\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/laDefense.jpg");\n}\nfunction setup() {\n background(50);\n // Top-left corner of the img is at (10, 10)\n // Width and height are 50 x 50\n image(img, 10, 10, 50, 50);\n}\n\n\n\n\nfunction setup() {\n // Here, we use a callback to display the image after loading\n loadImage("assets/laDefense.jpg", function(img) {\n image(img, 0, 0);\n });\n}\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/gradient.png");\n}\nfunction setup() {\n // 1. Background image\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img\'s original width and height, 100 x 100\n image(img, 0, 0);\n // 2. Top right image\n // Top-left corner of destination rectangle is at (50, 0)\n // Destination rectangle width and height are 40 x 20\n // The next parameters are relative to the source image:\n // - Starting at position (50, 50) on the source image, capture a 50 x 50\n // subsection\n // - Draw this subsection to fill the dimensions of the destination rectangle\n image(img, 50, 0, 40, 20, 50, 50, 50, 50);\n}\n\n'],alt:"image of the underside of a white umbrella and gridded ceiling above\nimage of the underside of a white umbrella and gridded ceiling above",class:"p5",module:"Image",submodule:"Loading & Displaying",overloads:[{line:125,params:[{name:"img",description:"the image to display
\n",type:"p5.Image|p5.Graphics"},{name:"x",description:"the x-coordinate of the top-left corner of the image
\n",type:"Number"},{name:"y",description:"the y-coordinate of the top-left corner of the image
\n",type:"Number"},{name:"width",description:"the width to draw the image
\n",type:"Number",optional:!0},{name:"height",description:"the height to draw the image
\n",type:"Number",optional:!0}]},{line:213,params:[{name:"img",description:"",type:"p5.Image|p5.Graphics"},{name:"dx",description:"the x-coordinate of the destination\n rectangle in which to draw the source image
\n",type:"Number"},{name:"dy",description:"the y-coordinate of the destination\n rectangle in which to draw the source image
\n",type:"Number"},{name:"dWidth",description:"the width of the destination rectangle
\n",type:"Number"},{name:"dHeight",description:"the height of the destination rectangle
\n",type:"Number"},{name:"sx",description:"the x-coordinate of the subsection of the source\nimage to draw into the destination rectangle
\n",type:"Number"},{name:"sy",description:"the y-coordinate of the subsection of the source\nimage to draw into the destination rectangle
\n",type:"Number"},{name:"sWidth",description:"the width of the subsection of the\n source image to draw into the destination\n rectangle
\n",type:"Number",optional:!0},{name:"sHeight",description:"the height of the subsection of the\n source image to draw into the destination rectangle
\n",type:"Number",optional:!0}]}]},{file:"src/image/loading_displaying.js",line:289,description:"Sets the fill value for displaying images. Images can be tinted to\nspecified colors or made transparent by including an alpha value.\n
\nTo apply transparency to an image without affecting its color, use\nwhite as the tint color and specify an alpha value. For instance,\ntint(255, 128) will make an image 50% transparent (assuming the default\nalpha range of 0-255, which can be changed with colorMode()).\n
\nThe value for the gray parameter must be less than or equal to the current\nmaximum value as specified by colorMode(). The default maximum value is\n255.
\n",itemtype:"method",name:"tint",class:"p5",module:"Image",submodule:"Loading & Displaying",overloads:[{line:289,params:[{name:"v1",description:"red or hue value relative to\n the current color range
\n",type:"Number"},{name:"v2",description:"green or saturation value\n relative to the current color range
\n",type:"Number"},{name:"v3",description:"blue or brightness value\n relative to the current color range
\n",type:"Number"},{name:"alpha",description:"",type:"Number",optional:!0}]},{line:313,params:[{name:"value",description:"a color string
\n",type:"String"},{name:"alpha",description:"",type:"Number",optional:!0}]},{line:319,params:[{name:"values",description:"an array containing the red,green,blue &\n and alpha components of the color
\n",type:"Number[]"}]},{line:325,params:[{name:"color",description:"the tint color
\n",type:"p5.Color"},{name:"alpha",description:"",type:"Number",optional:!0}]}]},{file:"src/image/loading_displaying.js",line:384,description:"Removes the current fill value for displaying images and reverts to\ndisplaying images with their original hues.
\n",itemtype:"method",name:"noTint",example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n tint(0, 153, 204); // Tint blue\n image(img, 0, 0);\n noTint(); // Disable tint\n image(img, 50, 0);\n}\n\n'],alt:"2 side by side images of bricks, left image with blue tint",class:"p5",module:"Image",submodule:"Loading & Displaying"},{file:"src/image/loading_displaying.js",line:413,description:"Apply the current tint color to the input image, return the resulting\ncanvas.
\n",params:[{name:"The",description:"image to be tinted
\n",type:"p5.Image"}],return:{description:"The resulting tinted canvas",type:"Canvas"},class:"p5",module:"Image",submodule:"Loading & Displaying"},{file:"src/image/loading_displaying.js",line:449,description:"Set image mode. Modifies the location from which images are drawn by\nchanging the way in which parameters given to image() are interpreted.\nThe default mode is imageMode(CORNER), which interprets the second and\nthird parameters of image() as the upper-left corner of the image. If\ntwo additional parameters are specified, they are used to set the image's\nwidth and height.\n
\nimageMode(CORNERS) interprets the second and third parameters of image()\nas the location of one corner, and the fourth and fifth parameters as the\nopposite corner.\n
\nimageMode(CENTER) interprets the second and third parameters of image()\nas the image's center point. If two additional parameters are specified,\nthey are used to set the image's width and height.
\n",itemtype:"method",name:"imageMode",params:[{name:"mode",description:"either CORNER, CORNERS, or CENTER
\n",type:"Constant"}],example:['\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n imageMode(CORNER);\n image(img, 10, 10, 50, 50);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n imageMode(CORNERS);\n image(img, 10, 10, 90, 40);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n imageMode(CENTER);\n image(img, 50, 50, 80, 80);\n}\n\n'],alt:"small square image of bricks\nhorizontal rectangle image of bricks\nlarge square image of bricks",class:"p5",module:"Image",submodule:"Loading & Displaying"},{file:"src/image/p5.Image.js",line:9,description:"This module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.
\n",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:45,description:"Image width.
\n",itemtype:"property",name:"width",type:"Number",readonly:"",example:['\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (var i=0; i < img.width; i++) {\n var c = img.get(i, img.height/2);\n stroke(c);\n line(i, height/2, i, height);\n }\n}\n'],alt:"rocky mountains in top and horizontal lines in corresponding colors in bottom.",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:72,description:"Image height.
\n",itemtype:"property",name:"height",type:"Number",readonly:"",example:['\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (var i=0; i < img.height; i++) {\n var c = img.get(img.width/2, i);\n stroke(c);\n line(0, i, width/2, i);\n }\n}\n'],alt:"rocky mountains on right and vertical lines in corresponding colors on left.",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:106,
-description:'Array containing the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh denisty displays may have more pixels[] (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. With\npixelDensity = 2, there will be 160,000. The first four values\n(indices 0-3) in the array will be the R, G, B, A values of the pixel at\n(0, 0). The second four values (indices 4-7) will contain the R, G, B, A\nvalues of the pixel at (1, 0). More generally, to set values for a pixel\nat (x, y):
\nvar d = pixelDensity;\nfor (var i = 0; i < d; i++) {\n for (var j = 0; j < d; j++) {\n // loop over\n idx = 4 * ((y * d + j) * width * d + (x * d + i));\n pixels[idx] = r;\n pixels[idx+1] = g;\n pixels[idx+2] = b;\n pixels[idx+3] = a;\n }\n}\n
\n
\nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.
\n',itemtype:"property",name:"pixels",type:"Number[]",example:["\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n\n\n\nvar pink = color(255, 102, 204);\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (var i = 0; i < 4*(width*height/2); i+=4) {\n img.pixels[i] = red(pink);\n img.pixels[i+1] = green(pink);\n img.pixels[i+2] = blue(pink);\n img.pixels[i+3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n"],alt:"66x66 turquoise rect in center of canvas\n66x66 pink rect in center of canvas",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:177,description:"Helper fxn for sharing pixel methods
\n",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:186,description:"Loads the pixels data for this image into the [pixels] attribute.
\n",itemtype:"method",name:"loadPixels",example:['\n\nvar myImage;\nvar halfImage;\n\nfunction preload() {\n myImage = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n myImage.loadPixels();\n halfImage = 4 * width * height/2;\n for(var i = 0; i < halfImage; i++){\n myImage.pixels[i+halfImage] = myImage.pixels[i];\n }\n myImage.updatePixels();\n}\n\nfunction draw() {\n image(myImage, 0, 0);\n}\n'],alt:"2 images of rocky mountains vertically stacked",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:222,description:"Updates the backing canvas for this image with the contents of\nthe [pixels] array.
\n",itemtype:"method",name:"updatePixels",class:"p5.Image",module:"Image",submodule:"Image",overloads:[{line:222,params:[{name:"x",description:"x-offset of the target update area for the\n underlying canvas
\n",type:"Integer"},{name:"y",description:"y-offset of the target update area for the\n underlying canvas
\n",type:"Integer"},{name:"w",description:"height of the target update area for the\n underlying canvas
\n",type:"Integer"},{name:"h",description:"height of the target update area for the\n underlying canvas
\n",type:"Integer"}]},{line:236,params:[]}]},{file:"src/image/p5.Image.js",line:270,description:"Get a region of pixels from an image.
\nIf no params are passed, those whole image is returned,\nif x and y are the only params passed a single pixel is extracted\nif all params are passed a rectangle region is extracted and a p5.Image\nis returned.
\nReturns undefined if the region is outside the bounds of the image
\n",itemtype:"method",name:"get",params:[{name:"x",description:"x-coordinate of the pixel
\n",type:"Number",optional:!0},{name:"y",description:"y-coordinate of the pixel
\n",type:"Number",optional:!0},{name:"w",description:"width
\n",type:"Number",optional:!0},{name:"h",description:"height
\n",type:"Number",optional:!0}],return:{description:"color of pixel at x,y in array format\n [R, G, B, A] or p5.Image",type:"Number[]|Color|p5.Image"},example:['\n\nvar myImage;\nvar c;\n\nfunction preload() {\n myImage = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n background(myImage);\n noStroke();\n c = myImage.get(60, 90);\n fill(c);\n rect(25, 25, 50, 50);\n}\n\n//get() returns color here\n'],alt:"image of rocky mountains with 50x50 green rect in front",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:315,description:"Set the color of a single pixel or write an image into\nthis p5.Image.
\nNote that for a large number of pixels this will\nbe slower than directly manipulating the pixels array\nand then calling updatePixels().
\n",itemtype:"method",name:"set",params:[{name:"x",description:"x-coordinate of the pixel
\n",type:"Number"},{name:"y",description:"y-coordinate of the pixel
\n",type:"Number"},{name:"a",description:"grayscale value | pixel array |\n a p5.Color | image to copy
\n",type:"Number|Array|Object"}],example:["\n\n\nimg = createImage(66, 66);\nimg.loadPixels();\nfor (i = 0; i < img.width; i++) {\n for (j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, i % img.width * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n"],alt:"2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:353,description:"Resize the image to a new width and height. To make the image scale\nproportionally, use 0 as the value for the wide or high parameter.\nFor instance, to make the width of an image 150 pixels, and change\nthe height using the same proportion, use resize(150, 0).
\n",itemtype:"method",name:"resize",params:[{name:"width",description:"the resized image width
\n",type:"Number"},{name:"height",description:"the resized image height
\n",type:"Number"}],example:['\n\nvar img;\n\nfunction setup() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction draw() {\n image(img, 0, 0);\n}\n\nfunction mousePressed() {\n img.resize(50, 100);\n}\n'],alt:"image of rocky mountains. zoomed in",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:435,description:"Copies a region of pixels from one image to another. If no\nsrcImage is specified this is used as the source. If the source\nand destination regions aren't the same size, it will\nautomatically resize source pixels to fit the specified\ntarget region.
\n",itemtype:"method",name:"copy",params:[{name:"srcImage",description:"source image
\n",type:"p5.Image|p5.Graphics|undefined"},{name:"sx",description:"X coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sy",description:"Y coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sw",description:"source image width
\n",type:"Integer"},{name:"sh",description:"source image height
\n",type:"Integer"},{name:"dx",description:"X coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dy",description:"Y coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dw",description:"destination image width
\n",type:"Integer"},{name:"dh",description:"destination image height
\n",type:"Integer"}],example:['\n\nvar photo;\nvar bricks;\nvar x;\nvar y;\n\nfunction preload() {\n photo = loadImage("assets/rockies.jpg");\n bricks = loadImage("assets/bricks.jpg");\n}\n\nfunction setup() {\n x = bricks.width/2;\n y = bricks.height/2;\n photo.copy(bricks, 0, 0, x, y, 0, 0, x, y);\n image(photo, 0, 0);\n}\n'],alt:"image of rocky mountains and smaller image on top of bricks at top left",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:480,description:"Masks part of an image from displaying by loading another\nimage and using it's alpha channel as an alpha channel for\nthis image.
\n",itemtype:"method",name:"mask",params:[{name:"srcImage",description:"source image
\n",type:"p5.Image"}],example:['\n\nvar photo, maskImage;\nfunction preload() {\n photo = loadImage("assets/rockies.jpg");\n maskImage = loadImage("assets/mask2.png");\n}\n\nfunction setup() {\n createCanvas(100, 100);\n photo.mask(maskImage);\n image(photo, 0, 0);\n}\n'],alt:"image of rocky mountains with white at right\n\n\nhttp://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:543,description:"Applies an image filter to a p5.Image
\n",itemtype:"method",name:"filter",params:[{name:"operation",description:"one of threshold, gray, invert, posterize, opaque\n erode, dilate and blur. See Filters.js for docs on\n each available filter
\n",type:"String"},{name:"value",description:"",type:"Number|undefined"}],example:['\n\nvar photo1;\nvar photo2;\n\nfunction preload() {\n photo1 = loadImage("assets/rockies.jpg");\n photo2 = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n photo2.filter("gray");\n image(photo1, 0, 0);\n image(photo2, width/2, 0);\n}\n'],alt:"2 images of rocky mountains left one in color, right in black and white",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:577,description:"Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.
\n",itemtype:"method",name:"blend",params:[{name:"srcImage",description:"source image
\n",type:"p5.Image|undefined"},{name:"sx",description:"X coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sy",description:"Y coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sw",description:"source image width
\n",type:"Integer"},{name:"sh",description:"source image height
\n",type:"Integer"},{name:"dx",description:"X coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dy",description:"Y coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dw",description:"destination image width
\n",type:"Integer"},{name:"dh",description:"destination image height
\n",type:"Integer"},{name:"blendMode",description:'the blend mode
\nAvailable blend modes are: normal | multiply | screen | overlay |\n darken | lighten | color-dodge | color-burn | hard-light |\n soft-light | difference | exclusion | hue | saturation |\n color | luminosity
\nhttp://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/
\n',type:"Integer"}],example:['\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage("assets/rockies.jpg");\n bricks = loadImage("assets/bricks_third.jpg");\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage("assets/rockies.jpg");\n bricks = loadImage("assets/bricks_third.jpg");\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n\n\nvar mountains;\nvar bricks;\n\nfunction preload() {\n mountains = loadImage("assets/rockies.jpg");\n bricks = loadImage("assets/bricks_third.jpg");\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n'],alt:"image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:658,description:"helper method for web GL mode to indicate that an image has been\nchanged or unchanged since last upload. gl texture upload will\nset this value to false after uploading the texture.
\n",itemtype:"method",name:"setModified",params:[{name:"val",description:"sets whether or not the image has been\nmodified.
\n",type:"Boolean"}],access:"private",tagname:"",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:671,description:"helper method for web GL mode to figure out if the image\nhas been modified and might need to be re-uploaded to texture\nmemory between frames.
\n",itemtype:"method",name:"isModified",access:"private",tagname:"",return:{description:"a boolean indicating whether or not the\nimage has been updated or modified since last texture upload.",type:"Boolean"},class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/p5.Image.js",line:684,description:"Saves the image to a file and force the browser to download it.\nAccepts two strings for filename and file extension\nSupports png (default) and jpg.
\n",itemtype:"method",name:"save",params:[{name:"filename",description:"give your file a name
\n",type:"String"},{name:"extension",description:"'png' or 'jpg'
\n",type:"String"}],example:['\n\nvar photo;\n\nfunction preload() {\n photo = loadImage("assets/rockies.jpg");\n}\n\nfunction draw() {\n image(photo, 0, 0);\n}\n\nfunction keyTyped() {\n if (key == \'s\') {\n photo.save("photo", "png");\n }\n}\n'],alt:"image of rocky mountains.",class:"p5.Image",module:"Image",submodule:"Image"},{file:"src/image/pixels.js",line:14,description:"Uint8ClampedArray\ncontaining the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh density displays will have more pixels[] (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. On a\nretina display, there will be 160,000.\n
\nThe first four values (indices 0-3) in the array will be the R, G, B, A\nvalues of the pixel at (0, 0). The second four values (indices 4-7) will\ncontain the R, G, B, A values of the pixel at (1, 0). More generally, to\nset values for a pixel at (x, y):
\nvar d = pixelDensity();\nfor (var i = 0; i < d; i++) {\n for (var j = 0; j < d; j++) {\n // loop over\n idx = 4 * ((y * d + j) * width * d + (x * d + i));\n pixels[idx] = r;\n pixels[idx+1] = g;\n pixels[idx+2] = b;\n pixels[idx+3] = a;\n }\n}\n
\nWhile the above method is complex, it is flexible enough to work with\nany pixelDensity. Note that set() will automatically take care of\nsetting all the appropriate values in pixels[] for a given (x, y) at\nany pixelDensity, but the performance may not be as fast when lots of\nmodifications are made to the pixel array.\n
\nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.\n
\nNote that this is not a standard javascript array. This means that\nstandard javascript functions such as slice() or\narrayCopy() do not\nwork.
",itemtype:"property",name:"pixels",type:"Number[]",example:["\n\n\nvar pink = color(255, 102, 204);\nloadPixels();\nvar d = pixelDensity();\nvar halfImage = 4 * (width * d) * (height/2 * d);\nfor (var i = 0; i < halfImage; i+=4) {\n pixels[i] = red(pink);\n pixels[i+1] = green(pink);\n pixels[i+2] = blue(pink);\n pixels[i+3] = alpha(pink);\n}\nupdatePixels();\n\n"],alt:"top half of canvas pink, bottom grey",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:83,description:"Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.
\nAvailable blend modes are: BLEND | DARKEST | LIGHTEST | DIFFERENCE |\nMULTIPLY| EXCLUSION | SCREEN | REPLACE | OVERLAY | HARD_LIGHT |\nSOFT_LIGHT | DODGE | BURN | ADD | NORMAL
\n",itemtype:"method",name:"blend",params:[{name:"srcImage",description:"source image
\n",type:"p5.Image|undefined"},{name:"sx",description:"X coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sy",description:"Y coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sw",description:"source image width
\n",type:"Integer"},{name:"sh",description:"source image height
\n",type:"Integer"},{name:"dx",description:"X coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dy",description:"Y coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dw",description:"destination image width
\n",type:"Integer"},{name:"dh",description:"destination image height
\n",type:"Integer"},{name:"blendMode",description:"the blend mode
\n",type:"Integer"}],example:['\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage("assets/rockies.jpg");\n img1 = loadImage("assets/bricks_third.jpg");\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n}\n\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage("assets/rockies.jpg");\n img1 = loadImage("assets/bricks_third.jpg");\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n}\n\n\nvar img0;\nvar img1;\n\nfunction preload() {\n img0 = loadImage("assets/rockies.jpg");\n img1 = loadImage("assets/bricks_third.jpg");\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n}\n'],alt:"image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:165,description:"Copies a region of the canvas to another region of the canvas\nand copies a region of pixels from an image used as the srcImg parameter\ninto the canvas srcImage is specified this is used as the source. If\nthe source and destination regions aren't the same size, it will\nautomatically resize source pixels to fit the specified\ntarget region.
\n",itemtype:"method",name:"copy",params:[{name:"srcImage",description:"source image
\n",type:"p5.Image|undefined"},{name:"sx",description:"X coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sy",description:"Y coordinate of the source's upper left corner
\n",type:"Integer"},{name:"sw",description:"source image width
\n",type:"Integer"},{name:"sh",description:"source image height
\n",type:"Integer"},{name:"dx",description:"X coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dy",description:"Y coordinate of the destination's upper left corner
\n",type:"Integer"},{name:"dw",description:"destination image width
\n",type:"Integer"},{name:"dh",description:"destination image height
\n",type:"Integer"}],example:['\n\nvar img;\n\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n background(img);\n copy(img, 7, 22, 10, 10, 35, 25, 50, 50);\n stroke(255);\n noFill();\n // Rectangle shows area being copied\n rect(7, 22, 10, 10);\n}\n'],alt:"image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:212,description:"Applies a filter to the canvas.\n
\nThe presets options are:\n
\nTHRESHOLD\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n
\nGRAY\nConverts any colors in the image to grayscale equivalents. No parameter\nis used.\n
\nOPAQUE\nSets the alpha channel to entirely opaque. No parameter is used.\n
\nINVERT\nSets each pixel to its inverse value. No parameter is used.\n
\nPOSTERIZE\nLimits each channel of the image to the number of colors specified as the\nparameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n
\nBLUR\nExecutes a Guassian blur with the level parameter specifying the extent\nof the blurring. If no parameter is used, the blur is equivalent to\nGuassian blur of radius 1. Larger values increase the blur.\n
\nERODE\nReduces the light areas. No parameter is used.\n
\nDILATE\nIncreases the light areas. No parameter is used.
\n",itemtype:"method",name:"filter",params:[{name:"filterType",description:"either THRESHOLD, GRAY, OPAQUE, INVERT,\n POSTERIZE, BLUR, ERODE or DILATE
\n",type:"Constant"},{name:"filterParam",description:"an optional parameter unique\n to each filter, see above
\n",type:"Number"}],example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(THRESHOLD);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(GRAY);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(OPAQUE);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(INVERT);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(POSTERIZE,3);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(DILATE);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(BLUR,3);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/bricks.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n filter(ERODE);\n}\n\n'],alt:"black and white image of a brick wall.\ngreyscale image of a brickwall\nimage of a brickwall\njade colored image of a brickwall\nred and pink image of a brickwall\nimage of a brickwall\nblurry image of a brickwall\nimage of a brickwall\nimage of a brickwall with less detail",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:390,description:"Returns an array of [R,G,B,A] values for any pixel or grabs a section of\nan image. If no parameters are specified, the entire image is returned.\nUse the x and y parameters to get the value of one pixel. Get a section of\nthe display window by specifying additional w and h parameters. When\ngetting an image, the x and y parameters define the coordinates for the\nupper-left corner of the image, regardless of the current imageMode().\n
\nIf the pixel requested is outside of the image window, [0,0,0,255] is\nreturned. To get the numbers scaled according to the current color ranges\nand taking into account colorMode, use getColor instead of get.\n
\nGetting the color of a single pixel with get(x, y) is easy, but not as fast\nas grabbing the data directly from pixels[]. The equivalent statement to\nget(x, y) using pixels[] with pixel density d is\n\nvar off = (y width + x) d * 4;\n[pixels[off],\npixels[off+1],\npixels[off+2],\npixels[off+3]]\n
\nSee the reference for pixels[] for more information.
\n",itemtype:"method",name:"get",params:[{name:"x",description:"x-coordinate of the pixel
\n",type:"Number",optional:!0},{name:"y",description:"y-coordinate of the pixel
\n",type:"Number",optional:!0},{name:"w",description:"width
\n",type:"Number",optional:!0},{name:"h",description:"height
\n",type:"Number",optional:!0}],return:{description:"values of pixel at x,y in array format\n [R, G, B, A] or p5.Image",type:"Number[]|p5.Image"},example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n var c = get();\n image(c, width/2, 0);\n}\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\nfunction setup() {\n image(img, 0, 0);\n var c = get(50, 90);\n fill(c);\n noStroke();\n rect(25, 25, 50, 50);\n}\n\n'],alt:"2 images of the rocky mountains, side-by-side\nImage of the rocky mountains with 50x50 green rect in center of canvas",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:461,description:"Loads the pixel data for the display window into the pixels[] array. This\nfunction must always be called before reading from or writing to pixels[].\nNote that only changes made with set() or direct manipulation of pixels[]\nwill occur.
\n",itemtype:"method",name:"loadPixels",example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n image(img, 0, 0);\n var d = pixelDensity();\n var halfImage = 4 * (img.width * d) *\n (img.height/2 * d);\n loadPixels();\n for (var i = 0; i < halfImage; i++) {\n pixels[i+halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n'],alt:"two images of the rocky mountains. one on top, one on bottom of canvas.",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:498,description:"Changes the color of any pixel, or writes an image directly to the\ndisplay window.
\nThe x and y parameters specify the pixel to change and the c parameter\nspecifies the color value. This can be a p5.Color object, or [R, G, B, A]\npixel array. It can also be a single grayscale value.\nWhen setting an image, the x and y parameters define the coordinates for\nthe upper-left corner of the image, regardless of the current imageMode().\n
\n\nAfter using set(), you must call updatePixels() for your changes to appear.\nThis should be called once all pixels have been set, and must be called before\ncalling .get() or drawing the image.\n
\nSetting the color of a single pixel with set(x, y) is easy, but not as\nfast as putting the data directly into pixels[]. Setting the pixels[]\nvalues directly may be complicated when working with a retina display,\nbut will perform better when lots of pixels need to be set directly on\nevery loop.
\nSee the reference for pixels[] for more information.
",itemtype:"method",name:"set",params:[{name:"x",description:"x-coordinate of the pixel
\n",type:"Number"},{name:"y",description:"y-coordinate of the pixel
\n",type:"Number"},{name:"c",description:"insert a grayscale value | a pixel array |\n a p5.Color object | a p5.Image to copy
\n",type:"Number|Array|Object"}],example:['\n\n\nvar black = color(0);\nset(30, 20, black);\nset(85, 20, black);\nset(85, 75, black);\nset(30, 75, black);\nupdatePixels();\n\n\n\n\n\nfor (var i = 30; i < width-15; i++) {\n for (var j = 20; j < height-25; j++) {\n var c = color(204-j, 153-i, 0);\n set(i, j, c);\n }\n}\nupdatePixels();\n\n\n\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n set(0, 0, img);\n updatePixels();\n line(0, 0, width, height);\n line(0, height, width, 0);\n}\n\n'],alt:"4 black points in the shape of a square middle-right of canvas.\nsquare with orangey-brown gradient lightening at bottom right.\nimage of the rocky mountains. with lines like an 'x' through the center.",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/image/pixels.js",line:572,description:"Updates the display window with the data in the pixels[] array.\nUse in conjunction with loadPixels(). If you're only reading pixels from\nthe array, there's no need to call updatePixels() — updating is only\nnecessary to apply changes. updatePixels() should be called anytime the\npixels array is manipulated or set() is called, and only changes made with\nset() or direct changes to pixels[] will occur.
\n",itemtype:"method",name:"updatePixels",params:[{name:"x",description:"x-coordinate of the upper-left corner of region\n to update
\n",type:"Number",optional:!0},{name:"y",description:"y-coordinate of the upper-left corner of region\n to update
\n",type:"Number",optional:!0},{name:"w",description:"width of region to update
\n",type:"Number",optional:!0},{name:"h",description:"height of region to update
\n",type:"Number",optional:!0}],example:['\n\n\nvar img;\nfunction preload() {\n img = loadImage("assets/rockies.jpg");\n}\n\nfunction setup() {\n image(img, 0, 0);\n var halfImage = 4 * (img.width * pixelDensity()) *\n (img.height * pixelDensity()/2);\n loadPixels();\n for (var i = 0; i < halfImage; i++) {\n pixels[i+halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n'],alt:"two images of the rocky mountains. one on top, one on bottom of canvas.",class:"p5",module:"Image",submodule:"Pixels"},{file:"src/io/files.js",line:19,
-description:'Loads a JSON file from a file or a URL, and returns an Object.\nNote that even if the JSON file contains an Array, an Object will be\nreturned with index numbers as keys.
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. JSONP is supported via a polyfill and you\ncan pass in as the second argument an object with definitions of the json\ncallback following the syntax specified here.
\n',itemtype:"method",name:"loadJSON",params:[{name:"path",description:"name of the file or url to load
\n",type:"String"},{name:"jsonpOptions",description:"options object for jsonp related settings
\n",type:"Object",optional:!0},{name:"datatype",description:""json" or "jsonp"
\n",type:"String",optional:!0},{name:"callback",description:"function to be executed after\n loadJSON() completes, data is passed\n in as first argument
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}],return:{description:"JSON data",type:"Object|Array"},example:["\n\nCalling loadJSON() inside preload() guarantees to complete the\noperation before setup() and draw() are called.
\n\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\nvar earthquakes;\nfunction preload() {\n // Get the most recent earthquake in the database\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n earthquakes = loadJSON(url);\n}\n\nfunction setup() {\n noLoop();\n}\n\nfunction draw() {\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:
\n\nfunction setup() {\n noLoop();\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n loadJSON(url, drawEarthquake);\n}\n\nfunction draw() {\n background(200);\n}\n\nfunction drawEarthquake(earthquakes) {\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n"],alt:"50x50 ellipse that changes from black to white depending on the current humidity\n50x50 ellipse that changes from black to white depending on the current humidity",class:"p5",module:"IO",submodule:"Input"},{file:"src/io/files.js",line:145,description:"Reads the contents of a file and creates a String array of its individual\nlines. If the name of the file is used as the parameter, as in the above\nexample, the file must be located in the sketch directory/folder.\n
\nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.\n
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed.
\n",itemtype:"method",name:"loadStrings",params:[{name:"filename",description:"name of the file or url to load
\n",type:"String"},{name:"callback",description:"function to be executed after loadStrings()\n completes, Array is passed in as first\n argument
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}],return:{description:"Array of Strings",type:"String[]"},example:["\n\nCalling loadStrings() inside preload() guarantees to complete the\noperation before setup() and draw() are called.
\n\n\nvar result;\nfunction preload() {\n result = loadStrings('assets/test.txt');\n}\n\nfunction setup() {\n background(200);\n var ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:
\n\n\nfunction setup() {\n loadStrings('assets/test.txt', pickString);\n}\n\nfunction pickString(result) {\n background(200);\n var ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n"],alt:'randomly generated text from a file, for example "i smell like butter"\nrandomly generated text from a file, for example "i have three feet"',class:"p5",module:"IO",submodule:"Input"},{file:"src/io/files.js",line:237,description:"Reads the contents of a file or URL and creates a p5.Table object with\nits values. If a file is specified, it must be located in the sketch's\n"data" folder. The filename parameter can also be a URL to a file found\nonline. By default, the file is assumed to be comma-separated (in CSV\nformat). Table only looks for a header row if the 'header' option is\nincluded.
\n\nPossible options include:\n
\n- csv - parse the table as comma-separated values
\n- tsv - parse the table as tab-separated values
\n- header - this table has a header (title) row
\n
\n\n\nWhen passing in multiple options, pass them in as separate parameters,\nseperated by commas. For example:\n
\n\n loadTable("my_csv_file.csv", "csv", "header")\n\n
\n\n All files loaded and saved use UTF-8 encoding.
\n\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadTable() inside preload()\nguarantees to complete the operation before setup() and draw() are called.\n
Outside of preload(), you may supply a callback function to handle the\nobject:
\n",itemtype:"method",name:"loadTable",params:[{name:"filename",description:"name of the file or URL to load
\n",type:"String"},{name:"options",description:""header" "csv" "tsv"
\n",type:"String",optional:!0},{name:"callback",description:"function to be executed after\n loadTable() completes. On success, the\n Table object is passed in as the\n first argument.
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}],return:{description:"Table object containing data",type:"Object"},example:['\n\n\n// Given the following CSV file called "mammals.csv"\n// located in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n //the file can be remote\n //table = loadTable("http://p5js.org/reference/assets/mammals.csv",\n // "csv", "header");\n}\n\nfunction setup() {\n //count the columns\n print(table.getRowCount() + " total rows in table");\n print(table.getColumnCount() + " total columns in table");\n\n print(table.getColumn("name"));\n //["Goat", "Leopard", "Zebra"]\n\n //cycle through the table\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++) {\n print(table.getString(r, c));\n }\n}\n\n'],alt:'randomly generated text from a file, for example "i smell like butter"\nrandomly generated text from a file, for example "i have three feet"',class:"p5",module:"IO",submodule:"Input"},{file:"src/io/files.js",line:558,description:"Reads the contents of a file and creates an XML object with its values.\nIf the name of the file is used as the parameter, as in the above example,\nthe file must be located in the sketch directory/folder.
\nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.
\nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadXML() inside preload()\nguarantees to complete the operation before setup() and draw() are called.
\nOutside of preload(), you may supply a callback function to handle the\nobject.
\n",itemtype:"method",name:"loadXML",params:[{name:"filename",description:"name of the file or URL to load
\n",type:"String"},{name:"callback",description:"function to be executed after loadXML()\n completes, XML object is passed in as\n first argument
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}],return:{description:"XML object containing data",type:"Object"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var children = xml.getChildren("animal");\n\n for (var i = 0; i < children.length; i++) {\n var id = children[i].getNum("id");\n var coloring = children[i].getString("species");\n var name = children[i].getContent();\n print(id + ", " + coloring + ", " + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n'],alt:"no image displayed",class:"p5",module:"IO",submodule:"Input"},{file:"src/io/files.js",line:654,description:"Method for executing an HTTP GET request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'GET').
\n",itemtype:"method",name:"httpGet",params:[{name:"path",description:"name of the file or url to load
\n",type:"String"},{name:"datatype",description:""json", "jsonp", "xml", or "text"
\n",type:"String",optional:!0},{name:"data",description:"param data passed sent with request
\n",type:"Object",optional:!0},{name:"callback",description:"function to be executed after\n httpGet() completes, data is passed in\n as first argument
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}],example:["\n\n // Examples use USGS Earthquake API:\n // https://earthquake.usgs.gov/fdsnws/event/1/#methods\n var earthquakes;\n function preload() {\n // Get the most recent earthquake in the database\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n httpGet(url, \"jsonp\", false, function(response) {\n // when the HTTP request completes, populate the variable that holds the\n // earthquake data used in the visualization.\n earthquakes = response;\n });\n }\n\n function draw() {\n if (!earthquakes) {\n // Wait until the earthquake data has loaded before drawing.\n return\n }\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n var earthquakeMag = earthquakes.features[0].properties.mag;\n var earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width/2, height/2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n noLoop();\n }\n"],class:"p5",module:"IO",submodule:"Input"},{file:"src/io/files.js",line:707,description:"Method for executing an HTTP POST request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'POST').
\n",itemtype:"method",name:"httpPost",params:[{name:"path",description:"name of the file or url to load
\n",type:"String"},{name:"datatype",description:""json", "jsonp", "xml", or "text".\n If omitted, httpPost() will guess.
\n",type:"String",optional:!0},{name:"data",description:"param data passed sent with request
\n",type:"Object",optional:!0},{name:"callback",description:"function to be executed after\n httpPost() completes, data is passed in\n as first argument
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}],example:["\n\n\n// Examples use jsonplaceholder.typicode.com for a Mock Data API\n\nvar url = 'https://jsonplaceholder.typicode.com/posts';\nvar postData = { userId: 1, title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\nfunction setup() {\n createCanvas(800, 800);\n}\n\nfunction mousePressed() {\n // Pick new random color values\n var r = random(255);\n var g = random(255);\n var b = random(255);\n\n httpPost(url, 'json',\n postData,\n function (result) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n ellipse(mouseX, mouseY, 200, 200);\n text(result.body, mouseX, mouseY);\n });\n}\n\n\n\n\n\n\n var url = 'https://invalidURL'; // A bad URL that will cause errors\n var postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\n function setup() {\n createCanvas(800, 800);\n }\n\n function mousePressed() {\n // Pick new random color values\n var r = random(255);\n var g = random(255);\n var b = random(255);\n\n httpPost(url, 'json',\n postData,\n function (result) {\n // ... won't be called\n },\n function (error) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n text(error.toString(), mouseX, mouseY);\n });\n }\n\n\n\n"],class:"p5",module:"IO",submodule:"Input"},{file:"src/io/files.js",line:794,description:"Method for executing an HTTP request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text.
\nFor more advanced use, you may also pass in the path as the first argument\nand a object as the second argument, the signature follows the one specified\nin the Fetch API specification.
\n",itemtype:"method",name:"httpDo",example:["\n\n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\n\n// displays an animation of all USGS earthquakes\nvar earthquakes;\nvar eqFeatureIndex = 0;\n\nfunction preload() {\n var url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';\n httpDo(url,\n {\n method: 'GET',\n // Other Request options, like special headers for apis\n headers: { authorization: 'Bearer secretKey' }\n },\n function(res) {\n earthquakes = res;\n });\n}\n\nfunction draw() {\n // wait until the data is loaded\n if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {\n return;\n }\n clear();\n\n var feature = earthquakes.features[eqFeatureIndex];\n var mag = feature.properties.mag;\n var rad = mag / 11 * ((width + height) / 2);\n fill(255, 0, 0, 100);\n ellipse(\n width / 2 + random(-2, 2),\n height / 2 + random(-2, 2),\n rad, rad\n );\n\n if (eqFeatureIndex >= earthquakes.features.length) {\n eqFeatureIndex = 0;\n } else {\n eqFeatureIndex += 1;\n }\n}\n\n"],class:"p5",module:"IO",submodule:"Input",overloads:[{line:794,params:[{name:"path",description:"name of the file or url to load
\n",type:"String"},{name:"method",description:"either "GET", "POST", or "PUT",\n defaults to "GET"
\n",type:"String",optional:!0},{name:"datatype",description:""json", "jsonp", "xml", or "text"
\n",type:"String",optional:!0},{name:"data",description:"param data passed sent with request
\n",type:"Object",optional:!0},{name:"callback",description:"function to be executed after\n httpGet() completes, data is passed in\n as first argument
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to be executed if\n there is an error, response is passed\n in as first argument
\n",type:"Function",optional:!0}]},{line:865,params:[{name:"path",description:"",type:"String"},{name:"options",description:'Request object options as documented in the\n "fetch" API\nreference
\n',type:"Object"},{name:"callback",description:"",type:"Function",optional:!0},{name:"errorCallback",description:"",type:"Function",optional:!0}]}]},{file:"src/io/files.js",line:1077,description:"Save an image, text, json, csv, wav, or html. Prompts download to\nthe client's computer. Note that it is not recommended to call save()\nwithin draw if it's looping, as the save() function will open a new save\ndialog every frame.
\nThe default behavior is to save the canvas as an image. You can\noptionally specify a filename.\nFor example:
\n\nsave();\nsave('myCanvas.jpg'); // save a specific canvas with a filename\n
\n\nAlternately, the first parameter can be a pointer to a canvas\np5.Element, an Array of Strings,\nan Array of JSON, a JSON object, a p5.Table, a p5.Image, or a\np5.SoundFile (requires p5.sound). The second parameter is a filename\n(including extension). The third parameter is for options specific\nto this type of object. This method will save a file that fits the\ngiven paramaters. For example:
\n\n\n\nsave('myCanvas.jpg'); // Saves canvas as an image\n\nvar cnv = createCanvas(100, 100);\nsave(cnv, 'myCanvas.jpg'); // Saves canvas as an image\n\nvar gb = createGraphics(100, 100);\nsave(gb, 'myGraphics.jpg'); // Saves p5.Renderer object as an image\n\nsave(myTable, 'myTable.html'); // Saves table as html file\nsave(myTable, 'myTable.csv',); // Comma Separated Values\nsave(myTable, 'myTable.tsv'); // Tab Separated Values\n\nsave(myJSON, 'my.json'); // Saves pretty JSON\nsave(myJSON, 'my.json', true); // Optimizes JSON filesize\n\nsave(img, 'my.png'); // Saves pImage as a png image\n\nsave(arrayOfStrings, 'my.txt'); // Saves strings to a text file with line\n // breaks after each item in the array\n
",itemtype:"method",name:"save",params:[{name:"objectOrFilename",description:"If filename is provided, will\n save canvas as an image with\n either png or jpg extension\n depending on the filename.\n If object is provided, will\n save depending on the object\n and filename (see examples\n above).
\n",type:"Object|String",optional:!0},{name:"filename",description:"If an object is provided as the first\n parameter, then the second parameter\n indicates the filename,\n and should include an appropriate\n file extension (see examples above).
\n",type:"String",optional:!0},{name:"options",description:"Additional options depend on\n filetype. For example, when saving JSON,\n true indicates that the\n output will be optimized for filesize,\n rather than readability.
\n",type:"Boolean|String",optional:!0}],class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1194,description:"Writes the contents of an Array or a JSON object to a .json file.\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",itemtype:"method",name:"saveJSON",params:[{name:"json",description:"",type:"Array|Object"},{name:"filename",description:"",type:"String"},{name:"optimize",description:"If true, removes line breaks\n and spaces from the output\n file to optimize filesize\n (but not readability).
\n",type:"Boolean",optional:!0}],example:['\n\nvar json;\n\nfunction setup() {\n\n json = {}; // new JSON Object\n\n json.id = 0;\n json.species = \'Panthera leo\';\n json.name = \'Lion\';\n\n// To save, un-comment the line below, then click \'run\'\n// saveJSON(json, \'lion.json\');\n}\n\n// Saves the following to a file called "lion.json":\n// {\n// "id": 0,\n// "species": "Panthera leo",\n// "name": "Lion"\n// }\n'],alt:"no image displayed",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1248,description:"Writes an array of Strings to a text file, one line per String.\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",itemtype:"method",name:"saveStrings",params:[{name:"list",description:"string array to be written
\n",type:"Array"},{name:"filename",description:"filename for output
\n",type:"String"}],example:["\n\nvar words = 'apple bear cat dog';\n\n// .split() outputs an Array\nvar list = split(words, ' ');\n\n// To save the file, un-comment next line and click 'run'\n// saveStrings(list, 'nouns.txt');\n\n// Saves the following to a file called 'nouns.txt':\n//\n// apple\n// bear\n// cat\n// dog\n"],alt:"no image displayed",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1306,description:"Writes the contents of a Table object to a file. Defaults to a\ntext file with comma-separated-values ('csv') but can also\nuse tab separation ('tsv'), or generate an HTML table ('html').\nThe file saving process and location of the saved file will\nvary between web browsers.
\n",itemtype:"method",name:"saveTable",params:[{name:"Table",description:"the Table object to save to a file
\n",type:"p5.Table"},{name:"filename",description:"the filename to which the Table should be saved
\n",type:"String"},{name:"options",description:"can be one of "tsv", "csv", or "html"
\n",type:"String",optional:!0}],example:["\n\nvar table;\n\nfunction setup() {\n table = new p5.Table();\n\n table.addColumn('id');\n table.addColumn('species');\n table.addColumn('name');\n\n var newRow = table.addRow();\n newRow.setNum('id', table.getRowCount() - 1);\n newRow.setString('species', 'Panthera leo');\n newRow.setString('name', 'Lion');\n\n // To save, un-comment next line then click 'run'\n // saveTable(table, 'new.csv');\n }\n\n // Saves the following to a file called 'new.csv':\n // id,species,name\n // 0,Panthera leo,Lion\n"],alt:"no image displayed",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1433,description:"Generate a blob of file data as a url to prepare for download.\nAccepts an array of data, a filename, and an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.
\n",params:[{name:"dataToDownload",description:"",type:"Array"},{name:"filename",description:"",type:"String"},{name:"extension",description:"",type:"[String]"}],access:"private",tagname:"",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1456,description:"Forces download. Accepts a url to filedata/blob, a filename,\nand an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.
\n",params:[{name:"href",description:"i.e. an href generated by createObjectURL
\n",type:"String"},{name:"filename",description:"",type:"[String]"},{name:"extension",description:"",type:"[String]"}],class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1496,description:"Returns a file extension, or another string\nif the provided parameter has no extension.
\n",params:[{name:"filename",description:"",type:"String"}],return:{description:"[fileName, fileExtension]",type:"String[]"},access:"private",tagname:"",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1528,description:"Returns true if the browser is Safari, false if not.\nSafari makes trouble for downloading files.
\n",return:{description:"[description]",type:"Boolean"},access:"private",tagname:"",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/files.js",line:1540,description:"Helper function, a callback for download that deletes\nan invisible anchor element from the DOM once the file\nhas been automatically downloaded.
\n",access:"private",tagname:"",class:"p5",module:"IO",submodule:"Output"},{file:"src/io/p5.Table.js",line:12,description:'Table Options
\nGeneric class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.
\nCSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.
\nFile names should end with .csv if they're comma separated.
\nA rough "spec" for CSV can be found\nhere.
\nTo load files, use the loadTable method.
\nTo save tables to your computer, use the save method\n or the saveTable method.
\n\nPossible options include:
\n\n- csv - parse the table as comma-separated values\n
- tsv - parse the table as tab-separated values\n
- header - this table has a header (title) row\n
',class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:46,itemtype:"property",name:"columns",type:"String[]",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:51,itemtype:"property",name:"rows",type:"p5.TableRow[]",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:58,description:"Use addRow() to add a new row of data to a p5.Table object. By default,\nan empty row is created. Typically, you would store a reference to\nthe new row in a TableRow object (see newRow in the example above),\nand then set individual values using set().
\nIf a p5.TableRow object is included as a parameter, then that row is\nduplicated and added to the table.
\n",itemtype:"method",name:"addRow",params:[{name:"row",description:"row to be added to the table
\n",type:"p5.TableRow",optional:!0}],example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n //add a row\n var newRow = table.addRow();\n newRow.setString("id", table.getRowCount() - 1);\n newRow.setString("species", "Canis Lupus");\n newRow.setString("name", "Wolf");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:121,description:"Removes a row from the table object.
\n",itemtype:"method",name:"removeRow",params:[{name:"id",description:"ID number of the row to remove
\n",type:"Number"}],example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n //remove the first row\n var r = table.removeRow(0);\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:170,description:"Returns a reference to the specified p5.TableRow. The reference\ncan then be used to get and set values of the selected row.
\n",itemtype:"method",name:"getRow",params:[{name:"rowID",description:"ID number of the row to get
\n",type:"Number"}],return:{description:"p5.TableRow object",type:"p5.TableRow"},
-example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n var row = table.getRow(1);\n //print it column by column\n //note: a row is an object, not an array\n for (var c = 0; c < table.getColumnCount(); c++)\n print(row.getString(c));\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:215,description:"Gets all rows from the table. Returns an array of p5.TableRows.
\n",itemtype:"method",name:"getRows",return:{description:"Array of p5.TableRows",type:"p5.TableRow[]"},example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n var rows = table.getRows();\n\n //warning: rows is an array of objects\n for (var r = 0; r < rows.length; r++)\n rows[r].set("name", "Unicorn");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:263,description:"Finds the first row in the Table that contains the value\nprovided, and returns a reference to that row. Even if\nmultiple rows are possible matches, only the first matching\nrow is returned. The column to search may be specified by\neither its ID or title.
\n",itemtype:"method",name:"findRow",params:[{name:"value",description:"The value to match
\n",type:"String"},{name:"column",description:"ID number or title of the\n column to search
\n",type:"Number|String"}],return:{description:"",type:"p5.TableRow"},example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n //find the animal named zebra\n var row = table.findRow("Zebra", "name");\n //find the corresponding species\n print(row.getString("species"));\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:329,description:"Finds the rows in the Table that contain the value\nprovided, and returns references to those rows. Returns an\nArray, so for must be used to iterate through all the rows,\nas shown in the example above. The column to search may be\nspecified by either its ID or title.
\n",itemtype:"method",name:"findRows",params:[{name:"value",description:"The value to match
\n",type:"String"},{name:"column",description:"ID number or title of the\n column to search
\n",type:"Number|String"}],return:{description:"An Array of TableRow objects",type:"p5.TableRow[]"},example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n //add another goat\n var newRow = table.addRow();\n newRow.setString("id", table.getRowCount() - 1);\n newRow.setString("species", "Scape Goat");\n newRow.setString("name", "Goat");\n\n //find the rows containing animals named Goat\n var rows = table.findRows("Goat", "name");\n print(rows.length + " Goats found");\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:399,description:"Finds the first row in the Table that matches the regular\nexpression provided, and returns a reference to that row.\nEven if multiple rows are possible matches, only the first\nmatching row is returned. The column to search may be\nspecified by either its ID or title.
\n",itemtype:"method",name:"matchRow",params:[{name:"regexp",description:"The regular expression to match
\n",type:"String"},{name:"column",description:"The column ID (number) or\n title (string)
\n",type:"String|Number"}],return:{description:"TableRow object",type:"p5.TableRow"},class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:431,description:"Finds the rows in the Table that match the regular expression provided,\nand returns references to those rows. Returns an array, so for must be\nused to iterate through all the rows, as shown in the example. The\ncolumn to search may be specified by either its ID or title.
\n",itemtype:"method",name:"matchRows",params:[{name:"regexp",description:"The regular expression to match
\n",type:"String"},{name:"column",description:"The column ID (number) or\n title (string)
\n",type:"String|Number",optional:!0}],return:{description:"An Array of TableRow objects",type:"p5.TableRow[]"},example:["\nvar table;\n\nfunction setup() {\n\n table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n var newRow = table.addRow();\n newRow.setString('name', 'Lion');\n newRow.setString('type', 'Mammal');\n\n newRow = table.addRow();\n newRow.setString('name', 'Snake');\n newRow.setString('type', 'Reptile');\n\n newRow = table.addRow();\n newRow.setString('name', 'Mosquito');\n newRow.setString('type', 'Insect');\n\n newRow = table.addRow();\n newRow.setString('name', 'Lizard');\n newRow.setString('type', 'Reptile');\n\n var rows = table.matchRows('R.*', 'type');\n for (var i = 0; i < rows.length; i++) {\n print(rows[i].getString('name') + ': ' + rows[i].getString('type'));\n }\n}\n// Sketch prints:\n// Snake: Reptile\n// Lizard: Reptile"],class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:498,description:"Retrieves all values in the specified column, and returns them\nas an array. The column may be specified by either its ID or title.
\n",itemtype:"method",name:"getColumn",params:[{name:"column",description:"String or Number of the column to return
\n",type:"String|Number"}],return:{description:"Array of column values",type:"Array"},example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n //getColumn returns an array that can be printed directly\n print(table.getColumn("species"));\n //outputs ["Capra hircus", "Panthera pardus", "Equus zebra"]\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:551,description:"Removes all rows from a Table. While all rows are removed,\ncolumns and column titles are maintained.
\n",itemtype:"method",name:"clearRows",example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n table.clearRows();\n print(table.getRowCount() + " total rows in table");\n print(table.getColumnCount() + " total columns in table");\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:593,description:"Use addColumn() to add a new column to a Table object.\nTypically, you will want to specify a title, so the column\nmay be easily referenced later by name. (If no title is\nspecified, the new column's title will be null.)
\n",itemtype:"method",name:"addColumn",params:[{name:"title",description:"title of the given column
\n",type:"String",optional:!0}],example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n table.addColumn("carnivore");\n table.set(0, "carnivore", "no");\n table.set(1, "carnivore", "yes");\n table.set(2, "carnivore", "no");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:644,description:"Returns the total number of columns in a Table.
\n",return:{description:"Number of columns in this table",type:"Number"},class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:653,description:"Returns the total number of rows in a Table.
\n",itemtype:"method",name:"getRowCount",return:{description:"Number of rows in this table",type:"Number"},class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:664,description:"Removes any of the specified characters (or "tokens").
\n\nIf no column is specified, then the values in all columns and\nrows are processed. A specific column may be referenced by\neither its ID or title.
",itemtype:"method",name:"removeTokens",params:[{name:"chars",description:"String listing characters to be removed
\n",type:"String"},{name:"column",description:"Column ID (number)\n or name (string)
\n",type:"String|Number",optional:!0}],class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:715,description:"Trims leading and trailing whitespace, such as spaces and tabs,\nfrom String table values. If no column is specified, then the\nvalues in all columns and rows are trimmed. A specific column\nmay be referenced by either its ID or title.
\n",itemtype:"method",name:"trim",params:[{name:"column",description:"Column ID (number)\n or name (string)
\n",type:"String|Number"}],class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:757,description:"Use removeColumn() to remove an existing column from a Table\nobject. The column to be removed may be identified by either\nits title (a String) or its index value (an int).\nremoveColumn(0) would remove the first column, removeColumn(1)\nwould remove the second column, and so on.
\n",itemtype:"method",name:"removeColumn",params:[{name:"column",description:"columnName (string) or ID (number)
\n",type:"String|Number"}],example:['\n \n \n // Given the CSV file "mammals.csv"\n // in the project\'s "assets" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n var table;\n\n function preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n }\n\n function setup() {\n table.removeColumn("id");\n print(table.getColumnCount());\n }\n \n '],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:826,description:"Stores a value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.
\n",itemtype:"method",name:"set",params:[{name:"column",description:"column ID (Number)\n or title (String)
\n",type:"String|Number"},{name:"value",description:"value to assign
\n",type:"String|Number"}],example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n table.set(0, "species", "Canis Lupus");\n table.set(0, "name", "Wolf");\n\n //print the results\n for (var r = 0; r < table.getRowCount(); r++)\n for (var c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:875,description:"Stores a Float value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.
\n",itemtype:"method",name:"setNum",params:[{name:"row",description:"row ID
\n",type:"Number"},{name:"column",description:"column ID (Number)\n or title (String)
\n",type:"String|Number"},{name:"value",description:"value to assign
\n",type:"Number"}],example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n table.setNum(1, "id", 1);\n\n print(table.getColumn(0));\n //["0", 1, "2"]\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:922,description:"Stores a String value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.
\n",itemtype:"method",name:"setString",params:[{name:"row",description:"row ID
\n",type:"Number"},{name:"column",description:"column ID (Number)\n or title (String)
\n",type:"String|Number"},{name:"value",description:"value to assign
\n",type:"String"}],class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:937,description:"Retrieves a value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.
\n",itemtype:"method",name:"get",params:[{name:"row",description:"row ID
\n",type:"Number"},{name:"column",description:"columnName (string) or\n ID (number)
\n",type:"String|Number"}],return:{description:"",type:"String|Number"},example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n print(table.get(0, 1));\n //Capra hircus\n print(table.get(0, "species"));\n //Capra hircus\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:984,description:"Retrieves a Float value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.
\n",itemtype:"method",name:"getNum",params:[{name:"row",description:"row ID
\n",type:"Number"},{name:"column",description:"columnName (string) or\n ID (number)
\n",type:"String|Number"}],return:{description:"",type:"Number"},example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n print(table.getNum(1, 0) + 100);\n //id 1 + 100 = 101\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:1029,description:"Retrieves a String value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.
\n",itemtype:"method",name:"getString",params:[{name:"row",description:"row ID
\n",type:"Number"},{name:"column",description:"columnName (string) or\n ID (number)
\n",type:"String|Number"}],return:{description:"",type:"String"},example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n var tableArray = table.getArray();\n\n //output each row as array\n for (var i = 0; i < tableArray.length; i++)\n print(tableArray[i]);\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:1077,description:"Retrieves all table data and returns as an object. If a column name is\npassed in, each row object will be stored with that attribute as its\ntitle.
\n",itemtype:"method",name:"getObject",params:[{name:"headerColumn",description:"Name of the column which should be used to\n title each row object (optional)
\n",type:"String"}],return:{description:"",type:"Object"},example:['\n\n\n// Given the CSV file "mammals.csv"\n// in the project\'s "assets" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nvar table;\n\nfunction preload() {\n //my table is comma separated value "csv"\n //and has a header specifying the columns labels\n table = loadTable("assets/mammals.csv", "csv", "header");\n}\n\nfunction setup() {\n var tableObject = table.getObject();\n\n print(tableObject);\n //outputs an object\n}\n\n'],alt:"no image displayed",class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.Table.js",line:1141,description:"Retrieves all table data and returns it as a multidimensional array.
\n",itemtype:"method",name:"getArray",return:{description:"",type:"Array"},class:"p5.Table",module:"IO",submodule:"Table"},{file:"src/io/p5.TableRow.js",line:43,description:"Stores a value in the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",itemtype:"method",name:"set",params:[{name:"column",description:"Column ID (Number)\n or Title (String)
\n",type:"String|Number"},{name:"value",description:"The value to be stored
\n",type:"String|Number"}],class:"p5.TableRow",module:"IO",submodule:"Table"},{file:"src/io/p5.TableRow.js",line:79,description:"Stores a Float value in the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",itemtype:"method",name:"setNum",params:[{name:"column",description:"Column ID (Number)\n or Title (String)
\n",type:"String|Number"},{name:"value",description:"The value to be stored\n as a Float
\n",type:"Number"}],class:"p5.TableRow",module:"IO",submodule:"Table"},{file:"src/io/p5.TableRow.js",line:95,description:"Stores a String value in the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",itemtype:"method",name:"setString",params:[{name:"column",description:"Column ID (Number)\n or Title (String)
\n",type:"String|Number"},{name:"value",description:"The value to be stored\n as a String
\n",type:"String"}],class:"p5.TableRow",module:"IO",submodule:"Table"},{file:"src/io/p5.TableRow.js",line:110,description:"Retrieves a value from the TableRow's specified column.\nThe column may be specified by either its ID or title.
\n",itemtype:"method",name:"get",params:[{name:"column",description:"columnName (string) or\n ID (number)
\n",type:"String|Number"}],return:{description:"",type:"String|Number"},class:"p5.TableRow",module:"IO",submodule:"Table"},{file:"src/io/p5.TableRow.js",line:127,description:"Retrieves a Float value from the TableRow's specified\ncolumn. The column may be specified by either its ID or\ntitle.
\n",itemtype:"method",name:"getNum",params:[{name:"column",description:"columnName (string) or\n ID (number)
\n",type:"String|Number"}],return:{description:"Float Floating point number",type:"Number"},class:"p5.TableRow",module:"IO",submodule:"Table"},{file:"src/io/p5.TableRow.js",line:151,description:"Retrieves an String value from the TableRow's specified\ncolumn. The column may be specified by either its ID or\ntitle.
\n",itemtype:"method",name:"getString",params:[{name:"column",description:"columnName (string) or\n ID (number)
\n",type:"String|Number"}],return:{description:"String",type:"String"},class:"p5.TableRow",module:"IO",submodule:"Table"},{file:"src/io/p5.XML.js",line:66,description:"Gets a copy of the element's parent. Returns the parent as another\np5.XML object.
\n",itemtype:"method",name:"getParent",return:{description:"element parent",type:"p5.XML"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var children = xml.getChildren("animal");\n var parent = children[1].getParent();\n print(parent.getName());\n}\n\n// Sketch prints:\n// mammals\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:104,description:"Gets the element's full name, which is returned as a String.
\n",itemtype:"method",name:"getName",return:{description:"the name of the node",type:"String"},example:['<animal\n \n // The following short XML file called "mammals.xml" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id="0" species="Capra hircus">Goat</animal>\n // <animal id="1" species="Panthera pardus">Leopard</animal>\n // <animal id="2" species="Equus zebra">Zebra</animal>\n // </mammals>\n\n var xml;\n\n function preload() {\n xml = loadXML("assets/mammals.xml");\n }\n\n function setup() {\n print(xml.getName());\n }\n\n // Sketch prints:\n // mammals\n '],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:139,description:"Sets the element's name, which is specified as a String.
\n",itemtype:"method",name:"setName",params:[{name:"the",description:"new name of the node
\n",type:"String"}],example:['<animal\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n print(xml.getName());\n xml.setName("fish");\n print(xml.getName());\n}\n\n// Sketch prints:\n// mammals\n// fish\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:177,description:"Checks whether or not the element has any children, and returns the result\nas a boolean.
\n",itemtype:"method",name:"hasChildren",return:{description:"",type:"Boolean"},example:['<animal\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n print(xml.hasChildren());\n}\n\n// Sketch prints:\n// true\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:213,description:"Get the names of all of the element's children, and returns the names as an\narray of Strings. This is the same as looping through and calling getName()\non each child element individually.
\n",itemtype:"method",name:"listChildren",return:{description:"names of the children of the element",type:"String[]"},example:['<animal\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n print(xml.listChildren());\n}\n\n// Sketch prints:\n// ["animal", "animal", "animal"]\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:250,description:"Returns all of the element's children as an array of p5.XML objects. When\nthe name parameter is specified, then it will return all children that match\nthat name.
\n",itemtype:"method",name:"getChildren",params:[{name:"name",description:"element name
\n",type:"String",optional:!0}],return:{description:"children of the element",type:"p5.XML[]"},example:['<animal\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var animals = xml.getChildren("animal");\n\n for (var i = 0; i < animals.length; i++) {\n print(animals[i].getContent());\n }\n}\n\n// Sketch prints:\n// "Goat"\n// "Leopard"\n// "Zebra"\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:299,description:"Returns the first of the element's children that matches the name parameter\nor the child of the given index.It returns undefined if no matching\nchild is found.
\n",itemtype:"method",name:"getChild",params:[{name:"name",description:"element name or index
\n",type:"String|Number"}],return:{description:"",type:"p5.XML"},example:['<animal\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// "Goat"\n\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var secondChild = xml.getChild(1);\n print(secondChild.getContent());\n}\n\n// Sketch prints:\n// "Leopard"\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:360,description:"Appends a new child to the element. The child can be specified with\neither a String, which will be used as the new tag's name, or as a\nreference to an existing p5.XML object.\nA reference to the newly created child is returned as an p5.XML object.
\n",itemtype:"method",name:"addChild",params:[{name:"a",description:"p5.XML Object which will be the child to be added
\n",type:"p5.XML"}],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:377,description:"Removes the element specified by name or index.
\n",itemtype:"method",name:"removeChild",params:[{name:"name",description:"element name or index
\n",type:"String|Number"}],
-example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n xml.removeChild("animal");\n var children = xml.getChildren();\n for (var i=0; i\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n xml.removeChild(1);\n var children = xml.getChildren();\n for (var i=0; i'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:450,description:"Counts the specified element's number of attributes, returned as an Number.
\n",itemtype:"method",name:"getAttributeCount",return:{description:"",type:"Number"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getAttributeCount());\n}\n\n// Sketch prints:\n// 2\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:486,description:"Gets all of the specified element's attributes, and returns them as an\narray of Strings.
\n",itemtype:"method",name:"listAttributes",return:{description:"an array of strings containing the names of attributes",type:"String[]"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.listAttributes());\n}\n\n// Sketch prints:\n// ["id", "species"]\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:523,description:"Checks whether or not an element has the specified attribute.
\n",itemtype:"method",name:"hasAttribute",params:[{name:"the",description:"attribute to be checked
\n",type:"String"}],return:{description:"true if attribute found else false",type:"Boolean"},example:['\n \n // The following short XML file called "mammals.xml" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id="0" species="Capra hircus">Goat</animal>\n // <animal id="1" species="Panthera pardus">Leopard</animal>\n // <animal id="2" species="Equus zebra">Zebra</animal>\n // </mammals>\n\n var xml;\n\n function preload() {\n xml = loadXML("assets/mammals.xml");\n }\n\n function setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.hasAttribute("species"));\n print(firstChild.hasAttribute("color"));\n }\n\n // Sketch prints:\n // true\n // false\n '],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:562,description:"Returns an attribute value of the element as an Number. If the defaultValue\nparameter is specified and the attribute doesn't exist, then defaultValue\nis returned. If no defaultValue is specified and the attribute doesn't\nexist, the value 0 is returned.
\n",itemtype:"method",name:"getNum",params:[{name:"name",description:"the non-null full name of the attribute
\n",type:"String"},{name:"defaultValue",description:"the default value of the attribute
\n",type:"Number",optional:!0}],return:{description:"",type:"Number"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getNum("id"));\n}\n\n// Sketch prints:\n// 0\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:603,description:"Returns an attribute value of the element as an String. If the defaultValue\nparameter is specified and the attribute doesn't exist, then defaultValue\nis returned. If no defaultValue is specified and the attribute doesn't\nexist, null is returned.
\n",itemtype:"method",name:"getString",params:[{name:"name",description:"the non-null full name of the attribute
\n",type:"String"},{name:"defaultValue",description:"the default value of the attribute
\n",type:"Number",optional:!0}],return:{description:"",type:"Number"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getString("species"));\n}\n\n// Sketch prints:\n// "Capra hircus"\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:644,description:"Sets the content of an element's attribute. The first parameter specifies\nthe attribute name, while the second specifies the new content.
\n",itemtype:"method",name:"setAttribute",params:[{name:"name",description:"the full name of the attribute
\n",type:"String"},{name:"value",description:"the value of the attribute
\n",type:"Number"}],example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getString("species"));\n firstChild.setAttribute("species", "Jamides zebra");\n print(firstChild.getString("species"));\n}\n\n// Sketch prints:\n// "Capra hircus"\n// "Jamides zebra"\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:687,description:"Returns the content of an element. If there is no such content,\ndefaultValue is returned if specified, otherwise null is returned.
\n",itemtype:"method",name:"getContent",params:[{name:"defaultValue",description:"value returned if no content is found
\n",type:"String",optional:!0}],return:{description:"",type:"String"},example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// "Goat"\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:725,description:"Sets the element's content.
\n",itemtype:"method",name:"setContent",params:[{name:"text",description:"the new content
\n",type:"String"}],example:['\n\n// The following short XML file called "mammals.xml" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id="0" species="Capra hircus">Goat</animal>\n// <animal id="1" species="Panthera pardus">Leopard</animal>\n// <animal id="2" species="Equus zebra">Zebra</animal>\n// </mammals>\n\nvar xml;\n\nfunction preload() {\n xml = loadXML("assets/mammals.xml");\n}\n\nfunction setup() {\n var firstChild = xml.getChild("animal");\n print(firstChild.getContent());\n firstChild.setContent("Mountain Goat");\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// "Goat"\n// "Mountain Goat"\n'],class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:767,description:"This method is called while the parsing of XML (when loadXML() is\ncalled). The difference between this method and the setContent()\nmethod defined later is that this one is used to set the content\nwhen the node in question has more nodes under it and so on and\nnot directly text content. While in the other one is used when\nthe node in question directly has text inside it.
\n",class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/io/p5.XML.js",line:784,description:"This method is called while the parsing of XML (when loadXML() is\ncalled). The XML node is passed and its attributes are stored in the\np5.XML's attribute Object.
\n",class:"p5.XML",module:"IO",submodule:"XML"},{file:"src/math/calculation.js",line:12,description:"Calculates the absolute value (magnitude) of a number. Maps to Math.abs().\nThe absolute value of a number is always positive.
\n",itemtype:"method",name:"abs",params:[{name:"n",description:"number to compute
\n",type:"Number"}],return:{description:"absolute value of given number",type:"Number"},example:['\n\nfunction setup() {\n var x = -3;\n var y = abs(x);\n\n print(x); // -3\n print(y); // 3\n}\n'],alt:"no image displayed",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:36,description:"Calculates the closest int value that is greater than or equal to the\nvalue of the parameter. Maps to Math.ceil(). For example, ceil(9.03)\nreturns the value 10.
\n",itemtype:"method",name:"ceil",params:[{name:"n",description:"number to round up
\n",type:"Number"}],return:{description:"rounded up number",type:"Number"},example:["\n\nfunction draw() {\n background(200);\n // map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n //Get the ceiling of the mapped number.\n var bx = ceil(map(mouseX, 0, 100, 0,5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2,2), ax, ay - 5);\n text(nfc(bx,1,1), bx, by - 5);\n}\n"],alt:"2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:76,description:"Constrains a value between a minimum and maximum value.
\n",itemtype:"method",name:"constrain",params:[{name:"n",description:"number to constrain
\n",type:"Number"},{name:"low",description:"minimum limit
\n",type:"Number"},{name:"high",description:"maximum limit
\n",type:"Number"}],return:{description:"constrained number",type:"Number"},example:["\n\nfunction draw() {\n background(200);\n\n var leftWall = 25;\n var rightWall = 75;\n\n // xm is just the mouseX, while\n // xc is the mouseX, but constrained\n // between the leftWall and rightWall!\n var xm = mouseX;\n var xc = constrain(mouseX, leftWall, rightWall);\n\n // Draw the walls.\n stroke(150);\n line(leftWall, 0, leftWall, height);\n line(rightWall, 0, rightWall, height);\n\n // Draw xm and xc as circles.\n noStroke();\n fill(150);\n ellipse(xm, 33, 9,9); // Not Constrained\n fill(0);\n ellipse(xc, 66, 9,9); // Constrained\n}\n"],alt:"2 vertical lines. 2 ellipses move with mouse X 1 does not move passed lines",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:120,description:"Calculates the distance between two points.
\n",itemtype:"method",name:"dist",return:{description:"distance between the two points",type:"Number"},class:"p5",module:"Math",submodule:"Calculation",overloads:[{line:120,params:[{name:"x1",description:"x-coordinate of the first point
\n",type:"Number"},{name:"y1",description:"y-coordinate of the first point
\n",type:"Number"},{name:"x2",description:"x-coordinate of the second point
\n",type:"Number"},{name:"y2",description:"y-coordinate of the second point
\n",type:"Number"}],return:{description:"distance between the two points",type:"Number"}},{line:130,params:[{name:"x1",description:"",type:"Number"},{name:"y1",description:"",type:"Number"},{name:"z1",description:"z-coordinate of the first point
\n",type:"Number"},{name:"x2",description:"",type:"Number"},{name:"y2",description:"",type:"Number"},{name:"z2",description:"z-coordinate of the second point
\n",type:"Number"}],return:{description:"distance between the two points",type:"Number"}}]},{file:"src/math/calculation.js",line:184,description:"Returns Euler's number e (2.71828...) raised to the power of the n\nparameter. Maps to Math.exp().
\n",itemtype:"method",name:"exp",params:[{name:"n",description:"exponent to raise
\n",type:"Number"}],return:{description:"e^n",type:"Number"},example:['\n\nfunction draw() {\n background(200);\n\n // Compute the exp() function with a value between 0 and 2\n var xValue = map(mouseX, 0, width, 0, 2);\n var yValue = exp(xValue);\n\n var y = map(yValue, 0, 8, height, 0);\n\n var legend = "exp (" + nfc(xValue, 3) +")\\n= " + nf(yValue, 1, 4);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text(legend, 5, 15);\n noStroke();\n ellipse (mouseX,y, 7, 7);\n\n // Draw the exp(x) curve,\n // over the domain of x from 0 to 2\n noFill();\n stroke(0);\n beginShape();\n for (var x = 0; x < width; x++) {\n xValue = map(x, 0, width, 0, 2);\n yValue = exp(xValue);\n y = map(yValue, 0, 8, height, 0);\n vertex(x, y);\n }\n\n endShape();\n line(0, 0, 0, height);\n line(0, height-1, width, height-1);\n}\n'],alt:"ellipse moves along a curve with mouse x. e^n displayed.",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:234,description:"Calculates the closest int value that is less than or equal to the\nvalue of the parameter. Maps to Math.floor().
\n",itemtype:"method",name:"floor",params:[{name:"n",description:"number to round down
\n",type:"Number"}],return:{description:"rounded down number",type:"Number"},example:["\n\nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n //Get the floor of the mapped number.\n var bx = floor(map(mouseX, 0, 100, 0,5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2,2), ax, ay - 5);\n text(nfc(bx,1,1), bx, by - 5);\n}\n"],alt:"2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:273,description:"Calculates a number between two numbers at a specific increment. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first point, 0.1 is very near the first point, 0.5 is\nhalf-way in between, etc. The lerp function is convenient for creating\nmotion along a straight path and for drawing dotted lines.
\n",itemtype:"method",name:"lerp",params:[{name:"start",description:"first value
\n",type:"Number"},{name:"stop",description:"second value
\n",type:"Number"},{name:"amt",description:"number between 0.0 and 1.0
\n",type:"Number"}],return:{description:"lerped value",type:"Number"},example:["\n\nfunction setup() {\n background(200);\n var a = 20;\n var b = 80;\n var c = lerp(a,b, .2);\n var d = lerp(a,b, .5);\n var e = lerp(a,b, .8);\n\n var y = 50\n\n strokeWeight(5);\n stroke(0); // Draw the original points in black\n point(a, y);\n point(b, y);\n\n stroke(100); // Draw the lerp points in gray\n point(c, y);\n point(d, y);\n point(e, y);\n}\n"],alt:"5 points horizontally staggered mid-canvas. mid 3 are grey, outer black",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:317,description:"Calculates the natural logarithm (the base-e logarithm) of a number. This\nfunction expects the n parameter to be a value greater than 0.0. Maps to\nMath.log().
\n",itemtype:"method",name:"log",params:[{name:"n",description:"number greater than 0
\n",type:"Number"}],return:{description:"natural logarithm of n",type:"Number"},example:['\n\nfunction draw() {\n background(200);\n var maxX = 2.8;\n var maxY = 1.5;\n\n // Compute the natural log of a value between 0 and maxX\n var xValue = map(mouseX, 0, width, 0, maxX);\n if (xValue > 0) { // Cannot take the log of a negative number.\n var yValue = log(xValue);\n var y = map(yValue, -maxY, maxY, height, 0);\n\n // Display the calculation occurring.\n var legend = "log(" + nf(xValue, 1, 2) + ")\\n= " + nf(yValue, 1, 3);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text (legend, 5, 15);\n noStroke();\n ellipse (mouseX, y, 7, 7);\n }\n\n // Draw the log(x) curve,\n // over the domain of x from 0 to maxX\n noFill();\n stroke(0);\n beginShape();\n for(var x=0; x < width; x++) {\n xValue = map(x, 0, width, 0, maxX);\n yValue = log(xValue);\n y = map(yValue, -maxY, maxY, height, 0);\n vertex(x, y);\n }\n endShape();\n line(0,0,0,height);\n line(0,height/2,width, height/2);\n}\n'],alt:"ellipse moves along a curve with mouse x. natural logarithm of n displayed.",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:371,description:"Calculates the magnitude (or length) of a vector. A vector is a direction\nin space commonly used in computer graphics and linear algebra. Because it\nhas no "start" position, the magnitude of a vector can be thought of as\nthe distance from the coordinate 0,0 to its x,y value. Therefore, mag() is\na shortcut for writing dist(0, 0, x, y).
\n",itemtype:"method",name:"mag",params:[{name:"a",description:"first value
\n",type:"Number"},{name:"b",description:"second value
\n",type:"Number"}],return:{description:"magnitude of vector from (0,0) to (a,b)",type:"Number"},example:['\n\nfunction setup() {\n var x1 = 20;\n var x2 = 80;\n var y1 = 30;\n var y2 = 70;\n\n line(0, 0, x1, y1);\n print(mag(x1, y1)); // Prints "36.05551275463989"\n line(0, 0, x2, y1);\n print(mag(x2, y1)); // Prints "85.44003745317531"\n line(0, 0, x1, y2);\n print(mag(x1, y2)); // Prints "72.80109889280519"\n line(0, 0, x2, y2);\n print(mag(x2, y2)); // Prints "106.3014581273465"\n}\n'],alt:"4 lines of different length radiate from top left of canvas.",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:409,description:"Re-maps a number from one range to another.\n
\nIn the first example above, the number 25 is converted from a value in the\nrange of 0 to 100 into a value that ranges from the left edge of the\nwindow (0) to the right edge (width).
\n",itemtype:"method",name:"map",params:[{name:"value",description:"the incoming value to be converted
\n",type:"Number"},{name:"start1",description:"lower bound of the value's current range
\n",type:"Number"},{name:"stop1",description:"upper bound of the value's current range
\n",type:"Number"},{name:"start2",description:"lower bound of the value's target range
\n",type:"Number"},{name:"stop2",description:"upper bound of the value's target range
\n",type:"Number"},{name:"withinBounds",description:"constrain the value to the newly mapped range
\n",type:"Boolean",optional:!0}],return:{description:"remapped number",type:"Number"},example:["\n \n var value = 25;\n var m = map(value, 0, 100, 0, width);\n ellipse(m, 50, 10, 10);\n \n\n \n function setup() {\n noStroke();\n }\n\n function draw() {\n background(204);\n var x1 = map(mouseX, 0, width, 25, 75);\n ellipse(x1, 25, 25, 25);\n //This ellipse is constrained to the 0-100 range\n //after setting withinBounds to true\n var x2 = map(mouseX, 0, width, 0, 100, true);\n ellipse(x2, 75, 25, 25);\n }\n "],alt:"10 by 10 white ellipse with in mid left canvas\n2 25 by 25 white ellipses move with mouse x. Bottom has more range from X",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:464,description:"Determines the largest value in a sequence of numbers, and then returns\nthat value. max() accepts any number of Number parameters, or an Array\nof any length.
\n",itemtype:"method",name:"max",params:[{name:"n0",description:"Numbers to compare
\n",type:"Number|Array"}],return:{description:"maximum Number",type:"Number"},example:['\n\nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how max() works!\n numArray = new Array(2,1,5,4,8,9);\n fill(0);\n noStroke();\n text("Array Elements", 0, 10);\n // Draw all numbers in the array\n var spacing = 15;\n var elemsY = 25;\n for(var i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n maxX = 33;\n maxY = 80;\n // Draw the Maximum value in the array.\n textSize(32);\n text(max(numArray), maxX, maxY);\n}\n'],alt:"Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 9",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:507,description:"Determines the smallest value in a sequence of numbers, and then returns\nthat value. min() accepts any number of Number parameters, or an Array\nof any length.
\n",itemtype:"method",name:"min",params:[{name:"n0",description:"Numbers to compare
\n",type:"Number|Array"}],return:{description:"minimum Number",type:"Number"},example:['\n\nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how min() works!\n numArray = new Array(2,1,5,4,8,9);\n fill(0);\n noStroke();\n text("Array Elements", 0, 10);\n // Draw all numbers in the array\n var spacing = 15;\n var elemsY = 25;\n for(var i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n maxX = 33;\n maxY = 80;\n // Draw the Minimum value in the array.\n textSize(32);\n text(min(numArray), maxX, maxY);\n}\n'],alt:"Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 1",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:550,description:"Normalizes a number from another range into a value between 0 and 1.\nIdentical to map(value, low, high, 0, 1).\nNumbers outside of the range are not clamped to 0 and 1, because\nout-of-range values are often intentional and useful. (See the second\nexample above.)
\n",itemtype:"method",name:"norm",params:[{name:"value",description:"incoming value to be normalized
\n",type:"Number"},{name:"start",description:"lower bound of the value's current range
\n",type:"Number"},{name:"stop",description:"upper bound of the value's current range
\n",type:"Number"}],return:{description:"normalized number",type:"Number"},example:['\n\nfunction draw() {\n background(200);\n currentNum = mouseX;\n lowerBound = 0;\n upperBound = width; //100;\n normalized = norm(currentNum, lowerBound, upperBound);\n lineY = 70\n line(0, lineY, width, lineY);\n //Draw an ellipse mapped to the non-normalized value.\n noStroke();\n fill(50)\n var s = 7; // ellipse size\n ellipse(currentNum, lineY, s, s);\n\n // Draw the guide\n guideY = lineY + 15;\n text("0", 0, guideY);\n textAlign(RIGHT);\n text("100", width, guideY);\n\n // Draw the normalized value\n textAlign(LEFT);\n fill(0);\n textSize(32);\n normalY = 40;\n normalX = 20;\n text(normalized, normalX, normalY);\n}\n'],alt:"ellipse moves with mouse. 0 shown left & 100 right and updating values center",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:602,description:"Facilitates exponential expressions. The pow() function is an efficient\nway of multiplying numbers by themselves (or their reciprocals) in large\nquantities. For example, pow(3, 5) is equivalent to the expression\n33333 and pow(3, -5) is equivalent to 1 / 33333. Maps to\nMath.pow().
\n",itemtype:"method",name:"pow",params:[{name:"n",description:"base of the exponential expression
\n",type:"Number"},{name:"e",description:"power by which to raise the base
\n",type:"Number"}],return:{description:"n^e",type:"Number"},example:["\n\nfunction setup() {\n //Exponentially increase the size of an ellipse.\n eSize = 3; // Original Size\n eLoc = 10; // Original Location\n\n ellipse(eLoc, eLoc, eSize, eSize);\n\n ellipse(eLoc*2, eLoc*2, pow(eSize, 2), pow(eSize, 2));\n\n ellipse(eLoc*4, eLoc*4, pow(eSize, 3), pow(eSize, 3));\n\n ellipse(eLoc*8, eLoc*8, pow(eSize, 4), pow(eSize, 4));\n}\n"],alt:"small to large ellipses radiating from top left of canvas",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:636,description:"Calculates the integer closest to the n parameter. For example,\nround(133.8) returns the value 134. Maps to Math.round().
\n",itemtype:"method",name:"round",params:[{name:"n",description:"number to round
\n",type:"Number"}],return:{description:"rounded number",type:"Number"},example:["\n\nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n var ax = map(mouseX, 0, 100, 0, 5);\n var ay = 66;\n\n // Round the mapped number.\n var bx = round(map(mouseX, 0, 100, 0,5));\n var by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2,2), ax, ay - 5);\n text(nfc(bx,1,1), bx, by - 5);\n}\n"],alt:"horizontal center line squared values displayed on top and regular on bottom.",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:675,description:"Squares a number (multiplies a number by itself). The result is always a\npositive number, as multiplying two negative numbers always yields a\npositive result. For example, -1 * -1 = 1.
\n",itemtype:"method",name:"sq",params:[{name:"n",description:"number to square
\n",type:"Number"}],return:{description:"squared number",type:"Number"},example:['\n\nfunction draw() {\n background(200);\n eSize = 7;\n x1 = map(mouseX, 0, width, 0, 10);\n y1 = 80;\n x2 = sq(x1);\n y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100)\n line(0, height/2, width, height/2);\n\n // Draw text.\n var spacing = 15;\n noStroke();\n fill(0);\n text("x = " + x1, 0, y1 + spacing);\n text("sq(x) = " + x2, 0, y2 + spacing);\n}\n'],alt:"horizontal center line squared values displayed on top and regular on bottom.",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/calculation.js",line:720,description:"Calculates the square root of a number. The square root of a number is\nalways positive, even though there may be a valid negative root. The\nsquare root s of number a is such that s*s = a. It is the opposite of\nsquaring. Maps to Math.sqrt().
\n",itemtype:"method",name:"sqrt",params:[{name:"n",description:"non-negative number to square root
\n",type:"Number"}],return:{description:"square root of number",type:"Number"},example:['\n\nfunction draw() {\n background(200);\n eSize = 7;\n x1 = mouseX;\n y1 = 80;\n x2 = sqrt(x1);\n y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100)\n line(0, height/2, width, height/2);\n\n // Draw text.\n noStroke();\n fill(0);\n var spacing = 15;\n text("x = " + x1, 0, y1 + spacing);\n text("sqrt(x) = " + x2, 0, y2 + spacing);\n}\n'],alt:"horizontal center line squareroot values displayed on top and regular on bottom.",class:"p5",module:"Math",submodule:"Calculation"},{file:"src/math/math.js",line:13,description:"Creates a new p5.Vector (the datatype for storing vectors). This provides a\ntwo or three dimensional vector, specifically a Euclidean (also known as\ngeometric) vector. A vector is an entity that has both magnitude and\ndirection.
\n",itemtype:"method",name:"createVector",params:[{name:"x",description:"x component of the vector
\n",type:"Number",optional:!0},{name:"y",description:"y component of the vector
\n",type:"Number",optional:!0},{name:"z",description:"z component of the vector
\n",type:"Number",optional:!0}],return:{description:"",type:"p5.Vector"},class:"p5",module:"Math",submodule:"Math"},{file:"src/math/noise.js",line:41,
-description:"Returns the Perlin noise value at specified coordinates. Perlin noise is\na random sequence generator producing a more natural ordered, harmonic\nsuccession of numbers compared to the standard random() function.\nIt was invented by Ken Perlin in the 1980s and been used since in\ngraphical applications to produce procedural textures, natural motion,\nshapes, terrains etc.
The main difference to the\nrandom() function is that Perlin noise is defined in an infinite\nn-dimensional space where each pair of coordinates corresponds to a\nfixed semi-random value (fixed only for the lifespan of the program; see\nthe noiseSeed() function). p5.js can compute 1D, 2D and 3D noise,\ndepending on the number of coordinates given. The resulting value will\nalways be between 0.0 and 1.0. The noise value can be animated by moving\nthrough the noise space as demonstrated in the example above. The 2nd\nand 3rd dimension can also be interpreted as time.
The actual\nnoise is structured similar to an audio signal, in respect to the\nfunction's use of frequencies. Similar to the concept of harmonics in\nphysics, perlin noise is computed over several octaves which are added\ntogether for the final result.
Another way to adjust the\ncharacter of the resulting sequence is the scale of the input\ncoordinates. As the function works within an infinite space the value of\nthe coordinates doesn't matter as such, only the distance between\nsuccessive coordinates does (eg. when using noise() within a\nloop). As a general rule the smaller the difference between coordinates,\nthe smoother the resulting noise sequence will be. Steps of 0.005-0.03\nwork best for most applications, but this will differ depending on use.
\n",itemtype:"method",name:"noise",params:[{name:"x",description:"x-coordinate in noise space
\n",type:"Number"},{name:"y",description:"y-coordinate in noise space
\n",type:"Number",optional:!0},{name:"z",description:"z-coordinate in noise space
\n",type:"Number",optional:!0}],return:{description:"Perlin noise value (between 0 and 1) at specified\n coordinates",type:"Number"},example:["\n\nvar xoff = 0.0;\n\nfunction draw() {\n background(204);\n xoff = xoff + .01;\n var n = noise(xoff) * width;\n line(n, 0, n, height);\n}\n\n\n\nvar noiseScale=0.02;\n\nfunction draw() {\n background(0);\n for (var x=0; x < width; x++) {\n var noiseVal = noise((mouseX+x)*noiseScale, mouseY*noiseScale);\n stroke(noiseVal*255);\n line(x, mouseY+noiseVal*80, x, height);\n }\n}\n\n"],alt:"vertical line moves left to right with updating noise values.\nhorizontal wave pattern effected by mouse x-position & updating noise values.",class:"p5",module:"Math",submodule:"Noise"},{file:"src/math/noise.js",line:171,description:"Adjusts the character and level of detail produced by the Perlin noise\n function. Similar to harmonics in physics, noise is computed over\n several octaves. Lower octaves contribute more to the output signal and\n as such define the overall intensity of the noise, whereas higher octaves\n create finer grained details in the noise sequence.\n
\n By default, noise is computed over 4 octaves with each octave contributing\n exactly half than its predecessor, starting at 50% strength for the 1st\n octave. This falloff amount can be changed by adding an additional function\n parameter. Eg. a falloff factor of 0.75 means each octave will now have\n 75% impact (25% less) of the previous lower octave. Any value between\n 0.0 and 1.0 is valid, however note that values greater than 0.5 might\n result in greater than 1.0 values returned by noise().\n
\n By changing these parameters, the signal created by the noise()\n function can be adapted to fit very specific needs and characteristics.
\n",itemtype:"method",name:"noiseDetail",params:[{name:"lod",description:"number of octaves to be used by the noise
\n",type:"Number"},{name:"falloff",description:"falloff factor for each octave
\n",type:"Number"}],example:["\n \n \nvar noiseVal;\n var noiseScale=0.02;\nfunction setup() {\n createCanvas(100,100);\n }\nfunction draw() {\n background(0);\n for (var y = 0; y < height; y++) {\n for (var x = 0; x < width/2; x++) {\n noiseDetail(2,0.2);\n noiseVal = noise((mouseX+x) * noiseScale,\n (mouseY+y) * noiseScale);\n stroke(noiseVal*255);\n point(x,y);\n noiseDetail(8,0.65);\n noiseVal = noise((mouseX + x + width/2) * noiseScale,\n (mouseY + y) * noiseScale);\n stroke(noiseVal*255);\n point(x + width/2, y);\n }\n }\n }\n \n "],alt:"2 vertical grey smokey patterns affected my mouse x-position and noise.",class:"p5",module:"Math",submodule:"Noise"},{file:"src/math/noise.js",line:233,description:"Sets the seed value for noise(). By default, noise()\nproduces different results each time the program is run. Set the\nvalue parameter to a constant to return the same pseudo-random\nnumbers each time the software is run.
\n",itemtype:"method",name:"noiseSeed",params:[{name:"seed",description:"the seed value
\n",type:"Number"}],example:["\n\nvar xoff = 0.0;\n\nfunction setup() {\n noiseSeed(99);\n stroke(0, 10);\n}\n\nfunction draw() {\n xoff = xoff + .01;\n var n = noise(xoff) * width;\n line(n, 0, n, height);\n}\n\n"],alt:"vertical grey lines drawing in pattern affected by noise.",class:"p5",module:"Math",submodule:"Noise"},{file:"src/math/p5.Vector.js",line:69,description:"The x component of the vector
\n",itemtype:"property",name:"x",type:"Number",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:74,description:"The y component of the vector
\n",itemtype:"property",name:"y",type:"Number",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:79,description:"The z component of the vector
\n",itemtype:"property",name:"z",type:"Number",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:87,description:"Returns a string representation of a vector v by calling String(v)\nor v.toString(). This method is useful for logging vectors in the\nconsole.
\n",itemtype:"method",name:"toString",example:['\n\nfunction setup() {\n var v = createVector(20,30);\n print(String(v)); // prints "p5.Vector Object : [20, 30, 0]"\n}\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:105,description:"Sets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Vector, or the values from a float array.
\n",itemtype:"method",name:"set",params:[{name:"x",description:"the x component of the vector or a\n p5.Vector or an Array
\n",type:"Number|p5.Vector|Array",optional:!0},{name:"y",description:"the y component of the vector
\n",type:"Number",optional:!0},{name:"z",description:"the z component of the vector
\n",type:"Number",optional:!0}],chainable:1,example:['\n\n\nfunction setup() {\n var v = createVector(1, 2, 3);\n v.set(4,5,6); // Sets vector to [4, 5, 6]\n\n var v1 = createVector(0, 0, 0);\n var arr = [1, 2, 3];\n v1.set(arr); // Sets vector to [1, 2, 3]\n}\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:147,description:"Gets a copy of the vector, returns a p5.Vector object.
\n",itemtype:"method",name:"copy",return:{description:"the copy of the p5.Vector object",type:"p5.Vector"},example:['\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = v1.copy();\nprint(v1.x == v2.x && v1.y == v2.y && v1.z == v2.z);\n// Prints "true"\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:170,description:"Adds x, y, and z components to a vector, adds one vector to another, or\nadds two independent vectors together. The version of the method that adds\ntwo vectors together is a static method and returns a p5.Vector, the others\nacts directly on the vector. See the examples for more context.
\n",itemtype:"method",name:"add",chainable:1,example:['\n\n\nvar v = createVector(1, 2, 3);\nv.add(4,5,6);\n// v\'s components are set to [5, 7, 9]\n\n\n\n\n// Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(2, 3, 4);\n\nvar v3 = p5.Vector.add(v1, v2);\n// v3 has components [3, 5, 7]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:170,params:[{name:"x",description:"the x component of the vector to be\n added or a p5.Vector or an Array
\n",type:"Number|p5.Vector|Array"},{name:"y",description:"the y component of the vector to be\n added
\n",type:"Number",optional:!0},{name:"z",description:"the z component of the vector to be\n added
\n",type:"Number",optional:!0}],chainable:1},{line:907,params:[{name:"v1",description:"a p5.Vector to add
\n",type:"p5.Vector"},{name:"v2",description:"a p5.Vector to add
\n",type:"p5.Vector"},{name:"target",description:"the vector to receive the result
\n",type:"p5.Vector"}],static:1},{line:914,params:[{name:"v1",description:"",type:"p5.Vector"},{name:"v2",description:"",type:"p5.Vector"}],static:1,return:{description:"the resulting p5.Vector",type:"p5.Vector"}}]},{file:"src/math/p5.Vector.js",line:222,description:"Subtracts x, y, and z components from a vector, subtracts one vector from\nanother, or subtracts two independent vectors. The version of the method\nthat subtracts two vectors is a static method and returns a p5.Vector, the\nother acts directly on the vector. See the examples for more context.
\n",itemtype:"method",name:"sub",chainable:1,example:['\n\n\nvar v = createVector(4, 5, 6);\nv.sub(1, 1, 1);\n// v\'s components are set to [3, 4, 5]\n\n\n\n\n\n// Static method\nvar v1 = createVector(2, 3, 4);\nvar v2 = createVector(1, 2, 3);\n\nvar v3 = p5.Vector.sub(v1, v2);\n// v3 has components [1, 1, 1]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:222,params:[{name:"x",description:"the x component of the vector or a\n p5.Vector or an Array
\n",type:"Number|p5.Vector|Array"},{name:"y",description:"the y component of the vector
\n",type:"Number",optional:!0},{name:"z",description:"the z component of the vector
\n",type:"Number",optional:!0}],chainable:1},{line:937,params:[{name:"v1",description:"a p5.Vector to subtract from
\n",type:"p5.Vector"},{name:"v2",description:"a p5.Vector to subtract
\n",type:"p5.Vector"},{name:"target",description:"if undefined a new vector will be created
\n",type:"p5.Vector"}],static:1},{line:944,params:[{name:"v1",description:"",type:"p5.Vector"},{name:"v2",description:"",type:"p5.Vector"}],static:1,return:{description:"the resulting p5.Vector",type:"p5.Vector"}}]},{file:"src/math/p5.Vector.js",line:273,description:"Multiply the vector by a scalar. The static version of this method\ncreates a new p5.Vector while the non static version acts on the vector\ndirectly. See the examples for more context.
\n",itemtype:"method",name:"mult",chainable:1,example:['\n\n\nvar v = createVector(1, 2, 3);\nv.mult(2);\n// v\'s components are set to [2, 4, 6]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = p5.Vector.mult(v1, 2);\n// v2 has components [2, 4, 6]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:273,params:[{name:"n",description:"the number to multiply with the vector
\n",type:"Number"}],chainable:1},{line:966,params:[{name:"v",description:"the vector to multiply
\n",type:"p5.Vector"},{name:"n",description:"",type:"Number"},{name:"target",description:"if undefined a new vector will be created
\n",type:"p5.Vector"}],static:1},{line:973,params:[{name:"v",description:"",type:"p5.Vector"},{name:"n",description:"",type:"Number"}],static:1,return:{description:"the resulting new p5.Vector",type:"p5.Vector"}}]},{file:"src/math/p5.Vector.js",line:306,description:"Divide the vector by a scalar. The static version of this method creates a\nnew p5.Vector while the non static version acts on the vector directly.\nSee the examples for more context.
\n",itemtype:"method",name:"div",chainable:1,example:['\n\n\nvar v = createVector(6, 4, 2);\nv.div(2); //v\'s components are set to [3, 2, 1]\n\n\n\n\n\n// Static method\nvar v1 = createVector(6, 4, 2);\nvar v2 = p5.Vector.div(v, 2);\n// v2 has components [3, 2, 1]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:306,params:[{name:"n",description:"the number to divide the vector by
\n",type:"Number"}],chainable:1},{line:993,params:[{name:"v",description:"the vector to divide
\n",type:"p5.Vector"},{name:"n",description:"",type:"Number"},{name:"target",description:"if undefined a new vector will be created
\n",type:"p5.Vector"}],static:1},{line:1e3,params:[{name:"v",description:"",type:"p5.Vector"},{name:"n",description:"",type:"Number"}],static:1,return:{description:"the resulting new p5.Vector",type:"p5.Vector"}}]},{file:"src/math/p5.Vector.js",line:338,description:"Calculates the magnitude (length) of the vector and returns the result as\na float (this is simply the equation sqrt(xx + yy + z*z).)
\n",itemtype:"method",name:"mag",return:{description:"magnitude of the vector",type:"Number"},example:['\n\n\nvar v = createVector(20.0, 30.0, 40.0);\nvar m = v.mag();\nprint(m); // Prints "53.85164807134504"\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:338,params:[],return:{description:"magnitude of the vector",type:"Number"}},{line:1091,params:[{name:"vecT",description:"the vector to return the magnitude of
\n",type:"p5.Vector"}],static:1,return:{description:"the magnitude of vecT",type:"Number"}}]},{file:"src/math/p5.Vector.js",line:357,description:"Calculates the squared magnitude of the vector and returns the result\nas a float (this is simply the equation (xx + yy + z*z).)\nFaster if the real length is not required in the\ncase of comparing vectors, etc.
\n",itemtype:"method",name:"magSq",return:{description:"squared magnitude of the vector",type:"Number"},example:['\n\n\n// Static method\nvar v1 = createVector(6, 4, 2);\nprint(v1.magSq()); // Prints "56"\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:379,description:"Calculates the dot product of two vectors. The version of the method\nthat computes the dot product of two independent vectors is a static\nmethod. See the examples for more context.
\n",itemtype:"method",name:"dot",return:{description:"the dot product",type:"Number"},example:['\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(2, 3, 4);\n\nprint(v1.dot(v2)); // Prints "20"\n\n\n\n\n\n//Static method\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(3, 2, 1);\nprint (p5.Vector.dot(v1, v2)); // Prints "10"\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:379,params:[{name:"x",description:"x component of the vector or a p5.Vector
\n",type:"Number|p5.Vector"},{name:"y",description:"y component of the vector
\n",type:"Number",optional:!0},{name:"z",description:"z component of the vector
\n",type:"Number",optional:!0}],return:{description:"the dot product",type:"Number"}},{line:1021,params:[{name:"v1",description:"the first p5.Vector
\n",type:"p5.Vector"},{name:"v2",description:"the second p5.Vector
\n",type:"p5.Vector"}],static:1,return:{description:"the dot product",type:"Number"}}]},{file:"src/math/p5.Vector.js",line:419,description:"Calculates and returns a vector composed of the cross product between\ntwo vectors. Both the static and non static methods return a new p5.Vector.\nSee the examples for more context.
\n",itemtype:"method",name:"cross",return:{description:"p5.Vector composed of cross product",type:"p5.Vector"},example:['\n\n\nvar v1 = createVector(1, 2, 3);\nvar v2 = createVector(1, 2, 3);\n\nv1.cross(v2); // v\'s components are [0, 0, 0]\n\n\n\n\n\n// Static method\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar crossProduct = p5.Vector.cross(v1, v2);\n// crossProduct has components [0, 0, 1]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:419,params:[{name:"v",description:"p5.Vector to be crossed
\n",type:"p5.Vector"}],return:{description:"p5.Vector composed of cross product",type:"p5.Vector"}},{line:1035,params:[{name:"v1",description:"the first p5.Vector
\n",type:"p5.Vector"},{name:"v2",description:"the second p5.Vector
\n",type:"p5.Vector"}],static:1,return:{description:"the cross product",type:"Number"}}]},{file:"src/math/p5.Vector.js",line:459,description:"Calculates the Euclidean distance between two points (considering a\npoint as a vector object).
\n",itemtype:"method",name:"dist",return:{description:"the distance",type:"Number"},example:['\n\n\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar distance = v1.dist(v2); // distance is 1.4142...\n\n\n\n\n// Static method\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar distance = p5.Vector.dist(v1,v2);\n// distance is 1.4142...\n\n'],class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:459,params:[{name:"v",description:"the x, y, and z coordinates of a p5.Vector
\n",type:"p5.Vector"}],return:{description:"the distance",type:"Number"}},{line:1050,params:[{name:"v1",description:"the first p5.Vector
\n",type:"p5.Vector"},{name:"v2",description:"the second p5.Vector
\n",type:"p5.Vector"}],static:1,return:{description:"the distance",type:"Number"}}]},{file:"src/math/p5.Vector.js",line:491,description:"Normalize the vector to length 1 (make it a unit vector).
\n",itemtype:"method",name:"normalize",return:{description:"normalized p5.Vector",type:"p5.Vector"},example:['\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.normalize();\n// v\'s components are set to\n// [0.4454354, 0.8908708, 0.089087084]\n\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:512,description:"Limit the magnitude of this vector to the value used for the max\nparameter.
\n",itemtype:"method",name:"limit",params:[{name:"max",description:"the maximum magnitude for the vector
\n",type:"Number"}],chainable:1,example:['\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.limit(5);\n// v\'s components are set to\n// [2.2271771, 4.4543543, 0.4454354]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:539,description:"Set the magnitude of this vector to the value used for the len\nparameter.
\n",itemtype:"method",name:"setMag",params:[{name:"len",description:"the new length for this vector
\n",type:"Number"}],chainable:1,example:['\n\n\nvar v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.setMag(10);\n// v\'s components are set to [6.0, 8.0, 0.0]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:560,description:"Calculate the angle of rotation for this vector (only 2D vectors)
\n",itemtype:"method",name:"heading",return:{description:"the angle of rotation",type:"Number"},example:['\n\nfunction setup() {\n var v1 = createVector(30,50);\n print(v1.heading()); // 1.0303768265243125\n\n var v1 = createVector(40,50);\n print(v1.heading()); // 0.8960553845713439\n\n var v1 = createVector(30,70);\n print(v1.heading()); // 1.1659045405098132\n}\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:592,description:"Rotate the vector by an angle (only 2D vectors), magnitude remains the\nsame
\n",itemtype:"method",name:"rotate",params:[{name:"angle",description:"the angle of rotation
\n",type:"Number"}],chainable:1,example:['\n\n\nvar v = createVector(10.0, 20.0);\n// v has components [10.0, 20.0, 0.0]\nv.rotate(HALF_PI);\n// v\'s components are set to [-20.0, 9.999999, 0.0]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:622,description:"Calculates and returns the angle (in radians) between two vectors.
\n",itemtype:"method",name:"angleBetween",params:[{name:"the",description:"x, y, and z components of a p5.Vector
\n",type:"p5.Vector"}],return:{description:"the angle between (in radians)",type:"Number"},example:['\n\n\nvar v1 = createVector(1, 0, 0);\nvar v2 = createVector(0, 1, 0);\n\nvar angle = v1.angleBetween(v2);\n// angle is PI/2\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:654,description:"Linear interpolate the vector to another vector
\n",itemtype:"method",name:"lerp",chainable:1,class:"p5.Vector",module:"Math",submodule:"Math",overloads:[{line:654,params:[{name:"x",description:"the x component
\n",type:"p5.Vector"},{name:"y",description:"the y component
\n",type:"p5.Vector"},{name:"z",description:"the z component
\n",type:"p5.Vector"},{name:"amt",description:"the amount of interpolation; some value between 0.0\n (old vector) and 1.0 (new vector). 0.9 is very near\n the new vector. 0.5 is halfway in between.
\n",type:"Number"}],chainable:1},{line:666,params:[{name:"v",description:"the p5.Vector to lerp to
\n",type:"p5.Vector"},{name:"amt",description:"",type:"Number"}],chainable:1},{line:1065,params:[{name:"v1",description:"",type:"p5.Vector"},{name:"v2",description:"",type:"p5.Vector"},{name:"amt",description:"",type:"Number"},{name:"target",description:"if undefined a new vector will be created
\n",type:"p5.Vector"}],static:1},{line:1073,params:[{name:"v1",description:"",type:"p5.Vector"},{name:"v2",description:"",type:"p5.Vector"},{name:"amt",description:"",type:"Number"}],static:1,return:{description:"the lerped value",type:"Number"}}]},{file:"src/math/p5.Vector.js",line:701,description:"Return a representation of this vector as a float array. This is only\nfor temporary use. If used in any other fashion, the contents should be\ncopied by using the p5.Vector.copy() method to copy into your own\narray.
\n",itemtype:"method",name:"array",return:{description:"an Array with the 3 values",type:"Number[]"},example:['\n\nfunction setup() {\n var v = createVector(20,30);\n print(v.array()); // Prints : Array [20, 30, 0]\n}\n\n\n\nvar v = createVector(10.0, 20.0, 30.0);\nvar f = v.array();\nprint(f[0]); // Prints "10.0"\nprint(f[1]); // Prints "20.0"\nprint(f[2]); // Prints "30.0"\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:730,description:"Equality check against a p5.Vector
\n",itemtype:"method",name:"equals",params:[{name:"x",description:"the x component of the vector or a\n p5.Vector or an Array
\n",type:"Number|p5.Vector|Array",optional:!0},{name:"y",description:"the y component of the vector
\n",type:"Number",optional:!0},{name:"z",description:"the z component of the vector
\n",type:"Number",optional:!0}],return:{description:"whether the vectors are equals",type:"Boolean"},example:['\n\nv1 = createVector(5,10,20);\nv2 = createVector(5,10,20);\nv3 = createVector(13,10,19);\n\nprint(v1.equals(v2.x,v2.y,v2.z)); // true\nprint(v1.equals(v3.x,v3.y,v3.z)); // false\n\n\n\nvar v1 = createVector(10.0, 20.0, 30.0);\nvar v2 = createVector(10.0, 20.0, 30.0);\nvar v3 = createVector(0.0, 0.0, 0.0);\nprint (v1.equals(v2)) // true\nprint (v1.equals(v3)) // false\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:780,description:"Make a new 2D unit vector from an angle
\n",itemtype:"method",name:"fromAngle",static:1,params:[{name:"angle",description:"the desired angle
\n",type:"Number"}],return:{description:"the new p5.Vector object",type:"p5.Vector"},example:['\n\n\nfunction draw() {\n background (200);\n\n // Create a variable, proportional to the mouseX,\n // varying from 0-360, to represent an angle in degrees.\n angleMode(DEGREES);\n var myDegrees = map(mouseX, 0,width, 0,360);\n\n // Display that variable in an onscreen text.\n // (Note the nfc() function to truncate additional decimal places,\n // and the "\\xB0" character for the degree symbol.)\n var readout = "angle = " + nfc(myDegrees,1,1) + "\\xB0"\n noStroke();\n fill (0);\n text (readout, 5, 15);\n\n // Create a p5.Vector using the fromAngle function,\n // and extract its x and y components.\n var v = p5.Vector.fromAngle(radians(myDegrees));\n var vx = v.x;\n var vy = v.y;\n\n push();\n translate (width/2, height/2);\n noFill();\n stroke (150);\n line (0,0, 30,0);\n stroke (0);\n line (0,0, 30*vx, 30*vy);\n pop()\n}\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:837,description:"Make a new 2D unit vector from a random angle
\n",itemtype:"method",name:"random2D",static:1,return:{description:"the new p5.Vector object",type:"p5.Vector"},example:['\n\n\nvar v = p5.Vector.random2D();\n// May make v\'s attributes something like:\n// [0.61554617, -0.51195765, 0.0] or\n// [-0.4695841, -0.14366731, 0.0] or\n// [0.6091097, -0.22805278, 0.0]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:870,description:"Make a new random 3D unit vector.
\n",itemtype:"method",name:"random3D",static:1,return:{description:"the new p5.Vector object",type:"p5.Vector"},example:['\n\n\nvar v = p5.Vector.random3D();\n// May make v\'s attributes something like:\n// [0.61554617, -0.51195765, 0.599168] or\n// [-0.4695841, -0.14366731, -0.8711202] or\n// [0.6091097, -0.22805278, -0.7595902]\n\n'],class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:963,description:"Multiplies a vector by a scalar and returns a new vector.
\n",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:990,description:"Divides a vector by a scalar and returns a new vector.
\n",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:1018,description:"Calculates the dot product of two vectors.
\n",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:1032,description:"Calculates the cross product of two vectors.
\n",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:1046,description:"Calculates the Euclidean distance between two points (considering a\npoint as a vector object).
\n",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/p5.Vector.js",line:1061,description:"Linear interpolate a vector to another vector and return the result as a\nnew vector.
\n",class:"p5.Vector",module:"Math",submodule:"Math"},{file:"src/math/random.js",line:47,description:"Sets the seed value for random().
\nBy default, random() produces different results each time the program\nis run. Set the seed parameter to a constant to return the same\npseudo-random numbers each time the software is run.
\n",itemtype:"method",name:"randomSeed",params:[{name:"seed",description:"the seed value
\n",type:"Number"}],example:["\n\n\nrandomSeed(99);\nfor (var i=0; i < 100; i++) {\n var r = random(0, 255);\n stroke(r);\n line(i, 0, i, 100);\n}\n\n"],alt:"many vertical lines drawn in white, black or grey.",class:"p5",module:"Math",submodule:"Random"},{file:"src/math/random.js",line:78,description:"Return a random floating-point number.
\nTakes either 0, 1 or 2 arguments.
\nIf no argument is given, returns a random number from 0\nup to (but not including) 1.
\nIf one argument is given and it is a number, returns a random number from 0\nup to (but not including) the number.
\nIf one argument is given and it is an array, returns a random element from\nthat array.
\nIf two arguments are given, returns a random number from the\nfirst argument up to (but not including) the second argument.
\n",itemtype:"method",name:"random",return:{description:"the random number",type:"Number"},example:['\n\n\nfor (var i = 0; i < 100; i++) {\n var r = random(50);\n stroke(r*5);\n line(50, i, 50+r, i);\n}\n\n\n\n\nfor (var i = 0; i < 100; i++) {\n var r = random(-50, 50);\n line(50,i,50+r,i);\n}\n\n\n\n\n// Get a random element from an array using the random(Array) syntax\nvar words = [ "apple", "bear", "cat", "dog" ];\nvar word = random(words); // select random word\ntext(word,10,50); // draw the word\n\n'],alt:"100 horizontal lines from center canvas to right. size+fill change each time\n100 horizontal lines from center of canvas. height & side change each render\nword displayed at random. Either apple, bear, cat, or dog",class:"p5",module:"Math",submodule:"Random",overloads:[{line:78,params:[{name:"min",description:"the lower bound (inclusive)
\n",type:"Number",optional:!0},{name:"max",description:"the upper bound (exclusive)
\n",type:"Number",optional:!0}],return:{description:"the random number",type:"Number"}},{line:132,params:[{name:"choices",description:"the array to choose from
\n",type:"Array"}],return:{description:"the random element from the array",type:"*"}}]},{file:"src/math/random.js",line:168,description:"Returns a random number fitting a Gaussian, or\n normal, distribution. There is theoretically no minimum or maximum\n value that randomGaussian() might return. Rather, there is\n just a very low probability that values far from the mean will be\n returned; and a higher probability that numbers near the mean will\n be returned.\n
\n Takes either 0, 1 or 2 arguments.
\n If no args, returns a mean of 0 and standard deviation of 1.
\n If one arg, that arg is the mean (standard deviation is 1).
\n If two args, first is mean, second is standard deviation.
\n",itemtype:"method",name:"randomGaussian",params:[{name:"mean",description:"the mean
\n",type:"Number"},{name:"sd",description:"the standard deviation
\n",type:"Number"}],return:{
-description:"the random number",type:"Number"},example:["\n \n for (var y = 0; y < 100; y++) {\n var x = randomGaussian(50,15);\n line(50, y, x, y);\n}\n \n \n \n \nvar distribution = new Array(360);\n\nfunction setup() {\n createCanvas(100, 100);\n for (var i = 0; i < distribution.length; i++) {\n distribution[i] = floor(randomGaussian(0,15));\n }\n}\n\nfunction draw() {\n background(204);\n translate(width/2, width/2);\n for (var i = 0; i < distribution.length; i++) {\n rotate(TWO_PI/distribution.length);\n stroke(0);\n var dist = abs(distribution[i]);\n line(0, 0, dist, 0);\n }\n}\n \n "],alt:"100 horizontal lines from center of canvas. height & side change each render\n black lines radiate from center of canvas. size determined each render",class:"p5",module:"Math",submodule:"Random"},{file:"src/math/trigonometry.js",line:18,description:"The inverse of cos(), returns the arc cosine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned in\nthe range 0 to PI (3.1415927).
\n",itemtype:"method",name:"acos",params:[{name:"value",description:"the value whose arc cosine is to be returned
\n",type:"Number"}],return:{description:"the arc cosine of the given value",type:"Number"},example:['\n\n\nvar a = PI;\nvar c = cos(a);\nvar ac = acos(c);\n// Prints: "3.1415927 : -1.0 : 3.1415927"\nprint(a + " : " + c + " : " + ac);\n\n\n\n\n\nvar a = PI + PI/4.0;\nvar c = cos(a);\nvar ac = acos(c);\n// Prints: "3.926991 : -0.70710665 : 2.3561943"\nprint(a + " : " + c + " : " + ac);\n\n'],class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:56,description:"The inverse of sin(), returns the arc sine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned\nin the range -PI/2 to PI/2.
\n",itemtype:"method",name:"asin",params:[{name:"value",description:"the value whose arc sine is to be returned
\n",type:"Number"}],return:{description:"the arc sine of the given value",type:"Number"},example:['\n\n\nvar a = PI + PI/3;\nvar s = sin(a);\nvar as = asin(s);\n// Prints: "1.0471976 : 0.86602545 : 1.0471976"\nprint(a + " : " + s + " : " + as);\n\n\n\n\n\nvar a = PI + PI/3.0;\nvar s = sin(a);\nvar as = asin(s);\n// Prints: "4.1887903 : -0.86602545 : -1.0471976"\nprint(a + " : " + s + " : " + as);\n\n\n'],class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:95,description:"The inverse of tan(), returns the arc tangent of a value. This function\nexpects the values in the range of -Infinity to Infinity (exclusive) and\nvalues are returned in the range -PI/2 to PI/2.
\n",itemtype:"method",name:"atan",params:[{name:"value",description:"the value whose arc tangent is to be returned
\n",type:"Number"}],return:{description:"the arc tangent of the given value",type:"Number"},example:['\n\n\nvar a = PI + PI/3;\nvar t = tan(a);\nvar at = atan(t);\n// Prints: "1.0471976 : 1.7320509 : 1.0471976"\nprint(a + " : " + t + " : " + at);\n\n\n\n\n\nvar a = PI + PI/3.0;\nvar t = tan(a);\nvar at = atan(t);\n// Prints: "4.1887903 : 1.7320513 : 1.0471977"\nprint(a + " : " + t + " : " + at);\n\n\n'],class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:134,description:"Calculates the angle (in radians) from a specified point to the coordinate\norigin as measured from the positive x-axis. Values are returned as a\nfloat in the range from PI to -PI. The atan2() function is most often used\nfor orienting geometry to the position of the cursor.\n
\nNote: The y-coordinate of the point is the first parameter, and the\nx-coordinate is the second parameter, due the the structure of calculating\nthe tangent.
\n",itemtype:"method",name:"atan2",params:[{name:"y",description:"y-coordinate of the point
\n",type:"Number"},{name:"x",description:"x-coordinate of the point
\n",type:"Number"}],return:{description:"the arc tangent of the given point",type:"Number"},example:["\n\n\nfunction draw() {\n background(204);\n translate(width/2, height/2);\n var a = atan2(mouseY-height/2, mouseX-width/2);\n rotate(a);\n rect(-30, -5, 60, 10);\n}\n\n"],alt:"60 by 10 rect at center of canvas rotates with mouse movements",class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:174,description:"Calculates the cosine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.
\n",itemtype:"method",name:"cos",params:[{name:"angle",description:"the angle
\n",type:"Number"}],return:{description:"the cosine of the angle",type:"Number"},example:["\n\n\nvar a = 0.0;\nvar inc = TWO_PI/25.0;\nfor (var i = 0; i < 25; i++) {\n line(i*4, 50, i*4, 50+cos(a)*40.0);\n a = a + inc;\n}\n\n"],alt:"vertical black lines form wave patterns, extend-down on left and right side",class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:206,description:"Calculates the sine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.
\n",itemtype:"method",name:"sin",params:[{name:"angle",description:"the angle
\n",type:"Number"}],return:{description:"the sine of the angle",type:"Number"},example:["\n\n\nvar a = 0.0;\nvar inc = TWO_PI/25.0;\nfor (var i = 0; i < 25; i++) {\n line(i*4, 50, i*4, 50+sin(a)*40.0);\n a = a + inc;\n}\n\n"],alt:"vertical black lines extend down and up from center to form wave pattern",class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:238,description:"Calculates the tangent of an angle. This function takes into account\nthe current angleMode. Values are returned in the range -1 to 1.
\n",itemtype:"method",name:"tan",params:[{name:"angle",description:"the angle
\n",type:"Number"}],return:{description:"the tangent of the angle",type:"Number"},example:["\n\n\n var a = 0.0;\n var inc = TWO_PI/50.0;\n for (var i = 0; i < 100; i = i+2) {\n line(i, 50, i, 50+tan(a)*2.0);\n a = a + inc;\n }\n"],alt:"vertical black lines end down and up from center to form spike pattern",class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:270,description:"Converts a radian measurement to its corresponding value in degrees.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964.
\n",itemtype:"method",name:"degrees",params:[{name:"radians",description:"the radians value to convert to degrees
\n",type:"Number"}],return:{description:"the converted angle",type:"Number"},example:['\n\n\nvar rad = PI/4;\nvar deg = degrees(rad);\nprint(rad + " radians is " + deg + " degrees");\n// Prints: 0.7853981633974483 radians is 45 degrees\n\n\n'],class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:296,description:"Converts a degree measurement to its corresponding value in radians.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964.
\n",itemtype:"method",name:"radians",params:[{name:"degrees",description:"the degree value to convert to radians
\n",type:"Number"}],return:{description:"the converted angle",type:"Number"},example:['\n\n\nvar deg = 45.0;\nvar rad = radians(deg);\nprint(deg + " degrees is " + rad + " radians");\n// Prints: 45 degrees is 0.7853981633974483 radians\n\n'],class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/math/trigonometry.js",line:320,description:"Sets the current mode of p5 to given mode. Default mode is RADIANS.
\n",itemtype:"method",name:"angleMode",params:[{name:"mode",description:"either RADIANS or DEGREES
\n",type:"Constant"}],example:["\n\n\nfunction draw(){\n background(204);\n angleMode(DEGREES); // Change the mode to DEGREES\n var a = atan2(mouseY-height/2, mouseX-width/2);\n translate(width/2, height/2);\n push();\n rotate(a);\n rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees\n pop();\n angleMode(RADIANS); // Change the mode to RADIANS\n rotate(a); // var a stays the same\n rect(-40, -5, 20, 10); // Smaller rectangle is rotating in radians\n}\n\n"],alt:"40 by 10 rect in center rotates with mouse moves. 20 by 10 rect moves faster.",class:"p5",module:"Math",submodule:"Trigonometry"},{file:"src/typography/attributes.js",line:13,description:"Sets the current alignment for drawing text. Accepts two\narguments: horizAlign (LEFT, CENTER, or RIGHT) and\nvertAlign (TOP, BOTTOM, CENTER, or BASELINE).
\nThe horizAlign parameter is in reference to the x value\nof the text() function, while the vertAlign parameter is\nin reference to the y value.
\nSo if you write textAlign(LEFT), you are aligning the left\nedge of your text to the x value you give in text(). If you\nwrite textAlign(RIGHT, TOP), you are aligning the right edge\nof your text to the x value and the top of edge of the text\nto the y value.
\n",itemtype:"method",name:"textAlign",params:[{name:"horizAlign",description:"horizontal alignment, either LEFT,\n CENTER, or RIGHT
\n",type:"Constant"},{name:"vertAlign",description:"vertical alignment, either TOP,\n BOTTOM, CENTER, or BASELINE
\n",type:"Constant",optional:!0}],return:{description:"",type:"Number"},example:['\n\n\ntextSize(16);\ntextAlign(RIGHT);\ntext("ABCD", 50, 30);\ntextAlign(CENTER);\ntext("EFGH", 50, 50);\ntextAlign(LEFT);\ntext("IJKL", 50, 70);\n\n'],alt:"Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left.",class:"p5",module:"Typography",submodule:"Attributes"},{file:"src/typography/attributes.js",line:55,description:"Sets/gets the spacing, in pixels, between lines of text. This\nsetting will be used in all subsequent calls to the text() function.
\n",itemtype:"method",name:"textLeading",chainable:1,class:"p5",module:"Typography",submodule:"Attributes",overloads:[{line:55,params:[{name:"leading",description:"the size in pixels for spacing between lines
\n",type:"Number"}],chainable:1},{line:63,params:[],return:{description:"",type:"Number"}}]},{file:"src/typography/attributes.js",line:92,description:"Sets/gets the current font size. This size will be used in all subsequent\ncalls to the text() function. Font size is measured in pixels.
\n",itemtype:"method",name:"textSize",chainable:1,class:"p5",module:"Typography",submodule:"Attributes",overloads:[{line:92,params:[{name:"theSize",description:"the size of the letters in units of pixels
\n",type:"Number"}],chainable:1},{line:100,params:[],return:{description:"",type:"Number"}}]},{file:"src/typography/attributes.js",line:123,description:"Sets/gets the style of the text for system fonts to NORMAL, ITALIC, or BOLD.\nNote: this may be is overridden by CSS styling. For non-system fonts\n(opentype, truetype, etc.) please load styled fonts instead.
\n",itemtype:"method",name:"textStyle",chainable:1,class:"p5",module:"Typography",submodule:"Attributes",overloads:[{line:123,params:[{name:"theStyle",description:"styling for text, either NORMAL,\n ITALIC, or BOLD
\n",type:"Constant"}],chainable:1},{line:133,params:[],return:{description:"",type:"String"}}]},{file:"src/typography/attributes.js",line:158,description:"Calculates and returns the width of any character or text string.
\n",itemtype:"method",name:"textWidth",params:[{name:"theText",description:"the String of characters to measure
\n",type:"String"}],return:{description:"",type:"Number"},example:["\n\n\ntextSize(28);\n\nvar aChar = 'P';\nvar cWidth = textWidth(aChar);\ntext(aChar, 0, 40);\nline(cWidth, 0, cWidth, 50);\n\nvar aString = \"p5.js\";\nvar sWidth = textWidth(aString);\ntext(aString, 0, 85);\nline(sWidth, 50, sWidth, 100);\n\n"],alt:"Letter P and p5.js are displayed with vertical lines at end. P is wide",class:"p5",module:"Typography",submodule:"Attributes"},{file:"src/typography/attributes.js",line:192,description:"Returns the ascent of the current font at its current size. The ascent\nrepresents the distance, in pixels, of the tallest character above\nthe baseline.
\n",itemtype:"method",name:"textAscent",return:{description:"",type:"Number"},example:['\n\n\nvar base = height * 0.75;\nvar scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nvar asc = textAscent() * scalar; // Calc ascent\nline(0, base - asc, width, base - asc);\ntext("dp", 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\nasc = textAscent() * scalar; // Recalc ascent\nline(40, base - asc, width, base - asc);\ntext("dp", 40, base); // Draw text on baseline\n\n'],class:"p5",module:"Typography",submodule:"Attributes"},{file:"src/typography/attributes.js",line:220,description:"Returns the descent of the current font at its current size. The descent\nrepresents the distance, in pixels, of the character with the longest\ndescender below the baseline.
\n",itemtype:"method",name:"textDescent",return:{description:"",type:"Number"},example:['\n\n\nvar base = height * 0.75;\nvar scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nvar desc = textDescent() * scalar; // Calc ascent\nline(0, base+desc, width, base+desc);\ntext("dp", 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\ndesc = textDescent() * scalar; // Recalc ascent\nline(40, base + desc, width, base + desc);\ntext("dp", 40, base); // Draw text on baseline\n\n'],class:"p5",module:"Typography",submodule:"Attributes"},{file:"src/typography/attributes.js",line:248,description:"Helper function to measure ascent and descent.
\n",class:"p5",module:"Typography",submodule:"Attributes"},{file:"src/typography/loading_displaying.js",line:16,description:"Loads an opentype font file (.otf, .ttf) from a file or a URL,\nand returns a PFont Object. This method is asynchronous,\nmeaning it may not finish before the next line in your sketch\nis executed.\n
\nThe path to the font should be relative to the HTML file\nthat links in your sketch. Loading an from a URL or other\nremote location may be blocked due to your browser's built-in\nsecurity.
\n",itemtype:"method",name:"loadFont",params:[{name:"path",description:"name of the file or url to load
\n",type:"String"},{name:"callback",description:"function to be executed after\n loadFont()\n completes
\n",type:"Function",optional:!0}],return:{description:"p5.Font object",type:"p5.Font"},example:["\n\nCalling loadFont() inside preload() guarantees that the load\noperation will have completed before setup() and draw() are called.
\n\n\nvar myFont;\nfunction preload() {\n myFont = loadFont('assets/AvenirNextLTPro-Demi.otf');\n}\n\nfunction setup() {\n fill('#ED225D');\n textFont(myFont);\n textSize(36);\n text('p5*js', 10, 50);\n}\n\n\nOutside of preload(), you may supply a callback function to handle the\nobject:\n\n\nfunction setup() {\n loadFont('assets/AvenirNextLTPro-Demi.otf', drawText);\n}\n\nfunction drawText(font) {\n fill('#ED225D');\n textFont(font, 36);\n text('p5*js', 10, 50);\n}\n\n\n\nYou can also use the string name of the font to style other HTML\nelements.
\n\n\nvar myFont;\n\nfunction preload() {\n myFont = loadFont('assets/Avenir.otf');\n}\n\nfunction setup() {\n var myDiv = createDiv('hello there');\n myDiv.style('font-family', 'Avenir');\n}\n"],alt:"p5*js in p5's theme dark pink\np5*js in p5's theme dark pink",class:"p5",module:"Typography",submodule:"Loading & Displaying"},{file:"src/typography/loading_displaying.js",line:135,description:"Draws text to the screen. Displays the information specified in the first\nparameter on the screen in the position specified by the additional\nparameters. A default font will be used unless a font is set with the\ntextFont() function and a default size will be used unless a font is set\nwith textSize(). Change the color of the text with the fill() function.\nChange the outline of the text with the stroke() and strokeWeight()\nfunctions.\n
\nThe text displays in relation to the textAlign() function, which gives the\noption to draw to the left, right, and center of the coordinates.\n
\nThe x2 and y2 parameters define a rectangular area to display within and\nmay only be used with string data. When these parameters are specified,\nthey are interpreted based on the current rectMode() setting. Text that\ndoes not fit completely within the rectangle specified will not be drawn\nto the screen.
\n",itemtype:"method",name:"text",params:[{name:"str",description:"the alphanumeric symbols to be displayed
\n",type:"String"},{name:"x",description:"x-coordinate of text
\n",type:"Number"},{name:"y",description:"y-coordinate of text
\n",type:"Number"},{name:"x2",description:"by default, the width of the text box,\n see rectMode() for more info
\n",type:"Number",optional:!0},{name:"y2",description:"by default, the height of the text box,\n see rectMode() for more info
\n",type:"Number",optional:!0}],return:{description:"this",type:"P5"},example:['\n\n\ntextSize(32);\ntext("word", 10, 30);\nfill(0, 102, 153);\ntext("word", 10, 60);\nfill(0, 102, 153, 51);\ntext("word", 10, 90);\n\n\n\n\ns = "The quick brown fox jumped over the lazy dog.";\nfill(50);\ntext(s, 10, 10, 70, 80); // Text wraps within text box\n\n'],alt:"'word' displayed 3 times going from black, blue to translucent blue\nThe quick brown fox jumped over the lazy dog.",class:"p5",module:"Typography",submodule:"Loading & Displaying"},{file:"src/typography/loading_displaying.js",line:191,description:"Sets the current font that will be drawn with the text() function.
\n",itemtype:"method",name:"textFont",return:{description:"the current font",type:"Object"},class:"p5",module:"Typography",submodule:"Loading & Displaying",overloads:[{line:191,params:[],return:{description:"the current font",type:"Object"}},{line:197,params:[{name:"font",description:'a font loaded via loadFont(), or a String\nrepresenting a web safe font (a font\nthat is generally available across all systems)
\n',type:"Object|String"},{name:"size",description:"the font size to use
\n",type:"Number",optional:!0}],chainable:1}]},{file:"src/typography/p5.Font.js",line:33,description:"Underlying opentype font implementation
\n",itemtype:"property",name:"font",class:"p5.Font",module:"Typography",submodule:"Font"},{file:"src/typography/p5.Font.js",line:47,description:"Returns a tight bounding box for the given text string using this\nfont (currently only supports single lines)
\n",itemtype:"method",name:"textBounds",params:[{name:"line",description:"a line of text
\n",type:"String"},{name:"x",description:"x-position
\n",type:"Number"},{name:"y",description:"y-position
\n",type:"Number"},{name:"fontSize",description:"font size to use (optional)
\n",type:"Number"},{name:"options",description:"opentype options (optional)
\n",type:"Object"}],return:{description:"a rectangle object with properties: x, y, w, h",type:"Object"},example:["\n\n\nvar font;\nvar textString = 'Lorem ipsum dolor sit amet.';\nfunction preload() {\n font = loadFont('./assets/Regular.otf');\n};\nfunction setup() {\n background(210);\n\n var bbox = font.textBounds(textString, 10, 30, 12);\n fill(255);\n stroke(0);\n rect(bbox.x, bbox.y, bbox.w, bbox.h);\n fill(0);\n noStroke();\n\n textFont(font);\n textSize(12);\n text(textString, 10, 30);\n};\n\n"],alt:"words Lorem ipsum dol go off canvas and contained by white bounding box",class:"p5.Font",module:"Typography",submodule:"Font"},{file:"src/typography/p5.Font.js",line:148,description:"Computes an array of points following the path for specified text
\n",itemtype:"method",name:"textToPoints",params:[{name:"txt",description:"a line of text
\n",type:"String"},{name:"x",description:"x-position
\n",type:"Number"},{name:"y",description:"y-position
\n",type:"Number"},{name:"fontSize",description:"font size to use (optional)
\n",type:"Number"},{name:"options",description:"an (optional) object that can contain:
\n
sampleFactor - the ratio of path-length to number of samples\n(default=.25); higher values yield more points and are therefore\nmore precise
\n
simplifyThreshold - if set to a non-zero value, collinear points will be\nbe removed from the polygon; the value represents the threshold angle to use\nwhen determining whether two edges are collinear
\n",type:"Object"}],return:{description:"an array of points, each with x, y, alpha (the path angle)",type:"Array"},class:"p5.Font",module:"Typography",submodule:"Font"},{file:"src/typography/p5.Font.js",line:206,description:"Returns the set of opentype glyphs for the supplied string.
\nNote that there is not a strict one-to-one mapping between characters\nand glyphs, so the list of returned glyphs can be larger or smaller\n than the length of the given string.
\n",params:[{name:"str",description:"the string to be converted
\n",type:"String"}],return:{description:"the opentype glyphs",type:"Array"},class:"p5.Font",module:"Typography",submodule:"Font"},{file:"src/typography/p5.Font.js",line:221,description:"Returns an opentype path for the supplied string and position.
\n",params:[{name:"line",description:"a line of text
\n",type:"String"},{name:"x",description:"x-position
\n",type:"Number"},{name:"y",description:"y-position
\n",type:"Number"},{name:"options",description:"opentype options (optional)
\n",type:"Object"}],return:{description:"the opentype path",type:"Object"},class:"p5.Font",module:"Typography",submodule:"Font"},{file:"src/utilities/array_functions.js",line:12,description:"Adds a value to the end of an array. Extends the length of\nthe array by one. Maps to Array.push().
\n",itemtype:"method",name:"append",params:[{name:"array",description:"Array to append
\n",type:"Array"},{name:"value",description:"to be added to the Array
\n",type:"Any"}],example:['\n\nfunction setup() {\n\nvar myArray = new Array("Mango", "Apple", "Papaya")\nprint(myArray) // ["Mango", "Apple", "Papaya"]\n\nappend(myArray, "Peach")\nprint(myArray) // ["Mango", "Apple", "Papaya", "Peach"]\n\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:37,description:"Copies an array (or part of an array) to another array. The src array is\ncopied to the dst array, beginning at the position specified by\nsrcPosition and into the position specified by dstPosition. The number of\nelements to copy is determined by length. Note that copying values\noverwrites existing values in the destination array. To append values\ninstead of overwriting them, use concat().\n
\nThe simplified version with only two arguments, arrayCopy(src, dst),\ncopies an entire array to another of the same size. It is equivalent to\narrayCopy(src, 0, dst, 0, src.length).\n
\nUsing this function is far more efficient for copying array data than\niterating through a for() loop and copying each element individually.
\n",itemtype:"method",name:"arrayCopy",class:"p5",module:"Data",submodule:"Array Functions",overloads:[{line:37,params:[{name:"src",description:"the source Array
\n",type:"Array"},{name:"srcPosition",description:"starting position in the source Array
\n",type:"Number"},{name:"dst",description:"the destination Array
\n",type:"Array"},{name:"dstPosition",description:"starting position in the destination Array
\n",type:"Number"},{name:"length",description:"number of Array elements to be copied
\n",type:"Number"}]},{line:59,params:[{name:"src",description:"",type:"Array"},{name:"dst",description:"",type:"Array"},{name:"length",description:"",type:"Number",optional:!0}]}]},{file:"src/utilities/array_functions.js",line:124,description:"Concatenates two arrays, maps to Array.concat(). Does not modify the\ninput arrays.
\n",itemtype:"method",name:"concat",params:[{name:"a",description:"first Array to concatenate
\n",type:"Array"},{name:"b",description:"second Array to concatenate
\n",type:"Array"}],return:{description:"concatenated array",type:"Array"},example:['\n\nfunction setup() {\n var arr1 = new Array("A", "B", "C");\n var arr2 = new Array( 1 , 2 , 3 );\n\n print(arr1); // ["A","B","C"]\n print(arr2); // [1,2,3]\n\n var arr3 = concat(arr1, arr2);\n\n print(arr1); // ["A","B","C"]\n print(arr2); // [1,2,3]\n print(arr3); // ["A","B","C",1,2,3]\n\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:155,description:"Reverses the order of an array, maps to Array.reverse()
\n",itemtype:"method",name:"reverse",params:[{name:"list",description:"Array to reverse
\n",type:"Array"}],example:['\n\nfunction setup() {\n var myArray = new Array("A", "B", "C");\n print(myArray); // ["A","B","C"]\n\n reverse(myArray);\n print(myArray); // ["C","B","A"]\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:175,description:"Decreases an array by one element and returns the shortened array,\nmaps to Array.pop().
\n",itemtype:"method",name:"shorten",params:[{name:"list",description:"Array to shorten
\n",type:"Array"}],return:{description:"shortened Array",type:"Array"},example:['\n\nfunction setup() {\n var myArray = new Array("A", "B", "C");\n print(myArray); // ["A","B","C"]\n\n var newArray = shorten(myArray);\n print(myArray); // ["A","B","C"]\n print(newArray); // ["A","B"]\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:199,description:'Randomizes the order of the elements of an array. Implements\n\nFisher-Yates Shuffle Algorithm.
\n',itemtype:"method",name:"shuffle",params:[{name:"array",description:"Array to shuffle
\n",type:"Array"},{name:"bool",description:"modify passed array
\n",type:"Boolean",optional:!0}],return:{description:"shuffled Array",type:"Array"},example:["\n\nfunction setup() {\n var regularArr = ['ABC', 'def', createVector(), TAU, Math.E];\n print(regularArr);\n shuffle(regularArr, true); // force modifications to passed array\n print(regularArr);\n\n // By default shuffle() returns a shuffled cloned array:\n var newArr = shuffle(regularArr);\n print(regularArr);\n print(newArr);\n}\n"],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:239,description:"Sorts an array of numbers from smallest to largest, or puts an array of\nwords in alphabetical order. The original array is not modified; a\nre-ordered array is returned. The count parameter states the number of\nelements to sort. For example, if there are 12 elements in an array and\ncount is set to 5, only the first 5 elements in the array will be sorted.
\n",itemtype:"method",name:"sort",params:[{name:"list",description:"Array to sort
\n",type:"Array"},{name:"count",description:"number of elements to sort, starting from 0
\n",type:"Number",optional:!0}],example:['\n\nfunction setup() {\n var words = new Array("banana", "apple", "pear","lime");\n print(words); // ["banana", "apple", "pear", "lime"]\n var count = 4; // length of array\n\n words = sort(words, count);\n print(words); // ["apple", "banana", "lime", "pear"]\n}\n\n\nfunction setup() {\n var numbers = new Array(2,6,1,5,14,9,8,12);\n print(numbers); // [2,6,1,5,14,9,8,12]\n var count = 5; // Less than the length of the array\n\n numbers = sort(numbers, count);\n print(numbers); // [1,2,5,6,14,9,8,12]\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:283,description:"Inserts a value or an array of values into an existing array. The first\nparameter specifies the initial array to be modified, and the second\nparameter defines the data to be inserted. The third parameter is an index\nvalue which specifies the array position from which to insert data.\n(Remember that array index numbering starts at zero, so the first position\nis 0, the second position is 1, and so on.)
\n",itemtype:"method",name:"splice",params:[{name:"list",description:"Array to splice into
\n",type:"Array"},{name:"value",description:"value to be spliced in
\n",type:"Any"},{name:"position",description:"in the array from which to insert data
\n",type:"Number"}],example:['\n\nfunction setup() {\n var myArray = new Array(0,1,2,3,4);\n var insArray = new Array("A","B","C");\n print(myArray); // [0,1,2,3,4]\n print(insArray); // ["A","B","C"]\n\n splice(myArray, insArray, 3);\n print(myArray); // [0,1,2,"A","B","C",3,4]\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/array_functions.js",line:317,description:"Extracts an array of elements from an existing array. The list parameter\ndefines the array from which the elements will be copied, and the start\nand count parameters specify which elements to extract. If no count is\ngiven, elements will be extracted from the start to the end of the array.\nWhen specifying the start, remember that the first array element is 0.\nThis function does not change the source array.
\n",itemtype:"method",name:"subset",params:[{name:"list",description:"Array to extract from
\n",type:"Array"},{name:"start",description:"position to begin
\n",type:"Number"},{name:"count",description:"number of values to extract
\n",type:"Number",optional:!0}],return:{description:"Array of extracted elements",type:"Array"},example:['\n\nfunction setup() {\n var myArray = new Array(1,2,3,4,5);\n print(myArray); // [1,2,3,4,5]\n\n var sub1 = subset(myArray, 0, 3);\n var sub2 = subset(myArray, 2, 2);\n print(sub1); // [1,2,3]\n print(sub2); // [3,4]\n}\n'],class:"p5",module:"Data",submodule:"Array Functions"},{file:"src/utilities/conversion.js",line:12,
-description:"Converts a string to its floating point representation. The contents of a\nstring must resemble a number, or NaN (not a number) will be returned.\nFor example, float("1234.56") evaluates to 1234.56, but float("giraffe")\nwill return NaN.
\nWhen an array of values is passed in, then an array of floats of the same\nlength is returned.
\n",itemtype:"method",name:"float",params:[{name:"str",description:"float string to parse
\n",type:"String"}],return:{description:"floating point representation of string",type:"Number"},example:["\n\nvar str = '20';\nvar diameter = float(str);\nellipse(width/2, height/2, diameter, diameter);\n"],alt:"20 by 20 white ellipse in the center of the canvas",class:"p5",module:"Data",submodule:"Conversion"},{file:"src/utilities/conversion.js",line:42,description:"Converts a boolean, string, or float to its integer representation.\nWhen an array of values is passed in, then an int array of the same length\nis returned.
\n",itemtype:"method",name:"int",return:{description:"integer representation of value",type:"Number"},class:"p5",module:"Data",submodule:"Conversion",overloads:[{line:42,params:[{name:"n",description:"value to parse
\n",type:"String|Boolean|Number"}],return:{description:"integer representation of value",type:"Number"}},{line:51,params:[{name:"ns",description:"values to parse
\n",type:"Array"}],return:{description:"integer representation of values",type:"Number[]"}}]},{file:"src/utilities/conversion.js",line:79,description:"Converts a boolean, string or number to its string representation.\nWhen an array of values is passed in, then an array of strings of the same\nlength is returned.
\n",itemtype:"method",name:"str",params:[{name:"n",description:"value to parse
\n",type:"String|Boolean|Number|Array"}],return:{description:"string representation of value",type:"String"},example:['\n\nprint(str("10")); // "10"\nprint(str(10.31)); // "10.31"\nprint(str(-10)); // "-10"\nprint(str(true)); // "true"\nprint(str(false)); // "false"\nprint(str([true, "10.3", 9.8])); // [ "true", "10.3", "9.8" ]\n'],class:"p5",module:"Data",submodule:"Conversion"},{file:"src/utilities/conversion.js",line:105,description:"Converts a number or string to its boolean representation.\nFor a number, any non-zero value (positive or negative) evaluates to true,\nwhile zero evaluates to false. For a string, the value "true" evaluates to\ntrue, while any other value evaluates to false. When an array of number or\nstring values is passed in, then a array of booleans of the same length is\nreturned.
\n",itemtype:"method",name:"boolean",params:[{name:"n",description:"value to parse
\n",type:"String|Boolean|Number|Array"}],return:{description:"boolean representation of value",type:"Boolean"},example:['\n\nprint(boolean(0)); // false\nprint(boolean(1)); // true\nprint(boolean("true")); // true\nprint(boolean("abcd")); // false\nprint(boolean([0, 12, "true"])); // [false, true, false]\n'],class:"p5",module:"Data",submodule:"Conversion"},{file:"src/utilities/conversion.js",line:137,description:"Converts a number, string or boolean to its byte representation.\nA byte can be only a whole number between -128 and 127, so when a value\noutside of this range is converted, it wraps around to the corresponding\nbyte representation. When an array of number, string or boolean values is\npassed in, then an array of bytes the same length is returned.
\n",itemtype:"method",name:"byte",return:{description:"byte representation of value",type:"Number"},class:"p5",module:"Data",submodule:"Conversion",overloads:[{line:137,params:[{name:"n",description:"value to parse
\n",type:"String|Boolean|Number"}],return:{description:"byte representation of value",type:"Number"}},{line:148,params:[{name:"ns",description:"values to parse
\n",type:"Array"}],return:{description:"array of byte representation of values",type:"Number[]"}}]},{file:"src/utilities/conversion.js",line:171,description:"Converts a number or string to its corresponding single-character\nstring representation. If a string parameter is provided, it is first\nparsed as an integer and then translated into a single-character string.\nWhen an array of number or string values is passed in, then an array of\nsingle-character strings of the same length is returned.
\n",itemtype:"method",name:"char",return:{description:"string representation of value",type:"String"},class:"p5",module:"Data",submodule:"Conversion",overloads:[{line:171,params:[{name:"n",description:"value to parse
\n",type:"String|Number"}],return:{description:"string representation of value",type:"String"}},{line:182,params:[{name:"ns",description:"values to parse
\n",type:"Array"}],return:{description:"array of string representation of values",type:"String[]"}}]},{file:"src/utilities/conversion.js",line:204,description:"Converts a single-character string to its corresponding integer\nrepresentation. When an array of single-character string values is passed\nin, then an array of integers of the same length is returned.
\n",itemtype:"method",name:"unchar",return:{description:"integer representation of value",type:"Number"},class:"p5",module:"Data",submodule:"Conversion",overloads:[{line:204,params:[{name:"n",description:"value to parse
\n",type:"String"}],return:{description:"integer representation of value",type:"Number"}},{line:213,params:[{name:"ns",description:"values to parse
\n",type:"Array"}],return:{description:"integer representation of values",type:"Number[]"}}]},{file:"src/utilities/conversion.js",line:232,description:"Converts a number to a string in its equivalent hexadecimal notation. If a\nsecond parameter is passed, it is used to set the number of characters to\ngenerate in the hexadecimal notation. When an array is passed in, an\narray of strings in hexadecimal notation of the same length is returned.
\n",itemtype:"method",name:"hex",return:{description:"hexadecimal string representation of value",type:"String"},class:"p5",module:"Data",submodule:"Conversion",overloads:[{line:232,params:[{name:"n",description:"value to parse
\n",type:"Number"},{name:"digits",description:"",type:"Number",optional:!0}],return:{description:"hexadecimal string representation of value",type:"String"}},{line:243,params:[{name:"ns",description:"array of values to parse
\n",type:"Number[]"},{name:"digits",description:"",type:"Number",optional:!0}],return:{description:"hexadecimal string representation of values",type:"String[]"}}]},{file:"src/utilities/conversion.js",line:274,description:"Converts a string representation of a hexadecimal number to its equivalent\ninteger value. When an array of strings in hexadecimal notation is passed\nin, an array of integers of the same length is returned.
\n",itemtype:"method",name:"unhex",return:{description:"integer representation of hexadecimal value",type:"Number"},class:"p5",module:"Data",submodule:"Conversion",overloads:[{line:274,params:[{name:"n",description:"value to parse
\n",type:"String"}],return:{description:"integer representation of hexadecimal value",type:"Number"}},{line:283,params:[{name:"ns",description:"values to parse
\n",type:"Array"}],return:{description:"integer representations of hexadecimal value",type:"Number[]"}}]},{file:"src/utilities/string_functions.js",line:15,description:"Combines an array of Strings into one String, each separated by the\ncharacter(s) used for the separator parameter. To join arrays of ints or\nfloats, it's necessary to first convert them to Strings using nf() or\nnfs().
\n",itemtype:"method",name:"join",params:[{name:"list",description:"array of Strings to be joined
\n",type:"Array"},{name:"separator",description:"String to be placed between each item
\n",type:"String"}],return:{description:"joined String",type:"String"},example:['\n\n\nvar array = ["Hello", "world!"]\nvar separator = " "\nvar message = join(array, separator);\ntext(message, 5, 50);\n\n'],alt:'"hello world!" displayed middle left of canvas.',class:"p5",module:"Data",submodule:"String Functions"},{file:"src/utilities/string_functions.js",line:44,description:"This function is used to apply a regular expression to a piece of text,\nand return matching groups (elements found inside parentheses) as a\nString array. If there are no matches, a null value will be returned.\nIf no groups are specified in the regular expression, but the sequence\nmatches, an array of length 1 (with the matched text as the first element\nof the array) will be returned.\n
\nTo use the function, first check to see if the result is null. If the\nresult is null, then the sequence did not match at all. If the sequence\ndid match, an array is returned.\n
\nIf there are groups (specified by sets of parentheses) in the regular\nexpression, then the contents of each will be returned in the array.\nElement [0] of a regular expression match returns the entire matching\nstring, and the match groups start at element [1] (the first group is [1],\nthe second [2], and so on).
\n",itemtype:"method",name:"match",params:[{name:"str",description:"the String to be searched
\n",type:"String"},{name:"regexp",description:"the regexp to be used for matching
\n",type:"String"}],return:{description:"Array of Strings found",type:"String[]"},example:['\n\n\nvar string = "Hello p5js*!"\nvar regexp = "p5js\\\\*"\nvar match = match(string, regexp);\ntext(match, 5, 50);\n\n'],alt:'"p5js*" displayed middle left of canvas.',class:"p5",module:"Data",submodule:"String Functions"},{file:"src/utilities/string_functions.js",line:85,description:"This function is used to apply a regular expression to a piece of text,\nand return a list of matching groups (elements found inside parentheses)\nas a two-dimensional String array. If there are no matches, a null value\nwill be returned. If no groups are specified in the regular expression,\nbut the sequence matches, a two dimensional array is still returned, but\nthe second dimension is only of length one.\n
\nTo use the function, first check to see if the result is null. If the\nresult is null, then the sequence did not match at all. If the sequence\ndid match, a 2D array is returned.\n
\nIf there are groups (specified by sets of parentheses) in the regular\nexpression, then the contents of each will be returned in the array.\nAssuming a loop with counter variable i, element [i][0] of a regular\nexpression match returns the entire matching string, and the match groups\nstart at element [i][1] (the first group is [i][1], the second [i][2],\nand so on).
\n",itemtype:"method",name:"matchAll",params:[{name:"str",description:"the String to be searched
\n",type:"String"},{name:"regexp",description:"the regexp to be used for matching
\n",type:"String"}],return:{description:"2d Array of Strings found",type:"String[]"},example:['\n\n\nvar string = "Hello p5js*! Hello world!"\nvar regexp = "Hello"\nmatchAll(string, regexp);\n\n'],class:"p5",module:"Data",submodule:"String Functions"},{file:"src/utilities/string_functions.js",line:132,description:"Utility function for formatting numbers into strings. There are two\nversions: one for formatting floats, and one for formatting ints.\nThe values for the digits, left, and right parameters should always\nbe positive integers.
\n",itemtype:"method",name:"nf",return:{description:"formatted String",type:"String"},class:"p5",module:"Data",submodule:"String Functions",overloads:[{line:132,params:[{name:"num",description:"the Number to format
\n",type:"Number|String"},{name:"left",description:"number of digits to the left of the\n decimal point
\n",type:"Number|String",optional:!0},{name:"right",description:"number of digits to the right of the\n decimal point
\n",type:"Number|String",optional:!0}],return:{description:"formatted String",type:"String"}},{line:146,params:[{name:"nums",description:"the Numbers to format
\n",type:"Array"},{name:"left",description:"",type:"Number|String",optional:!0},{name:"right",description:"",type:"Number|String",optional:!0}],return:{description:"formatted Strings\\",type:"Array"}}]},{file:"src/utilities/string_functions.js",line:245,description:"Utility function for formatting numbers into strings and placing\nappropriate commas to mark units of 1000. There are two versions: one\nfor formatting ints, and one for formatting an array of ints. The value\nfor the right parameter should always be a positive integer.
\n",itemtype:"method",name:"nfc",return:{description:"formatted String",type:"String"},class:"p5",module:"Data",submodule:"String Functions",overloads:[{line:245,params:[{name:"num",description:"the Number to format
\n",type:"Number|String"},{name:"right",description:"number of digits to the right of the\n decimal point
\n",type:"Number|String",optional:!0}],return:{description:"formatted String",type:"String"}},{line:257,params:[{name:"nums",description:"the Numbers to format
\n",type:"Array"},{name:"right",description:"",type:"Number|String",optional:!0}],return:{description:"formatted Strings",type:"Array"}}]},{file:"src/utilities/string_functions.js",line:324,description:"Utility function for formatting numbers into strings. Similar to nf() but\nputs a "+" in front of positive numbers and a "-" in front of negative\nnumbers. There are two versions: one for formatting floats, and one for\nformatting ints. The values for left, and right parameters\nshould always be positive integers.
\n",itemtype:"method",name:"nfp",return:{description:"formatted String",type:"String"},class:"p5",module:"Data",submodule:"String Functions",overloads:[{line:324,params:[{name:"num",description:"the Number to format
\n",type:"Number"},{name:"left",description:"number of digits to the left of the decimal\n point
\n",type:"Number",optional:!0},{name:"right",description:"number of digits to the right of the\n decimal point
\n",type:"Number",optional:!0}],return:{description:"formatted String",type:"String"}},{line:339,params:[{name:"nums",description:"the Numbers to format
\n",type:"Number[]"},{name:"left",description:"",type:"Number",optional:!0},{name:"right",description:"",type:"Number",optional:!0}],return:{description:"formatted Strings",type:"String[]"}}]},{file:"src/utilities/string_functions.js",line:389,description:"Utility function for formatting numbers into strings. Similar to nf() but\nputs a " " (space) in front of positive numbers and a "-" in front of\nnegative numbers. There are two versions: one for formatting floats, and\none for formatting ints. The values for the digits, left, and right\nparameters should always be positive integers.
\n",itemtype:"method",name:"nfs",return:{description:"formatted String",type:"String"},class:"p5",module:"Data",submodule:"String Functions",overloads:[{line:389,params:[{name:"num",description:"the Number to format
\n",type:"Number"},{name:"left",description:"number of digits to the left of the decimal\n point
\n",type:"Number",optional:!0},{name:"right",description:"number of digits to the right of the\n decimal point
\n",type:"Number",optional:!0}],return:{description:"formatted String",type:"String"}},{line:404,params:[{name:"nums",description:"the Numbers to format
\n",type:"Array"},{name:"left",description:"",type:"Number",optional:!0},{name:"right",description:"",type:"Number",optional:!0}],return:{description:"formatted Strings",type:"Array"}}]},{file:"src/utilities/string_functions.js",line:454,description:"The split() function maps to String.split(), it breaks a String into\npieces using a character or string as the delimiter. The delim parameter\nspecifies the character or characters that mark the boundaries between\neach piece. A String[] array is returned that contains each of the pieces.
\nThe splitTokens() function works in a similar fashion, except that it\nsplits using a range of characters instead of a specific character or\nsequence.
\n",itemtype:"method",name:"split",params:[{name:"value",description:"the String to be split
\n",type:"String"},{name:"delim",description:"the String used to separate the data
\n",type:"String"}],return:{description:"Array of Strings",type:"String[]"},example:['\n\n\nvar names = "Pat,Xio,Alex"\nvar splitString = split(names, ",");\ntext(splitString[0], 5, 30);\ntext(splitString[1], 5, 50);\ntext(splitString[2], 5, 70);\n\n'],alt:'"pat" top left, "Xio" mid left and "Alex" displayed bottom left',class:"p5",module:"Data",submodule:"String Functions"},{file:"src/utilities/string_functions.js",line:488,description:"The splitTokens() function splits a String at one or many character\ndelimiters or "tokens." The delim parameter specifies the character or\ncharacters to be used as a boundary.\n
\nIf no delim characters are specified, any whitespace character is used to\nsplit. Whitespace characters include tab (\\t), line feed (\\n), carriage\nreturn (\\r), form feed (\\f), and space.
\n",itemtype:"method",name:"splitTokens",params:[{name:"value",description:"the String to be split
\n",type:"String"},{name:"delim",description:"list of individual Strings that will be used as\n separators
\n",type:"String",optional:!0}],return:{description:"Array of Strings",type:"String[]"},example:['\n\n\nfunction setup() {\n var myStr = "Mango, Banana, Lime";\n var myStrArr = splitTokens(myStr, ",");\n\n print(myStrArr); // prints : ["Mango"," Banana"," Lime"]\n}\n\n'],class:"p5",module:"Data",submodule:"String Functions"},{file:"src/utilities/string_functions.js",line:541,description:"Removes whitespace characters from the beginning and end of a String. In\naddition to standard whitespace characters such as space, carriage return,\nand tab, this function also removes the Unicode "nbsp" character.
\n",itemtype:"method",name:"trim",return:{description:"a trimmed String",type:"String"},class:"p5",module:"Data",submodule:"String Functions",overloads:[{line:541,params:[{name:"str",description:"a String to be trimmed
\n",type:"String"}],return:{description:"a trimmed String",type:"String"}},{line:550,params:[{name:"strs",description:"an Array of Strings to be trimmed
\n",type:"Array"}],return:{description:"an Array of trimmed Strings",type:"Array"}}]},{file:"src/utilities/time_date.js",line:12,description:"p5.js communicates with the clock on your computer. The day() function\nreturns the current day as a value from 1 - 31.
\n",itemtype:"method",name:"day",return:{description:"the current day",type:"Number"},example:['\n\n\nvar d = day();\ntext("Current day: \\n" + d, 5, 50);\n\n'],alt:"Current day is displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/utilities/time_date.js",line:34,description:"p5.js communicates with the clock on your computer. The hour() function\nreturns the current hour as a value from 0 - 23.
\n",itemtype:"method",name:"hour",return:{description:"the current hour",type:"Number"},example:['\n\n\nvar h = hour();\ntext("Current hour:\\n" + h, 5, 50);\n\n'],alt:"Current hour is displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/utilities/time_date.js",line:56,description:"p5.js communicates with the clock on your computer. The minute() function\nreturns the current minute as a value from 0 - 59.
\n",itemtype:"method",name:"minute",return:{description:"the current minute",type:"Number"},example:['\n\n\nvar m = minute();\ntext("Current minute: \\n" + m, 5, 50);\n\n'],alt:"Current minute is displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/utilities/time_date.js",line:78,description:"Returns the number of milliseconds (thousandths of a second) since\nstarting the program. This information is often used for timing events and\nanimation sequences.
\n",itemtype:"method",name:"millis",return:{description:"the number of milliseconds since starting the program",type:"Number"},example:['\n\n\nvar millisecond = millis();\ntext("Milliseconds \\nrunning: \\n" + millisecond, 5, 40);\n\n'],alt:"number of milliseconds since program has started displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/utilities/time_date.js",line:101,description:"p5.js communicates with the clock on your computer. The month() function\nreturns the current month as a value from 1 - 12.
\n",itemtype:"method",name:"month",return:{description:"the current month",type:"Number"},example:['\n\n\nvar m = month();\ntext("Current month: \\n" + m, 5, 50);\n\n'],alt:"Current month is displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/utilities/time_date.js",line:123,description:"p5.js communicates with the clock on your computer. The second() function\nreturns the current second as a value from 0 - 59.
\n",itemtype:"method",name:"second",return:{description:"the current second",type:"Number"},example:['\n\n\nvar s = second();\ntext("Current second: \\n" + s, 5, 50);\n\n'],alt:"Current second is displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/utilities/time_date.js",line:145,description:"p5.js communicates with the clock on your computer. The year() function\nreturns the current year as an integer (2014, 2015, 2016, etc).
\n",itemtype:"method",name:"year",return:{description:"the current year",type:"Number"},example:['\n\n\nvar y = year();\ntext("Current year: \\n" + y, 5, 50);\n\n'],alt:"Current year is displayed",class:"p5",module:"IO",submodule:"Time & Date"},{file:"src/webgl/camera.js",line:12,description:"Sets camera position for a 3D sketch. The function behaves similarly\ngluLookAt, except that it replaces the existing modelview matrix instead\nof applying any transformations calculated here on top of the existing\nmodel view.\nWhen called with no arguments, this function\nsets a default camera equivalent to calling\ncamera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0);
\n",itemtype:"method",name:"camera",params:[{name:"x",description:"camera position value on x axis
\n",type:"Number",optional:!0},{name:"y",description:"camera position value on y axis
\n",type:"Number",optional:!0},{name:"z",description:"camera position value on z axis
\n",type:"Number",optional:!0},{name:"centerX",description:"x coordinate representing center of the sketch
\n",type:"Number",optional:!0},{name:"centerY",description:"y coordinate representing center of the sketch
\n",type:"Number",optional:!0},{name:"centerZ",description:"z coordinate representing center of the sketch
\n",type:"Number",optional:!0},{name:"upX",description:"x component of direction 'up' from camera
\n",type:"Number",optional:!0},{name:"upY",description:"y component of direction 'up' from camera
\n",type:"Number",optional:!0},{name:"upZ",description:"z component of direction 'up' from camera
\n",type:"Number",optional:!0}],return:{description:"the p5 object",type:"P5"},example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n //move the camera away from the plane by a sin wave\n camera(0, 0, sin(frameCount * 0.01) * 100, 0, 0, 0, 0, 1, 0);\n plane(120, 120);\n}\n\n"],alt:"blue square shrinks in size grows to fill canvas. disappears then loops.",class:"p5",module:"Lights, Camera",submodule:"Camera"},{file:"src/webgl/camera.js",line:160,description:"Sets perspective camera. When called with no arguments, the defaults\nprovided are equivalent to\nperspective(PI/3.0, width/height, cameraZ/10.0, cameraZ10.0)\nwhere cameraZ is ((height/2.0) / tan(PI60.0/360.0));
\n",itemtype:"method",name:"perspective",params:[{name:"fovy",description:"camera frustum vertical field of view,\n from bottom to top of view, in degrees
\n",type:"Number",optional:!0},{name:"aspect",description:"camera frustum aspect ratio
\n",type:"Number",optional:!0},{name:"near",description:"frustum near plane length
\n",type:"Number",optional:!0},{name:"far",description:"frustum far plane length
\n",type:"Number",optional:!0}],return:{description:"the p5 object",type:"P5"},example:["\n\n\n//drag mouse to toggle the world!\n//you will see there's a vanish point\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n var fov = 60 / 180 * PI;\n var cameraZ = (height/2.0) / tan(fov/2.0);\n perspective(60 / 180 * PI, width/height, cameraZ * 0.1, cameraZ * 10);\n}\nfunction draw(){\n background(200);\n orbitControl();\n for(var i = -1; i < 2; i++){\n for(var j = -2; j < 3; j++){\n push();\n translate(i*160, 0, j*160);\n box(40, 40, 40);\n pop();\n }\n }\n}\n\n"],alt:"colored 3d boxes toggleable with mouse position",class:"p5",module:"Lights, Camera",submodule:"Camera"},{file:"src/webgl/camera.js",line:232,description:"Setup ortho camera
\n",itemtype:"method",name:"ortho",params:[{name:"left",description:"camera frustum left plane
\n",type:"Number"},{name:"right",description:"camera frustum right plane
\n",type:"Number"},{name:"bottom",description:"camera frustum bottom plane
\n",type:"Number"},{name:"top",description:"camera frustum top plane
\n",type:"Number"},{name:"near",description:"camera frustum near plane
\n",type:"Number"},{name:"far",description:"camera frustum far plane
\n",type:"Number"}],return:{description:"the p5 object",type:"P5"},example:["\n\n\n//drag mouse to toggle the world!\n//there's no vanish point\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n ortho(-width/2, width/2, height/2, -height/2, 0, 500);\n}\nfunction draw(){\n background(200);\n orbitControl();\n for(var i = -1; i < 2; i++){\n for(var j = -2; j < 3; j++){\n push();\n translate(i*160, 0, j*160);\n box(40, 40, 40);\n pop();\n }\n }\n}\n\n"],alt:"3 3d boxes, reveal several more boxes on 3d plane when mouse used to toggle",class:"p5",module:"Lights, Camera",submodule:"Camera"},{file:"src/webgl/light.js",line:12,description:"Creates an ambient light with a color
\n",itemtype:"method",name:"ambientLight",chainable:1,class:"p5",module:"Lights, Camera",submodule:"Lights",overloads:[{line:12,params:[{name:"v1",description:"red or hue value relative to\n the current color range
\n",type:"Number"},{name:"v2",description:"green or saturation value\n relative to the current color range
\n",type:"Number"},{name:"v3",description:"blue or brightness value\n relative to the current color range
\n",type:"Number"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1},{line:26,params:[{name:"value",description:"a color string
\n",type:"String"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1},{line:33,params:[{name:"values",description:"an array containing the red,green,blue &\n and alpha components of the color
\n",type:"Number[]"}],chainable:1},{line:40,params:[{name:"color",description:"the ambient light color
\n",type:"p5.Color"},{name:"alpha",description:"",type:"Number",optional:!0}],chainable:1}]},{file:"src/webgl/light.js",line:89,description:"Creates a directional light with a color and a direction
\n",itemtype:"method",name:"directionalLight",params:[{name:"v1",description:"gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",type:"Number|Array|String|p5.Color"},{name:"v2",description:"green or saturation value
\n",type:"Number",optional:!0},{name:"v3",description:"blue or brightness value
\n",type:"Number",optional:!0},{name:"a",description:"opacity
\n",type:"Number",optional:!0},{name:"x",description:"x axis direction or a p5.Vector
\n",type:"Number|p5.Vector"},{name:"y",description:"y axis direction
\n",type:"Number",optional:!0},{name:"z",description:"z axis direction
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n //move your mouse to change light direction\n var dirX = (mouseX / width - 0.5) *2;\n var dirY = (mouseY / height - 0.5) *(-2);\n directionalLight(250, 250, 250, dirX, dirY, 0.25);\n ambientMaterial(250);\n sphere(50);\n}\n\n"],alt:"light source on canvas changeable with mouse position",class:"p5",module:"Lights, Camera",submodule:"Lights"},{file:"src/webgl/light.js",line:168,description:"Creates a point light with a color and a light position
\n",itemtype:"method",name:"pointLight",params:[{name:"v1",description:"gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",type:"Number|Array|String|p5.Color"},{name:"v2",description:"green or saturation value
\n",type:"Number",optional:!0},{name:"v3",description:"blue or brightness value
\n",type:"Number",optional:!0},{name:"a",description:"opacity
\n",type:"Number",optional:!0},{name:"x",description:"x axis position or a p5.Vector
\n",type:"Number|p5.Vector"},{name:"y",description:"y axis position
\n",type:"Number",optional:!0},{name:"z",description:"z axis position
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n //move your mouse to change light position\n var locY = (mouseY / height - 0.5) *(-2);\n var locX = (mouseX / width - 0.5) *2;\n //to set the light position,\n //think of the world's coordinate as:\n // -1,1 -------- 1,1\n // | |\n // | |\n // | |\n // -1,-1---------1,-1\n pointLight(250, 250, 250, locX, locY, 0);\n ambientMaterial(250);\n sphere(50);\n}\n\n"],alt:"spot light on canvas changes position with mouse",class:"p5",module:"Lights, Camera",submodule:"Lights"},{file:"src/webgl/loading.js",line:14,description:"Load a 3d model from an OBJ file.\n
\nOne of the limitations of the OBJ format is that it doesn't have a built-in\nsense of scale. This means that models exported from different programs might\nbe very different sizes. If your model isn't displaying, try calling\nloadModel() with the normalized parameter set to true. This will resize the\nmodel to a scale appropriate for p5. You can also make additional changes to\nthe final size of your model with the scale() function.
\n",itemtype:"method",name:"loadModel",return:{description:"the p5.Geometry object",type:"p5.Geometry"},class:"p5",module:"Shape",submodule:"3D Models",overloads:[{line:14,params:[{name:"path",description:"Path of the model to be loaded
\n",type:"String"},{name:"normalize",
-description:"If true, scale the model to a\n standardized size when loading
\n",type:"Boolean"},{name:"successCallback",description:"Function to be called\n once the model is loaded. Will be passed\n the 3D model object.
\n",type:"function(p5.Geometry)",optional:!0},{name:"failureCallback",description:"called with event error if\n the image fails to load.
\n",type:"Function(Event)",optional:!0}],return:{description:"the p5.Geometry object",type:"p5.Geometry"}},{line:35,params:[{name:"path",description:"",type:"String"},{name:"successCallback",description:"",type:"function(p5.Geometry)",optional:!0},{name:"failureCallback",description:"",type:"Function(Event)",optional:!0}],return:{description:"the p5.Geometry object",type:"p5.Geometry"}}]},{file:"src/webgl/loading.js",line:98,description:"Parse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:
\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5
\nf 4 3 2 1
\n",class:"p5",module:"Shape",submodule:"3D Models"},{file:"src/webgl/loading.js",line:197,description:"Render a 3d model to the screen.
\n",itemtype:"method",name:"model",params:[{name:"model",description:"Loaded 3d model to be rendered
\n",type:"p5.Geometry"}],example:["\n\n\n//draw a spinning teapot\nvar teapot;\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n\n teapot = loadModel('assets/teapot.obj');\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n model(teapot);\n}\n\n"],alt:"Vertically rotating 3-d teapot with red, green and blue gradient.",class:"p5",module:"Shape",submodule:"3D Models"},{file:"src/webgl/material.js",line:15,description:"Loads a custom shader from the provided vertex and fragment\nshader paths. The shader files are loaded asynchronously in the\nbackground, so this method should be used in preload().
\nFor now, there are three main types of shaders. p5 will automatically\nsupply appropriate vertices, normals, colors, and lighting attributes\nif the parameters defined in the shader match the names.
\n",itemtype:"method",name:"loadShader",params:[{name:"vertFilename",description:"path to file containing vertex shader\nsource code
\n",type:"String",optional:!0},{name:"fragFilename",description:"path to file containing fragment shader\nsource code
\n",type:"String",optional:!0}],return:{description:"a shader object created from the provided\nvertex and fragment shader files.",type:"p5.Shader"},class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/material.js",line:58,description:"The shader() function lets the user provide a custom shader\nto fill in shapes in WEBGL mode. Users can create their\nown shaders by loading vertex and fragment shaders with\nloadShader().
\n",itemtype:"method",name:"shader",chainable:1,params:[{name:"s",description:"the desired p5.Shader to use for rendering\nshapes.
\n",type:"p5.Shader",optional:!0}],class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/material.js",line:81,description:'Normal material for geometry. You can view all\npossible materials in this\nexample.
\n',itemtype:"method",name:"normalMaterial",chainable:1,example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n normalMaterial();\n sphere(50);\n}\n\n"],alt:"Red, green and blue gradient.",class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/material.js",line:113,description:'Texture for geometry. You can view other possible materials in this\nexample.
\n',itemtype:"method",name:"texture",params:[{name:"tex",description:"2-dimensional graphics\n to render as texture
\n",type:"p5.Image|p5.MediaElement|p5.Graphics"}],chainable:1,example:['\n\n\nvar img;\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n img = loadImage("assets/laDefense.jpg");\n}\n\nfunction draw(){\n background(0);\n rotateZ(frameCount * 0.01);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n //pass image as texture\n texture(img);\n box(200, 200, 200);\n}\n\n\n\n\n\nvar pg;\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n pg = createGraphics(200, 200);\n pg.textSize(100);\n}\n\nfunction draw(){\n background(0);\n pg.background(255);\n pg.text(\'hello!\', 0, 100);\n //pass image as texture\n texture(pg);\n plane(200);\n}\n\n\n\n\n\nvar vid;\nfunction preload(){\n vid = createVideo("assets/fingers.mov");\n vid.hide();\n vid.loop();\n}\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(0);\n //pass video frame as texture\n texture(vid);\n plane(200);\n}\n\n'],alt:"Rotating view of many images umbrella and grid roof on a 3d plane\nblack canvas\nblack canvas",class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/material.js",line:210,description:'Ambient material for geometry with a given color. You can view all\npossible materials in this\nexample.
\n',itemtype:"method",name:"ambientMaterial",params:[{name:"v1",description:"gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",type:"Number|Array|String|p5.Color"},{name:"v2",description:"green or saturation value
\n",type:"Number",optional:!0},{name:"v3",description:"blue or brightness value
\n",type:"Number",optional:!0},{name:"a",description:"opacity
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n ambientLight(100);\n pointLight(250, 250, 250, 100, 100, 0);\n ambientMaterial(250);\n sphere(50);\n}\n\n"],alt:"radiating light source from top right of canvas",class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/material.js",line:253,description:'Specular material for geometry with a given color. You can view all\npossible materials in this\nexample.
\n',itemtype:"method",name:"specularMaterial",params:[{name:"v1",description:"gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",type:"Number|Array|String|p5.Color"},{name:"v2",description:"green or saturation value
\n",type:"Number",optional:!0},{name:"v3",description:"blue or brightness value
\n",type:"Number",optional:!0},{name:"a",description:"opacity
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\nfunction draw(){\n background(0);\n ambientLight(100);\n pointLight(250, 250, 250, 100, 100, 0);\n specularMaterial(250);\n sphere(50);\n}\n\n"],alt:"diffused radiating light source from top right of canvas",class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/material.js",line:297,access:"private",tagname:"blends colors according to color components.\nIf alpha value is less than 1, we need to enable blending\non our gl context. Otherwise opaque objects need to a depthMask.",params:[{name:"v1",description:"[description]
\n",type:"Number"},{name:"v2",description:"[description]
\n",type:"Number"},{name:"v3",description:"[description]
\n",type:"Number"},{name:"a",description:"[description]
\n",type:"Number"}],return:{description:"Normalized numbers array",type:"[Number]"},class:"p5",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/p5.Geometry.js",line:86,description:"computes smooth normals per vertex as an average of each\nface.
\n",chainable:1,class:"p5.Geometry",module:"Lights, Camera"},{file:"src/webgl/p5.Geometry.js",line:111,description:"Averages the vertex normals. Used in curved\nsurfaces
\n",chainable:1,class:"p5.Geometry",module:"Lights, Camera"},{file:"src/webgl/p5.Geometry.js",line:130,description:"Averages pole normals. Used in spherical primitives
\n",chainable:1,class:"p5.Geometry",module:"Lights, Camera"},{file:"src/webgl/p5.Geometry.js",line:161,description:"Create a 2D array for establishing stroke connections
\n",return:{description:"",type:"p5.Geometry"},class:"p5.Geometry",module:"Lights, Camera"},{file:"src/webgl/p5.Geometry.js",line:182,description:"Create 4 vertices for each stroke line, two at the beginning position\nand two at the end position. These vertices are displaced relative to\nthat line's normal on the GPU
\n",return:{description:"",type:"p5.Geometry"},class:"p5.Geometry",module:"Lights, Camera"},{file:"src/webgl/p5.Geometry.js",line:209,description:"Modifies all vertices to be centered within the range -100 to 100.
\n",chainable:1,class:"p5.Geometry",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:1,requires:["constants"],todo:["see methods below needing further implementation.\nfuture consideration: implement SIMD optimizations\nwhen browser compatibility becomes available\nhttps://developer.mozilla.org/en-US/docs/Web/JavaScript/\n Reference/Global_Objects/SIMD"],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:19,description:"A class to describe a 4x4 matrix\nfor model and view matrix manipulation in the p5js webgl renderer.\nclass p5.Matrix
\n",is_constructor:1,params:[{name:"mat4",description:"array literal of our 4x4 matrix
\n",type:"Array",optional:!0}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:75,description:"Sets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Matrix, or the values from a float array.
\n",params:[{name:"inMatrix",description:"the input p5.Matrix or\n an Array of length 16
\n",type:"p5.Matrix|Float32Array|Array",optional:!0},{name:"n00..n33",description:"16 numbers passed by value to avoid\n array copying.
\n",type:"Number",optional:!0}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:113,description:"Gets a copy of the vector, returns a p5.Matrix object.
\n",return:{description:"the copy of the p5.Matrix object",type:"p5.Matrix"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:122,description:"return a copy of a matrix
\n",return:{description:"the result matrix",type:"p5.Matrix"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:147,description:"return an identity matrix
\n",return:{description:"the result matrix",type:"p5.Matrix"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:155,description:"transpose according to a given matrix
\n",params:[{name:"a",description:"the matrix to be based on to transpose
\n",type:"p5.Matrix|Float32Array|Array"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:215,description:"invert matrix according to a give matrix
\n",params:[{name:"a",description:"the matrix to be based on to invert
\n",type:"p5.Matrix|Float32Array|Array"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:300,description:"Inverts a 3x3 matrix
\n",chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:336,description:"transposes a 3x3 p5.Matrix by a mat3
\n",params:[{name:"mat3",description:"1-dimensional array
\n",type:"[Number]"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:352,description:"converts a 4x4 matrix to its 3x3 inverse tranform\ncommonly used in MVMatrix to NMatrix conversions.
\n",params:[{name:"mat4",description:"the matrix to be based on to invert
\n",type:"p5.Matrix"}],chainable:1,todo:["finish implementation"],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:380,description:"inspired by Toji's mat4 determinant
\n",return:{description:"Determinant of our 4x4 matrix",type:"Number"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:403,description:"multiply two mat4s
\n",params:[{name:"multMatrix",description:"The matrix\n we want to multiply by
\n",type:"p5.Matrix|Float32Array|Array"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:460,description:"scales a p5.Matrix by scalars or a vector
\n",params:[{name:"s",description:"vector to scale by
\n",type:"p5.Vector|Float32Array|Array"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:505,description:"rotate our Matrix around an axis by the given angle.
\n",params:[{name:"a",description:"The angle of rotation in radians
\n",type:"Number"},{name:"axis",description:"the axis(es) to rotate around
\n",type:"p5.Vector|Array"}],chainable:"inspired by Toji's gl-matrix lib, mat4 rotation",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:584,todo:["finish implementing this method!\ntranslates"],params:[{name:"v",description:"vector to translate by
\n",type:"Number[]"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:614,description:"sets the perspective matrix
\n",params:[{name:"fovy",description:"[description]
\n",type:"Number"},{name:"aspect",description:"[description]
\n",type:"Number"},{name:"near",description:"near clipping plane
\n",type:"Number"},{name:"far",description:"far clipping plane
\n",type:"Number"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:648,description:"sets the ortho matrix
\n",params:[{name:"left",description:"[description]
\n",type:"Number"},{name:"right",description:"[description]
\n",type:"Number"},{name:"bottom",description:"[description]
\n",type:"Number"},{name:"top",description:"[description]
\n",type:"Number"},{name:"near",description:"near clipping plane
\n",type:"Number"},{name:"far",description:"far clipping plane
\n",type:"Number"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Matrix.js",line:683,description:"PRIVATE
\n",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Immediate.js",line:1,description:"Welcome to RendererGL Immediate Mode.\nImmediate mode is used for drawing custom shapes\nfrom a set of vertices. Immediate Mode is activated\nwhen you call beginShape() & de-activated when you call endShape().\nImmediate mode is a style of programming borrowed\nfrom OpenGL's (now-deprecated) immediate mode.\nIt differs from p5.js' default, Retained Mode, which caches\ngeometries and buffers on the CPU to reduce the number of webgl\ndraw calls. Retained mode is more efficient & performative,\nhowever, Immediate Mode is useful for sketching quick\ngeometric ideas.
\n",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Immediate.js",line:19,description:"Begin shape drawing. This is a helpful way of generating\ncustom shapes quickly. However in WEBGL mode, application\nperformance will likely drop as a result of too many calls to\nbeginShape() / endShape(). As a high performance alternative,\nplease use p5.js geometry primitives.
\n",params:[{name:"mode",description:"webgl primitives mode. beginShape supports the\n following modes:\n POINTS,LINES,LINE_STRIP,LINE_LOOP,TRIANGLES,\n TRIANGLE_STRIP,and TRIANGLE_FAN.
\n",type:"Number"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Immediate.js",line:60,description:"adds a vertex to be drawn in a custom Shape.
\n",params:[{name:"x",description:"x-coordinate of vertex
\n",type:"Number"},{name:"y",description:"y-coordinate of vertex
\n",type:"Number"},{name:"z",description:"z-coordinate of vertex
\n",type:"Number"}],chainable:1,todo:["implement handling of p5.Vector args"],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Immediate.js",line:103,description:"End shape drawing and render vertices to screen.
\n",chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Retained.js",line:8,description:"initializes buffer defaults. runs each time a new geometry is\nregistered
\n",params:[{name:"gId",description:"key of the geometry object
\n",type:"String"}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Retained.js",line:33,description:"createBuffers description
\n",params:[{name:"gId",description:"key of the geometry object
\n",type:"String"},{name:"obj",description:"contains geometry data
\n",type:"p5.Geometry"}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.Retained.js",line:84,description:"Draws buffers given a geometry key ID
\n",params:[{name:"gId",description:"ID in our geom hash
\n",type:"String"}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:69,description:"model view, projection, & normal\nmatrices
\n",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:184,description:"Set attributes for the WebGL Drawing context.\n This is a way of adjusting ways that the WebGL\n renderer works to fine-tune the display and performance.\n This should be put in setup().\n The available attributes are:\n
\n alpha - indicates if the canvas contains an alpha buffer\n default is true\n
\n depth - indicates whether the drawing buffer has a depth buffer\n of at least 16 bits - default is true\n
\n stencil - indicates whether the drawing buffer has a stencil buffer\n of at least 8 bits\n
\n antialias - indicates whether or not to perform anti-aliasing\n default is false\n
\n premultipliedAlpha - indicates that the page compositor will assume\n the drawing buffer contains colors with pre-multiplied alpha\n default is false\n
\n preserveDrawingBuffer - if true the buffers will not be cleared and\n and will preserve their values until cleared or overwritten by author\n (note that p5 clears automatically on draw loop)\n default is true\n
\n\n \n function setup() {\n createCanvas(150,150,WEBGL);\n }\n function draw() {\n background(255);\n push();\n rotateZ(frameCount 0.02);\n rotateX(frameCount 0.02);\n rotateY(frameCount 0.02);\n fill(0,0,0);\n box(50);\n pop();\n }\n \n \n
\n Now with the antialias attribute set to true.\n
\n \n \n function setup() {\n createCanvas(150,150,WEBGL);\n setAttributes('antialias', true);\n }\n function draw() {\n background(255);\n push();\n rotateZ(frameCount 0.02);\n rotateX(frameCount 0.02);\n rotateY(frameCount 0.02);\n fill(0,0,0);\n box(50);\n pop();\n }\n \n ",itemtype:"method",name:"setAttributes",params:[{name:"String",description:"name of attribute or object with key-value pairs
\n",type:"String|Object"},{name:"New",description:"value of named attribute
\n",type:"Boolean"}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:331,description:"[background description]
\n",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:352,description:"Basic fill material for geometry with a given color
\n",itemtype:"method",name:"fill",params:[{name:"v1",description:"gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",type:"Number|Array|String|p5.Color"},{name:"v2",description:"green or saturation value
\n",type:"Number",optional:!0},{name:"v3",description:"blue or brightness value
\n",type:"Number",optional:!0},{name:"a",description:"opacity
\n",type:"Number",optional:!0}],return:{description:"the p5 object",type:"P5"},example:["\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n noStroke();\n fill(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"],alt:"black canvas with purple cube spinning",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:400,description:"Does not render fill material
\n",itemtype:"method",name:"noFill",example:["\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n noFill();\n stroke(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"],alt:"black canvas with purple cube wireframe spinning",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:431,description:"Does not render stroke
\n",itemtype:"method",name:"noStroke",example:["\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n noStroke();\n fill(240, 150, 150);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"],alt:"black canvas with pink cube spinning",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:460,description:"Basic stroke material for geometry with a given color
\n",itemtype:"method",name:"stroke",params:[{name:"v1",description:"gray value,\nred or hue value (depending on the current color mode),\nor color Array, or CSS color string
\n",type:"Number|Array|String|p5.Color"},{name:"v2",description:"green or saturation value
\n",type:"Number",optional:!0},{name:"v3",description:"blue or brightness value
\n",type:"Number",optional:!0},{name:"a",description:"opacity
\n",type:"Number",optional:!0}],example:["\n\n\nfunction setup(){\n createCanvas(200, 200, WEBGL);\n}\n\nfunction draw(){\n background(0);\n stroke(240, 150, 150);\n fill(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(75, 75, 75);\n}\n\n"],alt:"black canvas with purple cube with pink outline spinning",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:505,description:"Change weight of stroke
\n",itemtype:"method",name:"strokeWeight",params:[{name:"stroke",description:"weight to be used for drawing
\n",type:"Number"}],example:["\n\n\nfunction setup(){\n createCanvas(200, 400, WEBGL);\n setAttributes('antialias', true);\n}\n\nfunction draw(){\n background(0);\n noStroke();\n translate(0,-100,0);\n stroke(240,150,150);\n fill(100,100,240);\n push();\n strokeWeight(8);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n sphere(75);\n pop();\n push();\n translate(0,200,0);\n strokeWeight(1);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n sphere(75);\n pop();\n}\n\n\n"],alt:"black canvas with two purple rotating spheres with pink\noutlines the sphere on top has much heavier outlines,",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:569,description:"Returns an array of [R,G,B,A] values for any pixel or grabs a section of\nan image. If no parameters are specified, the entire image is returned.\nUse the x and y parameters to get the value of one pixel. Get a section of\nthe display window by specifying additional w and h parameters. When\ngetting an image, the x and y parameters define the coordinates for the\nupper-left corner of the image, regardless of the current imageMode().\n
\nIf the pixel requested is outside of the image window, [0,0,0,255] is\nreturned.\n
\nGetting the color of a single pixel with get(x, y) is easy, but not as fast\nas grabbing the data directly from pixels[]. The equivalent statement to\nget(x, y) is using pixels[] with pixel density d
\n",itemtype:"method",name:"get",params:[{name:"x",description:"x-coordinate of the pixel
\n",type:"Number",optional:!0},{name:"y",description:"y-coordinate of the pixel
\n",type:"Number",optional:!0},{name:"w",description:"width
\n",type:"Number",optional:!0},{name:"h",description:"height
\n",type:"Number",optional:!0}],return:{description:"color of pixel at x,y in array format\n [R, G, B, A] or p5.Image",type:"Array|Color|p5.Image"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:597,description:"Loads the pixels data for this canvas into the pixels[] attribute.\nNote that updatePixels() and set() do not work.\nAny pixel manipulation must be done directly to the pixels[] array.
\n",itemtype:"method",name:"loadPixels",params:[{name:"x",description:"starting pixel x position, defaults to 0
\n",type:"Number",optional:!0},{name:"y",description:"starting pixel y position, defaults to 0
\n",type:"Number",optional:!0},{name:"w",description:"width of pixels to load, defaults to sketch width
\n",type:"Number",optional:!0},{name:"h",description:"height of pixels to load, defaults to sketch height
\n",type:"Number",optional:!0}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:642,description:"[resize description]
\n",params:[{name:"w",description:"[description]
\n",type:"Number"},{name:"h",description:"[description]
\n",type:"Number"}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:659,description:"clears color and depth buffers\nwith r,g,b,a
\n",params:[{name:"r",description:"normalized red val.
\n",type:"Number"},{name:"g",description:"normalized green val.
\n",type:"Number"},{name:"b",description:"normalized blue val.
\n",type:"Number"},{name:"a",description:"normalized alpha val.
\n",type:"Number"}],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:675,description:"[translate description]
\n",params:[{name:"x",description:"[description]
\n",type:"Number"},{name:"y",description:"[description]
\n",type:"Number"},{name:"z",description:"[description]
\n",type:"Number"}],chainable:1,todo:["implement handle for components or vector as args"],class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:693,description:"Scales the Model View Matrix by a vector
\n",params:[{name:"x",description:"[description]
\n",type:"Number | p5.Vector | Array"},{name:"y",description:"y-axis scalar
\n",type:"Number",optional:!0},{name:"z",description:"z-axis scalar
\n",type:"Number",optional:!0}],chainable:1,class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:725,description:"pushes a copy of the model view matrix onto the\nMV Matrix stack.
\n",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:734,description:"[pop description]
\n",class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:904,description:"turn a two dimensional array into one dimensional array
\n",params:[{name:"arr",description:"2-dimensional array
\n",type:"Array"}],return:{description:"1-dimensional array\n[[1, 2, 3],[4, 5, 6]] -> [1, 2, 3, 4, 5, 6]",type:"Array"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.RendererGL.js",line:918,description:"turn a p5.Vector Array into a one dimensional number array
\n",params:[{name:"arr",description:"an array of p5.Vector
\n",type:"Array"}],return:{description:"a one dimensional array of numbers\n[p5.Vector(1, 2, 3), p5.Vector(4, 5, 6)] ->\n[1, 2, 3, 4, 5, 6]",type:"Array]"},class:"p5.RendererGL",module:"Lights, Camera"},{file:"src/webgl/p5.Shader.js",line:40,description:"Creates, compiles, and links the shader based on its\nsources for the vertex and fragment shaders (provided\nto the constructor). Populates known attributes and\nuniforms from the shader.
\n",itemtype:"method",name:"init",chainable:1,access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:98,description:"Queries the active attributes for this shader and loads\ntheir names and locations into the attributes array.
\n",itemtype:"method",name:"_loadAttributes",access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:130,description:"Queries the active uniforms for this shader and loads\ntheir names and locations into the uniforms array.
\n",itemtype:"method",name:"_loadUniforms",access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:179,description:"initializes (if needed) and binds the shader program.
\n",itemtype:"method",name:"bindShader",access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:202,itemtype:"method",name:"unbindShader",chainable:1,access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:253,itemtype:"method",name:"useProgram",chainable:1,access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:264,description:"Wrapper around gl.uniform functions.\nAs we store uniform info in the shader we can use that\nto do type checking on the supplied data and call\nthe appropriate function.
\n",itemtype:"method",name:"setUniform",chainable:1,params:[{name:"uniformName",description:"the name of the uniform in the\nshader program
\n",type:"String"},{name:"data",description:"the data to be associated with that uniform; type\nvaries (could be a single numerical value, array, matrix, or\ntexture / sampler reference)
\n",type:"Object"}],class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Shader.js",line:394,itemtype:"method",name:"enableAttrib",chainable:1,access:"private",tagname:"",class:"p5.Shader",module:"Lights, Camera",submodule:"Shaders"},{file:"src/webgl/p5.Texture.js",line:66,description:"Initializes common texture parameters, creates a gl texture,\ntries to upload the texture for the first time if data is\nalready available.
\n",access:"private",tagname:"",itemtype:"method",name:"init",class:"p5.Texture",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/p5.Texture.js",line:98,description:"Checks if the source data for this texture has changed (if it's\neasy to do so) and reuploads the texture if necessary. If it's not\npossible or to expensive to do a calculation to determine wheter or\nnot the data has occurred, this method simply re-uploads the texture.
\n",itemtype:"method",name:"update",class:"p5.Texture",module:"Lights, Camera",submodule:"Material"},{
-file:"src/webgl/p5.Texture.js",line:185,description:"Binds the texture to the appropriate GL target.
\n",itemtype:"method",name:"bindTexture",class:"p5.Texture",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/p5.Texture.js",line:199,description:"Unbinds the texture from the appropriate GL target.
\n",itemtype:"method",name:"unbindTexture",class:"p5.Texture",module:"Lights, Camera",submodule:"Material"},{file:"src/webgl/primitives.js",line:13,description:"Draw a plane with given a width and height
\n",itemtype:"method",name:"plane",params:[{name:"width",description:"width of the plane
\n",type:"Number"},{name:"height",description:"height of the plane
\n",type:"Number"},{name:"detailX",description:"Optional number of triangle\n subdivisions in x-dimension
\n",type:"Number",optional:!0},{name:"detailY",description:"Optional number of triangle\n subdivisions in y-dimension
\n",type:"Number",optional:!0}],return:{description:"the p5 object",type:"P5"},example:["\n\n\n//draw a plane with width 200 and height 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n plane(50, 50);\n}\n\n"],alt:"Nothing displayed on canvas\nRotating interior view of a box with sides that change color.\n3d red and green gradient.\nRotating interior view of a cylinder with sides that change color.\nRotating view of a cylinder with sides that change color.\n3d red and green gradient.\nrotating view of a multi-colored cylinder with concave sides.",class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:93,description:"Draw a box with given width, height and depth
\n",itemtype:"method",name:"box",params:[{name:"width",description:"width of the box
\n",type:"Number"},{name:"Height",description:"height of the box
\n",type:"Number",optional:!0},{name:"depth",description:"depth of the box
\n",type:"Number",optional:!0},{name:"detailX",description:"Optional number of triangle\n subdivisions in x-dimension
\n",type:"Number",optional:!0},{name:"detailY",description:"Optional number of triangle\n subdivisions in y-dimension
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\n//draw a spinning box with width, height and depth 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(200, 200, 200);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:190,description:"Draw a sphere with given radius
\n",itemtype:"method",name:"sphere",params:[{name:"radius",description:"radius of circle
\n",type:"Number"},{name:"detailX",description:"number of segments,\n the more segments the smoother geometry\n default is 24
\n",type:"Number",optional:!0},{name:"detailY",description:"number of segments,\n the more segments the smoother geometry\n default is 16
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\n// draw a sphere with radius 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n sphere(50);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:265,access:"private",tagname:"helper function for creating both cones and cyllinders",class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:343,description:"Draw a cylinder with given radius and height
\n",itemtype:"method",name:"cylinder",params:[{name:"radius",description:"radius of the surface
\n",type:"Number"},{name:"height",description:"height of the cylinder
\n",type:"Number"},{name:"detailX",description:"number of segments,\n the more segments the smoother geometry\n default is 24
\n",type:"Number",optional:!0},{name:"detailY",description:"number of segments in y-dimension,\n the more segments the smoother geometry\n default is 16
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\n//draw a spinning cylinder with radius 200 and height 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cylinder(200, 200);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:409,description:"Draw a cone with given radius and height
\n",itemtype:"method",name:"cone",params:[{name:"radius",description:"radius of the bottom surface
\n",type:"Number"},{name:"height",description:"height of the cone
\n",type:"Number"},{name:"detailX",description:"number of segments,\n the more segments the smoother geometry\n default is 24
\n",type:"Number",optional:!0},{name:"detailY",description:"number of segments,\n the more segments the smoother geometry\n default is 16
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\n//draw a spinning cone with radius 200 and height 200\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cone(200, 200);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:475,description:"Draw an ellipsoid with given radius
\n",itemtype:"method",name:"ellipsoid",params:[{name:"radiusx",description:"xradius of circle
\n",type:"Number"},{name:"radiusy",description:"yradius of circle
\n",type:"Number"},{name:"radiusz",description:"zradius of circle
\n",type:"Number"},{name:"detailX",description:"number of segments,\n the more segments the smoother geometry\n default is 24. Avoid detail number above\n 150, it may crash the browser.
\n",type:"Number",optional:!0},{name:"detailY",description:"number of segments,\n the more segments the smoother geometry\n default is 16. Avoid detail number above\n 150, it may crash the browser.
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\n// draw an ellipsoid with radius 20, 30 and 40.\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n ellipsoid(20, 30, 40);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:556,description:"Draw a torus with given radius and tube radius
\n",itemtype:"method",name:"torus",params:[{name:"radius",description:"radius of the whole ring
\n",type:"Number"},{name:"tubeRadius",description:"radius of the tube
\n",type:"Number"},{name:"detailX",description:"number of segments in x-dimension,\n the more segments the smoother geometry\n default is 24
\n",type:"Number",optional:!0},{name:"detailY",description:"number of segments in y-dimension,\n the more segments the smoother geometry\n default is 16
\n",type:"Number",optional:!0}],chainable:1,example:["\n\n\n//draw a spinning torus with radius 200 and tube radius 60\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n torus(200, 60);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"src/webgl/primitives.js",line:860,description:"Draw a line given two points
\n",params:[{name:"x0",description:"x-coordinate of first vertex
\n",type:"Number"},{name:"y0",description:"y-coordinate of first vertex
\n",type:"Number"},{name:"z0",description:"z-coordinate of first vertex
\n",type:"Number"},{name:"x1",description:"x-coordinate of second vertex
\n",type:"Number"},{name:"y1",description:"y-coordinate of second vertex
\n",type:"Number"},{name:"z1",description:"z-coordinate of second vertex
\n",type:"Number"}],chainable:1,example:["\n\n\n//draw a line\nfunction setup(){\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw(){\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n // Use fill instead of stroke to change the color of shape.\n fill(255, 0, 0);\n line(10, 10, 0, 60, 60, 20);\n}\n\n"],class:"p5",module:"Shape",submodule:"3D Primitives"},{file:"lib/addons/p5.dom.js",line:41,description:"Searches the page for an element with the given ID, class, or tag name (using the '#' or '.'\nprefixes to specify an ID or class respectively, and none for a tag) and returns it as\na p5.Element. If a class or tag name is given with more than 1 element,\nonly the first element will be returned.\nThe DOM node itself can be accessed with .elt.\nReturns null if none found. You can also specify a container to search within.
\n",itemtype:"method",name:"select",params:[{name:"name",description:"id, class, or tag name of element to search for
\n",type:"String"},{name:"container",description:"id, p5.Element, or HTML element to search within
\n",type:"String",optional:!0}],return:{description:"p5.Element containing node found",type:"Object|p5.Element|Null"},example:["\n\nfunction setup() {\n createCanvas(100,100);\n //translates canvas 50px down\n select('canvas').position(100, 100);\n}\n\n\n// these are all valid calls to select()\nvar a = select('#moo');\nvar b = select('#blah', '#myContainer');\nvar c = select('#foo', b);\nvar d = document.getElementById('beep');\nvar e = select('p', d);\n\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:100,description:"Searches the page for elements with the given class or tag name (using the '.' prefix\nto specify a class and no prefix for a tag) and returns them as p5.Elements\nin an array.\nThe DOM node itself can be accessed with .elt.\nReturns an empty array if none found.\nYou can also specify a container to search within.
\n",itemtype:"method",name:"selectAll",params:[{name:"name",description:"class or tag name of elements to search for
\n",type:"String"},{name:"container",description:"id, p5.Element, or HTML element to search within
\n",type:"String",optional:!0}],return:{description:"Array of p5.Elements containing nodes found",type:"Array"},example:["\n\nfunction setup() {\n createButton('btn');\n createButton('2nd btn');\n createButton('3rd btn');\n var buttons = selectAll('button');\n\n for (var i = 0; i < buttons.length; i++){\n buttons[i].size(100,100);\n }\n}\n\n\n// these are all valid calls to selectAll()\nvar a = selectAll('.moo');\nvar b = selectAll('div');\nvar c = selectAll('button', '#myContainer');\nvar d = select('#container');\nvar e = selectAll('p', d);\nvar f = document.getElementById('beep');\nvar g = select('.blah', f);\n\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:156,description:"Helper function for select and selectAll
\n",class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:172,description:"Helper function for getElement and getElements.
\n",class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:199,description:"Removes all elements created by p5, except any canvas / graphics\nelements created by createCanvas or createGraphics.\nEvent handlers are removed, and element is removed from the DOM.
\n",itemtype:"method",name:"removeElements",example:["\n\nfunction setup() {\n createCanvas(100, 100);\n createDiv('this is some text');\n createP('this is a paragraph');\n}\nfunction mousePressed() {\n removeElements(); // this will remove the div and p, not canvas\n}\n\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:225,description:"Helpers for create methods.
\n",class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:236,description:"Creates a <div></div> element in the DOM with given inner HTML.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createDiv",params:[{name:"html",description:"inner HTML for element created
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar myDiv;\nfunction setup() {\n myDiv = createDiv('this is some text');\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:253,description:"Creates a <p></p> element in the DOM with given inner HTML. Used\nfor paragraph length text.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createP",params:[{name:"html",description:"inner HTML for element created
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar myP;\nfunction setup() {\n myP = createP('this is some text');\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:271,description:"Creates a <span></span> element in the DOM with given inner HTML.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createSpan",params:[{name:"html",description:"inner HTML for element created
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar mySpan;\nfunction setup() {\n mySpan = createSpan('this is some text');\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:297,description:"Creates an <img> element in the DOM with given src and\nalternate text.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createImg",params:[{name:"src",description:"src path or url for image
\n",type:"String"},{name:"alt",description:"alternate text to be used if image does not load
\n",type:"String",optional:!0},{name:"successCallback",description:"callback to be called once image data is loaded
\n",type:"Function",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar img;\nfunction setup() {\n img = createImg('http://p5js.org/img/asterisk-01.png');\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:342,description:"Creates an <a></a> element in the DOM for including a hyperlink.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createA",params:[{name:"href",description:"url of page to link to
\n",type:"String"},{name:"html",description:"inner html of link element to display
\n",type:"String"},{name:"target",description:"target where new link should open,\n could be _blank, _self, _parent, _top.
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar myLink;\nfunction setup() {\n myLink = createA('http://p5js.org/', 'this is a link');\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:369,class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:372,description:"Creates a slider <input></input> element in the DOM.\nUse .size() to set the display length of the slider.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createSlider",params:[{name:"min",description:"minimum value of the slider
\n",type:"Number"},{name:"max",description:"maximum value of the slider
\n",type:"Number"},{name:"value",description:"default value of the slider
\n",type:"Number",optional:!0},{name:"step",description:"step size for each tick of the slider (if step is set to 0, the slider will move continuously from the minimum to the maximum value)
\n",type:"Number",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar slider;\nfunction setup() {\n slider = createSlider(0, 255, 100);\n slider.position(10, 10);\n slider.style('width', '80px');\n}\n\nfunction draw() {\n var val = slider.value();\n background(val);\n}\n\n\n\nvar slider;\nfunction setup() {\n colorMode(HSB);\n slider = createSlider(0, 360, 60, 40);\n slider.position(10, 10);\n slider.style('width', '80px');\n}\n\nfunction draw() {\n var val = slider.value();\n background(val, 100, 100, 1);\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:428,description:"Creates a <button></button> element in the DOM.\nUse .size() to set the display size of the button.\nUse .mousePressed() to specify behavior on press.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createButton",params:[{name:"label",description:"label displayed on the button
\n",type:"String"},{name:"value",description:"value of the button
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar button;\nfunction setup() {\n createCanvas(100, 100);\n background(0);\n button = createButton('click me');\n button.position(19, 19);\n button.mousePressed(changeBG);\n}\n\nfunction changeBG() {\n var val = random(255);\n background(val);\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:463,description:"Creates a checkbox <input></input> element in the DOM.\nCalling .checked() on a checkbox returns if it is checked or not
\n",itemtype:"method",name:"createCheckbox",params:[{name:"label",description:"label displayed after checkbox
\n",type:"String",optional:!0},{name:"value",description:"value of the checkbox; checked is true, unchecked is false.Unchecked if no value given
\n",type:"Boolean",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar checkbox;\n\nfunction setup() {\n checkbox = createCheckbox('label', false);\n checkbox.changed(myCheckedEvent);\n}\n\nfunction myCheckedEvent() {\n if (this.checked()) {\n console.log(\"Checking!\");\n } else {\n console.log(\"Unchecking!\");\n }\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:528,description:"Creates a dropdown menu <select></select> element in the DOM.\nIt also helps to assign select-box methods to p5.Element when selecting existing select box
\n",itemtype:"method",name:"createSelect",return:{description:"",type:"p5.Element"},example:["\n\nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text(\"it's a \"+item+\"!\", 50, 50);\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom",overloads:[{line:528,params:[{name:"multiple",description:"true if dropdown should support multiple selections
\n",type:"Boolean",optional:!0}],return:{description:"",type:"p5.Element"}},{line:556,params:[{name:"existing",description:"DOM select element
\n",type:"Object"}],return:{description:"",type:"p5.Element"}}]},{file:"lib/addons/p5.dom.js",line:633,description:"Creates a radio button <input></input> element in the DOM.\nThe .option() method can be used to set options for the radio after it is\ncreated. The .value() method will return the currently selected option.
\n",itemtype:"method",name:"createRadio",params:[{name:"divId",description:"the id and name of the created div and input field respectively
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option(\"black\");\n radio.option(\"white\");\n radio.option(\"gray\");\n radio.style('width', '60px');\n textAlign(CENTER);\n fill(255, 0, 0);\n}\n\nfunction draw() {\n var val = radio.value();\n background(val);\n text(val, width/2, height/2);\n}\n\n\nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option('apple', 1);\n radio.option('bread', 2);\n radio.option('juice', 3);\n radio.style('width', '60px');\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(200);\n var val = radio.value();\n if (val) {\n text('item cost is $'+val, width/2, height/2);\n }\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:759,description:"Creates an <input></input> element in the DOM for text input.\nUse .size() to set the display length of the box.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createInput",params:[{name:"value",description:"default value of the input box
\n",type:"Number",optional:!0},{name:"type",description:"type of text, ie text, password etc. Defaults to text
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nfunction setup(){\n var inp = createInput('');\n inp.input(myInputEvent);\n}\n\nfunction myInputEvent(){\n console.log('you are typing: ', this.value());\n}\n\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:789,description:"Creates an <input></input> element in the DOM of type 'file'.\nThis allows users to select local files for use in a sketch.
\n",itemtype:"method",name:"createFileInput",params:[{name:"callback",description:"callback function for when a file loaded
\n",type:"Function",optional:!0},{name:"multiple",description:"optional to allow multiple files selected
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created DOM element",type:"Object|p5.Element"},example:["\nvar input;\nvar img;\n\nfunction setup() {\n input = createFileInput(handleFile);\n input.position(0, 0);\n}\n\nfunction draw() {\n if (img) {\n image(img, 0, 0, width, height);\n }\n}\n\nfunction handleFile(file) {\n print(file);\n if (file.type === 'image') {\n img = createImg(file.data);\n img.hide();\n }\n}"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:874,class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:911,description:'Creates an HTML5 <video> element in the DOM for simple playback\nof audio/video. Shown by default, can be hidden with .hide()\nand drawn into canvas using video(). Appends to the container\nnode if one is specified, otherwise appends to body. The first parameter\ncan be either a single string path to a video file, or an array of string\npaths to different formats of the same video. This is useful for ensuring\nthat your video can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.
\n',itemtype:"method",name:"createVideo",params:[{name:"src",description:"path to a video file, or array of paths for\n supporting different browsers
\n",type:"String|Array"},{name:"callback",description:"callback function to be called upon\n 'canplaythrough' event fire, that is, when the\n browser can play the media, and estimates that\n enough data has been loaded to play the media\n up to its end without having to stop for\n further buffering of content
\n",type:"Object",optional:!0}],return:{description:"pointer to video p5.Element",type:"p5.MediaElement|p5.Element"},class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:937,class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:939,description:'Creates a hidden HTML5 <audio> element in the DOM for simple audio\nplayback. Appends to the container node if one is specified,\notherwise appends to body. The first parameter\ncan be either a single string path to a audio file, or an array of string\npaths to different formats of the same audio. This is useful for ensuring\nthat your audio can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.
\n',itemtype:"method",name:"createAudio",params:[{name:"src",description:"path to an audio file, or array of paths for\n supporting different browsers
\n",type:"String|Array"},{name:"callback",description:"callback function to be called upon\n 'canplaythrough' event fire, that is, when the\n browser can play the media, and estimates that\n enough data has been loaded to play the media\n up to its end without having to stop for\n further buffering of content
\n",type:"Object",optional:!0}],return:{description:"pointer to audio p5.Element",type:"p5.MediaElement|p5.Element"},class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:965,class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:998,description:'Creates a new <video> element that contains the audio/video feed\nfrom a webcam. This can be drawn onto the canvas using video().
\nMore specific properties of the feed can be passing in a Constraints object.\nSee the\n W3C\nspec for possible properties. Note that not all of these are supported\nby all browsers.
\nSecurity note: A new browser security specification requires that getUserMedia,\nwhich is behind createCapture(), only works when you're running the code locally,\nor on HTTPS. Learn more here\nand here.
',itemtype:"method",name:"createCapture",params:[{name:"type",description:"type of capture, either VIDEO or\n AUDIO if none specified, default both,\n or a Constraints object
\n",type:"String|Constant|Object"},{name:"callback",description:"function to be called once\n stream has loaded
\n",type:"Function"}],return:{description:"capture video p5.Element",type:"Object|p5.Element"},example:["\n\nvar capture;\n\nfunction setup() {\n createCanvas(480, 120);\n capture = createCapture(VIDEO);\n}\n\nfunction draw() {\n image(capture, 0, 0, width, width*capture.height/capture.width);\n filter(INVERT);\n}\n\n\nfunction setup() {\n createCanvas(480, 120);\n var constraints = {\n video: {\n mandatory: {\n minWidth: 1280,\n minHeight: 720\n },\n optional: [\n { maxFrameRate: 10 }\n ]\n },\n audio: true\n };\n createCapture(constraints, function(stream) {\n console.log(stream);\n });\n}\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1111,description:"Creates element with given tag in the DOM with given content.\nAppends to the container node if one is specified, otherwise\nappends to body.
\n",itemtype:"method",name:"createElement",params:[{name:"tag",description:"tag for the new element
\n",type:"String"},{name:"content",description:"html content to be inserted into the element
\n",type:"String",optional:!0}],return:{description:"pointer to p5.Element holding created node",type:"Object|p5.Element"},example:["\n\nvar h2 = createElement('h2','im an h2 p5.element!');\n"],class:"p5.dom",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1137,description:"Adds specified class to the element.
\n",itemtype:"method",name:"addClass",params:[{name:"class",description:"name of class to add
\n",type:"String"}],return:{description:"",type:"Object|p5.Element"},example:["\n \n var div = createDiv('div');\n div.addClass('myClass');\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1164,description:"Removes specified class from the element.
\n",itemtype:"method",name:"removeClass",params:[{name:"class",description:"name of class to remove
\n",type:"String"}],return:{description:"",type:"Object|p5.Element"},class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1179,description:"Attaches the element as a child to the parent specified.\n Accepts either a string ID, DOM node, or p5.Element.\n If no argument is specified, an array of children DOM nodes is returned.
\n",itemtype:"method",name:"child",params:[{name:"child",description:"the ID, DOM node, or p5.Element\n to add to the current element
\n",type:"String|Object|p5.Element",optional:!0}],return:{description:"",type:"p5.Element"},
-example:["\n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div0.child(div1); // use p5.Element\n \n \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div1.id('apples');\n div0.child('apples'); // use id\n \n \n var div0 = createDiv('this is the parent');\n var elt = document.getElementById('myChildDiv');\n div0.child(elt); // use element from page\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1223,description:"Centers a p5 Element either vertically, horizontally,\nor both, relative to its parent or according to\nthe body if the Element has no parent. If no argument is passed\nthe Element is aligned both vertically and horizontally.
\n",params:[{name:"align",description:"passing 'vertical', 'horizontal' aligns element accordingly
\n",type:"String"}],return:{description:"pointer to p5.Element",type:"Object|p5.Element"},example:["\n\nfunction setup() {\n var div = createDiv('').size(10,10);\n div.style('background-color','orange');\n div.center();\n\n}\n"],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1276,description:"If an argument is given, sets the inner HTML of the element,\n replacing any existing html. If true is included as a second\n argument, html is appended instead of replacing existing html.\n If no arguments are given, returns\n the inner HTML of the element.
\n",itemtype:"method",name:"html",params:[{name:"html",description:"the HTML to be placed inside the element
\n",type:"String",optional:!0},{name:"append",description:"whether to append HTML to existing
\n",type:"Boolean",optional:!0}],return:{description:"",type:"Object|p5.Element|String"},example:["\n \n var div = createDiv('').size(100,100);\n div.html('hi');\n \n \n var div = createDiv('Hello ').size(100,100);\n div.html('World', true);\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1311,description:"Sets the position of the element relative to (0, 0) of the\n window. Essentially, sets position:absolute and left and top\n properties of style. If no arguments given returns the x and y position\n of the element in an object.
\n",itemtype:"method",name:"position",params:[{name:"x",description:"x-position relative to upper left of window
\n",type:"Number",optional:!0},{name:"y",description:"y-position relative to upper left of window
\n",type:"Number",optional:!0}],return:{description:"",type:"Object|p5.Element"},example:["\n \n function setup() {\n var cnv = createCanvas(100, 100);\n // positions canvas 50px to the right and 100px\n // below upper left corner of the window\n cnv.position(50, 100);\n }\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1392,description:"Sets the given style (css) property (1st arg) of the element with the\ngiven value (2nd arg). If a single argument is given, .style()\nreturns the value of the given property; however, if the single argument\nis given in css syntax ('text-align:center'), .style() sets the css\nappropriatly. .style() also handles 2d and 3d css transforms. If\nthe 1st arg is 'rotate', 'translate', or 'position', the following arguments\naccept Numbers as values. ('translate', 10, 100, 50);
\n",itemtype:"method",name:"style",params:[{name:"property",description:"property to be set
\n",type:"String"},{name:"value",description:"value to assign to property (only String|Number for rotate/translate)
\n",type:"String|Number|p5.Color",optional:!0}],return:{description:"value of property, if no value is specified\nor p5.Element",type:"String|Object|p5.Element"},example:['\n\nvar myDiv = createDiv("I like pandas.");\nmyDiv.style("font-size", "18px");\nmyDiv.style("color", "#ff0000");\n\n\nvar col = color(25,23,200,50);\nvar button = createButton("button");\nbutton.style("background-color", col);\nbutton.position(10, 10);\n\n\nvar myDiv = createDiv("I like lizards.");\nmyDiv.style("position", 20, 20);\nmyDiv.style("rotate", 45);\n\n\nvar myDiv;\nfunction setup() {\n background(200);\n myDiv = createDiv("I like gray.");\n myDiv.position(20, 20);\n}\n\nfunction draw() {\n myDiv.style("font-size", mouseX+"px");\n}\n'],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1474,description:"Adds a new attribute or changes the value of an existing attribute\n on the specified element. If no value is specified, returns the\n value of the given attribute, or null if attribute is not set.
\n",itemtype:"method",name:"attribute",params:[{name:"attr",description:"attribute to set
\n",type:"String"},{name:"value",description:"value to assign to attribute
\n",type:"String",optional:!0}],return:{description:"value of attribute, if no value is\n specified or p5.Element",type:"String|Object|p5.Element"},example:['\n \n var myDiv = createDiv("I like pandas.");\n myDiv.attribute("align", "center");\n '],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1514,description:"Removes an attribute on the specified element.
\n",itemtype:"method",name:"removeAttribute",params:[{name:"attr",description:"attribute to remove
\n",type:"String"}],return:{description:"",type:"Object|p5.Element"},example:["\n \n var button;\n var checkbox;\nfunction setup() {\n checkbox = createCheckbox('enable', true);\n checkbox.changed(enableButton);\n button = createButton('button');\n button.position(10, 10);\n }\nfunction enableButton() {\n if( this.checked() ) {\n // Re-enable the button\n button.removeAttribute('disabled');\n } else {\n // Disable the button\n button.attribute('disabled','');\n }\n }\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1558,description:"Either returns the value of the element if no arguments\ngiven, or sets the value of the element.
\n",itemtype:"method",name:"value",params:[{name:"value",description:"",type:"String|Number",optional:!0}],return:{description:"value of element if no value is specified or p5.Element",type:"String|Object|p5.Element"},example:["\n\n// gets the value\nvar inp;\nfunction setup() {\n inp = createInput('');\n}\n\nfunction mousePressed() {\n print(inp.value());\n}\n\n\n// sets the value\nvar inp;\nfunction setup() {\n inp = createInput('myValue');\n}\n\nfunction mousePressed() {\n inp.value(\"myValue\");\n}\n"],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1601,description:"Shows the current element. Essentially, setting display:block for the style.
\n",itemtype:"method",name:"show",return:{description:"",type:"Object|p5.Element"},example:["\n \n var div = createDiv('div');\n div.style(\"display\", \"none\");\n div.show(); // turns display to block\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1619,description:"Hides the current element. Essentially, setting display:none for the style.
\n",itemtype:"method",name:"hide",return:{description:"",type:"Object|p5.Element"},example:["\n\nvar div = createDiv('this is a div');\ndiv.hide();\n"],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1635,description:"Sets the width and height of the element. AUTO can be used to\n only adjust one dimension. If no arguments given returns the width and height\n of the element in an object.
\n",itemtype:"method",name:"size",params:[{name:"w",description:"width of the element
\n",type:"Number",optional:!0},{name:"h",description:"height of the element
\n",type:"Number",optional:!0}],return:{description:"",type:"Object|p5.Element"},example:["\n \n var div = createDiv('this is a div');\n div.size(100, 100);\n "],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1701,description:"Removes the element and deregisters all listeners.
\n",itemtype:"method",name:"remove",example:["\n\nvar myDiv = createDiv('this is some text');\nmyDiv.remove();\n"],class:"p5.Element",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1750,description:"Path to the media element source.
\n",itemtype:"property",name:"src",return:{description:"src",type:"String"},example:["\n\nvar ele;\n\nfunction setup() {\n background(250);\n\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n //We'll set up our example so that\n //when you click on the text,\n //an alert box displays the MediaElement's\n //src field.\n textAlign(CENTER);\n text(\"Click Me!\", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n //Show our p5.MediaElement's src field\n alert(ele.src);\n }\n}\n\n"],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1820,description:"Play an HTML5 media element.
\n",itemtype:"method",name:"play",return:{description:"",type:"Object|p5.Element"},example:['\n\nvar ele;\n\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio(\'assets/beat.mp3\');\n\n background(250);\n textAlign(CENTER);\n text("Click to Play!", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it\'s clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n\n //Here we call the play() function on\n //the p5.MediaElement we created above.\n //This will start the audio sample.\n ele.play();\n\n background(200);\n text("You clicked Play!", width/2, height/2);\n }\n}\n'],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1875,description:"Stops an HTML5 media element (sets current time to zero).
\n",itemtype:"method",name:"stop",return:{description:"",type:"Object|p5.Element"},example:['\n\n\n//This example both starts \n//and stops a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio(\'assets/beat.mp3\');\n background(200);\n textAlign(CENTER);\n text("Click to play!", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it\'s clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if(sampleIsPlaying) {\n //if the sample is currently playing\n //calling the stop() function on\n //our p5.MediaElement will stop\n //it and reset its current\n //time to 0 (i.e. it will start\n //at the beginning the next time\n //you play it)\n ele.stop();\n\n sampleIsPlaying = false;\n text("Click to play!", width/2, height/2);\n } else {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop(); \n\n sampleIsPlaying = true;\n text("Click to stop!", width/2, height/2);\n }\n }\n}\n\n'],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:1942,description:"Pauses an HTML5 media element.
\n",itemtype:"method",name:"pause",return:{description:"",type:"Object|p5.Element"},example:['\n\n//This example both starts\n//and pauses a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio(\'assets/lucky_dragons_-_power_melody.mp3\');\n background(200);\n textAlign(CENTER);\n text("Click to play!", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it\'s clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if(sampleIsPlaying) {\n //Calling pause() on our\n //p5.MediaElement will stop it\n //playing, but when we call the\n //loop() or play() functions\n //the sample will start from\n //where we paused it.\n ele.pause();\n\n sampleIsPlaying = false;\n text("Click to resume!", width/2, height/2);\n } else {\n //loop our sound element until we\n //call ele.pause() on it.\n ele.loop(); \n\n sampleIsPlaying = true;\n text("Click to pause!", width/2, height/2);\n }\n }\n}\n\n'],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2006,description:"Set 'loop' to true for an HTML5 media element, and starts playing.
\n",itemtype:"method",name:"loop",return:{description:"",type:"Object|p5.Element"},example:['\n\n//Clicking the canvas will loop\n//the audio sample until the user\n//clicks again to stop it\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsLooping = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio(\'assets/lucky_dragons_-_power_melody.mp3\');\n background(200);\n textAlign(CENTER);\n text("Click to loop!", width/2, height/2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it\'s clicked\n if(mouseX >= 0 && mouseX <= width &&\n mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if(sampleIsLooping == false) {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop();\n\n sampleIsLooping = true;\n text("Click to stop!", width/2, height/2);\n } else {\n ele.stop();\n\n sampleIsLooping = false;\n text("Click to loop!", width/2, height/2);\n }\n }\n}\n\n'],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2064,description:"Set 'loop' to false for an HTML5 media element. Element will stop\nwhen it reaches the end.
\n",itemtype:"method",name:"noLoop",return:{description:"",type:"Object|p5.Element"},class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2077,description:"Set HTML5 media element to autoplay or not.
\n",itemtype:"method",name:"autoplay",params:[{name:"autoplay",description:"whether the element should autoplay
\n",type:"Boolean"}],return:{description:"",type:"Object|p5.Element"},class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2089,description:"Sets volume for this HTML5 media element. If no argument is given,\nreturns the current volume.
\n",params:[{name:"val",description:"volume between 0.0 and 1.0
\n",type:"Number",optional:!0}],return:{description:"current volume or p5.MediaElement",type:"Number|p5.MediaElement"},itemtype:"method",name:"volume",class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2105,description:"If no arguments are given, returns the current playback speed of the\nelement. The speed parameter sets the speed where 2.0 will play the\nelement twice as fast, 0.5 will play at half the speed, and -1 will play\nthe element in normal speed in reverse.(Note that not all browsers support\nbackward playback and even if they do, playback might not be smooth.)
\n",itemtype:"method",name:"speed",params:[{name:"speed",description:"speed multiplier for element playback
\n",type:"Number",optional:!0}],return:{description:"current playback speed or p5.MediaElement",type:"Number|Object|p5.MediaElement"},class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2124,description:"If no arguments are given, returns the current time of the element.\nIf an argument is given the current time of the element is set to it.
\n",itemtype:"method",name:"time",params:[{name:"time",description:"time to jump to (in seconds)
\n",type:"Number",optional:!0}],return:{description:"current time (in seconds)\n or p5.MediaElement",type:"Number|Object|p5.MediaElement"},class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2141,description:"Returns the duration of the HTML5 media element.
\n",itemtype:"method",name:"duration",return:{description:"duration",type:"Number"},class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2201,description:"helper method for web GL mode to figure out if the element\nhas been modified and might need to be re-uploaded to texture\nmemory between frames.
\n",itemtype:"method",name:"isModified",access:"private",tagname:"",return:{description:"a boolean indicating whether or not the\nimage has been updated or modified since last texture upload.",type:"Boolean"},class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2213,description:"helper method for web GL mode to indicate that an element has been\nchanged or unchanged since last upload. gl texture upload will\nset this value to false after uploading the texture; or might set\nit to true if metadata has become available but there is no actual\ntexture data available yet..
\n",itemtype:"method",name:"setModified",params:[{name:"val",description:"sets whether or not the element has been\nmodified.
\n",type:"Boolean"}],access:"private",tagname:"",class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2227,description:"Schedule an event to be called when the audio or video\nelement reaches the end. If the element is looping,\nthis will not be called. The element is passed in\nas the argument to the onended callback.
\n",itemtype:"method",name:"onended",params:[{name:"callback",description:"function to call when the\n soundfile has ended. The\n media element will be passed\n in as the argument to the\n callback.
\n",type:"Function"}],return:{description:"",type:"Object|p5.MediaElement"},example:["\n\nfunction setup() {\n audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls(true);\n audioEl.onended(sayDone);\n}\n\nfunction sayDone(elt) {\n alert('done playing ' + elt.src );\n}\n"],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2259,class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2261,description:"Send the audio output of this element to a specified audioNode or\np5.sound object. If no element is provided, connects to p5's master\noutput. That connection is established when this method is first called.\nAll connections are removed by the .disconnect() method.
\nThis method is meant to be used with the p5.sound.js addon library.
\n",itemtype:"method",name:"connect",params:[{name:"audioNode",description:"AudioNode from the Web Audio API,\nor an object from the p5.sound library
\n",type:"AudioNode|Object"}],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2313,description:"Disconnect all Web Audio routing, including to master output.\nThis is useful if you want to re-route the output through\naudio effects, for example.
\n",itemtype:"method",name:"disconnect",class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2329,class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2331,description:"Show the default MediaElement controls, as determined by the web browser.
\n",itemtype:"method",name:"showControls",class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2342,description:"Hide the default mediaElement controls.
\n",itemtype:"method",name:"hideControls",class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2351,class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2353,description:"Schedule events to trigger every time a MediaElement\n(audio/video) reaches a playback cue point.
\nAccepts a callback function, a time (in seconds) at which to trigger\nthe callback, and an optional parameter for the callback.
\nTime will be passed as the first parameter to the callback function,\nand param will be the second parameter.
\n",itemtype:"method",name:"addCue",params:[{name:"time",description:"Time in seconds, relative to this media\n element's playback. For example, to trigger\n an event every time playback reaches two\n seconds, pass in the number 2. This will be\n passed as the first parameter to\n the callback function.
\n",type:"Number"},{name:"callback",description:"Name of a function that will be\n called at the given time. The callback will\n receive time and (optionally) param as its\n two parameters.
\n",type:"Function"},{name:"value",description:"An object to be passed as the\n second parameter to the\n callback function.
\n",type:"Object",optional:!0}],return:{description:"id ID of this cue,\n useful for removeCue(id)",type:"Number"},example:["\n\nfunction setup() {\n background(255,255,255);\n\n audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n\n // schedule three calls to changeBackground\n audioEl.addCue(0.5, changeBackground, color(255,0,0) );\n audioEl.addCue(1.0, changeBackground, color(0,255,0) );\n audioEl.addCue(2.5, changeBackground, color(0,0,255) );\n audioEl.addCue(3.0, changeBackground, color(0,255,255) );\n audioEl.addCue(4.2, changeBackground, color(255,255,0) );\n audioEl.addCue(5.0, changeBackground, color(255,255,0) );\n}\n\nfunction changeBackground(val) {\n background(val);\n}\n"],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2415,description:"Remove a callback based on its ID. The ID is returned by the\naddCue method.
\n",itemtype:"method",name:"removeCue",params:[{name:"id",description:"ID of the cue, as returned by addCue
\n",type:"Number"}],class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2435,description:"Remove all of the callbacks that had originally been scheduled\nvia the addCue method.
\n",itemtype:"method",name:"clearCues",class:"p5.MediaElement",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2491,description:"Underlying File object. All normal File methods can be called on this.
\n",itemtype:"property",name:"file",class:"p5.File",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2503,description:"File type (image, text, etc.)
\n",itemtype:"property",name:"type",class:"p5.File",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2509,description:"File subtype (usually the file extension jpg, png, xml, etc.)
\n",itemtype:"property",name:"subtype",class:"p5.File",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2515,description:"File name
\n",itemtype:"property",name:"name",class:"p5.File",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2521,description:"File size
\n",itemtype:"property",name:"size",class:"p5.File",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.dom.js",line:2528,description:"URL string containing image data.
\n",itemtype:"property",name:"data",class:"p5.File",module:"p5.dom",submodule:"p5.dom"},{file:"lib/addons/p5.sound.js",line:46,description:'p5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound
\nFrom the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors
\nMIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE
\nSome of the many audio libraries & resources that inspire p5.sound:
\n\n- TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js
\n- buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/
\n- Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0
\n- wavesurfer.js https://github.com/katspaugh/wavesurfer.js
\n- Web Audio Components by Jordan Santell https://github.com/web-audio-components
\nWilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound
\nWeb Audio API: http://w3.org/TR/webaudio/
\n
\n',class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:212,description:"Returns the Audio Context for this sketch. Useful for users\nwho would like to dig deeper into the Web Audio API\n.
",itemtype:"method",name:"getAudioContext",return:{description:"AudioContext for this sketch",type:"Object"},class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:226,description:"Determine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats
\n",class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:296,description:"Master contains AudioContext and the master sound output.
\n",class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:331,description:"Returns a number representing the master amplitude (volume) for sound\nin this sketch.
\n",itemtype:"method",name:"getMasterVolume",return:{description:"Master amplitude (volume) for sound in this sketch.\n Should be between 0.0 (silence) and 1.0.",type:"Number"},class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:342,description:"Scale the output of all sound in this sketch
\nScaled between 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Env class.\n\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.\n\nHow This Works: When you load the p5.sound module, it\ncreates a single instance of p5sound. All sound objects in this\nmodule output to p5sound before reaching your computer's output.\nSo if you change the amplitude of p5sound, it impacts all of the\nsound in this module.
\n\nIf no value is provided, returns a Web Audio API Gain Node
",itemtype:"method",name:"masterVolume",params:[{name:"volume",description:"Volume (amplitude) between 0.0\n and 1.0 or modulating signal/oscillator
\n",type:"Number|Object"},{name:"rampTime",description:"Fade for t seconds
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"Schedule this event to happen at\n t seconds in the future
\n",type:"Number",optional:!0}],class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:384,description:"p5.soundOut is the p5.sound master output. It sends output to\nthe destination of this window's web audio context. It contains\nWeb Audio API nodes including a dyanmicsCompressor (.limiter),\nand Gain Nodes for .input and .output.
\n",itemtype:"property",name:"soundOut",type:"Object",class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:393,description:"a silent connection to the DesinationNode\nwhich will ensure that anything connected to it\nwill not be garbage collected
\n",access:"private",tagname:"",class:"p5.sound",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:412,description:"Returns a number representing the sample rate, in samples per second,\nof all sound objects in this audio context. It is determined by the\nsampling rate of your operating system's sound card, and it is not\ncurrently possile to change.\nIt is often 44100, or twice the range of human hearing.
\n",itemtype:"method",name:"sampleRate",return:{description:"samplerate samples per second",type:"Number"},class:"p5",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:425,description:"Returns the closest MIDI note value for\na given frequency.
\n",params:[{name:"frequency",description:"A freqeuncy, for example, the "A"\n above Middle C is 440Hz
\n",type:"Number"}],return:{description:"MIDI note value",type:"Number"},class:"p5",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:438,
-description:"Returns the frequency value of a MIDI note value.\nGeneral MIDI treats notes as integers where middle C\nis 60, C# is 61, D is 62 etc. Useful for generating\nmusical frequencies with oscillators.
\n",itemtype:"method",name:"midiToFreq",params:[{name:"midiNote",description:"The number of a MIDI note
\n",type:"Number"}],return:{description:"Frequency value of the given MIDI note",type:"Number"},example:["\n\nvar notes = [60, 64, 67, 72];\nvar i = 0;\n\nfunction setup() {\n osc = new p5.Oscillator('Triangle');\n osc.start();\n frameRate(1);\n}\n\nfunction draw() {\n var freq = midiToFreq(notes[i]);\n osc.freq(freq);\n i++;\n if (i >= notes.length){\n i = 0;\n }\n}\n"],class:"p5",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:471,description:'List the SoundFile formats that you will include. LoadSound\nwill search your directory for these extensions, and will pick\na format that is compatable with the client's web browser.\nHere is a free online file\nconverter.
\n',itemtype:"method",name:"soundFormats",params:[{name:"formats",description:"i.e. 'mp3', 'wav', 'ogg'
\n",type:"String",optional:!0,multiple:!0}],example:["\n\nfunction preload() {\n // set the global sound formats\n soundFormats('mp3', 'ogg');\n\n // load either beatbox.mp3, or .ogg, depending on browser\n mySound = loadSound('assets/beatbox.mp3');\n}\n\nfunction setup() {\n mySound.play();\n}\n"],class:"p5",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:584,description:"Used by Osc and Env to chain signal math
\n",class:"p5",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:869,description:'loadSound() returns a new p5.SoundFile from a specified\npath. If called during preload(), the p5.SoundFile will be ready\nto play in time for setup() and draw(). If called outside of\npreload, the p5.SoundFile will not be ready immediately, so\nloadSound accepts a callback as the second parameter. Using a\n\nlocal server is recommended when loading external files.
\n',itemtype:"method",name:"loadSound",params:[{name:"path",description:"Path to the sound file, or an array with\n paths to soundfiles in multiple formats\n i.e. ['sound.ogg', 'sound.mp3'].\n Alternately, accepts an object: either\n from the HTML5 File API, or a p5.File.
\n",type:"String|Array"},{name:"successCallback",description:"Name of a function to call once file loads
\n",type:"Function",optional:!0},{name:"errorCallback",description:"Name of a function to call if there is\n an error loading the file.
\n",type:"Function",optional:!0},{name:"whileLoading",description:"Name of a function to call while file is loading.\n This function will receive the percentage loaded\n so far, from 0.0 to 1.0.
\n",type:"Function",optional:!0}],return:{description:"Returns a p5.SoundFile",type:"SoundFile"},example:["\n\nfunction preload() {\n mySound = loadSound('assets/doorbell.mp3');\n}\n\nfunction setup() {\n mySound.setVolume(0.1);\n mySound.play();\n}\n"],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:917,description:"This is a helper function that the p5.SoundFile calls to load\nitself. Accepts a callback (the name of another function)\nas an optional parameter.
\n",access:"private",tagname:"",params:[{name:"successCallback",description:"Name of a function to call once file loads
\n",type:"Function",optional:!0},{name:"errorCallback",description:"Name of a function to call if there is an error
\n",type:"Function",optional:!0}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1009,description:"Returns true if the sound file finished loading successfully.
\n",itemtype:"method",name:"isLoaded",return:{description:"",type:"Boolean"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1022,description:"Play the p5.SoundFile
\n",itemtype:"method",name:"play",params:[{name:"startTime",description:"(optional) schedule playback to start (in seconds from now).
\n",type:"Number",optional:!0},{name:"rate",description:"(optional) playback rate
\n",type:"Number",optional:!0},{name:"amp",description:"(optional) amplitude (volume)\n of playback
\n",type:"Number",optional:!0},{name:"cueStart",description:"(optional) cue start time in seconds
\n",type:"Number",optional:!0},{name:"duration",description:"(optional) duration of playback in seconds
\n",type:"Number",optional:!0}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1119,description:"p5.SoundFile has two play modes: restart and\nsustain. Play Mode determines what happens to a\np5.SoundFile if it is triggered while in the middle of playback.\nIn sustain mode, playback will continue simultaneous to the\nnew playback. In restart mode, play() will stop playback\nand start over. Sustain is the default mode.
\n",itemtype:"method",name:"playMode",params:[{name:"str",description:"'restart' or 'sustain'
\n",type:"String"}],example:["\n\nfunction setup(){\n mySound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\nfunction mouseClicked() {\n mySound.playMode('sustain');\n mySound.play();\n}\nfunction keyPressed() {\n mySound.playMode('restart');\n mySound.play();\n}\n\n "],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1161,description:"Pauses a file that is currently playing. If the file is not\nplaying, then nothing will happen.
\nAfter pausing, .play() will resume from the paused\nposition.\nIf p5.SoundFile had been set to loop before it was paused,\nit will continue to loop after it is unpaused with .play().
\n",itemtype:"method",name:"pause",params:[{name:"startTime",description:"(optional) schedule event to occur\n seconds from now
\n",type:"Number",optional:!0}],example:["\n\nvar soundFile;\n\nfunction preload() {\n soundFormats('ogg', 'mp3');\n soundFile = loadSound('assets/Damscray_-_Dancing_Tiger_02.mp3');\n}\nfunction setup() {\n background(0, 255, 0);\n soundFile.setVolume(0.1);\n soundFile.loop();\n}\nfunction keyTyped() {\n if (key == 'p') {\n soundFile.pause();\n background(255, 0, 0);\n }\n}\n\nfunction keyReleased() {\n if (key == 'p') {\n soundFile.play();\n background(0, 255, 0);\n }\n}\n\n"],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1217,description:"Loop the p5.SoundFile. Accepts optional parameters to set the\nplayback rate, playback volume, loopStart, loopEnd.
\n",itemtype:"method",name:"loop",params:[{name:"startTime",description:"(optional) schedule event to occur\n seconds from now
\n",type:"Number",optional:!0},{name:"rate",description:"(optional) playback rate
\n",type:"Number",optional:!0},{name:"amp",description:"(optional) playback volume
\n",type:"Number",optional:!0},{name:"cueLoopStart",description:"(optional) startTime in seconds
\n",type:"Number",optional:!0},{name:"duration",description:"(optional) loop duration in seconds
\n",type:"Number",optional:!0}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1233,description:"Set a p5.SoundFile's looping flag to true or false. If the sound\nis currently playing, this change will take effect when it\nreaches the end of the current playback.
\n",params:[{name:"Boolean",description:"set looping to true or false
\n",type:"Boolean"}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1253,description:"Returns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not.
\n",return:{description:"",type:"Boolean"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1267,description:"Returns true if a p5.SoundFile is playing, false if not (i.e.\npaused or stopped).
\n",itemtype:"method",name:"isPlaying",return:{description:"",type:"Boolean"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1277,description:"Returns true if a p5.SoundFile is paused, false if not (i.e.\nplaying or stopped).
\n",itemtype:"method",name:"isPaused",return:{description:"",type:"Boolean"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1287,description:"Stop soundfile playback.
\n",itemtype:"method",name:"stop",params:[{name:"startTime",description:"(optional) schedule event to occur\n in seconds from now
\n",type:"Number",optional:!0}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1311,description:"Stop playback on all of this soundfile's sources.
\n",access:"private",tagname:"",class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1333,description:"Multiply the output volume (amplitude) of a sound file\nbetween 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Env class.
\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.
\n",itemtype:"method",name:"setVolume",params:[{name:"volume",description:"Volume (amplitude) between 0.0\n and 1.0 or modulating signal/oscillator
\n",type:"Number|Object"},{name:"rampTime",description:"Fade for t seconds
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"Schedule this event to happen at\n t seconds in the future
\n",type:"Number",optional:!0}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1374,description:"Set the stereo panning of a p5.sound object to\na floating point number between -1.0 (left) and 1.0 (right).\nDefault is 0.0 (center).
\n",itemtype:"method",name:"pan",params:[{name:"panValue",description:"Set the stereo panner
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],example:["\n\n\n var ball = {};\n var soundFile;\n\n function setup() {\n soundFormats('ogg', 'mp3');\n soundFile = loadSound('assets/beatbox.mp3');\n }\n\n function draw() {\n background(0);\n ball.x = constrain(mouseX, 0, width);\n ellipse(ball.x, height/2, 20, 20)\n }\n\n function mousePressed(){\n // map the ball's x location to a panning degree\n // between -1.0 (left) and 1.0 (right)\n var panning = map(ball.x, 0., width,-1.0, 1.0);\n soundFile.pan(panning);\n soundFile.play();\n }\n "],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1413,description:"Returns the current stereo pan position (-1.0 to 1.0)
\n",return:{description:"Returns the stereo pan setting of the Oscillator\n as a number between -1.0 (left) and 1.0 (right).\n 0.0 is center and default.",type:"Number"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1423,description:"Set the playback rate of a sound file. Will change the speed and the pitch.\nValues less than zero will reverse the audio buffer.
\n",itemtype:"method",name:"rate",params:[{name:"playbackRate",description:"Set the playback rate. 1.0 is normal,\n .5 is half-speed, 2.0 is twice as fast.\n Values less than zero play backwards.
\n",type:"Number",optional:!0}],example:["\n\nvar song;\n\nfunction preload() {\n song = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n song.loop();\n}\n\nfunction draw() {\n background(200);\n\n // Set the rate to a range between 0.1 and 4\n // Changing the rate also alters the pitch\n var speed = map(mouseY, 0.1, height, 0, 2);\n speed = constrain(speed, 0.01, 4);\n song.rate(speed);\n\n // Draw a circle to show what is going on\n stroke(0);\n fill(51, 100);\n ellipse(mouseX, 100, 48, 48);\n}\n\n \n \n"],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1495,description:"Returns the duration of a sound file in seconds.
\n",itemtype:"method",name:"duration",return:{description:"The duration of the soundFile in seconds.",type:"Number"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1509,description:"Return the current position of the p5.SoundFile playhead, in seconds.\nNote that if you change the playbackRate while the p5.SoundFile is\nplaying, the results may not be accurate.
\n",itemtype:"method",name:"currentTime",return:{description:"currentTime of the soundFile in seconds.",type:"Number"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1525,description:"Move the playhead of the song to a position, in seconds. Start timing\nand playback duration. If none are given, will reset the file to play\nentire duration from start to finish.
\n",itemtype:"method",name:"jump",params:[{name:"cueTime",description:"cueTime of the soundFile in seconds.
\n",type:"Number"},{name:"duration",description:"duration in seconds.
\n",type:"Number"}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1548,description:"Return the number of channels in a sound file.\nFor example, Mono = 1, Stereo = 2.
\n",itemtype:"method",name:"channels",return:{description:"[channels]",type:"Number"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1558,description:"Return the sample rate of the sound file.
\n",itemtype:"method",name:"sampleRate",return:{description:"[sampleRate]",type:"Number"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1567,description:"Return the number of samples in a sound file.\nEqual to sampleRate * duration.
\n",itemtype:"method",name:"frames",return:{description:"[sampleCount]",type:"Number"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1577,description:"Returns an array of amplitude peaks in a p5.SoundFile that can be\nused to draw a static waveform. Scans through the p5.SoundFile's\naudio buffer to find the greatest amplitudes. Accepts one\nparameter, 'length', which determines size of the array.\nLarger arrays result in more precise waveform visualizations.
\nInspired by Wavesurfer.js.
\n",itemtype:"method",name:"getPeaks",params:[{name:"length",description:"length is the size of the returned array.\n Larger length results in more precision.\n Defaults to 5*width of the browser window.
\n",type:"Number",optional:!0}],return:{description:"Array of peaks.",type:"Float32Array"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1629,description:"Reverses the p5.SoundFile's buffer source.\nPlayback must be handled separately (see example).
\n",itemtype:"method",name:"reverseBuffer",example:["\n\nvar drum;\n\nfunction preload() {\n drum = loadSound('assets/drum.mp3');\n}\n\nfunction setup() {\n drum.reverseBuffer();\n drum.play();\n}\n\n \n "],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1664,description:"Schedule an event to be called when the soundfile\nreaches the end of a buffer. If the soundfile is\nplaying through once, this will be called when it\nends. If it is looping, it will be called when\nstop is called.
\n",itemtype:"method",name:"onended",params:[{name:"callback",description:"function to call when the\n soundfile has ended.
\n",type:"Function"}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1717,description:"Connects the output of a p5sound object to input of another\np5.sound object. For example, you may connect a p5.SoundFile to an\nFFT or an Effect. If no parameter is given, it will connect to\nthe master output. Most p5sound objects connect to the master\noutput when they are created.
\n",itemtype:"method",name:"connect",params:[{name:"object",description:"Audio object that accepts an input
\n",type:"Object",optional:!0}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1738,description:"Disconnects the output of this p5sound object.
\n",itemtype:"method",name:"disconnect",class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1746,class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1751,description:"Reset the source for this SoundFile to a\nnew path (URL).
\n",itemtype:"method",name:"setPath",params:[{name:"path",description:"path to audio file
\n",type:"String"},{name:"callback",description:"Callback
\n",type:"Function"}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1764,description:"Replace the current Audio Buffer with a new Buffer.
\n",params:[{name:"buf",description:"Array of Float32 Array(s). 2 Float32 Arrays\n will create a stereo source. 1 will create\n a mono source.
\n",type:"Array"}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:1835,description:"processPeaks returns an array of timestamps where it thinks there is a beat.
\nThis is an asynchronous function that processes the soundfile in an offline audio context,\nand sends the results to your callback function.
\nThe process involves running the soundfile through a lowpass filter, and finding all of the\npeaks above the initial threshold. If the total number of peaks are below the minimum number of peaks,\nit decreases the threshold and re-runs the analysis until either minPeaks or minThreshold are reached.
\n",itemtype:"method",name:"processPeaks",params:[{name:"callback",description:"a function to call once this data is returned
\n",type:"Function"},{name:"initThreshold",description:"initial threshold defaults to 0.9
\n",type:"Number",optional:!0},{name:"minThreshold",description:"minimum threshold defaults to 0.22
\n",type:"Number",optional:!0},{name:"minPeaks",description:"minimum number of peaks defaults to 200
\n",type:"Number",optional:!0}],return:{description:"Array of timestamped peaks",type:"Array"},class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2026,class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2035,description:"Schedule events to trigger every time a MediaElement\n(audio/video) reaches a playback cue point.
\nAccepts a callback function, a time (in seconds) at which to trigger\nthe callback, and an optional parameter for the callback.
\nTime will be passed as the first parameter to the callback function,\nand param will be the second parameter.
\n",itemtype:"method",name:"addCue",params:[{name:"time",description:"Time in seconds, relative to this media\n element's playback. For example, to trigger\n an event every time playback reaches two\n seconds, pass in the number 2. This will be\n passed as the first parameter to\n the callback function.
\n",type:"Number"},{name:"callback",description:"Name of a function that will be\n called at the given time. The callback will\n receive time and (optionally) param as its\n two parameters.
\n",type:"Function"},{name:"value",description:"An object to be passed as the\n second parameter to the\n callback function.
\n",type:"Object",optional:!0}],return:{description:"id ID of this cue,\n useful for removeCue(id)",type:"Number"},example:['\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text(\'click to play\', width/2, height/2);\n\n mySound = loadSound(\'assets/beat.mp3\');\n\n // schedule calls to changeText\n mySound.addCue(0.50, changeText, "hello" );\n mySound.addCue(1.00, changeText, "p5" );\n mySound.addCue(1.50, changeText, "what" );\n mySound.addCue(2.00, changeText, "do" );\n mySound.addCue(2.50, changeText, "you" );\n mySound.addCue(3.00, changeText, "want" );\n mySound.addCue(4.00, changeText, "to" );\n mySound.addCue(5.00, changeText, "make" );\n mySound.addCue(6.00, changeText, "?" );\n}\n\nfunction changeText(val) {\n background(0);\n text(val, width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (mySound.isPlaying() ) {\n mySound.stop();\n } else {\n mySound.play();\n }\n }\n}\n'],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2110,description:"Remove a callback based on its ID. The ID is returned by the\naddCue method.
\n",itemtype:"method",name:"removeCue",params:[{name:"id",description:"ID of the cue, as returned by addCue
\n",type:"Number"}],class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2128,description:"Remove all of the callbacks that had originally been scheduled\nvia the addCue method.
\n",itemtype:"method",name:"clearCues",class:"p5.SoundFile",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2236,description:"Connects to the p5sound instance (master output) by default.\nOptionally, you can pass in a specific source (i.e. a soundfile).
\n",itemtype:"method",name:"setInput",params:[{name:"snd",description:"set the sound source\n (optional, defaults to\n master output)
\n",type:"SoundObject|undefined",optional:!0},{name:"smoothing",description:"a range between 0.0 and 1.0\n to smooth amplitude readings
\n",type:"Number|undefined",optional:!0}],example:["\n\nfunction preload(){\n sound1 = loadSound('assets/beat.mp3');\n sound2 = loadSound('assets/drum.mp3');\n}\nfunction setup(){\n amplitude = new p5.Amplitude();\n sound1.play();\n sound2.play();\n amplitude.setInput(sound2);\n}\nfunction draw() {\n background(0);\n fill(255);\n var level = amplitude.getLevel();\n var size = map(level, 0, 1, 0, 200);\n ellipse(width/2, height/2, size, size);\n}\nfunction mouseClicked(){\n sound1.stop();\n sound2.stop();\n}\n"],class:"p5.Amplitude",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2341,description:"Returns a single Amplitude reading at the moment it is called.\nFor continuous readings, run in the draw loop.
\n",itemtype:"method",name:"getLevel",params:[{name:"channel",description:"Optionally return only channel 0 (left) or 1 (right)
\n",type:"Number",optional:!0}],return:{description:"Amplitude as a number between 0.0 and 1.0",type:"Number"},example:["\n\nfunction preload(){\n sound = loadSound('assets/beat.mp3');\n}\nfunction setup() {\n amplitude = new p5.Amplitude();\n sound.play();\n}\nfunction draw() {\n background(0);\n fill(255);\n var level = amplitude.getLevel();\n var size = map(level, 0, 1, 0, 200);\n ellipse(width/2, height/2, size, size);\n}\nfunction mouseClicked(){\n sound.stop();\n}\n"],class:"p5.Amplitude",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2382,description:"Determines whether the results of Amplitude.process() will be\nNormalized. To normalize, Amplitude finds the difference the\nloudest reading it has processed and the maximum amplitude of\n1.0. Amplitude adds this difference to all values to produce\nresults that will reliably map between 0.0 and 1.0. However,\nif a louder moment occurs, the amount that Normalize adds to\nall the values will change. Accepts an optional boolean parameter\n(true or false). Normalizing is off by default.
\n",itemtype:"method",name:"toggleNormalize",params:[{name:"boolean",description:"set normalize to true (1) or false (0)
\n",type:"Boolean",optional:!0}],class:"p5.Amplitude",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2402,description:"Smooth Amplitude analysis by averaging with the last analysis\nframe. Off by default.
\n",itemtype:"method",name:"smooth",params:[{name:"set",description:"smoothing from 0.0 <= 1
\n",type:"Number"}],class:"p5.Amplitude",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2571,description:"Set the input source for the FFT analysis. If no source is\nprovided, FFT will analyze all sound in the sketch.
\n",itemtype:"method",name:"setInput",params:[{name:"source",description:"p5.sound object (or web audio API source node)
\n",type:"Object",optional:!0}],class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2590,description:"Returns an array of amplitude values (between -1.0 and +1.0) that represent\na snapshot of amplitude readings in a single buffer. Length will be\nequal to bins (defaults to 1024). Can be used to draw the waveform\nof a sound.
\n",itemtype:"method",name:"waveform",params:[{name:"bins",description:"Must be a power of two between\n 16 and 1024. Defaults to 1024.
\n",type:"Number",optional:!0},{name:"precision",description:"If any value is provided, will return results\n in a Float32 Array which is more precise\n than a regular array.
\n",type:"String",optional:!0}],return:{description:"Array Array of amplitude values (-1 to 1)\n over time. Array length = bins.",type:"Array"},class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2633,description:"Returns an array of amplitude values (between 0 and 255)\nacross the frequency spectrum. Length is equal to FFT bins\n(1024 by default). The array indices correspond to frequencies\n(i.e. pitches), from the lowest to the highest that humans can\nhear. Each value represents amplitude at that slice of the\nfrequency spectrum. Must be called prior to using\ngetEnergy().
\n",itemtype:"method",name:"analyze",params:[{name:"bins",description:"Must be a power of two between\n 16 and 1024. Defaults to 1024.
\n",type:"Number",optional:!0},{name:"scale",description:"If "dB," returns decibel\n float measurements between\n -140 and 0 (max).\n Otherwise returns integers from 0-255.
\n",type:"Number",optional:!0}],return:{description:"spectrum Array of energy (amplitude/volume)\n values across the frequency spectrum.\n Lowest energy (silence) = 0, highest\n possible is 255.",type:"Array"},example:["\n\nvar osc;\nvar fft;\n\nfunction setup(){\n createCanvas(100,100);\n osc = new p5.Oscillator();\n osc.amp(0);\n osc.start();\n fft = new p5.FFT();\n}\n\nfunction draw(){\n background(0);\n\n var freq = map(mouseX, 0, 800, 20, 15000);\n freq = constrain(freq, 1, 20000);\n osc.freq(freq);\n\n var spectrum = fft.analyze();\n noStroke();\n fill(0,255,0); // spectrum is green\n for (var i = 0; i< spectrum.length; i++){\n var x = map(i, 0, spectrum.length, 0, width);\n var h = -height + map(spectrum[i], 0, 255, height, 0);\n rect(x, height, width / spectrum.length, h );\n }\n\n stroke(255);\n text('Freq: ' + round(freq)+'Hz', 10, 10);\n\n isMouseOverCanvas();\n}\n\n// only play sound when mouse is over canvas\nfunction isMouseOverCanvas() {\n var mX = mouseX, mY = mouseY;\n if (mX > 0 && mX < width && mY < height && mY > 0) {\n osc.amp(0.5, 0.2);\n } else {\n osc.amp(0, 0.2);\n }\n}\n\n\n"],class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2725,description:'Returns the amount of energy (volume) at a specific\n\nfrequency, or the average amount of energy between two\nfrequencies. Accepts Number(s) corresponding\nto frequency (in Hz), or a String corresponding to predefined\nfrequency ranges ("bass", "lowMid", "mid", "highMid", "treble").\nReturns a range between 0 (no energy/volume at that frequency) and\n255 (maximum energy).\nNOTE: analyze() must be called prior to getEnergy(). Analyze()\ntells the FFT to analyze frequency data, and getEnergy() uses\nthe results determine the value at a specific frequency or\nrange of frequencies.
\n',itemtype:"method",name:"getEnergy",params:[{name:"frequency1",description:"Will return a value representing\n energy at this frequency. Alternately,\n the strings "bass", "lowMid" "mid",\n "highMid", and "treble" will return\n predefined frequency ranges.
\n",type:"Number|String"},{name:"frequency2",description:"If a second frequency is given,\n will return average amount of\n energy that exists between the\n two frequencies.
\n",type:"Number",optional:!0}],return:{description:"Energy Energy (volume/amplitude) from\n 0 and 255.",type:"Number"},class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2805,description:'Returns the\n\nspectral centroid of the input signal.\nNOTE: analyze() must be called prior to getCentroid(). Analyze()\ntells the FFT to analyze frequency data, and getCentroid() uses\nthe results determine the spectral centroid.
\n',itemtype:"method",name:"getCentroid",return:{description:"Spectral Centroid Frequency Frequency of the spectral centroid in Hz.",type:"Number"},
-example:['\n\n\n\nfunction setup(){\ncnv = createCanvas(800,400);\nsound = new p5.AudioIn();\nsound.start();\nfft = new p5.FFT();\nsound.connect(fft);\n}\n\n\nfunction draw(){\n\nvar centroidplot = 0.0;\nvar spectralCentroid = 0;\n\n\nbackground(0);\nstroke(0,255,0);\nvar spectrum = fft.analyze();\nfill(0,255,0); // spectrum is green\n\n//draw the spectrum\n\nfor (var i = 0; i< spectrum.length; i++){\n var x = map(log(i), 0, log(spectrum.length), 0, width);\n var h = map(spectrum[i], 0, 255, 0, height);\n var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length));\n rect(x, height, rectangle_width, -h )\n}\n\nvar nyquist = 22050;\n\n// get the centroid\nspectralCentroid = fft.getCentroid();\n\n// the mean_freq_index calculation is for the display.\nvar mean_freq_index = spectralCentroid/(nyquist/spectrum.length);\n\ncentroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width);\n\n\nstroke(255,0,0); // the line showing where the centroid is will be red\n\nrect(centroidplot, 0, width / spectrum.length, height)\nnoStroke();\nfill(255,255,255); // text is white\ntextSize(40);\ntext("centroid: "+round(spectralCentroid)+" Hz", 10, 40);\n}\n '],class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2886,description:"Smooth FFT analysis by averaging with the last analysis frame.
\n",itemtype:"method",name:"smooth",params:[{name:"smoothing",description:"0.0 < smoothing < 1.0.\n Defaults to 0.8.
\n",type:"Number"}],class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2906,description:"Returns an array of average amplitude values for a given number\nof frequency bands split equally. N defaults to 16.\nNOTE: analyze() must be called prior to linAverages(). Analyze()\ntells the FFT to analyze frequency data, and linAverages() uses\nthe results to group them into a smaller set of averages.
\n",itemtype:"method",name:"linAverages",params:[{name:"N",description:"Number of returned frequency groups
\n",type:"Number"}],return:{description:"linearAverages Array of average amplitude values for each group",type:"Array"},class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2936,description:'Returns an array of average amplitude values of the spectrum, for a given\nset of \nOctave Bands\nNOTE: analyze() must be called prior to logAverages(). Analyze()\ntells the FFT to analyze frequency data, and logAverages() uses\nthe results to group them into a smaller set of averages.
\n',itemtype:"method",name:"logAverages",params:[{name:"octaveBands",description:"Array of Octave Bands objects for grouping
\n",type:"Array"}],return:{description:"logAverages Array of average amplitude values for each group",type:"Array"},class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:2966,description:'Calculates and Returns the 1/N\nOctave Bands\nN defaults to 3 and minimum central frequency to 15.625Hz.\n(1/3 Octave Bands ~= 31 Frequency Bands)\nSetting fCtr0 to a central value of a higher octave will ignore the lower bands\nand produce less frequency groups.
\n',itemtype:"method",name:"getOctaveBands",params:[{name:"N",description:"Specifies the 1/N type of generated octave bands
\n",type:"Number"},{name:"fCtr0",description:"Minimum central frequency for the lowest band
\n",type:"Number"}],return:{description:"octaveBands Array of octave band objects with their bounds",type:"Array"},class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:3024,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:3427,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:3448,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:3507,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:3960,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4097,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4130,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4176,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4197,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4217,class:"p5.FFT",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4319,description:"Fade to value, for smooth transitions
\n",itemtype:"method",name:"fade",params:[{name:"value",description:"Value to set this signal
\n",type:"Number"},{name:"secondsFromNow",description:"Length of fade, in seconds from now
\n",type:"Number",optional:!0}],class:"p5.Signal",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4330,description:"Connect a p5.sound object or Web Audio node to this\np5.Signal so that its amplitude values can be scaled.
\n",params:[{name:"input",description:"",type:"Object"}],class:"p5.Signal",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4343,description:"Add a constant value to this audio signal,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalAdd.
\n",itemtype:"method",name:"add",params:[{name:"number",description:"",type:"Number"}],return:{description:"object",type:"p5.SignalAdd"},class:"p5.Signal",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4362,description:"Multiply this signal by a constant value,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalMult.
\n",itemtype:"method",name:"mult",params:[{name:"number",description:"to multiply
\n",type:"Number"}],return:{description:"object",type:"Tone.Multiply"},class:"p5.Signal",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4381,description:"Scale this signal value to a given range,\nand return the result as an audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalScale.
\n",itemtype:"method",name:"scale",params:[{name:"number",description:"to multiply
\n",type:"Number"},{name:"inMin",description:"input range minumum
\n",type:"Number"},{name:"inMax",description:"input range maximum
\n",type:"Number"},{name:"outMin",description:"input range minumum
\n",type:"Number"},{name:"outMax",description:"input range maximum
\n",type:"Number"}],return:{description:"object",type:"p5.SignalScale"},class:"p5.Signal",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4515,description:"Start an oscillator. Accepts an optional parameter to\ndetermine how long (in seconds from now) until the\noscillator starts.
\n",itemtype:"method",name:"start",params:[{name:"time",description:"startTime in seconds from now.
\n",type:"Number",optional:!0},{name:"frequency",description:"frequency in Hz.
\n",type:"Number",optional:!0}],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4555,description:"Stop an oscillator. Accepts an optional parameter\nto determine how long (in seconds from now) until the\noscillator stops.
\n",itemtype:"method",name:"stop",params:[{name:"secondsFromNow",description:"Time, in seconds from now.
\n",type:"Number"}],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4571,description:"Set the amplitude between 0 and 1.0. Or, pass in an object\nsuch as an oscillator to modulate amplitude with an audio signal.
\n",itemtype:"method",name:"amp",params:[{name:"vol",description:"between 0 and 1.0\n or a modulating signal/oscillator
\n",type:"Number|Object"},{name:"rampTime",description:"create a fade that lasts rampTime
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],return:{description:"gain If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's\n gain/amplitude/volume)",type:"AudioParam"},class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4606,description:"Set frequency of an oscillator to a value. Or, pass in an object\nsuch as an oscillator to modulate the frequency with an audio signal.
\n",itemtype:"method",name:"freq",params:[{name:"Frequency",description:"Frequency in Hz\n or modulating signal/oscillator
\n",type:"Number|Object"},{name:"rampTime",description:"Ramp time (in seconds)
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"Schedule this event to happen\n at x seconds from now
\n",type:"Number",optional:!0}],return:{description:"Frequency If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's frequency",type:"AudioParam"},example:["\n\nvar osc = new p5.Oscillator(300);\nosc.start();\nosc.freq(40, 10);\n"],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4665,description:"Set type to 'sine', 'triangle', 'sawtooth' or 'square'.
\n",itemtype:"method",name:"setType",params:[{name:"type",description:"'sine', 'triangle', 'sawtooth' or 'square'.
\n",type:"String"}],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4677,description:"Connect to a p5.sound / Web Audio object.
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"A p5.sound or Web Audio object
\n",type:"Object"}],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4694,description:"Disconnect all outputs
\n",itemtype:"method",name:"disconnect",class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4705,description:"Pan between Left (-1) and Right (1)
\n",itemtype:"method",name:"pan",params:[{name:"panning",description:"Number between -1 and 1
\n",type:"Number"},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number"}],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4737,description:"Set the phase of an oscillator between 0.0 and 1.0.\nIn this implementation, phase is a delay time\nbased on the oscillator's current frequency.
\n",itemtype:"method",name:"phase",params:[{name:"phase",description:"float between 0.0 and 1.0
\n",type:"Number"}],class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4791,description:"Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method again\nwill override the initial add() with a new value.
\n",itemtype:"method",name:"add",params:[{name:"number",description:"Constant number to add
\n",type:"Number"}],return:{description:"Oscillator Returns this oscillator\n with scaled output",type:"p5.Oscillator"},class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4808,description:"Multiply the p5.Oscillator's output amplitude\nby a fixed value (i.e. turn it up!). Calling this method\nagain will override the initial mult() with a new value.
\n",itemtype:"method",name:"mult",params:[{name:"number",description:"Constant number to multiply
\n",type:"Number"}],return:{description:"Oscillator Returns this oscillator\n with multiplied output",type:"p5.Oscillator"},class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4824,description:"Scale this oscillator's amplitude values to a given\nrange, and return the oscillator. Calling this method\nagain will override the initial scale() with new values.
\n",itemtype:"method",name:"scale",params:[{name:"inMin",description:"input range minumum
\n",type:"Number"},{name:"inMax",description:"input range maximum
\n",type:"Number"},{name:"outMin",description:"input range minumum
\n",type:"Number"},{name:"outMax",description:"input range maximum
\n",type:"Number"}],return:{description:"Oscillator Returns this oscillator\n with scaled output",type:"p5.Oscillator"},class:"p5.Oscillator",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:4923,class:"p5.SqrOsc",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5109,class:"p5.SqrOsc",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5333,description:"Time until envelope reaches attackLevel
\n",itemtype:"property",name:"attackTime",class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5338,description:"Level once attack is complete.
\n",itemtype:"property",name:"attackLevel",class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5343,description:"Time until envelope reaches decayLevel.
\n",itemtype:"property",name:"decayTime",class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5348,description:"Level after decay. The envelope will sustain here until it is released.
\n",itemtype:"property",name:"decayLevel",class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5353,description:"Duration of the release portion of the envelope.
\n",itemtype:"property",name:"releaseTime",class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5358,description:"Level at the end of the release.
\n",itemtype:"property",name:"releaseLevel",class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5394,description:"Reset the envelope with a series of time/value pairs.
\n",itemtype:"method",name:"set",params:[{name:"attackTime",description:"Time (in seconds) before level\n reaches attackLevel
\n",type:"Number"},{name:"attackLevel",description:"Typically an amplitude between\n 0.0 and 1.0
\n",type:"Number"},{name:"decayTime",description:"Time
\n",type:"Number"},{name:"decayLevel",description:"Amplitude (In a standard ADSR envelope,\n decayLevel = sustainLevel)
\n",type:"Number"},{name:"releaseTime",description:"Release Time (in seconds)
\n",type:"Number"},{name:"releaseLevel",description:"Amplitude
\n",type:"Number"}],example:["\n\nvar t1 = 0.1; // attack time in seconds\nvar l1 = 0.7; // attack level 0.0 to 1.0\nvar t2 = 0.3; // decay time in seconds\nvar l2 = 0.1; // decay level 0.0 to 1.0\nvar t3 = 0.2; // sustain time in seconds\nvar l3 = dL; // sustain level 0.0 to 1.0\n// release level defaults to zero\n\nvar env;\nvar triOsc;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env(t1, l1, t2, l2, t3, l3);\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env); // give the env control of the triOsc's amp\n triOsc.start();\n}\n\n// mouseClick triggers envelope if over canvas\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(triOsc);\n }\n}\n\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5453,description:'Set values like a traditional\n\nADSR envelope\n.
\n',itemtype:"method",name:"setADSR",params:[{name:"attackTime",description:"Time (in seconds before envelope\n reaches Attack Level
\n",type:"Number"},{name:"decayTime",description:"Time (in seconds) before envelope\n reaches Decay/Sustain Level
\n",type:"Number",optional:!0},{name:"susRatio",description:"Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.
\n",type:"Number",optional:!0},{name:"releaseTime",description:"Time in seconds from now (defaults to 0)
\n",type:"Number",optional:!0}],example:["\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5518,description:"Set max (attackLevel) and min (releaseLevel) of envelope.
\n",itemtype:"method",name:"setRange",params:[{name:"aLevel",description:"attack level (defaults to 1)
\n",type:"Number"},{name:"rLevel",description:"release level (defaults to 0)
\n",type:"Number"}],example:["\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n env.play();\n}\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5597,description:"Assign a parameter to be controlled by this envelope.\nIf a p5.Sound object is given, then the p5.Env will control its\noutput gain. If multiple inputs are provided, the env will\ncontrol all of them.
\n",itemtype:"method",name:"setInput",params:[{name:"inputs",description:"A p5.sound object or\n Web Audio Param.
\n",type:"Object",optional:!0,multiple:!0}],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5612,description:"Set whether the envelope ramp is linear (default) or exponential.\nExponential ramps can be useful because we perceive amplitude\nand frequency logarithmically.
\n",itemtype:"method",name:"setExp",params:[{name:"isExp",description:"true is exponential, false is linear
\n",type:"Boolean"}],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5630,description:'Play tells the envelope to start acting on a given input.\nIf the input is a p5.sound object (i.e. AudioIn, Oscillator,\nSoundFile), then Env will control its output volume.\nEnvelopes can also be used to control any \nWeb Audio Audio Param.
\n',itemtype:"method",name:"play",params:[{name:"unit",description:"A p5.sound object or\n Web Audio Param.
\n",type:"Object"},{name:"startTime",description:"time from now (in seconds) at which to play
\n",type:"Number",optional:!0},{name:"sustainTime",description:"time to sustain before releasing the envelope
\n",type:"Number",optional:!0}],example:["\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv(){\n // trigger env on triOsc, 0 seconds from now\n // After decay, sustain for 0.2 seconds before release\n env.play(triOsc, 0, 0.2);\n}\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5691,description:'Trigger the Attack, and Decay portion of the Envelope.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go. Input can be\nany p5.sound object, or a \nWeb Audio Param.
\n',itemtype:"method",name:"triggerAttack",params:[{name:"unit",description:"p5.sound Object or Web Audio Param
\n",type:"Object"},{name:"secondsFromNow",description:"time from now (in seconds)
\n",type:"Number"}],example:["\n\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack(){\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5800,description:"Trigger the Release of the Envelope. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.
\n",itemtype:"method",name:"triggerRelease",params:[{name:"unit",description:"p5.sound Object or Web Audio Param
\n",type:"Object"},{name:"secondsFromNow",description:"time to trigger the release
\n",type:"Number"}],example:["\n\n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack(){\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:5899,description:'Exponentially ramp to a value using the first two\nvalues from setADSR(attackTime, decayTime)\nas \ntime constants for simple exponential ramps.\nIf the value is higher than current value, it uses attackTime,\nwhile a decrease uses decayTime.
\n',itemtype:"method",name:"ramp",params:[{name:"unit",description:"p5.sound Object or Web Audio Param
\n",type:"Object"},{name:"secondsFromNow",description:"When to trigger the ramp
\n",type:"Number"},{name:"v",description:"Target value
\n",type:"Number"},{name:"v2",description:"Second target value (optional)
\n",type:"Number",optional:!0}],example:["\n\nvar env, osc, amp, cnv;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar attackLevel = 1;\nvar decayLevel = 0;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n fill(0,255,0);\n noStroke();\n\n env = new p5.Env();\n env.setADSR(attackTime, decayTime);\n\n osc = new p5.Oscillator();\n osc.amp(env);\n osc.start();\n\n amp = new p5.Amplitude();\n\n cnv.mousePressed(triggerRamp);\n}\n\nfunction triggerRamp() {\n env.ramp(osc, 0, attackLevel, decayLevel);\n}\n\nfunction draw() {\n background(20,20,20);\n text('click me', 10, 20);\n var h = map(amp.getLevel(), 0, 0.4, 0, height);;\n\n rect(0, height, width, -h);\n}\n"],class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6004,description:"Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method\nagain will override the initial add() with new values.
\n",itemtype:"method",name:"add",params:[{name:"number",description:"Constant number to add
\n",type:"Number"}],return:{description:"Envelope Returns this envelope\n with scaled output",type:"p5.Env"},class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6020,description:"Multiply the p5.Env's output amplitude\nby a fixed value. Calling this method\nagain will override the initial mult() with new values.
\n",itemtype:"method",name:"mult",params:[{name:"number",description:"Constant number to multiply
\n",type:"Number"}],return:{description:"Envelope Returns this envelope\n with scaled output",type:"p5.Env"},class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6036,description:"Scale this envelope's amplitude values to a given\nrange, and return the envelope. Calling this method\nagain will override the initial scale() with new values.
\n",itemtype:"method",name:"scale",params:[{name:"inMin",description:"input range minumum
\n",type:"Number"},{name:"inMax",description:"input range maximum
\n",type:"Number"},{name:"outMin",description:"input range minumum
\n",type:"Number"},{name:"outMax",description:"input range maximum
\n",type:"Number"}],return:{description:"Envelope Returns this envelope\n with scaled output",type:"p5.Env"},class:"p5.Env",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6140,description:"Set the width of a Pulse object (an oscillator that implements\nPulse Width Modulation).
\n",itemtype:"method",name:"width",params:[{name:"width",description:"Width between the pulses (0 to 1.0,\n defaults to 0)
\n",type:"Number",optional:!0}],class:"p5.Pulse",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6325,description:"Set type of noise to 'white', 'pink' or 'brown'.\nWhite is the default.
\n",itemtype:"method",name:"setType",params:[{name:"type",description:"'white', 'pink' or 'brown'
\n",type:"String",optional:!0}],class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6355,description:"Start the noise
\n",itemtype:"method",name:"start",class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6372,description:"Stop the noise.
\n",itemtype:"method",name:"stop",class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6384,description:"Pan the noise.
\n",itemtype:"method",name:"pan",params:[{name:"panning",description:"Number between -1 (left)\n and 1 (right)
\n",type:"Number"},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number"}],class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6393,description:"Set the amplitude of the noise between 0 and 1.0. Or,\nmodulate amplitude with an audio signal such as an oscillator.
\n",params:[{name:"volume",description:"amplitude between 0 and 1.0\n or modulating signal/oscillator
\n",type:"Number|Object"},{name:"rampTime",description:"create a fade that lasts rampTime
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6403,description:"Send output to a p5.sound or web audio object
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"",type:"Object"}],class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6409,description:"Disconnect all output.
\n",itemtype:"method",name:"disconnect",class:"p5.Noise",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6481,description:"Client must allow browser to access their microphone / audioin source.\nDefault: false. Will become true when the client enables acces.
\n",itemtype:"property",name:"enabled",type:"Boolean",class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6506,description:"Start processing audio input. This enables the use of other\nAudioIn methods like getLevel(). Note that by default, AudioIn\nis not connected to p5.sound's output. So you won't hear\nanything unless you use the connect() method.
\nCertain browsers limit access to the user's microphone. For example,\nChrome only allows access from localhost and over https. For this reason,\nyou may want to include an errorCallback—a function that is called in case\nthe browser won't provide mic access.
\n",itemtype:"method",name:"start",params:[{name:"successCallback",
-description:"Name of a function to call on\n success.
\n",type:"Function",optional:!0},{name:"errorCallback",description:"Name of a function to call if\n there was an error. For example,\n some browsers do not support\n getUserMedia.
\n",type:"Function",optional:!0}],class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6571,description:"Turn the AudioIn off. If the AudioIn is stopped, it cannot getLevel().\nIf re-starting, the user may be prompted for permission access.
\n",itemtype:"method",name:"stop",class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6583,description:"Connect to an audio unit. If no parameter is provided, will\nconnect to the master output (i.e. your speakers).
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"An object that accepts audio input,\n such as an FFT
\n",type:"Object",optional:!0}],class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6604,description:"Disconnect the AudioIn from all audio units. For example, if\nconnect() had been called, disconnect() will stop sending\nsignal to your speakers.
\n",itemtype:"method",name:"disconnect",class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6616,description:"Read the Amplitude (volume level) of an AudioIn. The AudioIn\nclass contains its own instance of the Amplitude class to help\nmake it easy to get a microphone's volume level. Accepts an\noptional smoothing value (0.0 < 1.0). NOTE: AudioIn must\n.start() before using .getLevel().
\n",itemtype:"method",name:"getLevel",params:[{name:"smoothing",description:"Smoothing is 0.0 by default.\n Smooths values based on previous values.
\n",type:"Number",optional:!0}],return:{description:"Volume level (between 0.0 and 1.0)",type:"Number"},class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6634,description:"Add input sources to the list of available sources.
\n",access:"private",tagname:"",class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6649,description:"Set amplitude (volume) of a mic input between 0 and 1.0.
\n",itemtype:"method",name:"amp",params:[{name:"vol",description:"between 0 and 1.0
\n",type:"Number"},{name:"time",description:"ramp time (optional)
\n",type:"Number",optional:!0}],class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6677,description:'Chrome only. Returns a list of available input sources\nand allows the user to set the media source. Firefox allows\nthe user to choose from input sources in the permissions dialogue\ninstead of enumerating available sources and selecting one.\nNote: in order to have descriptive media names your page must be\nserved over a secure (HTTPS) connection and the page should\nrequest user media before enumerating devices. Otherwise device\nID will be a long device ID number and does not specify device\ntype. For example see\nhttps://simpl.info/getusermedia/sources/index.html vs.\nhttp://simpl.info/getusermedia/sources/index.html
\n',itemtype:"method",name:"getSources",params:[{name:"callback",description:"a callback to handle the sources\n when they have been enumerated
\n",type:"Function"}],example:["\n \n var audiograb;\n\n function setup(){\n //new audioIn\n audioGrab = new p5.AudioIn();\n\n audioGrab.getSources(function(sourceList) {\n //print out the array of available sources\n console.log(sourceList);\n //set the source to the first item in the inputSources array\n audioGrab.setSource(0);\n });\n }\n "],class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6726,description:"Set the input source. Accepts a number representing a\nposition in the array returned by listSources().\nThis is only available in browsers that support\nMediaStreamTrack.getSources(). Instead, some browsers\ngive users the option to set their own media source.
\n",itemtype:"method",name:"setSource",params:[{name:"num",description:"position of input source in the array
\n",type:"Number"}],class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6763,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6779,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6803,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6829,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6858,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6888,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6936,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6959,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:6984,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7005,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7012,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7034,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7063,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7090,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7118,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7146,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7192,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7223,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7241,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7629,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7651,class:"p5.AudioIn",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7721,description:"The p5.Effect class is built\n using Tone.js CrossFade
\n",access:"private",tagname:"",class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7727,description:"In classes that extend\np5.Effect, connect effect nodes\nto the wet parameter
\n",class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7740,description:"Set the output volume of the filter.
\n",itemtype:"method",name:"amp",params:[{name:"vol",description:"amplitude between 0 and 1.0
\n",type:"Number",optional:!0},{name:"rampTime",description:"create a fade that lasts until rampTime
\n",type:"Number",optional:!0},{name:"tFromNow",description:"schedule this event to happen in tFromNow seconds
\n",type:"Number",optional:!0}],class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7757,description:"Link effects together in a chain
Example usage: filter.chain(reverb, delay, panner);\nMay be used with an open-ended number of arguments
\n",itemtype:"method",name:"chain",params:[{name:"arguments",description:"Chain together multiple sound objects
\n",type:"Object",optional:!0}],class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7774,description:"Adjust the dry/wet value.
\n",itemtype:"method",name:"drywet",params:[{name:"fade",description:"The desired drywet value (0 - 1.0)
\n",type:"Number",optional:!0}],class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7786,description:"Send output to a p5.js-sound, Web Audio Node, or use signal to\ncontrol an AudioParam
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"",type:"Object"}],class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7797,description:"Disconnect all output.
\n",itemtype:"method",name:"disconnect",class:"p5.Effect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7904,description:'The p5.Filter is built with a\n\nWeb Audio BiquadFilter Node.
\n',itemtype:"property",name:"biquadFilter",type:"DelayNode",class:"p5.Filter",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7919,description:"Filter an audio signal according to a set\nof filter parameters.
\n",itemtype:"method",name:"process",params:[{name:"Signal",description:"An object that outputs audio
\n",type:"Object"},{name:"freq",description:"Frequency in Hz, from 10 to 22050
\n",type:"Number",optional:!0},{name:"res",description:"Resonance/Width of the filter frequency\n from 0.001 to 1000
\n",type:"Number",optional:!0}],class:"p5.Filter",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7933,description:"Set the frequency and the resonance of the filter.
\n",itemtype:"method",name:"set",params:[{name:"freq",description:"Frequency in Hz, from 10 to 22050
\n",type:"Number",optional:!0},{name:"res",description:"Resonance (Q) from 0.001 to 1000
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],class:"p5.Filter",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7950,description:"Set the filter frequency, in Hz, from 10 to 22050 (the range of\nhuman hearing, although in reality most people hear in a narrower\nrange).
\n",itemtype:"method",name:"freq",params:[{name:"freq",description:"Filter Frequency
\n",type:"Number"},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],return:{description:"value Returns the current frequency value",type:"Number"},class:"p5.Filter",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7975,description:"Controls either width of a bandpass frequency,\nor the resonance of a low/highpass cutoff frequency.
\n",itemtype:"method",name:"res",params:[{name:"res",description:"Resonance/Width of filter freq\n from 0.001 to 1000
\n",type:"Number"},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],return:{description:"value Returns the current res value",type:"Number"},class:"p5.Filter",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:7997,description:"Set the type of a p5.Filter. Possible types include:\n"lowpass" (default), "highpass", "bandpass",\n"lowshelf", "highshelf", "peaking", "notch",\n"allpass".
\n",itemtype:"method",name:"setType",params:[{name:"t",description:"",type:"String"}],class:"p5.Filter",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8124,description:'The p5.Delay is built with two\n\nWeb Audio Delay Nodes, one for each stereo channel.
\n',itemtype:"property",name:"leftDelay",type:"DelayNode",class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8132,description:'The p5.Delay is built with two\n\nWeb Audio Delay Nodes, one for each stereo channel.
\n',itemtype:"property",name:"rightDelay",type:"DelayNode",class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8164,description:"Add delay to an audio signal according to a set\nof delay parameters.
\n",itemtype:"method",name:"process",params:[{name:"Signal",description:"An object that outputs audio
\n",type:"Object"},{name:"delayTime",description:"Time (in seconds) of the delay/echo.\n Some browsers limit delayTime to\n 1 second.
\n",type:"Number",optional:!0},{name:"feedback",description:"sends the delay back through itself\n in a loop that decreases in volume\n each time.
\n",type:"Number",optional:!0},{name:"lowPass",description:"Cutoff frequency. Only frequencies\n below the lowPass will be part of the\n delay.
\n",type:"Number",optional:!0}],class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8199,description:"Set the delay (echo) time, in seconds. Usually this value will be\na floating point number between 0.0 and 1.0.
\n",itemtype:"method",name:"delayTime",params:[{name:"delayTime",description:"Time (in seconds) of the delay
\n",type:"Number"}],class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8218,description:"Feedback occurs when Delay sends its signal back through its input\nin a loop. The feedback amount determines how much signal to send each\ntime through the loop. A feedback greater than 1.0 is not desirable because\nit will increase the overall output each time through the loop,\ncreating an infinite feedback loop. The default value is 0.5
\n",itemtype:"method",name:"feedback",params:[{name:"feedback",description:"0.0 to 1.0, or an object such as an\n Oscillator that can be used to\n modulate this param
\n",type:"Number|Object"}],return:{description:"Feedback value",type:"Number"},class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8246,description:"Set a lowpass filter frequency for the delay. A lowpass filter\nwill cut off any frequencies higher than the filter frequency.
\n",itemtype:"method",name:"filter",params:[{name:"cutoffFreq",description:"A lowpass filter will cut off any\n frequencies higher than the filter frequency.
\n",type:"Number|Object"},{name:"res",description:"Resonance of the filter frequency\n cutoff, or an object (i.e. a p5.Oscillator)\n that can be used to modulate this parameter.\n High numbers (i.e. 15) will produce a resonance,\n low numbers (i.e. .2) will produce a slope.
\n",type:"Number|Object"}],class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8263,description:"Choose a preset type of delay. 'pingPong' bounces the signal\nfrom the left to the right channel to produce a stereo effect.\nAny other parameter will revert to the default delay setting.
\n",itemtype:"method",name:"setType",params:[{name:"type",description:"'pingPong' (1) or 'default' (0)
\n",type:"String|Number"}],class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8296,description:"Set the output level of the delay effect.
\n",itemtype:"method",name:"amp",params:[{name:"volume",description:"amplitude between 0 and 1.0
\n",type:"Number"},{name:"rampTime",description:"create a fade that lasts rampTime
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8305,description:"Send output to a p5.sound or web audio object
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"",type:"Object"}],class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8311,description:"Disconnect all output.
\n",itemtype:"method",name:"disconnect",class:"p5.Delay",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8390,description:"Connect a source to the reverb, and assign reverb parameters.
\n",itemtype:"method",name:"process",params:[{name:"src",description:"p5.sound / Web Audio object with a sound\n output.
\n",type:"Object"},{name:"seconds",description:"Duration of the reverb, in seconds.\n Min: 0, Max: 10. Defaults to 3.
\n",type:"Number",optional:!0},{name:"decayRate",description:"Percentage of decay with each echo.\n Min: 0, Max: 100. Defaults to 2.
\n",type:"Number",optional:!0},{name:"reverse",description:"Play the reverb backwards or forwards.
\n",type:"Boolean",optional:!0}],class:"p5.Reverb",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8419,description:"Set the reverb settings. Similar to .process(), but without\nassigning a new input.
\n",itemtype:"method",name:"set",params:[{name:"seconds",description:"Duration of the reverb, in seconds.\n Min: 0, Max: 10. Defaults to 3.
\n",type:"Number",optional:!0},{name:"decayRate",description:"Percentage of decay with each echo.\n Min: 0, Max: 100. Defaults to 2.
\n",type:"Number",optional:!0},{name:"reverse",description:"Play the reverb backwards or forwards.
\n",type:"Boolean",optional:!0}],class:"p5.Reverb",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8447,description:"Set the output level of the reverb effect.
\n",itemtype:"method",name:"amp",params:[{name:"volume",description:"amplitude between 0 and 1.0
\n",type:"Number"},{name:"rampTime",description:"create a fade that lasts rampTime
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],class:"p5.Reverb",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8456,description:"Send output to a p5.sound or web audio object
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"",type:"Object"}],class:"p5.Reverb",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8462,description:"Disconnect all output.
\n",itemtype:"method",name:"disconnect",class:"p5.Reverb",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8467,description:'Inspired by Simple Reverb by Jordan Santell\nhttps://github.com/web-audio-components/simple-reverb/blob/master/index.js
\nUtility function for building an impulse response\nbased on the module parameters.
\n',access:"private",tagname:"",class:"p5.Reverb",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8556,description:'Internally, the p5.Convolver uses the a\n\nWeb Audio Convolver Node.
\n',itemtype:"property",name:"convolverNod",type:"ConvolverNode",class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8581,description:"Create a p5.Convolver. Accepts a path to a soundfile\nthat will be used to generate an impulse response.
\n",itemtype:"method",name:"createConvolver",params:[{name:"path",description:"path to a sound file
\n",type:"String"},{name:"callback",description:"function to call if loading is successful.\n The object will be passed in as the argument\n to the callback function.
\n",type:"Function",optional:!0},{name:"errorCallback",description:"function to call if loading is not successful.\n A custom error will be passed in as the argument\n to the callback function.
\n",type:"Function",optional:!0}],return:{description:"",type:"p5.Convolver"},example:["\n\nvar cVerb, sound;\nfunction preload() {\n // We have both MP3 and OGG versions of all sound assets\n soundFormats('ogg', 'mp3');\n\n // Try replacing 'bx-spring' with other soundfiles like\n // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox'\n cVerb = createConvolver('assets/bx-spring.mp3');\n\n // Try replacing 'Damscray_DancingTiger' with\n // 'beat', 'doorbell', lucky_dragons_-_power_melody'\n sound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n // disconnect from master output...\n sound.disconnect();\n\n // ...and process with cVerb\n // so that we only hear the convolution\n cVerb.process(sound);\n\n sound.play();\n}\n"],class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8631,description:"Private method to load a buffer as an Impulse Response,\nassign it to the convolverNode, and add to the Array of .impulses.
\n",params:[{name:"path",description:"",type:"String"},{name:"callback",description:"",type:"Function"},{name:"errorCallback",description:"",type:"Function"}],access:"private",tagname:"",class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8697,description:"Connect a source to the reverb, and assign reverb parameters.
\n",itemtype:"method",name:"process",params:[{name:"src",description:"p5.sound / Web Audio object with a sound\n output.
\n",type:"Object"}],example:["\n\nvar cVerb, sound;\nfunction preload() {\n soundFormats('ogg', 'mp3');\n\n cVerb = createConvolver('assets/concrete-tunnel.mp3');\n\n sound = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n // disconnect from master output...\n sound.disconnect();\n\n // ...and process with (i.e. connect to) cVerb\n // so that we only hear the convolution\n cVerb.process(sound);\n\n sound.play();\n}\n"],class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8729,description:"If you load multiple impulse files using the .addImpulse method,\nthey will be stored as Objects in this Array. Toggle between them\nwith the toggleImpulse(id) method.
\n",itemtype:"property",name:"impulses",type:"Array",class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8737,description:"Load and assign a new Impulse Response to the p5.Convolver.\nThe impulse is added to the .impulses array. Previous\nimpulses can be accessed with the .toggleImpulse(id)\nmethod.
\n",itemtype:"method",name:"addImpulse",params:[{name:"path",description:"path to a sound file
\n",type:"String"},{name:"callback",description:"function (optional)
\n",type:"Function"},{name:"errorCallback",description:"function (optional)
\n",type:"Function"}],class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8755,description:"Similar to .addImpulse, except that the .impulses\nArray is reset to save memory. A new .impulses\narray is created with this impulse as the only item.
\n",itemtype:"method",name:"resetImpulse",params:[{name:"path",description:"path to a sound file
\n",type:"String"},{name:"callback",description:"function (optional)
\n",type:"Function"},{name:"errorCallback",description:"function (optional)
\n",type:"Function"}],class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8773,description:'If you have used .addImpulse() to add multiple impulses\nto a p5.Convolver, then you can use this method to toggle between\nthe items in the .impulses Array. Accepts a parameter\nto identify which impulse you wish to use, identified either by its\noriginal filename (String) or by its position in the .impulses\n Array (Number).
\nYou can access the objects in the .impulses Array directly. Each\nObject has two attributes: an .audioBuffer (type:\nWeb Audio \nAudioBuffer) and a .name, a String that corresponds\nwith the original filename.
\n',itemtype:"method",name:"toggleImpulse",params:[{name:"id",description:"Identify the impulse by its original filename\n (String), or by its position in the\n .impulses Array (Number).
\n",type:"String|Number"}],class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8817,class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:8842,class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9059,description:"Set the global tempo, in beats per minute, for all\np5.Parts. This method will impact all active p5.Parts.
\n",params:[{name:"BPM",description:"Beats Per Minute
\n",type:"Number"},{name:"rampTime",description:"Seconds from now
\n",type:"Number"}],class:"p5.Convolver",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9148,description:"Array of values to pass into the callback\nat each step of the phrase. Depending on the callback\nfunction's requirements, these values may be numbers,\nstrings, or an object with multiple parameters.\nZero (0) indicates a rest.
\n",itemtype:"property",name:"sequence",type:"Array",class:"p5.Phrase",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9236,description:"Set the tempo of this part, in Beats Per Minute.
\n",itemtype:"method",name:"setBPM",params:[{name:"BPM",description:"Beats Per Minute
\n",type:"Number"},{name:"rampTime",description:"Seconds from now
\n",type:"Number",optional:!0}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9246,description:"Returns the Beats Per Minute of this currently part.
\n",itemtype:"method",name:"getBPM",return:{description:"",type:"Number"},class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9255,description:"Start playback of this part. It will play\nthrough all of its phrases at a speed\ndetermined by setBPM.
\n",itemtype:"method",name:"start",params:[{name:"time",description:"seconds from now
\n",type:"Number",optional:!0}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9271,description:"Loop playback of this part. It will begin\nlooping through all of its phrases at a speed\ndetermined by setBPM.
\n",itemtype:"method",name:"loop",params:[{name:"time",description:"seconds from now
\n",type:"Number",optional:!0}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9288,description:"Tell the part to stop looping.
\n",itemtype:"method",name:"noLoop",class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9300,description:"Stop the part and cue it to step 0.
\n",itemtype:"method",name:"stop",params:[{name:"time",description:"seconds from now
\n",type:"Number",optional:!0}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9310,description:"Pause the part. Playback will resume\nfrom the current step.
\n",itemtype:"method",name:"pause",params:[{name:"time",description:"seconds from now
\n",type:"Number"}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9322,description:"Add a p5.Phrase to this Part.
\n",itemtype:"method",name:"addPhrase",params:[{name:"phrase",description:"reference to a p5.Phrase
\n",type:"p5.Phrase"}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9343,description:"Remove a phrase from this part, based on the name it was\ngiven when it was created.
\n",itemtype:"method",name:"removePhrase",params:[{name:"phraseName",description:"",type:"String"}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9357,description:"Get a phrase from this part, based on the name it was\ngiven when it was created. Now you can modify its array.
\n",itemtype:"method",name:"getPhrase",params:[{name:"phraseName",description:"",type:"String"}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9371,description:"Get a phrase from this part, based on the name it was\ngiven when it was created. Now you can modify its array.
\n",itemtype:"method",name:"replaceSequence",params:[{name:"phraseName",description:"",type:"String"},{name:"sequence",description:"Array of values to pass into the callback\n at each step of the phrase.
\n",type:"Array"}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9399,description:"Fire a callback function at every step.
\n",itemtype:"method",name:"onStep",params:[{name:"callback",description:"The name of the callback\n you want to fire\n on every beat/tatum.
\n",type:"Function"}],class:"p5.Part",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9452,description:"Start playback of the score.
\n",itemtype:"method",name:"start",class:"p5.Score",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9461,description:"Stop playback of the score.
\n",itemtype:"method",name:"stop",class:"p5.Score",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9471,description:"Pause playback of the score.
\n",itemtype:"method",name:"pause",class:"p5.Score",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9479,description:"Loop playback of the score.
\n",itemtype:"method",name:"loop",class:"p5.Score",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9488,description:"Stop looping playback of the score. If it\nis currently playing, this will go into effect\nafter the current round of playback completes.
\n",itemtype:"method",name:"noLoop",class:"p5.Score",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9513,description:"Set the tempo for all parts in the score
\n",params:[{name:"BPM",description:"Beats Per Minute
\n",type:"Number"},{name:"rampTime",description:"Seconds from now
\n",type:"Number"}],class:"p5.Score",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9567,
-description:'The p5.Compressor is built with a Web Audio Dynamics Compressor Node\n
\n',itemtype:"property",name:"compressor",type:"WebAudioNode",class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9578,description:"Performs the same function as .connect, but also accepts\noptional parameters to set compressor's audioParams
\n",itemtype:"method",name:"process",params:[{name:"src",description:"Sound source to be connected
\n",type:"Object"},{name:"attack",description:"The amount of time (in seconds) to reduce the gain by 10dB,\n default = .003, range 0 - 1
\n",type:"Number",optional:!0},{name:"knee",description:"A decibel value representing the range above the \n threshold where the curve smoothly transitions to the "ratio" portion.\n default = 30, range 0 - 40
\n",type:"Number",optional:!0},{name:"ratio",description:"The amount of dB change in input for a 1 dB change in output\n default = 12, range 1 - 20
\n",type:"Number",optional:!0},{name:"threshold",description:"The decibel value above which the compression will start taking effect\n default = -24, range -100 - 0
\n",type:"Number",optional:!0},{name:"release",description:"The amount of time (in seconds) to increase the gain by 10dB\n default = .25, range 0 - 1
\n",type:"Number",optional:!0}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9601,description:"Set the paramters of a compressor.
\n",itemtype:"method",name:"set",params:[{name:"attack",description:"The amount of time (in seconds) to reduce the gain by 10dB,\n default = .003, range 0 - 1
\n",type:"Number"},{name:"knee",description:"A decibel value representing the range above the \n threshold where the curve smoothly transitions to the "ratio" portion.\n default = 30, range 0 - 40
\n",type:"Number"},{name:"ratio",description:"The amount of dB change in input for a 1 dB change in output\n default = 12, range 1 - 20
\n",type:"Number"},{name:"threshold",description:"The decibel value above which the compression will start taking effect\n default = -24, range -100 - 0
\n",type:"Number"},{name:"release",description:"The amount of time (in seconds) to increase the gain by 10dB\n default = .25, range 0 - 1
\n",type:"Number"}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9633,description:"Get current attack or set value w/ time ramp
\n",itemtype:"method",name:"attack",params:[{name:"attack",description:"Attack is the amount of time (in seconds) to reduce the gain by 10dB,\n default = .003, range 0 - 1
\n",type:"Number",optional:!0},{name:"time",description:"Assign time value to schedule the change in value
\n",type:"Number",optional:!0}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9653,description:"Get current knee or set value w/ time ramp
\n",itemtype:"method",name:"knee",params:[{name:"knee",description:"A decibel value representing the range above the \n threshold where the curve smoothly transitions to the "ratio" portion.\n default = 30, range 0 - 40
\n",type:"Number",optional:!0},{name:"time",description:"Assign time value to schedule the change in value
\n",type:"Number",optional:!0}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9673,description:"Get current ratio or set value w/ time ramp
\n",itemtype:"method",name:"ratio",params:[{name:"ratio",description:"The amount of dB change in input for a 1 dB change in output\n default = 12, range 1 - 20
\n",type:"Number",optional:!0},{name:"time",description:"Assign time value to schedule the change in value
\n",type:"Number",optional:!0}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9692,description:"Get current threshold or set value w/ time ramp
\n",itemtype:"method",name:"threshold",params:[{name:"threshold",description:"The decibel value above which the compression will start taking effect\n default = -24, range -100 - 0
\n",type:"Number"},{name:"time",description:"Assign time value to schedule the change in value
\n",type:"Number",optional:!0}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9711,description:"Get current release or set value w/ time ramp
\n",itemtype:"method",name:"release",params:[{name:"release",description:"The amount of time (in seconds) to increase the gain by 10dB\n default = .25, range 0 - 1
\n",type:"Number"},{name:"time",description:"Assign time value to schedule the change in value
\n",type:"Number",optional:!0}],class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9731,description:"Return the current reduction value
\n",return:{description:"Value of the amount of gain reduction that is applied to the signal",type:"Number"},class:"p5.Compressor",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9828,description:"callback invoked when the recording is over
\n",access:"private",tagname:"",type:"Function(Float32Array)",class:"p5.SoundRecorder",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9841,description:"Connect a specific device to the p5.SoundRecorder.\nIf no parameter is given, p5.SoundRecorer will record\nall audible p5.sound from your sketch.
\n",itemtype:"method",name:"setInput",params:[{name:"unit",description:"p5.sound object or a web audio unit\n that outputs sound
\n",type:"Object",optional:!0}],class:"p5.SoundRecorder",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9862,description:"Start recording. To access the recording, provide\na p5.SoundFile as the first parameter. The p5.SoundRecorder\nwill send its recording to that p5.SoundFile for playback once\nrecording is complete. Optional parameters include duration\n(in seconds) of the recording, and a callback function that\nwill be called once the complete recording has been\ntransfered to the p5.SoundFile.
\n",itemtype:"method",name:"record",params:[{name:"soundFile",description:"p5.SoundFile
\n",type:"p5.SoundFile"},{name:"duration",description:"Time (in seconds)
\n",type:"Number",optional:!0},{name:"callback",description:"The name of a function that will be\n called once the recording completes
\n",type:"Function",optional:!0}],class:"p5.SoundRecorder",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9895,description:"Stop the recording. Once the recording is stopped,\nthe results will be sent to the p5.SoundFile that\nwas given on .record(), and if a callback function\nwas provided on record, that function will be called.
\n",itemtype:"method",name:"stop",class:"p5.SoundRecorder",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9914,description:"internal method called on audio process
\n",access:"private",tagname:"",params:[{name:"event",description:"",type:"AudioProcessorEvent"}],class:"p5.SoundRecorder",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:9968,description:"Save a p5.SoundFile as a .wav audio file.
\n",itemtype:"method",name:"saveSound",params:[{name:"soundFile",description:"p5.SoundFile that you wish to save
\n",type:"p5.SoundFile"},{name:"name",description:"name of the resulting .wav file.
\n",type:"String"}],class:"p5.SoundRecorder",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10144,description:"isDetected is set to true when a peak is detected.
\n",itemtype:"attribute",name:"isDetected",type:"Boolean",default:"false",class:"p5.PeakDetect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10157,description:"The update method is run in the draw loop.
\nAccepts an FFT object. You must call .analyze()\non the FFT object prior to updating the peakDetect\nbecause it relies on a completed FFT analysis.
\n",itemtype:"method",name:"update",params:[{name:"fftObject",description:"A p5.FFT object
\n",type:"p5.FFT"}],class:"p5.PeakDetect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10188,description:"onPeak accepts two arguments: a function to call when\na peak is detected. The value of the peak,\nbetween 0.0 and 1.0, is passed to the callback.
\n",itemtype:"method",name:"onPeak",params:[{name:"callback",description:"Name of a function that will\n be called when a peak is\n detected.
\n",type:"Function"},{name:"val",description:"Optional value to pass\n into the function when\n a peak is detected.
\n",type:"Object",optional:!0}],example:["\n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 0;\n\nfunction setup() {\n cnv = createCanvas(100,100);\n textAlign(CENTER);\n\n soundFile = loadSound('assets/beat.mp3');\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n\n setupSound();\n\n // when a beat is detected, call triggerBeat()\n peakDetect.onPeak(triggerBeat);\n}\n\nfunction draw() {\n background(0);\n fill(255);\n text('click to play', width/2, height/2);\n\n fft.analyze();\n peakDetect.update(fft);\n\n ellipseWidth *= 0.95;\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// this function is called by peakDetect.onPeak\nfunction triggerBeat() {\n ellipseWidth = 50;\n}\n\n// mouseclick starts/stops sound\nfunction setupSound() {\n cnv.mouseClicked( function() {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n });\n}\n"],class:"p5.PeakDetect",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10334,description:"Connect a source to the gain node.
\n",itemtype:"method",name:"setInput",params:[{name:"src",description:"p5.sound / Web Audio object with a sound\n output.
\n",type:"Object"}],class:"p5.Gain",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10344,description:"Send output to a p5.sound or web audio object
\n",itemtype:"method",name:"connect",params:[{name:"unit",description:"",type:"Object"}],class:"p5.Gain",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10354,description:"Disconnect all output.
\n",itemtype:"method",name:"disconnect",class:"p5.Gain",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10362,description:"Set the output level of the gain node.
\n",itemtype:"method",name:"amp",params:[{name:"volume",description:"amplitude between 0 and 1.0
\n",type:"Number"},{name:"rampTime",description:"create a fade that lasts rampTime
\n",type:"Number",optional:!0},{name:"timeFromNow",description:"schedule this event to happen\n seconds from now
\n",type:"Number",optional:!0}],class:"p5.Gain",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10443,description:'The p5.Distortion is built with a\n\nWeb Audio WaveShaper Node.
\n',itemtype:"property",name:"WaveShaperNode",type:"AudioNode",class:"p5.Distortion",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10458,description:"Process a sound source, optionally specify amount and oversample values.
\n",itemtype:"method",name:"process",params:[{name:"amount",description:"Unbounded distortion amount.\n Normal values range from 0-1.
\n",type:"Number",optional:!0,optdefault:"0.25"},{name:"oversample",description:"'none', '2x', or '4x'.
\n",type:"String",optional:!0,optdefault:"'none'"}],class:"p5.Distortion",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10470,description:"Set the amount and oversample of the waveshaper distortion.
\n",itemtype:"method",name:"set",params:[{name:"amount",description:"Unbounded distortion amount.\n Normal values range from 0-1.
\n",type:"Number",optional:!0,optdefault:"0.25"},{name:"oversample",description:"'none', '2x', or '4x'.
\n",type:"String",optional:!0,optdefault:"'none'"}],class:"p5.Distortion",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10488,description:"Return the distortion amount, typically between 0-1.
\n",itemtype:"method",name:"getAmount",return:{description:"Unbounded distortion amount.\n Normal values range from 0-1.",type:"Number"},class:"p5.Distortion",module:"p5.sound",submodule:"p5.sound"},{file:"lib/addons/p5.sound.js",line:10498,description:"Return the oversampling.
\n",itemtype:"method",name:"getOversample",return:{description:"Oversample can either be 'none', '2x', or '4x'.",type:"String"},class:"p5.Distortion",module:"p5.sound",submodule:"p5.sound"}],warnings:[{message:"unknown tag: alt",line:" src/color/creating_reading.js:16"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:60"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:89"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:118"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:326"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:356"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:392"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:489"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:518"},{message:"unknown tag: alt",line:" src/color/creating_reading.js:557"},{message:"unknown tag: alt",line:" src/color/p5.Color.js:447"},{message:"unknown tag: alt",line:" src/color/setting.js:15"},{message:"unknown tag: alt",line:" src/color/setting.js:178"},{message:"unknown tag: alt",line:" src/color/setting.js:235"},{message:"unknown tag: alt",line:" src/color/setting.js:373"},{message:"unknown tag: alt",line:" src/color/setting.js:489"},{message:"unknown tag: alt",line:" src/color/setting.js:514"},{message:"unknown tag: alt",line:" src/color/setting.js:581"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:16"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:132"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:187"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:262"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:313"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:393"},{message:"unknown tag: alt",line:" src/core/2d_primitives.js:477"},{message:"unknown tag: alt",line:" src/core/attributes.js:14"},{message:"unknown tag: alt",line:" src/core/attributes.js:80"},{message:"unknown tag: alt",line:" src/core/attributes.js:108"},{message:"unknown tag: alt",line:" src/core/attributes.js:174"},{message:"unknown tag: alt",line:" src/core/attributes.js:203"},{message:"unknown tag: alt",line:" src/core/attributes.js:237"},{message:"unknown tag: alt",line:" src/core/attributes.js:301"},{message:"unknown tag: alt",line:" src/core/constants.js:33"},{message:"unknown tag: alt",line:" src/core/constants.js:52"},{message:"unknown tag: alt",line:" src/core/constants.js:71"},{message:"unknown tag: alt",line:" src/core/constants.js:90"},{message:"unknown tag: alt",line:" src/core/constants.js:109"},{message:"unknown tag: alt",line:" src/core/core.js:49"},{message:"unknown tag: alt",line:" src/core/core.js:85"},{message:"unknown tag: alt",line:" src/core/core.js:116"},{message:"unknown tag: alt",line:" src/core/core.js:393"},{message:"unknown tag: alt",line:" src/core/curves.js:16"},{message:"unknown tag: alt",line:" src/core/curves.js:99"},{message:"unknown tag: alt",line:" src/core/curves.js:124"},{message:"unknown tag: alt",line:" src/core/curves.js:175"},{message:"unknown tag: alt",line:" src/core/curves.js:256"},{message:"unknown tag: alt",line:" src/core/curves.js:308"},{message:"unknown tag: alt",line:" src/core/curves.js:353"},{message:"unknown tag: alt",line:" src/core/curves.js:378"},{message:"unknown tag: alt",line:" src/core/curves.js:476"},{message:"unknown tag: alt",line:" src/core/environment.js:22"},{message:"unknown tag: alt",line:" src/core/environment.js:51"},{message:"unknown tag: alt",line:" src/core/environment.js:79"},{message:"unknown tag: alt",line:" src/core/environment.js:110"},{message:"unknown tag: alt",line:" src/core/environment.js:188"},{message:"unknown tag: alt",line:" src/core/environment.js:262"},{message:"unknown tag: alt",line:" src/core/environment.js:288"},{message:"unknown tag: alt",line:" src/core/environment.js:305"},{message:"unknown tag: alt",line:" src/core/environment.js:322"},{message:"unknown tag: alt",line:" src/core/environment.js:338"},{message:"unknown tag: alt",line:" src/core/environment.js:354"},{message:"unknown tag: alt",line:" src/core/environment.js:428"},{message:"replacing incorrect tag: returns with return",line:" src/core/environment.js:475"},{message:"unknown tag: alt",line:" src/core/environment.js:475"},{message:"replacing incorrect tag: returns with return",line:" src/core/environment.js:520"},{message:"unknown tag: alt",line:" src/core/environment.js:520"},{message:"unknown tag: alt",line:" src/core/environment.js:577"},{message:"unknown tag: alt",line:" src/core/environment.js:608"},{message:"unknown tag: alt",line:" src/core/environment.js:629"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:53"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:112"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:163"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:213"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:263"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:329"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:383"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:437"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:496"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:541"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:608"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:643"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:686"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:735"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:776"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:828"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:866"},{message:"unknown tag: alt",line:" src/core/p5.Element.js:904"},{message:"unknown tag: alt",line:" src/core/rendering.js:14"},{message:"unknown tag: alt",line:" src/core/rendering.js:112"},{message:"unknown tag: alt",line:" src/core/rendering.js:162"},{message:"unknown tag: alt",line:" src/core/rendering.js:185"},{message:"unknown tag: alt",line:" src/core/rendering.js:223"},{message:"unknown tag: alt",line:" src/core/structure.js:15"},{message:"unknown tag: alt",line:" src/core/structure.js:77"},{message:"unknown tag: alt",line:" src/core/structure.js:119"},{message:"unknown tag: alt",line:" src/core/structure.js:194"},{message:"unknown tag: alt",line:" src/core/structure.js:266"},{message:"unknown tag: alt",line:" src/core/transform.js:15"},{message:"unknown tag: alt",line:" src/core/transform.js:137"},{message:"unknown tag: alt",line:" src/core/transform.js:163"},{message:"unknown tag: alt",line:" src/core/transform.js:263"},{message:"unknown tag: alt",line:" src/core/transform.js:345"},{message:"unknown tag: alt",line:" src/core/transform.js:386"},{message:"unknown tag: alt",line:" src/core/transform.js:427"},{message:"unknown tag: alt",line:" src/core/vertex.js:22"},{message:"unknown tag: alt",line:" src/core/vertex.js:70"},{message:"unknown tag: alt",line:" src/core/vertex.js:267"},{message:"unknown tag: alt",line:" src/core/vertex.js:332"},{message:"unknown tag: alt",line:" src/core/vertex.js:374"},{message:"unknown tag: alt",line:" src/core/vertex.js:434"},{message:"unknown tag: alt",line:" src/core/vertex.js:502"},{message:"unknown tag: alt",line:" src/core/vertex.js:579"},{message:"unknown tag: alt",line:" src/events/acceleration.js:91"},{message:"unknown tag: alt",line:" src/events/acceleration.js:125"},{message:"unknown tag: alt",line:" src/events/acceleration.js:158"},{message:"unknown tag: alt",line:" src/events/acceleration.js:194"},{message:"unknown tag: alt",line:" src/events/acceleration.js:237"},{message:"unknown tag: alt",line:" src/events/acceleration.js:280"},{message:"unknown tag: alt",line:" src/events/acceleration.js:372"},{message:"unknown tag: alt",line:" src/events/acceleration.js:403"},{message:"unknown tag: alt",line:" src/events/acceleration.js:462"},{message:"unknown tag: alt",line:" src/events/keyboard.js:18"},{message:"unknown tag: alt",line:" src/events/keyboard.js:46"},{message:"unknown tag: alt",line:" src/events/keyboard.js:75"},{message:"unknown tag: alt",line:" src/events/keyboard.js:108"},{message:"unknown tag: alt",line:" src/events/keyboard.js:198"},{message:"unknown tag: alt",line:" src/events/keyboard.js:254"},{message:"unknown tag: alt",line:" src/events/keyboard.js:317"},{message:"unknown tag: alt",line:" src/events/mouse.js:23"},{message:"unknown tag: alt",line:" src/events/mouse.js:49"},{message:"unknown tag: alt",line:" src/events/mouse.js:75"},{message:"unknown tag: alt",line:" src/events/mouse.js:107"},{message:"unknown tag: alt",line:" src/events/mouse.js:137"},{message:"unknown tag: alt",line:" src/events/mouse.js:175"},{message:"unknown tag: alt",line:" src/events/mouse.js:213"},{message:"unknown tag: alt",line:" src/events/mouse.js:255"},{message:"unknown tag: alt",line:" src/events/mouse.js:298"},{message:"unknown tag: alt",line:" src/events/mouse.js:334"},{message:"unknown tag: alt",line:" src/events/mouse.js:416"},{message:"unknown tag: alt",line:" src/events/mouse.js:460"},{message:"unknown tag: alt",line:" src/events/mouse.js:531"},{message:"unknown tag: alt",line:" src/events/mouse.js:597"},{message:"unknown tag: alt",line:" src/events/mouse.js:664"},{message:"unknown tag: alt",line:" src/events/mouse.js:723"},{message:"unknown tag: alt",line:" src/events/mouse.js:781"},{message:"unknown tag: alt",line:" src/events/touch.js:53"},{message:"unknown tag: alt",line:" src/events/touch.js:116"},{message:"unknown tag: alt",line:" src/events/touch.js:178"},{message:"unknown tag: alt",line:" src/image/image.js:24"},{message:"unknown tag: alt",line:" src/image/image.js:115"},{message:"unknown tag: alt",line:" src/image/image.js:233"},{message:"unknown tag: alt",line:" src/image/loading_displaying.js:17"},{message:"replacing incorrect tag: returns with return",line:" src/image/loading_displaying.js:107"},{message:"unknown tag: alt",line:" src/image/loading_displaying.js:125"},{message:"unknown tag: alt",line:" src/image/loading_displaying.js:325"},{message:"unknown tag: alt",line:" src/image/loading_displaying.js:384"},{message:"unknown tag: alt",line:" src/image/loading_displaying.js:449"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:45"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:72"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:106"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:186"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:236"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:270"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:315"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:353"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:435"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:480"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:543"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:577"},{message:"unknown tag: alt",line:" src/image/p5.Image.js:684"},{message:"unknown tag: alt",line:" src/image/pixels.js:14"},{message:"unknown tag: alt",line:" src/image/pixels.js:83"},{message:"unknown tag: alt",line:" src/image/pixels.js:165"},{message:"unknown tag: alt",line:" src/image/pixels.js:212"},{message:"unknown tag: alt",line:" src/image/pixels.js:390"},{message:"unknown tag: alt",line:" src/image/pixels.js:461"},{message:"unknown tag: alt",line:" src/image/pixels.js:498"},{message:"unknown tag: alt",line:" src/image/pixels.js:572"},{message:"unknown tag: alt",line:" src/io/files.js:19"},{message:"unknown tag: alt",line:" src/io/files.js:145"},{message:"unknown tag: alt",line:" src/io/files.js:237"},{message:"unknown tag: alt",line:" src/io/files.js:558"},{message:"unknown tag: alt",line:" src/io/files.js:1194"},{message:"unknown tag: alt",line:" src/io/files.js:1248"},{message:"unknown tag: alt",line:" src/io/files.js:1306"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:58"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:121"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:170"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:215"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:263"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:329"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:498"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:551"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:593"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:757"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:826"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:875"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:937"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:984"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:1029"},{message:"unknown tag: alt",line:" src/io/p5.Table.js:1077"},{message:"unknown tag: alt",line:" src/io/p5.XML.js:11"},{message:"unknown tag: alt",line:" src/math/calculation.js:12"},{message:"unknown tag: alt",line:" src/math/calculation.js:36"},{message:"unknown tag: alt",line:" src/math/calculation.js:76"},{message:"unknown tag: alt",line:" src/math/calculation.js:130"},{message:"unknown tag: alt",line:" src/math/calculation.js:184"},{message:"unknown tag: alt",line:" src/math/calculation.js:234"},{message:"unknown tag: alt",line:" src/math/calculation.js:273"},{message:"unknown tag: alt",line:" src/math/calculation.js:317"},{message:"unknown tag: alt",line:" src/math/calculation.js:371"},{message:"unknown tag: alt",line:" src/math/calculation.js:409"},{message:"unknown tag: alt",line:" src/math/calculation.js:464"},{message:"unknown tag: alt",line:" src/math/calculation.js:507"},{message:"unknown tag: alt",line:" src/math/calculation.js:550"},{message:"unknown tag: alt",line:" src/math/calculation.js:602"},{message:"unknown tag: alt",line:" src/math/calculation.js:636"},{message:"unknown tag: alt",line:" src/math/calculation.js:675"},{message:"unknown tag: alt",line:" src/math/calculation.js:720"},{message:"unknown tag: alt",line:" src/math/noise.js:41"},{message:"unknown tag: alt",line:" src/math/noise.js:171"},{message:"unknown tag: alt",line:" src/math/noise.js:233"},{message:"unknown tag: alt",line:" src/math/p5.Vector.js:13"},{message:"unknown tag: alt",line:" src/math/random.js:47"},{message:"unknown tag: alt",line:" src/math/random.js:78"},{message:"unknown tag: alt",line:" src/math/random.js:168"},{message:"unknown tag: alt",line:" src/math/trigonometry.js:134"},{message:"unknown tag: alt",line:" src/math/trigonometry.js:174"},{message:"unknown tag: alt",line:" src/math/trigonometry.js:206"},{message:"unknown tag: alt",line:" src/math/trigonometry.js:238"},{message:"unknown tag: alt",line:" src/math/trigonometry.js:320"},{message:"unknown tag: alt",line:" src/typography/attributes.js:13"},{message:"unknown tag: alt",line:" src/typography/attributes.js:63"},{message:"unknown tag: alt",line:" src/typography/attributes.js:100"},{message:"unknown tag: alt",line:" src/typography/attributes.js:133"},{message:"unknown tag: alt",line:" src/typography/attributes.js:158"},{message:"unknown tag: alt",line:" src/typography/loading_displaying.js:16"},{message:"unknown tag: alt",line:" src/typography/loading_displaying.js:135"},{message:"unknown tag: alt",line:" src/typography/loading_displaying.js:197"},{message:"unknown tag: alt",line:" src/typography/p5.Font.js:47"},{message:"unknown tag: alt",line:" src/utilities/conversion.js:12"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:15"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:44"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:146"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:257"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:339"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:404"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:454"},{message:"unknown tag: alt",line:" src/utilities/string_functions.js:550"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:12"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:34"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:56"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:78"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:101"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:123"},{message:"unknown tag: alt",line:" src/utilities/time_date.js:145"},{message:"unknown tag: alt",line:" src/webgl/camera.js:12"},{message:"unknown tag: alt",line:" src/webgl/camera.js:160"},{message:"unknown tag: alt",line:" src/webgl/camera.js:232"},{message:"unknown tag: alt",line:" src/webgl/light.js:40"},{message:"unknown tag: alt",line:" src/webgl/light.js:89"},{message:"unknown tag: alt",line:" src/webgl/light.js:168"},{message:"unknown tag: alt",line:" src/webgl/loading.js:35"},{message:"unknown tag: alt",line:" src/webgl/loading.js:197"},{message:"unknown tag: alt",line:" src/webgl/material.js:81"},{message:"unknown tag: alt",line:" src/webgl/material.js:113"},{message:"unknown tag: alt",line:" src/webgl/material.js:210"},{message:"unknown tag: alt",line:" src/webgl/material.js:253"},{message:"unknown tag: alt",line:" src/webgl/p5.RendererGL.js:352"},{message:"unknown tag: alt",line:" src/webgl/p5.RendererGL.js:400"},{message:"unknown tag: alt",line:" src/webgl/p5.RendererGL.js:431"},{message:"unknown tag: alt",line:" src/webgl/p5.RendererGL.js:460"},{message:"unknown tag: alt",line:" src/webgl/p5.RendererGL.js:505"},{message:"unknown tag: alt",line:" src/webgl/primitives.js:13"},{message:"replacing incorrect tag: params with param",line:" lib/addons/p5.sound.js:1577"},{message:"replacing incorrect tag: returns with return",line:" lib/addons/p5.sound.js:1577"},{message:"replacing incorrect tag: returns with return",line:" lib/addons/p5.sound.js:8218"},{
-message:"Missing item type\nConversions adapted from .\n\nIn these functions, hue is always in the range [0,1); all other components\nare in the range [0,1]. 'Brightness' and 'value' are used interchangeably.",line:" src/color/color_conversion.js:10"},{message:"Missing item type\nConvert an HSBA array to HSLA.",line:" src/color/color_conversion.js:20"},{message:"Missing item type\nConvert an HSBA array to RGBA.",line:" src/color/color_conversion.js:46"},{message:"Missing item type\nConvert an HSLA array to HSBA.",line:" src/color/color_conversion.js:95"},{message:"Missing item type\nConvert an HSLA array to RGBA.\n\nWe need to change basis from HSLA to something that can be more easily be\nprojected onto RGBA. We will choose hue and brightness as our first two\ncomponents, and pick a convenient third one ('zest') so that we don't need\nto calculate formal HSBA saturation.",line:" src/color/color_conversion.js:118"},{message:"Missing item type\nConvert an RGBA array to HSBA.",line:" src/color/color_conversion.js:176"},{message:"Missing item type\nConvert an RGBA array to HSLA.",line:" src/color/color_conversion.js:211"},{message:"Missing item type\nHue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.",line:" src/color/p5.Color.js:118"},{message:"Missing item type\nSaturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.",line:" src/color/p5.Color.js:149"},{message:"Missing item type\nCSS named colors.",line:" src/color/p5.Color.js:168"},{message:"Missing item type\nThese regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.\n\nNote that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.",line:" src/color/p5.Color.js:321"},{message:"Missing item type\nFull color string patterns. The capture groups are necessary.",line:" src/color/p5.Color.js:334"},{message:"Missing item type\nFor a number of different inputs, returns a color formatted as [r, g, b, a]\narrays, with each component normalized between 0 and 1.",line:" src/color/p5.Color.js:447"},{message:"Missing item type\nFor HSB and HSL, interpret the gray level as a brightness/lightness\nvalue (they are equivalent when chroma is zero). For RGB, normalize the\ngray level according to the blue maximum.",line:" src/color/p5.Color.js:638"},{message:"Missing item type",line:" src/core/canvas.js:1"},{message:'Missing item type\nThis is the p5 instance constructor.\n\nA p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.\n\nA p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object',line:" src/core/core.js:15"},{message:"Missing item type\nSets the resolution at which Beziers display.\n\nThe default value is 20.",line:" src/core/curves.js:99"},{message:"Missing item type\nSets the resolution at which curves display.\n\nThe default value is 20.",line:" src/core/curves.js:353"},{message:"Missing item type\nReturns the current framerate.",line:" src/core/environment.js:238"},{message:"Missing item type\nSpecifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second.\n\nCalling frameRate() with no arguments returns the current framerate.",line:" src/core/environment.js:247"},{message:"Missing item type",line:" src/core/error_helpers.js:1"},{message:"Missing item type\nPrints out a fancy, colorful message to the console log",line:" src/core/error_helpers.js:34"},{message:'Missing item type\nValidates parameters\nparam {String} func the name of the function\nparam {Array} args user input arguments\n\nexample:\n var a;\n ellipse(10,10,a,5);\nconsole ouput:\n "It looks like ellipse received an empty variable in spot #2."\n\nexample:\n ellipse(10,"foo",5,5);\nconsole output:\n "ellipse was expecting a number for parameter #1,\n received "foo" instead."',line:" src/core/error_helpers.js:106"},{message:"Missing item type\nPrints out all the colors in the color pallete with white text.\nFor color blindness testing.",line:" src/core/error_helpers.js:273"},{message:'Missing item type\n_globalInit\n\nTODO: ???\nif sketch is on window\nassume "global" mode\nand instantiate p5 automatically\notherwise do nothing',line:" src/core/init.js:5"},{message:"Missing item type\nHelper fxn for sharing pixel methods",line:" src/core/p5.Element.js:1031"},{message:"Missing item type\nResize our canvas element.",line:" src/core/p5.Renderer.js:72"},{message:"Missing item type\nHelper fxn to check font type (system or otf)",line:" src/core/p5.Renderer.js:146"},{message:"Missing item type\nHelper fxn to measure ascent and descent.\nAdapted from http://stackoverflow.com/a/25355178",line:" src/core/p5.Renderer.js:202"},{message:"Missing item type\np5.Renderer2D\nThe 2D graphics canvas renderer class.\nextends p5.Renderer",line:" src/core/p5.Renderer2D.js:9"},{message:"Missing item type\nGenerate a cubic Bezier representing an arc on the unit circle of total\nangle `size` radians, beginning `start` radians above the x-axis. Up to\nfour of these curves are combined to make a full arc.\n\nSee www.joecridge.me/bezier.pdf for an explanation of the method.",line:" src/core/p5.Renderer2D.js:356"},{message:"Missing item type\nshim for Uint8ClampedArray.slice\n(allows arrayCopy to work with pixels[])\nwith thanks to http://halfpapstudios.com/blog/tag/html5-canvas/\nEnumerable set to false to protect for...in from\nUint8ClampedArray.prototype pollution.",line:" src/core/shim.js:65"},{message:"Missing item type\nprivate helper function to handle the user passing objects in\nduring construction or calls to create()",line:" src/data/p5.TypedDict.js:179"},{message:"Missing item type\nprivate helper function to ensure that the user passed in valid\nvalues for the Dictionary type",line:" src/data/p5.TypedDict.js:321"},{message:"Missing item type\nprivate helper function to ensure that the user passed in valid\nvalues for the Dictionary type",line:" src/data/p5.TypedDict.js:368"},{message:"Missing item type\nprivate helper function for finding lowest or highest value\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'",line:" src/data/p5.TypedDict.js:485"},{message:"Missing item type\nprivate helper function for finding lowest or highest key\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'",line:" src/data/p5.TypedDict.js:548"},{message:"Missing item type\n_updatePAccelerations updates the pAcceleration values",line:" src/events/acceleration.js:80"},{message:"Missing item type\nHolds the key codes of currently pressed keys.",line:" src/events/keyboard.js:12"},{message:"Missing item type\nThe onblur function is called when the user is no longer focused\non the p5 element. Because the keyup events will not fire if the user is\nnot focused on the element we must assume all keys currently down have\nbeen released.",line:" src/events/keyboard.js:307"},{message:"Missing item type\nThe checkDownKeys function returns a boolean true if any keys pressed\nand a false if no keys are currently pressed.\n\nHelps avoid instances where a multiple keys are pressed simultaneously and\nreleasing a single key will then switch the\nkeyIsPressed property to true.",line:" src/events/keyboard.js:364"},{message:"Missing item type\nThis module defines the filters for use with image buffers.\n\nThis module is basically a collection of functions stored in an object\nas opposed to modules. The functions are destructive, modifying\nthe passed in canvas rather than creating a copy.\n\nGenerally speaking users of this module will use the Filters.apply method\non a canvas to create an effect.\n\nA number of functions are borrowed/adapted from\nhttp://www.html5rocks.com/en/tutorials/canvas/imagefilters/\nor the java processing implementation.",line:" src/image/filters.js:3"},{message:"Missing item type\nReturns the pixel buffer for a canvas",line:" src/image/filters.js:28"},{message:"Missing item type\nReturns a 32 bit number containing ARGB data at ith pixel in the\n1D array containing pixels data.",line:" src/image/filters.js:51"},{message:"Missing item type\nModifies pixels RGBA values to values contained in the data object.",line:" src/image/filters.js:70"},{message:"Missing item type\nReturns the ImageData object for a canvas\nhttps://developer.mozilla.org/en-US/docs/Web/API/ImageData",line:" src/image/filters.js:90"},{message:"Missing item type\nReturns a blank ImageData object.",line:" src/image/filters.js:113"},{message:"Missing item type\nApplys a filter function to a canvas.\n\nThe difference between this and the actual filter functions defined below\nis that the filter functions generally modify the pixel buffer but do\nnot actually put that data back to the canvas (where it would actually\nupdate what is visible). By contrast this method does make the changes\nactually visible in the canvas.\n\nThe apply method is the method that callers of this module would generally\nuse. It has been separated from the actual filters to support an advanced\nuse case of creating a filter chain that executes without actually updating\nthe canvas in between everystep.",line:" src/image/filters.js:129"},{message:"Missing item type\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/",line:" src/image/filters.js:167"},{message:"Missing item type\nConverts any colors in the image to grayscale equivalents.\nNo parameter is used.\n\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/",line:" src/image/filters.js:202"},{message:"Missing item type\nSets the alpha channel to entirely opaque. No parameter is used.",line:" src/image/filters.js:224"},{message:"Missing item type\nSets each pixel to its inverse value. No parameter is used.",line:" src/image/filters.js:239"},{message:"Missing item type\nLimits each channel of the image to the number of colors specified as\nthe parameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n\nAdapted from java based processing implementation",line:" src/image/filters.js:255"},{message:"Missing item type\nreduces the bright areas in an image",line:" src/image/filters.js:286"},{message:"Missing item type\nincreases the bright areas in an image",line:" src/image/filters.js:367"},{message:"Missing item type\nThis module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.",line:" src/image/image.js:8"},{message:"Missing item type\nValidates clipping params. Per drawImage spec sWidth and sHight cannot be\nnegative or greater than image intrinsic width and height",line:" src/image/loading_displaying.js:107"},{message:"Missing item type\nApply the current tint color to the input image, return the resulting\ncanvas.",line:" src/image/loading_displaying.js:413"},{message:"Missing item type\nThis module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.",line:" src/image/p5.Image.js:9"},{message:"Missing item type\nHelper fxn for sharing pixel methods",line:" src/image/p5.Image.js:177"},{message:"Missing item type\nGenerate a blob of file data as a url to prepare for download.\nAccepts an array of data, a filename, and an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.",line:" src/io/files.js:1433"},{message:"Missing item type\nForces download. Accepts a url to filedata/blob, a filename,\nand an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.",line:" src/io/files.js:1456"},{message:"Missing item type\nReturns a file extension, or another string\nif the provided parameter has no extension.",line:" src/io/files.js:1496"},{message:"Missing item type\nReturns true if the browser is Safari, false if not.\nSafari makes trouble for downloading files.",line:" src/io/files.js:1528"},{message:"Missing item type\nHelper function, a callback for download that deletes\nan invisible anchor element from the DOM once the file\nhas been automatically downloaded.",line:" src/io/files.js:1540"},{message:'Missing item type\nTable Options\nGeneric class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.
\nCSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don\'t bother with the\nquotes.
\nFile names should end with .csv if they\'re comma separated.
\nA rough "spec" for CSV can be found\nhere.
\nTo load files, use the loadTable method.
\nTo save tables to your computer, use the save method\n or the saveTable method.
\n\nPossible options include:\n\n- csv - parse the table as comma-separated values\n
- tsv - parse the table as tab-separated values\n
- header - this table has a header (title) row\n
',line:" src/io/p5.Table.js:12"},{message:"Missing item type\nReturns the total number of columns in a Table.",line:" src/io/p5.Table.js:644"},{message:"Missing item type\nThis method is called while the parsing of XML (when loadXML() is\ncalled). The difference between this method and the setContent()\nmethod defined later is that this one is used to set the content\nwhen the node in question has more nodes under it and so on and\nnot directly text content. While in the other one is used when\nthe node in question directly has text inside it.",line:" src/io/p5.XML.js:767"},{message:"Missing item type\nThis method is called while the parsing of XML (when loadXML() is\ncalled). The XML node is passed and its attributes are stored in the\np5.XML's attribute Object.",line:" src/io/p5.XML.js:784"},{message:"Missing item type\nMultiplies a vector by a scalar and returns a new vector.",line:" src/math/p5.Vector.js:963"},{message:"Missing item type\nDivides a vector by a scalar and returns a new vector.",line:" src/math/p5.Vector.js:990"},{message:"Missing item type\nCalculates the dot product of two vectors.",line:" src/math/p5.Vector.js:1018"},{message:"Missing item type\nCalculates the cross product of two vectors.",line:" src/math/p5.Vector.js:1032"},{message:"Missing item type\nCalculates the Euclidean distance between two points (considering a\npoint as a vector object).",line:" src/math/p5.Vector.js:1046"},{message:"Missing item type\nLinear interpolate a vector to another vector and return the result as a\nnew vector.",line:" src/math/p5.Vector.js:1061"},{message:"Missing item type\nHelper function to measure ascent and descent.",line:" src/typography/attributes.js:248"},{message:"Missing item type\nReturns the set of opentype glyphs for the supplied string.\n\nNote that there is not a strict one-to-one mapping between characters\nand glyphs, so the list of returned glyphs can be larger or smaller\n than the length of the given string.",line:" src/typography/p5.Font.js:206"},{message:"Missing item type\nReturns an opentype path for the supplied string and position.",line:" src/typography/p5.Font.js:221"},{message:"Missing item type\nParse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:\n\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5\n\nf 4 3 2 1",line:" src/webgl/loading.js:98"},{message:"Missing item type",line:" src/webgl/material.js:297"},{message:"Missing item type\ncomputes smooth normals per vertex as an average of each\nface.",line:" src/webgl/p5.Geometry.js:86"},{message:"Missing item type\nAverages the vertex normals. Used in curved\nsurfaces",line:" src/webgl/p5.Geometry.js:111"},{message:"Missing item type\nAverages pole normals. Used in spherical primitives",line:" src/webgl/p5.Geometry.js:130"},{message:"Missing item type\nCreate a 2D array for establishing stroke connections",line:" src/webgl/p5.Geometry.js:161"},{message:"Missing item type\nCreate 4 vertices for each stroke line, two at the beginning position\nand two at the end position. These vertices are displaced relative to\nthat line's normal on the GPU",line:" src/webgl/p5.Geometry.js:182"},{message:"Missing item type\nModifies all vertices to be centered within the range -100 to 100.",line:" src/webgl/p5.Geometry.js:209"},{message:"Missing item type",line:" src/webgl/p5.Matrix.js:1"},{message:"Missing item type\nA class to describe a 4x4 matrix\nfor model and view matrix manipulation in the p5js webgl renderer.\nclass p5.Matrix",line:" src/webgl/p5.Matrix.js:19"},{message:"Missing item type\nSets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Matrix, or the values from a float array.",line:" src/webgl/p5.Matrix.js:75"},{message:"Missing item type\nGets a copy of the vector, returns a p5.Matrix object.",line:" src/webgl/p5.Matrix.js:113"},{message:"Missing item type\nreturn a copy of a matrix",line:" src/webgl/p5.Matrix.js:122"},{message:"Missing item type\nreturn an identity matrix",line:" src/webgl/p5.Matrix.js:147"},{message:"Missing item type\ntranspose according to a given matrix",line:" src/webgl/p5.Matrix.js:155"},{message:"Missing item type\ninvert matrix according to a give matrix",line:" src/webgl/p5.Matrix.js:215"},{message:"Missing item type\nInverts a 3x3 matrix",line:" src/webgl/p5.Matrix.js:300"},{message:"Missing item type\ntransposes a 3x3 p5.Matrix by a mat3",line:" src/webgl/p5.Matrix.js:336"},{message:"Missing item type\nconverts a 4x4 matrix to its 3x3 inverse tranform\ncommonly used in MVMatrix to NMatrix conversions.",line:" src/webgl/p5.Matrix.js:352"},{message:"Missing item type\ninspired by Toji's mat4 determinant",line:" src/webgl/p5.Matrix.js:380"},{message:"Missing item type\nmultiply two mat4s",line:" src/webgl/p5.Matrix.js:403"},{message:"Missing item type\nscales a p5.Matrix by scalars or a vector",line:" src/webgl/p5.Matrix.js:460"},{message:"Missing item type\nrotate our Matrix around an axis by the given angle.",line:" src/webgl/p5.Matrix.js:505"},{message:"Missing item type",line:" src/webgl/p5.Matrix.js:584"},{message:"Missing item type\nsets the perspective matrix",line:" src/webgl/p5.Matrix.js:614"},{message:"Missing item type\nsets the ortho matrix",line:" src/webgl/p5.Matrix.js:648"},{message:"Missing item type\nPRIVATE",line:" src/webgl/p5.Matrix.js:683"},{message:"Missing item type\nWelcome to RendererGL Immediate Mode.\nImmediate mode is used for drawing custom shapes\nfrom a set of vertices. Immediate Mode is activated\nwhen you call beginShape() & de-activated when you call endShape().\nImmediate mode is a style of programming borrowed\nfrom OpenGL's (now-deprecated) immediate mode.\nIt differs from p5.js' default, Retained Mode, which caches\ngeometries and buffers on the CPU to reduce the number of webgl\ndraw calls. Retained mode is more efficient & performative,\nhowever, Immediate Mode is useful for sketching quick\ngeometric ideas.",line:" src/webgl/p5.RendererGL.Immediate.js:1"},{message:"Missing item type\nBegin shape drawing. This is a helpful way of generating\ncustom shapes quickly. However in WEBGL mode, application\nperformance will likely drop as a result of too many calls to\nbeginShape() / endShape(). As a high performance alternative,\nplease use p5.js geometry primitives.",line:" src/webgl/p5.RendererGL.Immediate.js:19"},{message:"Missing item type\nadds a vertex to be drawn in a custom Shape.",line:" src/webgl/p5.RendererGL.Immediate.js:60"},{message:"Missing item type\nEnd shape drawing and render vertices to screen.",line:" src/webgl/p5.RendererGL.Immediate.js:103"},{message:"Missing item type\ninitializes buffer defaults. runs each time a new geometry is\nregistered",line:" src/webgl/p5.RendererGL.Retained.js:8"},{message:"Missing item type\ncreateBuffers description",line:" src/webgl/p5.RendererGL.Retained.js:33"},{message:"Missing item type\nDraws buffers given a geometry key ID",line:" src/webgl/p5.RendererGL.Retained.js:84"},{message:"Missing item type\nmodel view, projection, & normal\nmatrices",line:" src/webgl/p5.RendererGL.js:69"},{message:"Missing item type\n[background description]",line:" src/webgl/p5.RendererGL.js:331"},{message:"Missing item type\n[resize description]",line:" src/webgl/p5.RendererGL.js:642"},{message:"Missing item type\nclears color and depth buffers\nwith r,g,b,a",line:" src/webgl/p5.RendererGL.js:659"},{message:"Missing item type\n[translate description]",line:" src/webgl/p5.RendererGL.js:675"},{message:"Missing item type\nScales the Model View Matrix by a vector",line:" src/webgl/p5.RendererGL.js:693"},{message:"Missing item type\npushes a copy of the model view matrix onto the\nMV Matrix stack.",line:" src/webgl/p5.RendererGL.js:725"},{message:"Missing item type\n[pop description]",line:" src/webgl/p5.RendererGL.js:734"},{message:"Missing item type\nturn a two dimensional array into one dimensional array",line:" src/webgl/p5.RendererGL.js:904"},{message:"Missing item type\nturn a p5.Vector Array into a one dimensional number array",line:" src/webgl/p5.RendererGL.js:918"},{message:"Missing item type",line:" src/webgl/primitives.js:265"},{message:"Missing item type\nDraw a line given two points",line:" src/webgl/primitives.js:860"},{message:"Missing item type\nHelper function for select and selectAll",line:" lib/addons/p5.dom.js:156"},{message:"Missing item type\nHelper function for getElement and getElements.",line:" lib/addons/p5.dom.js:172"},{message:"Missing item type\nHelpers for create methods.",line:" lib/addons/p5.dom.js:225"},{message:"Missing item type",line:" lib/addons/p5.dom.js:369"},{message:"Missing item type",line:" lib/addons/p5.dom.js:874"},{message:"Missing item type",line:" lib/addons/p5.dom.js:937"},{message:"Missing item type",line:" lib/addons/p5.dom.js:965"},{message:"Missing item type\nCenters a p5 Element either vertically, horizontally,\nor both, relative to its parent or according to\nthe body if the Element has no parent. If no argument is passed\nthe Element is aligned both vertically and horizontally.",line:" lib/addons/p5.dom.js:1223"},{message:"Missing item type",line:" lib/addons/p5.dom.js:2259"},{message:"Missing item type",line:" lib/addons/p5.dom.js:2329"},{message:"Missing item type",line:" lib/addons/p5.dom.js:2351"},{message:"Missing item type\np5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound\n\nFrom the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors\n\nMIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE\n\nSome of the many audio libraries & resources that inspire p5.sound:\n - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js\n - buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/\n - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0\n - wavesurfer.js https://github.com/katspaugh/wavesurfer.js\n - Web Audio Components by Jordan Santell https://github.com/web-audio-components\n - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound\n\n Web Audio API: http://w3.org/TR/webaudio/",line:" lib/addons/p5.sound.js:46"},{message:"Missing item type\nDetermine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats",line:" lib/addons/p5.sound.js:226"},{message:"Missing item type\nMaster contains AudioContext and the master sound output.",line:" lib/addons/p5.sound.js:296"},{message:"Missing item type\na silent connection to the DesinationNode\nwhich will ensure that anything connected to it\nwill not be garbage collected",line:" lib/addons/p5.sound.js:393"},{message:"Missing item type\nReturns the closest MIDI note value for\na given frequency.",line:" lib/addons/p5.sound.js:425"},{message:"Missing item type\nUsed by Osc and Env to chain signal math",line:" lib/addons/p5.sound.js:584"},{message:"Missing item type\nThis is a helper function that the p5.SoundFile calls to load\nitself. Accepts a callback (the name of another function)\nas an optional parameter.",line:" lib/addons/p5.sound.js:917"},{message:"Missing item type\nSet a p5.SoundFile's looping flag to true or false. If the sound\nis currently playing, this change will take effect when it\nreaches the end of the current playback.",line:" lib/addons/p5.sound.js:1233"},{message:"Missing item type\nReturns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not.",line:" lib/addons/p5.sound.js:1253"},{message:"Missing item type\nStop playback on all of this soundfile's sources.",line:" lib/addons/p5.sound.js:1311"},{message:"Missing item type\nReturns the current stereo pan position (-1.0 to 1.0)",line:" lib/addons/p5.sound.js:1413"},{message:"Missing item type",line:" lib/addons/p5.sound.js:1746"},{message:"Missing item type\nReplace the current Audio Buffer with a new Buffer.",line:" lib/addons/p5.sound.js:1764"},{message:"Missing item type",line:" lib/addons/p5.sound.js:2026"},{message:"Missing item type",line:" lib/addons/p5.sound.js:3024"},{message:"Missing item type",line:" lib/addons/p5.sound.js:3427"},{message:"Missing item type",line:" lib/addons/p5.sound.js:3448"},{message:"Missing item type",line:" lib/addons/p5.sound.js:3507"},{message:"Missing item type",line:" lib/addons/p5.sound.js:3960"},{message:"Missing item type",line:" lib/addons/p5.sound.js:4097"},{message:"Missing item type",line:" lib/addons/p5.sound.js:4130"},{message:"Missing item type",line:" lib/addons/p5.sound.js:4176"},{message:"Missing item type",line:" lib/addons/p5.sound.js:4197"},{message:"Missing item type",line:" lib/addons/p5.sound.js:4217"},{message:"Missing item type\nConnect a p5.sound object or Web Audio node to this\np5.Signal so that its amplitude values can be scaled.",line:" lib/addons/p5.sound.js:4330"},{message:"Missing item type",line:" lib/addons/p5.sound.js:4923"},{message:"Missing item type",line:" lib/addons/p5.sound.js:5109"},{message:"Missing item type\nSet the amplitude of the noise between 0 and 1.0. Or,\nmodulate amplitude with an audio signal such as an oscillator.",line:" lib/addons/p5.sound.js:6393"},{message:"Missing item type\nAdd input sources to the list of available sources.",line:" lib/addons/p5.sound.js:6634"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6763"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6779"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6803"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6829"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6858"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6888"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6936"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6959"},{message:"Missing item type",line:" lib/addons/p5.sound.js:6984"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7005"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7012"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7034"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7063"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7090"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7118"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7146"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7192"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7223"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7241"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7629"},{message:"Missing item type",line:" lib/addons/p5.sound.js:7651"},{message:"Missing item type\nThe p5.Effect class is built\n using Tone.js CrossFade",line:" lib/addons/p5.sound.js:7721"},{message:"Missing item type\nIn classes that extend\np5.Effect, connect effect nodes\nto the wet parameter",line:" lib/addons/p5.sound.js:7727"},{message:"Missing item type\nInspired by Simple Reverb by Jordan Santell\nhttps://github.com/web-audio-components/simple-reverb/blob/master/index.js\n\nUtility function for building an impulse response\nbased on the module parameters.",line:" lib/addons/p5.sound.js:8467"},{message:"Missing item type\nPrivate method to load a buffer as an Impulse Response,\nassign it to the convolverNode, and add to the Array of .impulses.",line:" lib/addons/p5.sound.js:8631"},{message:"Missing item type",line:" lib/addons/p5.sound.js:8817"},{message:"Missing item type",line:" lib/addons/p5.sound.js:8842"},{message:"Missing item type\nSet the global tempo, in beats per minute, for all\np5.Parts. This method will impact all active p5.Parts.",line:" lib/addons/p5.sound.js:9059"},{message:"Missing item type\nSet the tempo for all parts in the score",line:" lib/addons/p5.sound.js:9513"},{message:"Missing item type\nReturn the current reduction value",line:" lib/addons/p5.sound.js:9731"},{message:"Missing item type\ncallback invoked when the recording is over",line:" lib/addons/p5.sound.js:9828"},{message:"Missing item type\ninternal method called on audio process",line:" lib/addons/p5.sound.js:9914"}]}},{}],2:[function(a,b,c){!function(a){"use strict";function b(a){var b=a.charCodeAt(0);return b===f||b===k?62:b===g||b===l?63:b0)throw new Error("Invalid string. Length must be a multiple of 4");var k=a.length;i="="===a.charAt(k-2)?2:"="===a.charAt(k-1)?1:0,j=new e(3*a.length/4-i),g=i>0?a.length-4:a.length;var l=0;for(d=0,f=0;d>16),c((65280&h)>>8),c(255&h);return 2===i?(h=b(a.charAt(d))<<2|b(a.charAt(d+1))>>4,c(255&h)):1===i&&(h=b(a.charAt(d))<<10|b(a.charAt(d+1))<<4|b(a.charAt(d+2))>>2,c(h>>8&255),c(255&h)),j}function d(a){function b(a){return"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(a)}function c(a){return b(a>>18&63)+b(a>>12&63)+b(a>>6&63)+b(63&a)}var d,e,f,g=a.length%3,h="";for(d=0,f=a.length-g;d>2),h+=b(e<<4&63),h+="==";break;case 2:e=(a[a.length-2]<<8)+a[a.length-1],h+=b(e>>10),h+=b(e>>4&63),h+=b(e<<2&63),h+="="}return h}
-var e="undefined"!=typeof Uint8Array?Uint8Array:Array,f="+".charCodeAt(0),g="/".charCodeAt(0),h="0".charCodeAt(0),i="a".charCodeAt(0),j="A".charCodeAt(0),k="-".charCodeAt(0),l="_".charCodeAt(0);a.toByteArray=c,a.fromByteArray=d}(void 0===c?this.base64js={}:c)},{}],3:[function(a,b,c){},{}],4:[function(a,b,c){(function(b){"use strict";function d(){function a(){}try{var b=new Uint8Array(1);return b.foo=function(){return 42},b.constructor=a,42===b.foo()&&b.constructor===a&&"function"==typeof b.subarray&&0===b.subarray(1,1).byteLength}catch(a){return!1}}function e(){return f.TYPED_ARRAY_SUPPORT?2147483647:1073741823}function f(a){return this instanceof f?(f.TYPED_ARRAY_SUPPORT||(this.length=0,this.parent=void 0),"number"==typeof a?g(this,a):"string"==typeof a?h(this,a,arguments.length>1?arguments[1]:"utf8"):i(this,a)):arguments.length>1?new f(a,arguments[1]):new f(a)}function g(a,b){if(a=p(a,b<0?0:0|q(b)),!f.TYPED_ARRAY_SUPPORT)for(var c=0;c>>1&&(a.parent=Z),a}function q(a){if(a>=e())throw new RangeError("Attempt to allocate Buffer larger than maximum size: 0x"+e().toString(16)+" bytes");return 0|a}function r(a,b){if(!(this instanceof r))return new r(a,b);var c=new f(a,b);return delete c.parent,c}function s(a,b){"string"!=typeof a&&(a=""+a);var c=a.length;if(0===c)return 0;for(var d=!1;;)switch(b){case"ascii":case"binary":case"raw":case"raws":return c;case"utf8":case"utf-8":return R(a).length;case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return 2*c;case"hex":return c>>>1;case"base64":return U(a).length;default:if(d)return R(a).length;b=(""+b).toLowerCase(),d=!0}}function t(a,b,c){var d=!1;if(b|=0,c=void 0===c||c===1/0?this.length:0|c,a||(a="utf8"),b<0&&(b=0),c>this.length&&(c=this.length),c<=b)return"";for(;;)switch(a){case"hex":return F(this,b,c);case"utf8":case"utf-8":return B(this,b,c);case"ascii":return D(this,b,c);case"binary":return E(this,b,c);case"base64":return A(this,b,c);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return G(this,b,c);default:if(d)throw new TypeError("Unknown encoding: "+a);a=(a+"").toLowerCase(),d=!0}}function u(a,b,c,d){c=Number(c)||0;var e=a.length-c;d?(d=Number(d))>e&&(d=e):d=e;var f=b.length;if(f%2!=0)throw new Error("Invalid hex string");d>f/2&&(d=f/2);for(var g=0;g239?4:f>223?3:f>191?2:1;if(e+h<=c){var i,j,k,l;switch(h){case 1:f<128&&(g=f);break;case 2:i=a[e+1],128==(192&i)&&(l=(31&f)<<6|63&i)>127&&(g=l);break;case 3:i=a[e+1],j=a[e+2],128==(192&i)&&128==(192&j)&&(l=(15&f)<<12|(63&i)<<6|63&j)>2047&&(l<55296||l>57343)&&(g=l);break;case 4:i=a[e+1],j=a[e+2],k=a[e+3],128==(192&i)&&128==(192&j)&&128==(192&k)&&(l=(15&f)<<18|(63&i)<<12|(63&j)<<6|63&k)>65535&&l<1114112&&(g=l)}}null===g?(g=65533,h=1):g>65535&&(g-=65536,d.push(g>>>10&1023|55296),g=56320|1023&g),d.push(g),e+=h}return C(d)}function C(a){var b=a.length;if(b<=$)return String.fromCharCode.apply(String,a);for(var c="",d=0;dd)&&(c=d);for(var e="",f=b;fc)throw new RangeError("Trying to access beyond buffer length")}function I(a,b,c,d,e,g){if(!f.isBuffer(a))throw new TypeError("buffer must be a Buffer instance");if(b>e||ba.length)throw new RangeError("index out of range")}function J(a,b,c,d){b<0&&(b=65535+b+1);for(var e=0,f=Math.min(a.length-c,2);e>>8*(d?e:1-e)}function K(a,b,c,d){b<0&&(b=4294967295+b+1);for(var e=0,f=Math.min(a.length-c,4);e>>8*(d?e:3-e)&255}function L(a,b,c,d,e,f){if(b>e||ba.length)throw new RangeError("index out of range");if(c<0)throw new RangeError("index out of range")}function M(a,b,c,d,e){return e||L(a,b,c,4,3.4028234663852886e38,-3.4028234663852886e38),X.write(a,b,c,d,23,4),c+4}function N(a,b,c,d,e){return e||L(a,b,c,8,1.7976931348623157e308,-1.7976931348623157e308),X.write(a,b,c,d,52,8),c+8}function O(a){if(a=P(a).replace(aa,""),a.length<2)return"";for(;a.length%4!=0;)a+="=";return a}function P(a){return a.trim?a.trim():a.replace(/^\s+|\s+$/g,"")}function Q(a){return a<16?"0"+a.toString(16):a.toString(16)}function R(a,b){b=b||1/0;for(var c,d=a.length,e=null,f=[],g=0;g55295&&c<57344){if(!e){if(c>56319){(b-=3)>-1&&f.push(239,191,189);continue}if(g+1===d){(b-=3)>-1&&f.push(239,191,189);continue}e=c;continue}if(c<56320){(b-=3)>-1&&f.push(239,191,189),e=c;continue}c=65536+(e-55296<<10|c-56320)}else e&&(b-=3)>-1&&f.push(239,191,189);if(e=null,c<128){if((b-=1)<0)break;f.push(c)}else if(c<2048){if((b-=2)<0)break;f.push(c>>6|192,63&c|128)}else if(c<65536){if((b-=3)<0)break;f.push(c>>12|224,c>>6&63|128,63&c|128)}else{if(!(c<1114112))throw new Error("Invalid code point");if((b-=4)<0)break;f.push(c>>18|240,c>>12&63|128,c>>6&63|128,63&c|128)}}return f}function S(a){for(var b=[],c=0;c>8,e=c%256,f.push(e),f.push(d);return f}function U(a){return W.toByteArray(O(a))}function V(a,b,c,d){for(var e=0;e=b.length||e>=a.length);e++)b[e+c]=a[e];return e}var W=a("base64-js"),X=a("ieee754"),Y=a("isarray");c.Buffer=f,c.SlowBuffer=r,c.INSPECT_MAX_BYTES=50,f.poolSize=8192;var Z={};f.TYPED_ARRAY_SUPPORT=void 0!==b.TYPED_ARRAY_SUPPORT?b.TYPED_ARRAY_SUPPORT:d(),f.TYPED_ARRAY_SUPPORT?(f.prototype.__proto__=Uint8Array.prototype,f.__proto__=Uint8Array):(f.prototype.length=void 0,f.prototype.parent=void 0),f.isBuffer=function(a){return!(null==a||!a._isBuffer)},f.compare=function(a,b){if(!f.isBuffer(a)||!f.isBuffer(b))throw new TypeError("Arguments must be Buffers");if(a===b)return 0;for(var c=a.length,d=b.length,e=0,g=Math.min(c,d);e0&&(a=this.toString("hex",0,b).match(/.{2}/g).join(" "),this.length>b&&(a+=" ... ")),""},f.prototype.compare=function(a){if(!f.isBuffer(a))throw new TypeError("Argument must be a Buffer");return this===a?0:f.compare(this,a)},f.prototype.indexOf=function(a,b){function c(a,b,c){for(var d=-1,e=0;c+e2147483647?b=2147483647:b<-2147483648&&(b=-2147483648),b>>=0,0===this.length)return-1;if(b>=this.length)return-1;if(b<0&&(b=Math.max(this.length+b,0)),"string"==typeof a)return 0===a.length?-1:String.prototype.indexOf.call(this,a,b);if(f.isBuffer(a))return c(this,a,b);if("number"==typeof a)return f.TYPED_ARRAY_SUPPORT&&"function"===Uint8Array.prototype.indexOf?Uint8Array.prototype.indexOf.call(this,a,b):c(this,[a],b);throw new TypeError("val must be string, number or Buffer")},f.prototype.get=function(a){return console.log(".get() is deprecated. Access using array indexes instead."),this.readUInt8(a)},f.prototype.set=function(a,b){return console.log(".set() is deprecated. Access using array indexes instead."),this.writeUInt8(a,b)},f.prototype.write=function(a,b,c,d){if(void 0===b)d="utf8",c=this.length,b=0;else if(void 0===c&&"string"==typeof b)d=b,c=this.length,b=0;else if(isFinite(b))b|=0,isFinite(c)?(c|=0,void 0===d&&(d="utf8")):(d=c,c=void 0);else{var e=d;d=b,b=0|c,c=e}var f=this.length-b;if((void 0===c||c>f)&&(c=f),a.length>0&&(c<0||b<0)||b>this.length)throw new RangeError("attempt to write outside buffer bounds");d||(d="utf8");for(var g=!1;;)switch(d){case"hex":return u(this,a,b,c);case"utf8":case"utf-8":return v(this,a,b,c);case"ascii":return w(this,a,b,c);case"binary":return x(this,a,b,c);case"base64":return y(this,a,b,c);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return z(this,a,b,c);default:if(g)throw new TypeError("Unknown encoding: "+d);d=(""+d).toLowerCase(),g=!0}},f.prototype.toJSON=function(){return{type:"Buffer",data:Array.prototype.slice.call(this._arr||this,0)}};var $=4096;f.prototype.slice=function(a,b){var c=this.length;a=~~a,b=void 0===b?c:~~b,a<0?(a+=c)<0&&(a=0):a>c&&(a=c),b<0?(b+=c)<0&&(b=0):b>c&&(b=c),b0&&(e*=256);)d+=this[a+--b]*e;return d},f.prototype.readUInt8=function(a,b){return b||H(a,1,this.length),this[a]},f.prototype.readUInt16LE=function(a,b){return b||H(a,2,this.length),this[a]|this[a+1]<<8},f.prototype.readUInt16BE=function(a,b){return b||H(a,2,this.length),this[a]<<8|this[a+1]},f.prototype.readUInt32LE=function(a,b){return b||H(a,4,this.length),(this[a]|this[a+1]<<8|this[a+2]<<16)+16777216*this[a+3]},f.prototype.readUInt32BE=function(a,b){return b||H(a,4,this.length),16777216*this[a]+(this[a+1]<<16|this[a+2]<<8|this[a+3])},f.prototype.readIntLE=function(a,b,c){a|=0,b|=0,c||H(a,b,this.length);for(var d=this[a],e=1,f=0;++f=e&&(d-=Math.pow(2,8*b)),d},f.prototype.readIntBE=function(a,b,c){a|=0,b|=0,c||H(a,b,this.length);for(var d=b,e=1,f=this[a+--d];d>0&&(e*=256);)f+=this[a+--d]*e;return e*=128,f>=e&&(f-=Math.pow(2,8*b)),f},f.prototype.readInt8=function(a,b){return b||H(a,1,this.length),128&this[a]?(255-this[a]+1)*-1:this[a]},f.prototype.readInt16LE=function(a,b){b||H(a,2,this.length);var c=this[a]|this[a+1]<<8;return 32768&c?4294901760|c:c},f.prototype.readInt16BE=function(a,b){b||H(a,2,this.length);var c=this[a+1]|this[a]<<8;return 32768&c?4294901760|c:c},f.prototype.readInt32LE=function(a,b){return b||H(a,4,this.length),this[a]|this[a+1]<<8|this[a+2]<<16|this[a+3]<<24},f.prototype.readInt32BE=function(a,b){return b||H(a,4,this.length),this[a]<<24|this[a+1]<<16|this[a+2]<<8|this[a+3]},f.prototype.readFloatLE=function(a,b){return b||H(a,4,this.length),X.read(this,a,!0,23,4)},f.prototype.readFloatBE=function(a,b){return b||H(a,4,this.length),X.read(this,a,!1,23,4)},f.prototype.readDoubleLE=function(a,b){return b||H(a,8,this.length),X.read(this,a,!0,52,8)},f.prototype.readDoubleBE=function(a,b){return b||H(a,8,this.length),X.read(this,a,!1,52,8)},f.prototype.writeUIntLE=function(a,b,c,d){a=+a,b|=0,c|=0,d||I(this,a,b,c,Math.pow(2,8*c),0);var e=1,f=0;for(this[b]=255&a;++f=0&&(f*=256);)this[b+e]=a/f&255;return b+c},f.prototype.writeUInt8=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,1,255,0),f.TYPED_ARRAY_SUPPORT||(a=Math.floor(a)),this[b]=255&a,b+1},f.prototype.writeUInt16LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,65535,0),f.TYPED_ARRAY_SUPPORT?(this[b]=255&a,this[b+1]=a>>>8):J(this,a,b,!0),b+2},f.prototype.writeUInt16BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,65535,0),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>8,this[b+1]=255&a):J(this,a,b,!1),b+2},f.prototype.writeUInt32LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,4294967295,0),f.TYPED_ARRAY_SUPPORT?(this[b+3]=a>>>24,this[b+2]=a>>>16,this[b+1]=a>>>8,this[b]=255&a):K(this,a,b,!0),b+4},f.prototype.writeUInt32BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,4294967295,0),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>24,this[b+1]=a>>>16,this[b+2]=a>>>8,this[b+3]=255&a):K(this,a,b,!1),b+4},f.prototype.writeIntLE=function(a,b,c,d){if(a=+a,b|=0,!d){var e=Math.pow(2,8*c-1);I(this,a,b,c,e-1,-e)}var f=0,g=1,h=a<0?1:0;for(this[b]=255&a;++f>0)-h&255;return b+c},f.prototype.writeIntBE=function(a,b,c,d){if(a=+a,b|=0,!d){var e=Math.pow(2,8*c-1);I(this,a,b,c,e-1,-e)}var f=c-1,g=1,h=a<0?1:0;for(this[b+f]=255&a;--f>=0&&(g*=256);)this[b+f]=(a/g>>0)-h&255;return b+c},f.prototype.writeInt8=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,1,127,-128),f.TYPED_ARRAY_SUPPORT||(a=Math.floor(a)),a<0&&(a=255+a+1),this[b]=255&a,b+1},f.prototype.writeInt16LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,32767,-32768),f.TYPED_ARRAY_SUPPORT?(this[b]=255&a,this[b+1]=a>>>8):J(this,a,b,!0),b+2},f.prototype.writeInt16BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,32767,-32768),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>8,this[b+1]=255&a):J(this,a,b,!1),b+2},f.prototype.writeInt32LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,2147483647,-2147483648),f.TYPED_ARRAY_SUPPORT?(this[b]=255&a,this[b+1]=a>>>8,this[b+2]=a>>>16,this[b+3]=a>>>24):K(this,a,b,!0),b+4},f.prototype.writeInt32BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,2147483647,-2147483648),a<0&&(a=4294967295+a+1),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>24,this[b+1]=a>>>16,this[b+2]=a>>>8,this[b+3]=255&a):K(this,a,b,!1),b+4},f.prototype.writeFloatLE=function(a,b,c){return M(this,a,b,!0,c)},f.prototype.writeFloatBE=function(a,b,c){return M(this,a,b,!1,c)},f.prototype.writeDoubleLE=function(a,b,c){return N(this,a,b,!0,c)},f.prototype.writeDoubleBE=function(a,b,c){return N(this,a,b,!1,c)},f.prototype.copy=function(a,b,c,d){if(c||(c=0),d||0===d||(d=this.length),b>=a.length&&(b=a.length),b||(b=0),d>0&&d=this.length)throw new RangeError("sourceStart out of bounds");if(d<0)throw new RangeError("sourceEnd out of bounds");d>this.length&&(d=this.length),a.length-b=0;e--)a[e+b]=this[e+c];else if(g<1e3||!f.TYPED_ARRAY_SUPPORT)for(e=0;e=this.length)throw new RangeError("start out of bounds");if(c<0||c>this.length)throw new RangeError("end out of bounds");var d;if("number"==typeof a)for(d=b;d>1,k=-7,l=c?e-1:0,m=c?-1:1,n=a[b+l];for(l+=m,f=n&(1<<-k)-1,n>>=-k,k+=h;k>0;f=256*f+a[b+l],l+=m,k-=8);for(g=f&(1<<-k)-1,f>>=-k,k+=d;k>0;g=256*g+a[b+l],l+=m,k-=8);if(0===f)f=1-j;else{if(f===i)return g?NaN:1/0*(n?-1:1);g+=Math.pow(2,d),f-=j}return(n?-1:1)*g*Math.pow(2,f-d)},c.write=function(a,b,c,d,e,f){var g,h,i,j=8*f-e-1,k=(1<>1,m=23===e?Math.pow(2,-24)-Math.pow(2,-77):0,n=d?0:f-1,o=d?1:-1,p=b<0||0===b&&1/b<0?1:0;for(b=Math.abs(b),isNaN(b)||b===1/0?(h=isNaN(b)?1:0,g=k):(g=Math.floor(Math.log(b)/Math.LN2),b*(i=Math.pow(2,-g))<1&&(g--,i*=2),b+=g+l>=1?m/i:m*Math.pow(2,1-l),b*i>=2&&(g++,i/=2),g+l>=k?(h=0,g=k):g+l>=1?(h=(b*i-1)*Math.pow(2,e),g+=l):(h=b*Math.pow(2,l-1)*Math.pow(2,e),g=0));e>=8;a[c+n]=255&h,n+=o,h/=256,e-=8);for(g=g<0;a[c+n]=255&g,n+=o,g/=256,j-=8);a[c+n-o]|=128*p}},{}],8:[function(a,b,c){var d={}.toString;b.exports=Array.isArray||function(a){return"[object Array]"==d.call(a)}},{}],9:[function(a,b,c){"use strict";function d(a,b,c,d,e){return Math.pow(1-e,3)*a+3*Math.pow(1-e,2)*e*b+3*(1-e)*Math.pow(e,2)*c+Math.pow(e,3)*d}function e(){this.x1=Number.NaN,this.y1=Number.NaN,this.x2=Number.NaN,this.y2=Number.NaN}e.prototype.isEmpty=function(){return isNaN(this.x1)||isNaN(this.y1)||isNaN(this.x2)||isNaN(this.y2)},e.prototype.addPoint=function(a,b){"number"==typeof a&&((isNaN(this.x1)||isNaN(this.x2))&&(this.x1=a,this.x2=a),athis.x2&&(this.x2=a)),"number"==typeof b&&((isNaN(this.y1)||isNaN(this.y2))&&(this.y1=b,this.y2=b),bthis.y2&&(this.y2=b))},e.prototype.addX=function(a){this.addPoint(a,null)},e.prototype.addY=function(a){this.addPoint(null,a)},e.prototype.addBezier=function(a,b,c,e,f,g,h,i){var j=[a,b],k=[c,e],l=[f,g],m=[h,i];this.addPoint(a,b),this.addPoint(h,i);for(var n=0;n<=1;n++){var o=6*j[n]-12*k[n]+6*l[n],p=-3*j[n]+9*k[n]-9*l[n]+3*m[n],q=3*k[n]-3*j[n];if(0!==p){var r=Math.pow(o,2)-4*q*p;if(!(r<0)){var s=(-o+Math.sqrt(r))/(2*p);00,"No English "+b+" specified.")}var c=[],d=this;b("fontFamily"),b("weightName"),b("manufacturer"),b("copyright"),b("version"),a(this.unitsPerEm>0,"No unitsPerEm specified.")},d.prototype.toTables=function(){return f.fontToTable(this)},d.prototype.toBuffer=function(){return console.warn("Font.toBuffer is deprecated. Use Font.toArrayBuffer instead."),this.toArrayBuffer()},d.prototype.toArrayBuffer=function(){for(var a=this.toTables(),b=a.encode(),c=new ArrayBuffer(b.length),d=new Uint8Array(c),e=0;e=176&&c<=183)e+=c-176+1;else if(c>=184&&c<=191)e+=2*(c-184+1);else if(b&&1===f&&27===c)break}while(f>0);a.ip=e}function t(a,b){lb&&console.log(b.step,"SVTCA["+a.axis+"]"),b.fv=b.pv=b.dpv=a}function u(a,b){lb&&console.log(b.step,"SPVTCA["+a.axis+"]"),b.pv=b.dpv=a}function v(a,b){lb&&console.log(b.step,"SFVTCA["+a.axis+"]"),b.fv=a}function w(a,b){var c=b.stack,d=c.pop(),e=c.pop(),f=b.z2[d],g=b.z1[e];lb&&console.log("SPVTL["+a+"]",d,e);var h,i;a?(h=f.y-g.y,i=g.x-f.x):(h=g.x-f.x,i=g.y-f.y),b.pv=b.dpv=l(h,i)}function x(a,b){var c=b.stack,d=c.pop(),e=c.pop(),f=b.z2[d],g=b.z1[e];lb&&console.log("SFVTL["+a+"]",d,e);var h,i;a?(h=f.y-g.y,i=g.x-f.x):(h=g.x-f.x,i=g.y-f.y),b.fv=l(h,i)}function y(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"SPVFS[]",c,d),a.pv=a.dpv=l(d,c)}function z(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"SPVFS[]",c,d),a.fv=l(d,c)}function A(a){var b=a.stack,c=a.pv;lb&&console.log(a.step,"GPV[]"),b.push(16384*c.x),b.push(16384*c.y)}function B(a){var b=a.stack,c=a.fv;lb&&console.log(a.step,"GFV[]"),b.push(16384*c.x),b.push(16384*c.y)}function C(a){a.fv=a.pv,lb&&console.log(a.step,"SFVTPV[]")}function D(a){var b=a.stack,c=b.pop(),d=b.pop(),e=b.pop(),f=b.pop(),g=b.pop(),h=a.z0,i=a.z1,j=h[c],k=h[d],l=i[e],m=i[f],n=a.z2[g];lb&&console.log("ISECT[], ",c,d,e,f,g);var o=j.x,p=j.y,q=k.x,r=k.y,s=l.x,t=l.y,u=m.x,v=m.y,w=(o-q)*(t-v)-(p-r)*(s-u),x=o*r-p*q,y=s*v-t*u;n.x=(x*(s-u)-y*(o-q))/w,n.y=(x*(t-v)-y*(p-r))/w}function E(a){a.rp0=a.stack.pop(),lb&&console.log(a.step,"SRP0[]",a.rp0)}function F(a){a.rp1=a.stack.pop(),lb&&console.log(a.step,"SRP1[]",a.rp1)}function G(a){a.rp2=a.stack.pop(),lb&&console.log(a.step,"SRP2[]",a.rp2)}function H(a){var b=a.stack.pop();switch(lb&&console.log(a.step,"SZP0[]",b),a.zp0=b,b){case 0:a.tZone||r(a),a.z0=a.tZone;break;case 1:a.z0=a.gZone;break;default:throw new Error("Invalid zone pointer")}}function I(a){var b=a.stack.pop();switch(lb&&console.log(a.step,"SZP1[]",b),a.zp1=b,b){case 0:a.tZone||r(a),a.z1=a.tZone;break;case 1:a.z1=a.gZone;break;default:throw new Error("Invalid zone pointer")}}function J(a){var b=a.stack.pop();switch(lb&&console.log(a.step,"SZP2[]",b),a.zp2=b,b){case 0:a.tZone||r(a),a.z2=a.tZone;break;case 1:a.z2=a.gZone;break;default:throw new Error("Invalid zone pointer")}}function K(a){var b=a.stack.pop();switch(lb&&console.log(a.step,"SZPS[]",b),a.zp0=a.zp1=a.zp2=b,b){case 0:a.tZone||r(a),a.z0=a.z1=a.z2=a.tZone;break;case 1:a.z0=a.z1=a.z2=a.gZone;break;default:throw new Error("Invalid zone pointer")}}function L(a){a.loop=a.stack.pop(),lb&&console.log(a.step,"SLOOP[]",a.loop)}function M(a){lb&&console.log(a.step,"RTG[]"),a.round=f}function N(a){lb&&console.log(a.step,"RTHG[]"),a.round=h}function O(a){var b=a.stack.pop();lb&&console.log(a.step,"SMD[]",b),a.minDis=b/64}function P(a){lb&&console.log(a.step,"ELSE[]"),s(a,!1)}function Q(a){var b=a.stack.pop();lb&&console.log(a.step,"JMPR[]",b),a.ip+=b-1}function R(a){var b=a.stack.pop();lb&&console.log(a.step,"SCVTCI[]",b),a.cvCutIn=b/64}function S(a){var b=a.stack;lb&&console.log(a.step,"DUP[]"),b.push(b[b.length-1])}function T(a){lb&&console.log(a.step,"POP[]"),a.stack.pop()}function U(a){lb&&console.log(a.step,"CLEAR[]"),a.stack.length=0}function V(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"SWAP[]"),b.push(c),b.push(d)}function W(a){var b=a.stack;lb&&console.log(a.step,"DEPTH[]"),b.push(b.length)}function X(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"LOOPCALL[]",c,d);var e=a.ip,f=a.prog;a.prog=a.funcs[c];for(var g=0;g1?"loop "+(b.loop-h)+": ":"")+"SHP["+(a?"rp1":"rp2")+"]",j)}b.loop=1}function da(a,b){var c=b.stack,d=a?b.rp1:b.rp2,e=(a?b.z0:b.z1)[d],f=b.fv,g=b.pv,h=c.pop(),i=b.z2[b.contours[h]],j=i;lb&&console.log(b.step,"SHC["+a+"]",h);var k=g.distance(e,e,!1,!0);do{j!==e&&f.setRelative(j,j,k,g),j=j.nextPointOnContour}while(j!==i)}function ea(a,b){var c=b.stack,d=a?b.rp1:b.rp2,e=(a?b.z0:b.z1)[d],f=b.fv,g=b.pv,h=c.pop();lb&&console.log(b.step,"SHZ["+a+"]",h);var i;switch(h){case 0:i=b.tZone;break;case 1:i=b.gZone;break;default:throw new Error("Invalid zone")}for(var j,k=g.distance(e,e,!1,!0),l=i.length-2,m=0;m1?"loop "+(a.loop-c)+": ":"")+"SHPIX[]",g,e),d.setRelative(h,h,e),d.touch(h)}a.loop=1}function ga(a){for(var b=a.stack,c=a.rp1,d=a.rp2,e=a.loop,f=a.z0[c],g=a.z1[d],h=a.fv,i=a.dpv,j=a.z2;e--;){var k=b.pop(),l=j[k];lb&&console.log(a.step,(a.loop>1?"loop "+(a.loop-e)+": ":"")+"IP[]",k,c,"<->",d),h.interpolate(l,f,g,i),h.touch(l)}a.loop=1}function ha(a,b){var c=b.stack,d=c.pop()/64,e=c.pop(),f=b.z1[e],g=b.z0[b.rp0],h=b.fv,i=b.pv;h.setRelative(f,g,d,i),h.touch(f),lb&&console.log(b.step,"MSIRP["+a+"]",d,e),b.rp1=b.rp0,b.rp2=e,a&&(b.rp0=e)}function ia(a){for(var b=a.stack,c=a.rp0,d=a.z0[c],e=a.loop,f=a.fv,g=a.pv,h=a.z1;e--;){var i=b.pop(),j=h[i];lb&&console.log(a.step,(a.loop>1?"loop "+(a.loop-e)+": ":"")+"ALIGNRP[]",i),f.setRelative(j,d,0,g),f.touch(j)}a.loop=1}function ja(a){lb&&console.log(a.step,"RTDG[]"),a.round=g}function ka(a,b){var c=b.stack,d=c.pop(),e=c.pop(),f=b.z0[e],g=b.fv,h=b.pv,i=b.cvt[d];a&&(i=b.round(i)),
-lb&&console.log(b.step,"MIAP["+a+"]",d,"(",i,")",e),g.setRelative(f,pb,i,h),0===b.zp0&&(f.xo=f.x,f.yo=f.y),g.touch(f),b.rp0=b.rp1=e}function la(a){var b=a.prog,c=a.ip,d=a.stack,e=b[++c];lb&&console.log(a.step,"NPUSHB[]",e);for(var f=0;f",h),b.stack.push(Math.round(64*h))}function ta(a){lb&&console.log(a.step,"MPPEM[]"),a.stack.push(a.ppem)}function ua(a){lb&&console.log(a.step,"FLIPON[]"),a.autoFlip=!0}function va(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"LT[]",c,d),b.push(dc?1:0)}function ya(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"GTEQ[]",c,d),b.push(d>=c?1:0)}function za(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"EQ[]",c,d),b.push(c===d?1:0)}function Aa(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"NEQ[]",c,d),b.push(c!==d?1:0)}function Ba(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"ODD[]",c),b.push(Math.trunc(c)%2?1:0)}function Ca(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"EVEN[]",c),b.push(Math.trunc(c)%2?0:1)}function Da(a){var b,c=a.stack.pop();lb&&console.log(a.step,"IF[]",c),c||(s(a,!0),lb&&console.log(a.step,27===b?"ELSE[]":"EIF[]"))}function Ea(a){lb&&console.log(a.step,"EIF[]")}function Fa(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"AND[]",c,d),b.push(c&&d?1:0)}function Ga(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"OR[]",c,d),b.push(c||d?1:0)}function Ha(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"NOT[]",c),b.push(c?0:1)}function Ia(a,b){var c=b.stack,d=c.pop(),e=b.fv,f=b.pv,g=b.ppem,h=b.deltaBase+16*(a-1),i=b.deltaShift,j=b.z0;lb&&console.log(b.step,"DELTAP["+a+"]",d,c);for(var k=0;k>4)===g){var n=(15&m)-8;n>=0&&n++,lb&&console.log(b.step,"DELTAPFIX",l,"by",n*i);var o=j[l];e.setRelative(o,o,n*i,f)}}}function Ja(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"SDB[]",c),a.deltaBase=c}function Ka(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"SDS[]",c),a.deltaShift=Math.pow(.5,c)}function La(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"ADD[]",c,d),b.push(d+c)}function Ma(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"SUB[]",c,d),b.push(d-c)}function Na(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"DIV[]",c,d),b.push(64*d/c)}function Oa(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"MUL[]",c,d),b.push(d*c/64)}function Pa(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"ABS[]",c),b.push(Math.abs(c))}function Qa(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"NEG[]",c),b.push(-c)}function Ra(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"FLOOR[]",c),b.push(64*Math.floor(c/64))}function Sa(a){var b=a.stack,c=b.pop();lb&&console.log(a.step,"CEILING[]",c),b.push(64*Math.ceil(c/64))}function Ta(a,b){var c=b.stack,d=c.pop();lb&&console.log(b.step,"ROUND[]"),c.push(64*b.round(d/64))}function Ua(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"WCVTF[]",c,d),a.cvt[d]=c*a.ppem/a.font.unitsPerEm}function Va(a,b){var c=b.stack,d=c.pop(),e=b.ppem,f=b.deltaBase+16*(a-1),g=b.deltaShift;lb&&console.log(b.step,"DELTAC["+a+"]",d,c);for(var h=0;h>4)===e){var k=(15&j)-8;k>=0&&k++;var l=k*g;lb&&console.log(b.step,"DELTACFIX",i,"by",l),b.cvt[i]+=l}}}function Wa(a){var b=a.stack.pop();lb&&console.log(a.step,"SROUND[]",b),a.round=mb;var c;switch(192&b){case 0:c=.5;break;case 64:c=1;break;case 128:c=2;break;default:throw new Error("invalid SROUND value")}switch(a.srPeriod=c,48&b){case 0:a.srPhase=0;break;case 16:a.srPhase=.25*c;break;case 32:a.srPhase=.5*c;break;case 48:a.srPhase=.75*c;break;default:throw new Error("invalid SROUND value")}b&=15,a.srThreshold=0===b?0:(b/8-.5)*c}function Xa(a){var b=a.stack.pop();lb&&console.log(a.step,"S45ROUND[]",b),a.round=mb;var c;switch(192&b){case 0:c=Math.sqrt(2)/2;break;case 64:c=Math.sqrt(2);break;case 128:c=2*Math.sqrt(2);break;default:throw new Error("invalid S45ROUND value")}switch(a.srPeriod=c,48&b){case 0:a.srPhase=0;break;case 16:a.srPhase=.25*c;break;case 32:a.srPhase=.5*c;break;case 48:a.srPhase=.75*c;break;default:throw new Error("invalid S45ROUND value")}b&=15,a.srThreshold=0===b?0:(b/8-.5)*c}function Ya(a){lb&&console.log(a.step,"ROFF[]"),a.round=e}function Za(a){lb&&console.log(a.step,"RUTG[]"),a.round=i}function $a(a){lb&&console.log(a.step,"RDTG[]"),a.round=j}function _a(a){var b=a.stack.pop();lb&&console.log(a.step,"SCANCTRL[]",b)}function ab(a,b){var c=b.stack,d=c.pop(),e=c.pop(),f=b.z2[d],g=b.z1[e];lb&&console.log("SDPVTL["+a+"]",d,e);var h,i;a?(h=f.y-g.y,i=g.x-f.x):(h=g.x-f.x,i=g.y-f.y),b.dpv=l(h,i)}function bb(a){var b=a.stack,c=b.pop(),d=0;lb&&console.log(a.step,"GETINFO[]",c),1&c&&(d=35),32&c&&(d|=4096),b.push(d)}function cb(a){var b=a.stack,c=b.pop(),d=b.pop(),e=b.pop();lb&&console.log(a.step,"ROLL[]"),b.push(d),b.push(c),b.push(e)}function db(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"MAX[]",c,d),b.push(Math.max(d,c))}function eb(a){var b=a.stack,c=b.pop(),d=b.pop();lb&&console.log(a.step,"MIN[]",c,d),b.push(Math.min(d,c))}function fb(a){var b=a.stack.pop();lb&&console.log(a.step,"SCANTYPE[]",b)}function gb(a){var b=a.stack.pop(),c=a.stack.pop();switch(lb&&console.log(a.step,"INSTCTRL[]",b,c),b){case 1:return void(a.inhibitGridFit=!!c);case 2:return void(a.ignoreCvt=!!c);default:throw new Error("invalid INSTCTRL[] selector")}}function hb(a,b){var c=b.stack,d=b.prog,e=b.ip;lb&&console.log(b.step,"PUSHB["+a+"]");for(var f=0;f=0?1:-1,h=Math.abs(h),a&&(j=f.cvt[l],d&&Math.abs(h-j)":"_")+(d?"R":"_")+(0===e?"Gr":1===e?"Bl":2===e?"Wh":"")+"]",a?l+"("+f.cvt[l]+","+j+")":"",m,"(d =",g,"->",i*h,")"),f.rp1=f.rp0,f.rp2=m,b&&(f.rp0=m)}var kb,q,p,o,lb=!1,mb=function(a){var b=this.srPeriod,c=this.srPhase,d=this.srThreshold,e=1;return a<0&&(a=-a,e=-1),a+=d-c,a=Math.trunc(a/b)*b,a+=c,e>0&&a<0?c:e<0&&a>0?-c:a*e},nb={x:1,y:0,axis:"x",distance:function(a,b,c,d){return(c?a.xo:a.x)-(d?b.xo:b.x)},interpolate:function(a,b,c,d){var e,f,g,h,i,j,k;return d&&d!==this?(e=d.distance(a,b,!0,!0),f=d.distance(a,c,!0,!0),i=d.distance(b,b,!1,!0),j=d.distance(c,c,!1,!0),g=Math.abs(e),h=Math.abs(f),0===(k=g+h)?void nb.setRelative(a,a,(i+j)/2,d,!0):void nb.setRelative(a,a,(i*h+j*g)/k,d,!0)):(e=a.xo-b.xo,f=a.xo-c.xo,i=b.x-b.xo,j=c.x-c.xo,g=Math.abs(e),h=Math.abs(f),0===(k=g+h)?void(a.x=a.xo+(i+j)/2):void(a.x=a.xo+(i*h+j*g)/k))},normalSlope:Number.NEGATIVE_INFINITY,setRelative:function(a,b,c,d,e){if(!d||d===this)return void(a.x=(e?b.xo:b.x)+c);var f=e?b.xo:b.x,g=e?b.yo:b.y,h=f+c*d.x,i=g+c*d.y;a.x=h+(a.y-i)/d.normalSlope},slope:0,touch:function(a){a.xTouched=!0},touched:function(a){return a.xTouched},untouch:function(a){a.xTouched=!1}},ob={x:0,y:1,axis:"y",distance:function(a,b,c,d){return(c?a.yo:a.y)-(d?b.yo:b.y)},interpolate:function(a,b,c,d){var e,f,g,h,i,j,k;return d&&d!==this?(e=d.distance(a,b,!0,!0),f=d.distance(a,c,!0,!0),i=d.distance(b,b,!1,!0),j=d.distance(c,c,!1,!0),g=Math.abs(e),h=Math.abs(f),0===(k=g+h)?void ob.setRelative(a,a,(i+j)/2,d,!0):void ob.setRelative(a,a,(i*h+j*g)/k,d,!0)):(e=a.yo-b.yo,f=a.yo-c.yo,i=b.y-b.yo,j=c.y-c.yo,g=Math.abs(e),h=Math.abs(f),0===(k=g+h)?void(a.y=a.yo+(i+j)/2):void(a.y=a.yo+(i*h+j*g)/k))},normalSlope:0,setRelative:function(a,b,c,d,e){if(!d||d===this)return void(a.y=(e?b.yo:b.y)+c);var f=e?b.xo:b.x,g=e?b.yo:b.y,h=f+c*d.x,i=g+c*d.y;a.y=i+d.normalSlope*(a.x-h)},slope:Number.POSITIVE_INFINITY,touch:function(a){a.yTouched=!0},touched:function(a){return a.yTouched},untouch:function(a){a.yTouched=!1}};Object.freeze(nb),Object.freeze(ob),k.prototype.distance=function(a,b,c,d){return this.x*nb.distance(a,b,c,d)+this.y*ob.distance(a,b,c,d)},k.prototype.interpolate=function(a,b,c,d){var e,f,g,h,i,j,k;if(g=d.distance(a,b,!0,!0),h=d.distance(a,c,!0,!0),e=d.distance(b,b,!1,!0),f=d.distance(c,c,!1,!0),i=Math.abs(g),j=Math.abs(h),0===(k=i+j))return void this.setRelative(a,a,(e+f)/2,d,!0);this.setRelative(a,a,(e*j+f*i)/k,d,!0)},k.prototype.setRelative=function(a,b,c,d,e){d=d||this;var f=e?b.xo:b.x,g=e?b.yo:b.y,h=f+c*d.x,i=g+c*d.y,j=d.normalSlope,k=this.slope,l=a.x,m=a.y;a.x=(k*l-j*h+i-m)/(k-j),a.y=k*(a.x-l)+m},k.prototype.touch=function(a){a.xTouched=!0,a.yTouched=!0},m.prototype.nextTouched=function(a){for(var b=this.nextPointOnContour;!a.touched(b)&&b!==this;)b=b.nextPointOnContour;return b},m.prototype.prevTouched=function(a){for(var b=this.prevPointOnContour;!a.touched(b)&&b!==this;)b=b.prevPointOnContour;return b};var pb=Object.freeze(new m(0,0)),qb={cvCutIn:17/16,deltaBase:9,deltaShift:.125,loop:1,minDis:1,autoFlip:!0};d.prototype.exec=function(a,b){if("number"!=typeof b)throw new Error("Point size is not a number!");if(!(this._errorState>2)){var c=this.font,d=this._prepState;if(!d||d.ppem!==b){var e=this._fpgmState;if(!e){n.prototype=qb,e=this._fpgmState=new n("fpgm",c.tables.fpgm),e.funcs=[],e.font=c,lb&&(console.log("---EXEC FPGM---"),e.step=-1);try{q(e)}catch(a){return console.log("Hinting error in FPGM:"+a),void(this._errorState=3)}}n.prototype=e,d=this._prepState=new n("prep",c.tables.prep),d.ppem=b;var f=c.tables.cvt;if(f)for(var g=d.cvt=new Array(f.length),h=b/c.unitsPerEm,i=0;i1))try{return o(a,d)}catch(a){return this._errorState<1&&(console.log("Hinting error:"+a),console.log("Note: further hinting errors are silenced")),void(this._errorState=1)}}},kb=[t.bind(void 0,ob),t.bind(void 0,nb),u.bind(void 0,ob),u.bind(void 0,nb),v.bind(void 0,ob),v.bind(void 0,nb),w.bind(void 0,0),w.bind(void 0,1),x.bind(void 0,0),x.bind(void 0,1),y,z,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,void 0,void 0,S,T,U,V,W,Z,$,void 0,void 0,void 0,X,Y,_,void 0,aa.bind(void 0,0),aa.bind(void 0,1),ba.bind(void 0,ob),ba.bind(void 0,nb),ca.bind(void 0,0),ca.bind(void 0,1),da.bind(void 0,0),da.bind(void 0,1),ea.bind(void 0,0),ea.bind(void 0,1),fa,ga,ha.bind(void 0,0),ha.bind(void 0,1),ia,ja,ka.bind(void 0,0),ka.bind(void 0,1),la,ma,na,oa,pa,qa,ra.bind(void 0,0),ra.bind(void 0,1),void 0,sa.bind(void 0,0),sa.bind(void 0,1),ta,void 0,ua,void 0,void 0,va,wa,xa,ya,za,Aa,Ba,Ca,Da,Ea,Fa,Ga,Ha,Ia.bind(void 0,1),Ja,Ka,La,Ma,Na,Oa,Pa,Qa,Ra,Sa,Ta.bind(void 0,0),Ta.bind(void 0,1),Ta.bind(void 0,2),Ta.bind(void 0,3),void 0,void 0,void 0,void 0,Ua,Ia.bind(void 0,2),Ia.bind(void 0,3),Va.bind(void 0,1),Va.bind(void 0,2),Va.bind(void 0,3),Wa,Xa,void 0,void 0,Ya,void 0,Za,$a,T,T,void 0,void 0,void 0,void 0,void 0,_a,ab.bind(void 0,0),ab.bind(void 0,1),bb,void 0,cb,db,eb,fb,gb,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,hb.bind(void 0,1),hb.bind(void 0,2),hb.bind(void 0,3),hb.bind(void 0,4),hb.bind(void 0,5),hb.bind(void 0,6),hb.bind(void 0,7),hb.bind(void 0,8),ib.bind(void 0,1),ib.bind(void 0,2),ib.bind(void 0,3),ib.bind(void 0,4),ib.bind(void 0,5),ib.bind(void 0,6),ib.bind(void 0,7),ib.bind(void 0,8),jb.bind(void 0,0,0,0,0,0),jb.bind(void 0,0,0,0,0,1),jb.bind(void 0,0,0,0,0,2),jb.bind(void 0,0,0,0,0,3),jb.bind(void 0,0,0,0,1,0),jb.bind(void 0,0,0,0,1,1),jb.bind(void 0,0,0,0,1,2),jb.bind(void 0,0,0,0,1,3),jb.bind(void 0,0,0,1,0,0),jb.bind(void 0,0,0,1,0,1),jb.bind(void 0,0,0,1,0,2),jb.bind(void 0,0,0,1,0,3),jb.bind(void 0,0,0,1,1,0),jb.bind(void 0,0,0,1,1,1),jb.bind(void 0,0,0,1,1,2),jb.bind(void 0,0,0,1,1,3),jb.bind(void 0,0,1,0,0,0),jb.bind(void 0,0,1,0,0,1),jb.bind(void 0,0,1,0,0,2),jb.bind(void 0,0,1,0,0,3),jb.bind(void 0,0,1,0,1,0),jb.bind(void 0,0,1,0,1,1),jb.bind(void 0,0,1,0,1,2),jb.bind(void 0,0,1,0,1,3),jb.bind(void 0,0,1,1,0,0),jb.bind(void 0,0,1,1,0,1),jb.bind(void 0,0,1,1,0,2),jb.bind(void 0,0,1,1,0,3),jb.bind(void 0,0,1,1,1,0),jb.bind(void 0,0,1,1,1,1),jb.bind(void 0,0,1,1,1,2),jb.bind(void 0,0,1,1,1,3),jb.bind(void 0,1,0,0,0,0),jb.bind(void 0,1,0,0,0,1),jb.bind(void 0,1,0,0,0,2),jb.bind(void 0,1,0,0,0,3),jb.bind(void 0,1,0,0,1,0),jb.bind(void 0,1,0,0,1,1),jb.bind(void 0,1,0,0,1,2),jb.bind(void 0,1,0,0,1,3),jb.bind(void 0,1,0,1,0,0),jb.bind(void 0,1,0,1,0,1),jb.bind(void 0,1,0,1,0,2),jb.bind(void 0,1,0,1,0,3),jb.bind(void 0,1,0,1,1,0),jb.bind(void 0,1,0,1,1,1),jb.bind(void 0,1,0,1,1,2),jb.bind(void 0,1,0,1,1,3),jb.bind(void 0,1,1,0,0,0),jb.bind(void 0,1,1,0,0,1),jb.bind(void 0,1,1,0,0,2),jb.bind(void 0,1,1,0,0,3),jb.bind(void 0,1,1,0,1,0),jb.bind(void 0,1,1,0,1,1),jb.bind(void 0,1,1,0,1,2),jb.bind(void 0,1,1,0,1,3),jb.bind(void 0,1,1,1,0,0),jb.bind(void 0,1,1,1,0,1),jb.bind(void 0,1,1,1,0,2),jb.bind(void 0,1,1,1,0,3),jb.bind(void 0,1,1,1,1,0),jb.bind(void 0,1,1,1,1,1),jb.bind(void 0,1,1,1,1,2),jb.bind(void 0,1,1,1,1,3)],b.exports=d},{}],17:[function(a,b,c){"use strict";function d(a,b){for(var c=0,d=a.length-1;c<=d;){var e=c+d>>>1,f=a[e].tag;if(f===b)return e;f>>1,f=a[e];if(f===b)return e;f=0)return e[f].script;if(b){var g={tag:a,script:{defaultLangSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]},langSysRecords:[]}};return e.splice(-1-f,0,g),g.script}}},getLangSysTable:function(a,b,c){var e=this.getScriptTable(a,c);if(e){if(!b||"dflt"===b||"DFLT"===b)return e.defaultLangSys;var f=d(e.langSysRecords,b);if(f>=0)return e.langSysRecords[f].langSys;if(c){var g={tag:b,langSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]}};return e.langSysRecords.splice(-1-f,0,g),g.langSys}}},getFeatureTable:function(a,b,c,d){var e=this.getLangSysTable(a,b,d);if(e){for(var f,h=e.featureIndexes,i=this.font.tables[this.tableName].features,j=0;j=i[k-1].tag,"Features must be added in alphabetical order."),f={tag:c,feature:{params:0,lookupListIndexes:[]}},i.push(f),h.push(k),f.feature}}},getLookupTables:function(a,b,c,d,e){var f=this.getFeatureTable(a,b,c,e),g=[];if(f){for(var h,i=f.lookupListIndexes,j=this.font.tables[this.tableName].lookups,k=0;k0)return new e(this.data,this.offset+b).parseStruct(a)},e.prototype.parseListOfLists=function(a){for(var b=this.parseOffset16List(),c=b.length,d=this.relativeOffset,e=new Array(c),f=0;f=0&&c>0&&(a+=" "),a+=b(d)}return a}a=void 0!==a?a:2;for(var d="",e=0;e=0){for(var m=h.ligatureSets[l],n=0;n>4,g=15&e;if(f===c)break;if(b+=d[f],g===c)break;b+=d[g]}return parseFloat(b)}function h(a,b){var c,d,e,f;if(28===b)return c=a.parseByte(),d=a.parseByte(),c<<8|d;if(29===b)return c=a.parseByte(),d=a.parseByte(),e=a.parseByte(),f=a.parseByte(),c<<24|d<<16|e<<8|f;if(30===b)return g(a);if(b>=32&&b<=246)return b-139;if(b>=247&&b<=250)return c=a.parseByte(),256*(b-247)+c+108;if(b>=251&&b<=254)return c=a.parseByte(),256*-(b-251)-c-108;throw new Error("Invalid b0 "+b)}function i(a){for(var b={},c=0;c>1,p.length=0,r=!0}function f(c){for(var m,v,w,y,z,A,B,C,D,E,F,G,H=0;H1&&!r&&(x=p.shift()+n,r=!0),u+=p.pop(),d(t,u);break;case 5:for(;p.length>0;)t+=p.shift(),u+=p.shift(),o.lineTo(t,u);break;case 6:for(;p.length>0&&(t+=p.shift(),o.lineTo(t,u),0!==p.length);)u+=p.shift(),o.lineTo(t,u);break;case 7:for(;p.length>0&&(u+=p.shift(),o.lineTo(t,u),0!==p.length);)t+=p.shift(),o.lineTo(t,u);break;case 8:for(;p.length>0;)g=t+p.shift(),h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),t=i+p.shift(),u=j+p.shift(),o.curveTo(g,h,i,j,t,u);break;case 10:z=p.pop()+l,A=k[z],A&&f(A);break;case 11:return;case 12:switch(I=c[H],H+=1,I){case 35:g=t+p.shift(),h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j+p.shift(),D=B+p.shift(),E=C+p.shift(),F=D+p.shift(),G=E+p.shift(),t=F+p.shift(),u=G+p.shift(),p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,t,u);break;case 34:g=t+p.shift(),h=u,i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j,D=B+p.shift(),E=j,F=D+p.shift(),G=u,t=F+p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,t,u);break;case 36:g=t+p.shift(),h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j,D=B+p.shift(),E=j,F=D+p.shift(),G=E+p.shift(),t=F+p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,t,u);break;case 37:g=t+p.shift(),h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j+p.shift(),D=B+p.shift(),E=C+p.shift(),F=D+p.shift(),G=E+p.shift(),Math.abs(F-t)>Math.abs(G-u)?t=F+p.shift():u=G+p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,t,u);break;default:console.log("Glyph "+b.index+": unknown operator 1200"+I),p.length=0}break;case 14:p.length>0&&!r&&(x=p.shift()+n,r=!0),s&&(o.closePath(),s=!1);break;case 18:e();break;case 19:case 20:e(),H+=q+7>>3;break;case 21:p.length>2&&!r&&(x=p.shift()+n,r=!0),u+=p.pop(),t+=p.pop(),d(t,u);break;case 22:p.length>1&&!r&&(x=p.shift()+n,r=!0),t+=p.pop(),d(t,u);break;case 23:e();break;case 24:for(;p.length>2;)g=t+p.shift(),h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),t=i+p.shift(),u=j+p.shift(),o.curveTo(g,h,i,j,t,u);t+=p.shift(),u+=p.shift(),o.lineTo(t,u);break;case 25:for(;p.length>6;)t+=p.shift(),u+=p.shift(),o.lineTo(t,u);g=t+p.shift(),h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),t=i+p.shift(),u=j+p.shift(),o.curveTo(g,h,i,j,t,u);break;case 26:for(p.length%2&&(t+=p.shift());p.length>0;)g=t,h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),t=i,u=j+p.shift(),o.curveTo(g,h,i,j,t,u);break;case 27:for(p.length%2&&(u+=p.shift());p.length>0;)g=t+p.shift(),h=u,i=g+p.shift(),j=h+p.shift(),t=i+p.shift(),u=j,o.curveTo(g,h,i,j,t,u);break;case 28:m=c[H],v=c[H+1],p.push((m<<24|v<<16)>>16),H+=2;break;case 29:z=p.pop()+a.gsubrsBias,A=a.gsubrs[z],A&&f(A);break;case 30:for(;p.length>0&&(g=t,h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),t=i+p.shift(),u=j+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,t,u),0!==p.length);)g=t+p.shift(),h=u,i=g+p.shift(),j=h+p.shift(),u=j+p.shift(),t=i+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,t,u);break;case 31:for(;p.length>0&&(g=t+p.shift(),h=u,i=g+p.shift(),j=h+p.shift(),u=j+p.shift(),t=i+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,t,u),0!==p.length);)g=t,h=u+p.shift(),i=g+p.shift(),j=h+p.shift(),t=i+p.shift(),u=j+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,t,u);break;default:I<32?console.log("Glyph "+b.index+": unknown operator "+I):I<247?p.push(I-139):I<251?(m=c[H],H+=1,p.push(256*(I-247)+m+108)):I<255?(m=c[H],H+=1,p.push(256*-(I-251)-m-108)):(m=c[H],v=c[H+1],w=c[H+2],y=c[H+3],H+=4,p.push((m<<24|v<<16|w<<8|y)/65536))}}}var g,h,i,j,k,l,m,n,o=new L.Path,p=[],q=0,r=!1,s=!1,t=0,u=0;if(a.isCIDFont){var v=a.tables.cff.topDict._fdSelect[b.index],w=a.tables.cff.topDict._fdArray[v];k=w._subrs,l=w._subrsBias,m=w._defaultWidthX,n=w._nominalWidthX}else k=a.tables.cff.topDict._subrs,l=a.tables.cff.topDict._subrsBias,m=a.tables.cff.topDict._defaultWidthX,n=a.tables.cff.topDict._nominalWidthX;var x=m;return f(c),b.advanceWidth=x,o}function t(a,b,c,d){var e,f=[],g=new K.Parser(a,b),h=g.parseCard8();if(0===h)for(var i=0;i=d)throw new Error("CFF table CID Font FDSelect has bad FD index value "+e+" (FD count "+d+")");f.push(e)}else{if(3!==h)throw new Error("CFF Table CID Font FDSelect table has unsupported format "+h);var j=g.parseCard16(),k=g.parseCard16();if(0!==k)throw new Error("CFF Table CID Font FDSelect format 3 range has bad initial GID "+k);for(var l,m=0;m=d)throw new Error("CFF table CID Font FDSelect has bad FD index value "+e+" (FD count "+d+")");if(l>c)throw new Error("CFF Table CID Font FDSelect format 3 range has bad GID "+l);for(;k=0&&(c=d),d=b.indexOf(a),d>=0?c=d+I.cffStandardStrings.length:(c=I.cffStandardStrings.length+b.length,b.push(a)),c}function w(){return new M.Record("Header",[{name:"major",type:"Card8",value:1},{name:"minor",type:"Card8",value:0},{name:"hdrSize",type:"Card8",value:4},{name:"major",type:"Card8",value:1}])}function x(a){var b=new M.Record("Name INDEX",[{name:"names",type:"INDEX",value:[]}]);b.names=[];for(var c=0;c>1,b.skip("uShort",3),a.glyphIndexMap={};var h=new k.Parser(c,d+e+14),i=new k.Parser(c,d+e+16+2*g),j=new k.Parser(c,d+e+16+4*g),l=new k.Parser(c,d+e+16+6*g),m=d+e+16+8*g;for(f=0;f=0;c-=1){var h=k.getUShort(a,b+4+8*c),i=k.getUShort(a,b+4+8*c+2);if(3===h&&(0===i||1===i||10===i)){g=k.getULong(a,b+4+8*c+4);break}}if(g===-1)throw new Error("No valid cmap sub-tables found.");var l=new k.Parser(a,b+g);if(f.format=l.parseUShort(),12===f.format)d(f,l);else{if(4!==f.format)throw new Error("Only format 4 and 12 cmap tables are supported (found format "+f.format+").");e(f,l,a,b,g)}return f}function g(a,b,c){a.segments.push({end:b,start:b,delta:-(b-c),offset:0})}function h(a){a.segments.push({end:65535,start:65535,delta:1,offset:0})}function i(a){var b,c=new l.Table("cmap",[{name:"version",type:"USHORT",value:0},{name:"numTables",type:"USHORT",value:1},{name:"platformID",type:"USHORT",value:3},{name:"encodingID",type:"USHORT",value:1},{name:"offset",type:"ULONG",value:12},{name:"format",type:"USHORT",value:4},{name:"length",type:"USHORT",value:0},{name:"language",type:"USHORT",value:0},{name:"segCountX2",type:"USHORT",value:0},{name:"searchRange",type:"USHORT",value:0},{name:"entrySelector",type:"USHORT",value:0},{name:"rangeShift",type:"USHORT",value:0}]);for(c.segments=[],b=0;b0?(f=a.parseByte(),0==(b&e)&&(f=-f),f=c+f):f=(b&e)>0?c:c+a.parseShort(),f}function e(a,b,c){var e=new m.Parser(b,c);a.numberOfContours=e.parseShort(),a._xMin=e.parseShort(),a._yMin=e.parseShort(),a._xMax=e.parseShort(),a._yMax=e.parseShort();var f,g,h;if(a.numberOfContours>0){var i=a.endPointIndices=[];for(h=0;h0)for(var l=e.parseByte(),n=0;n0){var o,p=[];if(j>0){for(h=0;h=0,p.push(o);var q=0;for(h=0;h0?(2&f)>0?(t.dx=e.parseShort(),t.dy=e.parseShort()):t.matchedPoints=[e.parseUShort(),e.parseUShort()]:(2&f)>0?(t.dx=e.parseChar(),t.dy=e.parseChar()):t.matchedPoints=[e.parseByte(),e.parseByte()],(8&f)>0?t.xScale=t.yScale=e.parseF2Dot14():(64&f)>0?(t.xScale=e.parseF2Dot14(),t.yScale=e.parseF2Dot14()):(128&f)>0&&(t.xScale=e.parseF2Dot14(),t.scale01=e.parseF2Dot14(),t.scale10=e.parseF2Dot14(),t.yScale=e.parseF2Dot14()),a.components.push(t),s=!!(32&f)}if(256&f)for(a.instructionLength=e.parseUShort(),a.instructions=[],h=0;hb.points.length-1||d.matchedPoints[1]>e.points.length-1)throw Error("Matched points out of range in "+b.name);var i=b.points[d.matchedPoints[0]],j=e.points[d.matchedPoints[1]],k={xScale:d.xScale,scale01:d.scale01,scale10:d.scale10,yScale:d.yScale,dx:0,dy:0};j=f([j],k)[0],k.dx=i.x-j.x,k.dy=i.y-j.y,g=f(e.points,k)}b.points=b.points.concat(g)}}return h(b.points)}function j(a,b,c,d){var f,g=new l.GlyphSet(d);for(f=0;f>1;a1&&console.warn("Only the first kern subtable is supported."),a.skip("uLong");var c=a.parseUShort(),d=255&c;if(a.skip("uShort"),0===d){var e=a.parseUShort();a.skip("uShort",3);for(var f=0;f=c.begin&&a=1&&(c.ulCodePageRange1=d.parseULong(),c.ulCodePageRange2=d.parseULong()),c.version>=2&&(c.sxHeight=d.parseShort(),c.sCapHeight=d.parseShort(),c.usDefaultChar=d.parseUShort(),c.usBreakChar=d.parseUShort(),c.usMaxContent=d.parseUShort()),c}function f(a){return new h.Table("OS/2",[{name:"version",type:"USHORT",value:3},{name:"xAvgCharWidth",type:"SHORT",value:0},{name:"usWeightClass",type:"USHORT",value:0},{name:"usWidthClass",type:"USHORT",value:0},{name:"fsType",type:"USHORT",value:0},{name:"ySubscriptXSize",type:"SHORT",value:650},{name:"ySubscriptYSize",type:"SHORT",value:699},{name:"ySubscriptXOffset",type:"SHORT",value:0},{name:"ySubscriptYOffset",type:"SHORT",value:140},{name:"ySuperscriptXSize",type:"SHORT",value:650},{name:"ySuperscriptYSize",type:"SHORT",value:699},{name:"ySuperscriptXOffset",type:"SHORT",value:0},{name:"ySuperscriptYOffset",type:"SHORT",value:479},{name:"yStrikeoutSize",type:"SHORT",value:49},{name:"yStrikeoutPosition",type:"SHORT",value:258},{name:"sFamilyClass",type:"SHORT",value:0},{name:"bFamilyType",type:"BYTE",value:0},{name:"bSerifStyle",type:"BYTE",value:0},{name:"bWeight",type:"BYTE",value:0},{name:"bProportion",type:"BYTE",value:0},{name:"bContrast",type:"BYTE",value:0},{name:"bStrokeVariation",type:"BYTE",value:0},{name:"bArmStyle",type:"BYTE",value:0},{name:"bLetterform",type:"BYTE",value:0},{name:"bMidline",type:"BYTE",value:0},{name:"bXHeight",type:"BYTE",value:0},{name:"ulUnicodeRange1",type:"ULONG",value:0},{name:"ulUnicodeRange2",type:"ULONG",value:0},{name:"ulUnicodeRange3",type:"ULONG",value:0},{name:"ulUnicodeRange4",type:"ULONG",value:0},{name:"achVendID",type:"CHARARRAY",value:"XXXX"},{name:"fsSelection",type:"USHORT",value:0},{name:"usFirstCharIndex",type:"USHORT",value:0},{name:"usLastCharIndex",type:"USHORT",value:0},{name:"sTypoAscender",type:"SHORT",value:0},{name:"sTypoDescender",type:"SHORT",value:0},{name:"sTypoLineGap",type:"SHORT",value:0},{name:"usWinAscent",type:"USHORT",value:0},{name:"usWinDescent",type:"USHORT",value:0},{name:"ulCodePageRange1",type:"ULONG",value:0},{name:"ulCodePageRange2",type:"ULONG",value:0},{name:"sxHeight",type:"SHORT",value:0},{name:"sCapHeight",type:"SHORT",value:0},{name:"usDefaultChar",type:"USHORT",value:0},{name:"usBreakChar",type:"USHORT",value:0},{name:"usMaxContext",type:"USHORT",value:0}],a)}var g=a("../parse"),h=a("../table"),i=[{begin:0,end:127},{begin:128,end:255},{begin:256,end:383},{begin:384,end:591},{begin:592,end:687},{begin:688,end:767},{begin:768,end:879},{begin:880,end:1023},{begin:11392,end:11519},{begin:1024,end:1279},{begin:1328,end:1423},{begin:1424,end:1535},{begin:42240,end:42559},{begin:1536,end:1791},{begin:1984,end:2047},{begin:2304,end:2431},{begin:2432,end:2559},{begin:2560,end:2687},{begin:2688,end:2815},{begin:2816,end:2943},{begin:2944,end:3071},{begin:3072,end:3199},{begin:3200,end:3327},{begin:3328,end:3455},{begin:3584,end:3711},{begin:3712,end:3839},{begin:4256,end:4351},{begin:6912,end:7039},{begin:4352,end:4607},{begin:7680,end:7935},{begin:7936,end:8191},{begin:8192,end:8303},{begin:8304,end:8351},{begin:8352,end:8399},{begin:8400,end:8447},{begin:8448,end:8527},{begin:8528,end:8591},{begin:8592,end:8703},{begin:8704,end:8959},{begin:8960,end:9215},{begin:9216,end:9279},{begin:9280,end:9311},{begin:9312,end:9471},{begin:9472,end:9599},{begin:9600,end:9631},{begin:9632,end:9727},{begin:9728,end:9983},{begin:9984,end:10175},{begin:12288,end:12351},{begin:12352,end:12447},{begin:12448,end:12543},{begin:12544,end:12591},{begin:12592,end:12687},{begin:43072,end:43135},{begin:12800,end:13055},{begin:13056,end:13311},{begin:44032,end:55215},{begin:55296,end:57343},{begin:67840,end:67871},{begin:19968,end:40959},{begin:57344,end:63743},{begin:12736,end:12783},{begin:64256,end:64335},{begin:64336,end:65023},{begin:65056,end:65071},{begin:65040,end:65055},{begin:65104,end:65135},{begin:65136,end:65279},{begin:65280,end:65519},{begin:65520,end:65535},{begin:3840,end:4095},{begin:1792,end:1871},{begin:1920,end:1983},{begin:3456,end:3583},{begin:4096,end:4255},{begin:4608,end:4991},{begin:5024,end:5119},{begin:5120,end:5759},{begin:5760,end:5791},{begin:5792,end:5887},{begin:6016,end:6143},{begin:6144,end:6319},{begin:10240,end:10495},{begin:40960,end:42127},{begin:5888,end:5919},{begin:66304,end:66351},{begin:66352,end:66383},{begin:66560,end:66639},{begin:118784,end:119039},{begin:119808,end:120831},{begin:1044480,end:1048573},{begin:65024,end:65039},{begin:917504,end:917631},{begin:6400,end:6479},{begin:6480,end:6527},{begin:6528,end:6623},{begin:6656,end:6687},{begin:11264,end:11359},{begin:11568,end:11647},{begin:19904,end:19967},{begin:43008,end:43055},{begin:65536,end:65663},{begin:65856,end:65935},{begin:66432,end:66463},{begin:66464,end:66527},{begin:66640,end:66687},{begin:66688,end:66735},{begin:67584,end:67647},{begin:68096,end:68191},{begin:119552,end:119647},{begin:73728,end:74751},{begin:119648,end:119679},{begin:7040,end:7103},{begin:7168,end:7247},{begin:7248,end:7295},{begin:43136,end:43231},{begin:43264,end:43311},{begin:43312,end:43359},{begin:43520,end:43615},{begin:65936,end:65999},{begin:66e3,end:66047},{begin:66208,end:66271},{begin:127024,end:127135}];c.unicodeRanges=i,c.getUnicodeRange=d,c.parse=e,c.make=f},{"../parse":19,"../table":22}],39:[function(a,b,c){"use strict";function d(a,b){var c,d={},e=new g.Parser(a,b);switch(d.version=e.parseVersion(),d.italicAngle=e.parseFixed(),d.underlinePosition=e.parseShort(),d.underlineThickness=e.parseShort(),d.isFixedPitch=e.parseULong(),d.minMemType42=e.parseULong(),d.maxMemType42=e.parseULong(),d.minMemType1=e.parseULong(),d.maxMemType1=e.parseULong(),d.version){case 1:d.names=f.standardNames.slice();break;case 2:for(d.numberOfGlyphs=e.parseUShort(),d.glyphNameIndex=new Array(d.numberOfGlyphs),c=0;c=f.standardNames.length){var h=e.parseChar();d.names.push(e.parseString(h))}break;case 2.5:for(d.numberOfGlyphs=e.parseUShort(),d.offset=new Array(d.numberOfGlyphs),c=0;cb.value.tag?1:-1}),b.fields=b.fields.concat(g),b.fields=b.fields.concat(h),b}function h(a,b,c){for(var d=0;d0){return a.glyphs.get(e).getMetrics()}}return c}function i(a){for(var b=0,c=0;cG||void 0===b)&&G>0&&(b=G),z 123 are reserved for internal usage");D|=1<0?r.make(W):void 0,Z=v.make(),$=n.make(a.glyphs,{version:a.getEnglishName("version"),fullName:S,familyName:Q,weightName:R,postScriptName:T,unitsPerEm:a.unitsPerEm,fontBBox:[0,J.yMin,J.ascender,J.advanceWidthMax]}),_=a.metas&&Object.keys(a.metas).length>0?x.make(a.metas):void 0,aa=[K,L,M,N,X,P,Z,$,O];Y&&aa.push(Y),a.tables.gsub&&aa.push(w.make(a.tables.gsub)),_&&aa.push(_);var ba=g(aa),ca=ba.encode(),da=e(ca),ea=ba.fields,fa=!1;for(E=0;E=-128&&a<=127}function f(a,b,c){for(var d=0,e=a.length;b>8&255,j+256&255)}return g}var i=a("./check"),j=32768,k=2147483648,l={},m={},n={};m.BYTE=function(a){return i.argument(a>=0&&a<=255,"Byte value should be between 0 and 255."),[a]},n.BYTE=d(1),m.CHAR=function(a){return[a.charCodeAt(0)]},n.CHAR=d(1),m.CHARARRAY=function(a){for(var b=[],c=0;c>8&255,255&a]},n.USHORT=d(2),m.SHORT=function(a){return a>=j&&(a=-(2*j-a)),[a>>8&255,255&a]},n.SHORT=d(2),m.UINT24=function(a){return[a>>16&255,a>>8&255,255&a]},n.UINT24=d(3),m.ULONG=function(a){return[a>>24&255,a>>16&255,a>>8&255,255&a]},n.ULONG=d(4),m.LONG=function(a){return a>=k&&(a=-(2*k-a)),[a>>24&255,a>>16&255,a>>8&255,255&a]},n.LONG=d(4),m.FIXED=m.ULONG,n.FIXED=n.ULONG,m.FWORD=m.SHORT,n.FWORD=n.SHORT,m.UFWORD=m.USHORT,n.UFWORD=n.USHORT,m.LONGDATETIME=function(a){return[0,0,0,0,a>>24&255,a>>16&255,a>>8&255,255&a]},n.LONGDATETIME=d(8),m.TAG=function(a){return i.argument(4===a.length,"Tag should be exactly 4 ASCII characters."),[a.charCodeAt(0),a.charCodeAt(1),a.charCodeAt(2),a.charCodeAt(3)]},n.TAG=d(4),m.Card8=m.BYTE,n.Card8=n.BYTE,m.Card16=m.USHORT,n.Card16=n.USHORT,m.OffSize=m.BYTE,n.OffSize=n.BYTE,m.SID=m.USHORT,n.SID=n.USHORT,m.NUMBER=function(a){return a>=-107&&a<=107?[a+139]:a>=108&&a<=1131?(a-=108,[247+(a>>8),255&a]):a>=-1131&&a<=-108?(a=-a-108,[251+(a>>8),255&a]):a>=-32768&&a<=32767?m.NUMBER16(a):m.NUMBER32(a)},n.NUMBER=function(a){return m.NUMBER(a).length},m.NUMBER16=function(a){return[28,a>>8&255,255&a]},n.NUMBER16=d(3),m.NUMBER32=function(a){return[29,a>>24&255,a>>16&255,a>>8&255,255&a]},n.NUMBER32=d(5),m.REAL=function(a){var b=a.toString(),c=/\.(\d*?)(?:9{5,20}|0{5,20})\d{0,2}(?:e(.+)|$)/.exec(b);if(c){var d=parseFloat("1e"+((c[2]?+c[2]:0)+c[1].length));b=(Math.round(a*d)/d).toString()}var e,f,g="";for(e=0,f=b.length;e>8&255,b[b.length]=255&d}return b},n.UTF16=function(a){return 2*a.length};var o={"x-mac-croatian":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®Š™´¨≠ŽØ∞±≤≥∆µ∂∑∏š∫ªºΩžø¿¡¬√ƒ≈Ć«Č… ÀÃÕŒœĐ—“”‘’÷◊©⁄€‹›Æ»–·‚„‰ÂćÁčÈÍÎÏÌÓÔđÒÚÛÙıˆ˜¯πË˚¸Êæˇ","x-mac-cyrillic":"АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ†°Ґ£§•¶І®©™Ђђ≠Ѓѓ∞±≤≥іµґЈЄєЇїЉљЊњјЅ¬√ƒ≈∆«»… ЋћЌќѕ–—“”‘’÷„ЎўЏџ№Ёёяабвгдежзийклмнопрстуфхцчшщъыьэю","x-mac-gaelic":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØḂ±≤≥ḃĊċḊḋḞḟĠġṀæøṁṖṗɼƒſṠ«»… ÀÃÕŒœ–—“”‘’ṡẛÿŸṪ€‹›Ŷŷṫ·Ỳỳ⁊ÂÊÁËÈÍÎÏÌÓÔ♣ÒÚÛÙıÝýŴŵẄẅẀẁẂẃ","x-mac-greek":"Ĺ²É³ÖÜ΅àâä΄¨çéèê룙î‰ôö¦€ùûü†ΓΔΘΛΞΠß®©ΣΪ§≠°·Α±≤≥¥ΒΕΖΗΙΚΜΦΫΨΩάΝ¬ΟΡ≈Τ«»… ΥΧΆΈœ–―“”‘’÷ΉΊΌΎέήίόΏύαβψδεφγηιξκλμνοπώρστθωςχυζϊϋΐΰ","x-mac-icelandic":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûüÝ°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€ÐðÞþý·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ","x-mac-inuit":"ᐃᐄᐅᐆᐊᐋᐱᐲᐳᐴᐸᐹᑉᑎᑏᑐᑑᑕᑖᑦᑭᑮᑯᑰᑲᑳᒃᒋᒌᒍᒎᒐᒑ°ᒡᒥᒦ•¶ᒧ®©™ᒨᒪᒫᒻᓂᓃᓄᓅᓇᓈᓐᓯᓰᓱᓲᓴᓵᔅᓕᓖᓗᓘᓚᓛᓪᔨᔩᔪᔫᔭ… ᔮᔾᕕᕖᕗ–—“”‘’ᕘᕙᕚᕝᕆᕇᕈᕉᕋᕌᕐᕿᖀᖁᖂᖃᖄᖅᖏᖐᖑᖒᖓᖔᖕᙱᙲᙳᙴᙵᙶᖖᖠᖡᖢᖣᖤᖥᖦᕼŁł","x-mac-ce":"ÄĀāÉĄÖÜáąČäčĆć鏟ĎíďĒēĖóėôöõúĚěü†°Ę£§•¶ß®©™ę¨≠ģĮįĪ≤≥īĶ∂∑łĻļĽľĹĺŅņѬ√ńŇ∆«»… ňŐÕőŌ–—“”‘’÷◊ōŔŕŘ‹›řŖŗŠ‚„šŚśÁŤťÍŽžŪÓÔūŮÚůŰűŲųÝýķŻŁżĢˇ",macintosh:"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›fifl‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ","x-mac-romanian":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ĂȘ∞±≤≥¥µ∂∑∏π∫ªºΩăș¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›Țț‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ","x-mac-turkish":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ"};l.MACSTRING=function(a,b,c,d){var e=o[d];if(void 0!==e){for(var f="",g=0;g=128&&void 0===(f=c[f]))return;d[e]=f}return d}},n.MACSTRING=function(a,b){var c=m.MACSTRING(a,b);return void 0!==c?c.length:0},m.VARDELTAS=function(a){for(var b=0,c=[];b=-128&&d<=127?g(a,b,c):h(a,b,c)}return c},m.INDEX=function(a){var b,c=1,d=[c],e=[];for(b=0;b>8,c[l+1]=255&n,c=c.concat(e[b])}return c},n.TABLE=function(a){for(var b=0,c=a.fields.length,d=0;d1)for(var c=1;c>>=1,b}function j(a,b,c){if(!b)return c;for(;a.bitcount<24;)a.tag|=a.source[a.sourceIndex++]<>>16-b;return a.tag>>>=b,a.bitcount-=b,d+c}function k(a,b){for(;a.bitcount<24;)a.tag|=a.source[a.sourceIndex++]<>>=1,++e,c+=b.table[e],d-=b.table[e]}while(d>=0);return a.tag=f,a.bitcount-=e,b.trans[c+d]}function l(a,b,c){var d,e,f,g,i,l;for(d=j(a,5,257),e=j(a,5,1),f=j(a,4,4),g=0;g<19;++g)z[g]=0;for(g=0;g8;)a.sourceIndex--,a.bitcount-=8;if(b=a.source[a.sourceIndex+1],b=256*b+a.source[a.sourceIndex],c=a.source[a.sourceIndex+3],c=256*c+a.source[a.sourceIndex+2],b!==(65535&~c))return q;for(a.sourceIndex+=4,d=b;d;--d)a.dest[a.destLen++]=a.source[a.sourceIndex++];return a.bitcount=0,p}function o(a,b){var c,d,f=new e(a,b);do{switch(c=i(f),j(f,2,0)){case 0:d=n(f);break;case 1:d=m(f,r,s);break;case 2:l(f,f.ltree,f.dtree),d=m(f,f.ltree,f.dtree);break;default:d=q}if(d!==p)throw new Error("Data error")}while(!c);return f.destLen-1?b:a}function n(a,b){b=b||{};var c=b.body;if(a instanceof n){if(a.bodyUsed)throw new TypeError("Already read");this.url=a.url,this.credentials=a.credentials,b.headers||(this.headers=new e(a.headers)),this.method=a.method,this.mode=a.mode,c||null==a._bodyInit||(c=a._bodyInit,a.bodyUsed=!0)}else this.url=String(a);if(this.credentials=b.credentials||this.credentials||"omit",!b.headers&&this.headers||(this.headers=new e(b.headers)),this.method=m(b.method||this.method||"GET"),this.mode=b.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&c)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(c)}function o(a){var b=new FormData;return a.trim().split("&").forEach(function(a){if(a){var c=a.split("="),d=c.shift().replace(/\+/g," "),e=c.join("=").replace(/\+/g," ");b.append(decodeURIComponent(d),decodeURIComponent(e))}}),b}function p(a){var b=new e;return a.split(/\r?\n/).forEach(function(a){var c=a.split(":"),d=c.shift().trim();if(d){var e=c.join(":").trim();b.append(d,e)}}),b}function q(a,b){b||(b={}),this.type="default",this.status="status"in b?b.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in b?b.statusText:"OK",this.headers=new e(b.headers),this.url=b.url||"",this._initBody(a)}if(!a.fetch){var r={searchParams:"URLSearchParams"in a,iterable:"Symbol"in a&&"iterator"in Symbol,blob:"FileReader"in a&&"Blob"in a&&function(){try{return new Blob,!0}catch(a){return!1}}(),formData:"FormData"in a,arrayBuffer:"ArrayBuffer"in a};if(r.arrayBuffer)var s=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],t=function(a){return a&&DataView.prototype.isPrototypeOf(a)},u=ArrayBuffer.isView||function(a){return a&&s.indexOf(Object.prototype.toString.call(a))>-1};e.prototype.append=function(a,d){a=b(a),d=c(d);var e=this.map[a];this.map[a]=e?e+","+d:d},e.prototype.delete=function(a){delete this.map[b(a)]},e.prototype.get=function(a){return a=b(a),this.has(a)?this.map[a]:null},e.prototype.has=function(a){return this.map.hasOwnProperty(b(a))},e.prototype.set=function(a,d){this.map[b(a)]=c(d)},e.prototype.forEach=function(a,b){for(var c in this.map)this.map.hasOwnProperty(c)&&a.call(b,this.map[c],c,this)},e.prototype.keys=function(){var a=[];return this.forEach(function(b,c){a.push(c)}),d(a)},e.prototype.values=function(){var a=[];return this.forEach(function(b){a.push(b)}),d(a)},e.prototype.entries=function(){var a=[];return this.forEach(function(b,c){a.push([c,b])}),d(a)},r.iterable&&(e.prototype[Symbol.iterator]=e.prototype.entries);var v=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];n.prototype.clone=function(){return new n(this,{body:this._bodyInit})},l.call(n.prototype),l.call(q.prototype),q.prototype.clone=function(){return new q(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new e(this.headers),url:this.url})},q.error=function(){var a=new q(null,{status:0,statusText:""});return a.type="error",a};var w=[301,302,303,307,308];q.redirect=function(a,b){if(w.indexOf(b)===-1)throw new RangeError("Invalid status code");return new q(null,{status:b,headers:{location:a}})},a.Headers=e,a.Request=n,a.Response=q,a.fetch=function(a,b){return new Promise(function(c,d){var e=new n(a,b),f=new XMLHttpRequest;f.onload=function(){var a={status:f.status,statusText:f.statusText,headers:p(f.getAllResponseHeaders()||"")};a.url="responseURL"in f?f.responseURL:a.headers.get("X-Request-URL"),c(new q("response"in f?f.response:f.responseText,a))},f.onerror=function(){d(new TypeError("Network request failed"))},f.ontimeout=function(){d(new TypeError("Network request failed"))},f.open(e.method,e.url,!0),"include"===e.credentials&&(f.withCredentials=!0),"responseType"in f&&r.blob&&(f.responseType="blob"),e.headers.forEach(function(a,b){f.setRequestHeader(b,a)}),f.send(void 0===e._bodyInit?null:e._bodyInit)})},a.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},{}],46:[function(a,b,c){"use strict";var d=a("./core/core");a("./color/p5.Color"),a("./core/p5.Element"),a("./typography/p5.Font"),a("./core/p5.Graphics"),a("./core/p5.Renderer2D"),a("./image/p5.Image"),a("./math/p5.Vector"),a("./io/p5.TableRow"),a("./io/p5.Table"),a("./io/p5.XML"),a("./color/creating_reading"),a("./color/setting"),a("./core/constants"),a("./utilities/conversion"),a("./utilities/array_functions"),a("./utilities/string_functions"),a("./core/environment"),a("./image/image"),a("./image/loading_displaying"),a("./image/pixels"),a("./io/files"),a("./events/keyboard"),a("./events/acceleration"),a("./events/mouse"),a("./utilities/time_date"),a("./events/touch"),a("./math/math"),a("./math/calculation"),a("./math/random"),a("./math/noise"),a("./math/trigonometry"),a("./core/rendering"),a("./core/2d_primitives"),a("./core/attributes"),a("./core/curves"),a("./core/vertex"),a("./core/structure"),a("./core/transform"),a("./typography/attributes"),a("./typography/loading_displaying"),a("./data/p5.TypedDict"),a("./webgl/p5.RendererGL"),a("./webgl/p5.Geometry"),a("./webgl/p5.RendererGL.Retained"),a("./webgl/p5.RendererGL.Immediate"),a("./webgl/primitives"),a("./webgl/loading"),a("./webgl/p5.Matrix"),a("./webgl/material"),a("./webgl/light"),a("./webgl/p5.Shader"),a("./webgl/camera"),a("./webgl/interaction"),a("./core/init.js"),b.exports=d},{"./color/creating_reading":48,"./color/p5.Color":49,"./color/setting":50,"./core/2d_primitives":51,"./core/attributes":52,"./core/constants":54,"./core/core":55,"./core/curves":56,"./core/environment":57,"./core/init.js":59,"./core/p5.Element":60,"./core/p5.Graphics":61,"./core/p5.Renderer2D":63,"./core/rendering":64,"./core/structure":66,"./core/transform":67,"./core/vertex":68,"./data/p5.TypedDict":69,"./events/acceleration":70,"./events/keyboard":71,"./events/mouse":72,"./events/touch":73,"./image/image":75,"./image/loading_displaying":76,"./image/p5.Image":77,"./image/pixels":78,"./io/files":79,"./io/p5.Table":80,"./io/p5.TableRow":81,"./io/p5.XML":82,"./math/calculation":83,"./math/math":84,"./math/noise":85,"./math/p5.Vector":86,"./math/random":88,"./math/trigonometry":89,"./typography/attributes":90,"./typography/loading_displaying":91,"./typography/p5.Font":92,"./utilities/array_functions":93,"./utilities/conversion":94,"./utilities/string_functions":95,"./utilities/time_date":96,"./webgl/camera":97,"./webgl/interaction":98,"./webgl/light":99,"./webgl/loading":100,"./webgl/material":101,"./webgl/p5.Geometry":102,"./webgl/p5.Matrix":103,"./webgl/p5.RendererGL":106,"./webgl/p5.RendererGL.Immediate":104,"./webgl/p5.RendererGL.Retained":105,"./webgl/p5.Shader":107,"./webgl/primitives":109}],47:[function(a,b,c){"use strict";var d=a("../core/core");d.ColorConversion={},d.ColorConversion._hsbaToHSLA=function(a){var b=a[0],c=a[1],d=a[2],e=(2-c)*d/2;return 0!==e&&(1===e?c=0:e<.5?c/=2-c:c=c*d/(2-2*e)),[b,c,e,a[3]]},d.ColorConversion._hsbaToRGBA=function(a){var b=6*a[0],c=a[1],d=a[2],e=[];if(0===c)e=[d,d,d,a[3]];else{var f,g,h,i=Math.floor(b),j=d*(1-c),k=d*(1-c*(b-i)),l=d*(1-c*(1+i-b));1===i?(f=k,g=d,h=j):2===i?(f=j,g=d,h=l):3===i?(f=j,g=k,h=d):4===i?(f=l,g=j,h=d):5===i?(f=d,g=j,h=k):(f=d,g=l,h=j),e=[f,g,h,a[3]]}return e},d.ColorConversion._hslaToHSBA=function(a){var b,c=a[0],d=a[1],e=a[2];return b=e<.5?(1+d)*e:e+d-e*d,d=2*(b-e)/b,[c,d,b,a[3]]},d.ColorConversion._hslaToRGBA=function(a){var b=6*a[0],c=a[1],d=a[2],e=[];if(0===c)e=[d,d,d,a[3]];else{var f;f=d<.5?(1+c)*d:d+c-d*c;var g=2*d-f,h=function(a,b,c){return a<0?a+=6:a>=6&&(a-=6),a<1?b+(c-b)*a:a<3?c:a<4?b+(c-b)*(4-a):b};e=[h(b+2,g,f),h(b,g,f),h(b-2,g,f),a[3]]}return e},d.ColorConversion._rgbaToHSBA=function(a){var b,c,d=a[0],e=a[1],f=a[2],g=Math.max(d,e,f),h=g-Math.min(d,e,f);return 0===h?(b=0,c=0):(c=h/g,d===g?b=(e-f)/h:e===g?b=2+(f-d)/h:f===g&&(b=4+(d-e)/h),b<0?b+=6:b>=6&&(b-=6)),[b/6,c,g,a[3]]},d.ColorConversion._rgbaToHSLA=function(a){var b,c,d=a[0],e=a[1],f=a[2],g=Math.max(d,e,f),h=Math.min(d,e,f),i=g+h,j=g-h;return 0===j?(b=0,c=0):(c=i<1?j/i:j/(2-i),d===g?b=(e-f)/j:e===g?b=2+(f-d)/j:f===g&&(b=4+(d-e)/j),b<0?b+=6:b>=6&&(b-=6)),[b/6,c,i/2,a[3]]},b.exports=d.ColorConversion},{"../core/core":55}],48:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("../core/constants");a("./p5.Color"),a("../core/error_helpers"),d.prototype.alpha=function(a){return d._validateParameters("alpha",arguments),this.color(a)._getAlpha()},d.prototype.blue=function(a){return d._validateParameters("blue",arguments),this.color(a)._getBlue()},d.prototype.brightness=function(a){return d._validateParameters("brightness",arguments),this.color(a)._getBrightness()},d.prototype.color=function(){return arguments[0]instanceof d.Color?arguments[0]:arguments[0]instanceof Array?this instanceof d.Renderer?new d.Color(this,arguments[0]):new d.Color(this._renderer,arguments[0]):(d._validateParameters("color",arguments),this instanceof d.Renderer?new d.Color(this,arguments):new d.Color(this._renderer,arguments))},d.prototype.green=function(a){return d._validateParameters("green",arguments),this.color(a)._getGreen()},d.prototype.hue=function(a){return d._validateParameters("hue",arguments),this.color(a)._getHue()},d.prototype.lerpColor=function(a,b,c){d._validateParameters("lerpColor",arguments);var f,g,h,i,j,k,l=this._renderer._colorMode,m=this._renderer._colorMaxes;if(l===e.RGB)j=arguments[0].levels.map(function(a){return a/255}),k=arguments[1].levels.map(function(a){return a/255});else if(l===e.HSB)arguments[0]._getBrightness(),arguments[1]._getBrightness(),j=arguments[0].hsba,k=arguments[1].hsba;else{if(l!==e.HSL)throw new Error(l+"cannot be used for interpolation.");arguments[0]._getLightness(),arguments[1]._getLightness(),j=arguments[0].hsla,k=arguments[1].hsla}return c=Math.max(Math.min(arguments[2],1),0),void 0===this.lerp&&(this.lerp=function(a,b,c){return c*(b-a)+a}),f=this.lerp(j[0],k[0],c),g=this.lerp(j[1],k[1],c),h=this.lerp(j[2],k[2],c),i=this.lerp(j[3],k[3],c),f*=m[l][0],g*=m[l][1],h*=m[l][2],i*=m[l][3],this.color(f,g,h,i)},d.prototype.lightness=function(a){return d._validateParameters("lightness",arguments),this.color(a)._getLightness()},d.prototype.red=function(a){return d._validateParameters("red",arguments),this.color(a)._getRed()},d.prototype.saturation=function(a){return d._validateParameters("saturation",arguments),this.color(a)._getSaturation()},b.exports=d},{"../core/constants":54,"../core/core":55,"../core/error_helpers":58,"./p5.Color":49}],49:[function(a,b,c){var d=a("../core/core"),e=a("../core/constants"),f=a("./color_conversion");d.Color=function(a,b){if(this._storeModeAndMaxes(a._colorMode,a._colorMaxes),this.mode!==e.RGB&&this.mode!==e.HSL&&this.mode!==e.HSB)throw new Error(this.mode+" is an invalid colorMode.");return this._array=d.Color._parseInputs.apply(this,b),this._calculateLevels(),this.name="p5.Color",this},d.Color.prototype.toString=function(){var a=this.levels,b=this._array[3];return"rgba("+a[0]+","+a[1]+","+a[2]+","+b+")"},d.Color.prototype.setRed=function(a){this._array[0]=a/this.maxes[e.RGB][0],this._calculateLevels()},d.Color.prototype.setGreen=function(a){this._array[1]=a/this.maxes[e.RGB][1],this._calculateLevels()},d.Color.prototype.setBlue=function(a){this._array[2]=a/this.maxes[e.RGB][2],this._calculateLevels()},d.Color.prototype.setAlpha=function(a){this._array[3]=a/this.maxes[this.mode][3],this._calculateLevels()},d.Color.prototype._calculateLevels=function(){this.levels=this._array.map(function(a){return Math.round(255*a)})},d.Color.prototype._getAlpha=function(){return this._array[3]*this.maxes[this.mode][3]},d.Color.prototype._storeModeAndMaxes=function(a,b){this.mode=a,this.maxes=b},d.Color.prototype._getMode=function(){return this.mode},d.Color.prototype._getMaxes=function(){return this.maxes},d.Color.prototype._getBlue=function(){return this._array[2]*this.maxes[e.RGB][2]},d.Color.prototype._getBrightness=function(){return this.hsba||(this.hsba=f._rgbaToHSBA(this._array)),this.hsba[2]*this.maxes[e.HSB][2]},d.Color.prototype._getGreen=function(){return this._array[1]*this.maxes[e.RGB][1]},d.Color.prototype._getHue=function(){return this.mode===e.HSB?(this.hsba||(this.hsba=f._rgbaToHSBA(this._array)),this.hsba[0]*this.maxes[e.HSB][0]):(this.hsla||(this.hsla=f._rgbaToHSLA(this._array)),this.hsla[0]*this.maxes[e.HSL][0])},d.Color.prototype._getLightness=function(){return this.hsla||(this.hsla=f._rgbaToHSLA(this._array)),this.hsla[2]*this.maxes[e.HSL][2]},d.Color.prototype._getRed=function(){return this._array[0]*this.maxes[e.RGB][0]},d.Color.prototype._getSaturation=function(){return this.mode===e.HSB?(this.hsba||(this.hsba=f._rgbaToHSBA(this._array)),this.hsba[1]*this.maxes[e.HSB][1]):(this.hsla||(this.hsla=f._rgbaToHSLA(this._array)),this.hsla[1]*this.maxes[e.HSL][1])};var g={
-aliceblue:"#f0f8ff",antiquewhite:"#faebd7",aqua:"#00ffff",aquamarine:"#7fffd4",azure:"#f0ffff",beige:"#f5f5dc",bisque:"#ffe4c4",black:"#000000",blanchedalmond:"#ffebcd",blue:"#0000ff",blueviolet:"#8a2be2",brown:"#a52a2a",burlywood:"#deb887",cadetblue:"#5f9ea0",chartreuse:"#7fff00",chocolate:"#d2691e",coral:"#ff7f50",cornflowerblue:"#6495ed",cornsilk:"#fff8dc",crimson:"#dc143c",cyan:"#00ffff",darkblue:"#00008b",darkcyan:"#008b8b",darkgoldenrod:"#b8860b",darkgray:"#a9a9a9",darkgreen:"#006400",darkgrey:"#a9a9a9",darkkhaki:"#bdb76b",darkmagenta:"#8b008b",darkolivegreen:"#556b2f",darkorange:"#ff8c00",darkorchid:"#9932cc",darkred:"#8b0000",darksalmon:"#e9967a",darkseagreen:"#8fbc8f",darkslateblue:"#483d8b",darkslategray:"#2f4f4f",darkslategrey:"#2f4f4f",darkturquoise:"#00ced1",darkviolet:"#9400d3",deeppink:"#ff1493",deepskyblue:"#00bfff",dimgray:"#696969",dimgrey:"#696969",dodgerblue:"#1e90ff",firebrick:"#b22222",floralwhite:"#fffaf0",forestgreen:"#228b22",fuchsia:"#ff00ff",gainsboro:"#dcdcdc",ghostwhite:"#f8f8ff",gold:"#ffd700",goldenrod:"#daa520",gray:"#808080",green:"#008000",greenyellow:"#adff2f",grey:"#808080",honeydew:"#f0fff0",hotpink:"#ff69b4",indianred:"#cd5c5c",indigo:"#4b0082",ivory:"#fffff0",khaki:"#f0e68c",lavender:"#e6e6fa",lavenderblush:"#fff0f5",lawngreen:"#7cfc00",lemonchiffon:"#fffacd",lightblue:"#add8e6",lightcoral:"#f08080",lightcyan:"#e0ffff",lightgoldenrodyellow:"#fafad2",lightgray:"#d3d3d3",lightgreen:"#90ee90",lightgrey:"#d3d3d3",lightpink:"#ffb6c1",lightsalmon:"#ffa07a",lightseagreen:"#20b2aa",lightskyblue:"#87cefa",lightslategray:"#778899",lightslategrey:"#778899",lightsteelblue:"#b0c4de",lightyellow:"#ffffe0",lime:"#00ff00",limegreen:"#32cd32",linen:"#faf0e6",magenta:"#ff00ff",maroon:"#800000",mediumaquamarine:"#66cdaa",mediumblue:"#0000cd",mediumorchid:"#ba55d3",mediumpurple:"#9370db",mediumseagreen:"#3cb371",mediumslateblue:"#7b68ee",mediumspringgreen:"#00fa9a",mediumturquoise:"#48d1cc",mediumvioletred:"#c71585",midnightblue:"#191970",mintcream:"#f5fffa",mistyrose:"#ffe4e1",moccasin:"#ffe4b5",navajowhite:"#ffdead",navy:"#000080",oldlace:"#fdf5e6",olive:"#808000",olivedrab:"#6b8e23",orange:"#ffa500",orangered:"#ff4500",orchid:"#da70d6",palegoldenrod:"#eee8aa",palegreen:"#98fb98",paleturquoise:"#afeeee",palevioletred:"#db7093",papayawhip:"#ffefd5",peachpuff:"#ffdab9",peru:"#cd853f",pink:"#ffc0cb",plum:"#dda0dd",powderblue:"#b0e0e6",purple:"#800080",red:"#ff0000",rosybrown:"#bc8f8f",royalblue:"#4169e1",saddlebrown:"#8b4513",salmon:"#fa8072",sandybrown:"#f4a460",seagreen:"#2e8b57",seashell:"#fff5ee",sienna:"#a0522d",silver:"#c0c0c0",skyblue:"#87ceeb",slateblue:"#6a5acd",slategray:"#708090",slategrey:"#708090",snow:"#fffafa",springgreen:"#00ff7f",steelblue:"#4682b4",tan:"#d2b48c",teal:"#008080",thistle:"#d8bfd8",tomato:"#ff6347",turquoise:"#40e0d0",violet:"#ee82ee",wheat:"#f5deb3",white:"#ffffff",whitesmoke:"#f5f5f5",yellow:"#ffff00",yellowgreen:"#9acd32"},h=/\s*/,i=/(\d{1,3})/,j=/((?:\d+(?:\.\d+)?)|(?:\.\d+))/,k=new RegExp(j.source+"%"),l={HEX3:/^#([a-f0-9])([a-f0-9])([a-f0-9])$/i,HEX4:/^#([a-f0-9])([a-f0-9])([a-f0-9])([a-f0-9])$/i,HEX6:/^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i,HEX8:/^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i,RGB:new RegExp(["^rgb\\(",i.source,",",i.source,",",i.source,"\\)$"].join(h.source),"i"),RGB_PERCENT:new RegExp(["^rgb\\(",k.source,",",k.source,",",k.source,"\\)$"].join(h.source),"i"),RGBA:new RegExp(["^rgba\\(",i.source,",",i.source,",",i.source,",",j.source,"\\)$"].join(h.source),"i"),RGBA_PERCENT:new RegExp(["^rgba\\(",k.source,",",k.source,",",k.source,",",j.source,"\\)$"].join(h.source),"i"),HSL:new RegExp(["^hsl\\(",i.source,",",k.source,",",k.source,"\\)$"].join(h.source),"i"),HSLA:new RegExp(["^hsla\\(",i.source,",",k.source,",",k.source,",",j.source,"\\)$"].join(h.source),"i"),HSB:new RegExp(["^hsb\\(",i.source,",",k.source,",",k.source,"\\)$"].join(h.source),"i"),HSBA:new RegExp(["^hsba\\(",i.source,",",k.source,",",k.source,",",j.source,"\\)$"].join(h.source),"i")};d.Color._parseInputs=function(){var a=arguments.length,b=this.mode,c=this.maxes,h=[];if(a>=3)return h[0]=arguments[0]/c[b][0],h[1]=arguments[1]/c[b][1],h[2]=arguments[2]/c[b][2],"number"==typeof arguments[3]?h[3]=arguments[3]/c[b][3]:h[3]=1,h=h.map(function(a){return Math.max(Math.min(a,1),0)}),b===e.HSL?f._hslaToRGBA(h):b===e.HSB?f._hsbaToRGBA(h):h;if(1===a&&"string"==typeof arguments[0]){var i=arguments[0].trim().toLowerCase();if(g[i])return d.Color._parseInputs.apply(this,[g[i]]);if(l.HEX3.test(i))return h=l.HEX3.exec(i).slice(1).map(function(a){return parseInt(a+a,16)/255}),h[3]=1,h;if(l.HEX6.test(i))return h=l.HEX6.exec(i).slice(1).map(function(a){return parseInt(a,16)/255}),h[3]=1,h;if(l.HEX4.test(i))return h=l.HEX4.exec(i).slice(1).map(function(a){return parseInt(a+a,16)/255});if(l.HEX8.test(i))return h=l.HEX8.exec(i).slice(1).map(function(a){return parseInt(a,16)/255});if(l.RGB.test(i))return h=l.RGB.exec(i).slice(1).map(function(a){return a/255}),h[3]=1,h;if(l.RGB_PERCENT.test(i))return h=l.RGB_PERCENT.exec(i).slice(1).map(function(a){return parseFloat(a)/100}),h[3]=1,h;if(l.RGBA.test(i))return h=l.RGBA.exec(i).slice(1).map(function(a,b){return 3===b?parseFloat(a):a/255});if(l.RGBA_PERCENT.test(i))return h=l.RGBA_PERCENT.exec(i).slice(1).map(function(a,b){return 3===b?parseFloat(a):parseFloat(a)/100});if(l.HSL.test(i)?(h=l.HSL.exec(i).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),h[3]=1):l.HSLA.test(i)&&(h=l.HSLA.exec(i).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),h=h.map(function(a){return Math.max(Math.min(a,1),0)}),h.length)return f._hslaToRGBA(h);if(l.HSB.test(i)?(h=l.HSB.exec(i).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),h[3]=1):l.HSBA.test(i)&&(h=l.HSBA.exec(i).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),h=h.map(function(a){return Math.max(Math.min(a,1),0)}),h.length)return f._hsbaToRGBA(h);h=[1,1,1,1]}else{if(1!==a&&2!==a||"number"!=typeof arguments[0])throw new Error(arguments+"is not a valid color representation.");h[0]=arguments[0]/c[b][2],h[1]=arguments[0]/c[b][2],h[2]=arguments[0]/c[b][2],"number"==typeof arguments[1]?h[3]=arguments[1]/c[b][3]:h[3]=1,h=h.map(function(a){return Math.max(Math.min(a,1),0)})}return h},b.exports=d.Color},{"../core/constants":54,"../core/core":55,"./color_conversion":47}],50:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("../core/constants");a("./p5.Color"),d.prototype.background=function(){return arguments[0]instanceof d.Image?this.image(arguments[0],0,0,this.width,this.height):this._renderer.background.apply(this._renderer,arguments),this},d.prototype.clear=function(){return this._renderer.clear(),this},d.prototype.colorMode=function(){if(arguments[0]===e.RGB||arguments[0]===e.HSB||arguments[0]===e.HSL){this._renderer._colorMode=arguments[0];var a=this._renderer._colorMaxes[this._renderer._colorMode];2===arguments.length?(a[0]=arguments[1],a[1]=arguments[1],a[2]=arguments[1],a[3]=arguments[1]):4===arguments.length?(a[0]=arguments[1],a[1]=arguments[2],a[2]=arguments[3]):5===arguments.length&&(a[0]=arguments[1],a[1]=arguments[2],a[2]=arguments[3],a[3]=arguments[4])}return this},d.prototype.fill=function(){return this._renderer._setProperty("_fillSet",!0),this._renderer._setProperty("_doFill",!0),this._renderer.fill.apply(this._renderer,arguments),this},d.prototype.noFill=function(){return this._renderer.isP3D&&this._renderer.noFill(),this._renderer._setProperty("_doFill",!1),this},d.prototype.noStroke=function(){return this._renderer.isP3D&&this._renderer.noStroke(),this._renderer._setProperty("_doStroke",!1),this},d.prototype.stroke=function(){return this._renderer._setProperty("_strokeSet",!0),this._renderer._setProperty("_doStroke",!0),this._renderer.stroke.apply(this._renderer,arguments),this},b.exports=d},{"../core/constants":54,"../core/core":55,"./p5.Color":49}],51:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants"),f=a("./canvas");a("./error_helpers"),d.prototype.arc=function(a,b,c,f,g,h,i){for(var j=new Array(arguments.length),k=0;ke.HALF_PI&&g<=3*e.HALF_PI?Math.atan(c/f*Math.tan(g))+e.PI:Math.atan(c/f*Math.tan(g))+e.TWO_PI,h=h<=e.HALF_PI?Math.atan(c/f*Math.tan(h)):h>e.HALF_PI&&h<=3*e.HALF_PI?Math.atan(c/f*Math.tan(h))+e.PI:Math.atan(c/f*Math.tan(h))+e.TWO_PI,g>h&&(h+=e.TWO_PI),c=Math.abs(c),f=Math.abs(f),this._renderer.arc(a,b,c,f,g,h,i),this},d.prototype.ellipse=function(){for(var a=new Array(arguments.length),b=0;b=c-5)&&(this.redraw(),this._frameRate=1e3/(a-this._lastFrameTime),this._lastFrameTime=a,void 0!==this._updateMouseCoords&&this._updateMouseCoords()),this._loop&&(this._requestAnimId=window.requestAnimationFrame(this._draw))}.bind(this),this._runFrames=function(){this._updateInterval&&clearInterval(this._updateInterval)}.bind(this),this._setProperty=function(a,b){this[a]=b,this._isGlobal&&(window[a]=b)}.bind(this),this.remove=function(){if(this._curElement){this._loop=!1,this._requestAnimId&&window.cancelAnimationFrame(this._requestAnimId);for(var a in this._events)window.removeEventListener(a,this._events[a]);for(var b=0;b-1)d=a;else if("string"==typeof a){var f="";b&&c&&"number"==typeof b&&"number"==typeof c&&(f=b+" "+c),d="http://"===a.substring(0,7)||"https://"===a.substring(0,8)?"url("+a+") "+f+", auto":/\.(cur|jpg|jpeg|gif|png|CUR|JPG|JPEG|GIF|PNG)$/.test(a)?"url("+a+") "+f+", auto":a}e.style.cursor=d},h.prototype.frameRate=function(a){return"number"!=typeof a||a<0?this._frameRate:(this._setProperty("_targetFrameRate",a),this._runFrames(),this)},h.prototype.getFrameRate=function(){return this.frameRate()},h.prototype.setFrameRate=function(a){return this.frameRate(a)},h.prototype.noCursor=function(){this._curElement.elt.style.cursor="none"},h.prototype.displayWidth=screen.width,h.prototype.displayHeight=screen.height,h.prototype.windowWidth=d(),h.prototype.windowHeight=e(),h.prototype._onresize=function(a){this._setProperty("windowWidth",d()),this._setProperty("windowHeight",e());var b,c=this._isGlobal?window:this;"function"==typeof c.windowResized&&(void 0===(b=c.windowResized(a))||b||a.preventDefault())},h.prototype.width=0,h.prototype.height=0,h.prototype.fullscreen=function(a){if(void 0===a)return document.fullscreenElement||document.webkitFullscreenElement||document.mozFullScreenElement||document.msFullscreenElement;a?f(document.documentElement):g()},h.prototype.pixelDensity=function(a){if("number"!=typeof a)return this._pixelDensity;this._pixelDensity=a,this.resizeCanvas(this.width,this.height,!0)},h.prototype.displayDensity=function(){return window.devicePixelRatio},h.prototype.getURL=function(){return location.href},h.prototype.getURLPath=function(){return location.pathname.split("/").filter(function(a){return""!==a})},h.prototype.getURLParams=function(){for(var a,b=/[?&]([^&=]+)(?:[&=])([^&=]+)/gim,c={};null!=(a=b.exec(location.search));)a.index===b.lastIndex&&b.lastIndex++,c[a[1]]=a[2];return c},b.exports=h},{"./constants":54,"./core":55}],58:[function(a,b,c){"use strict";function d(a,b,c){m&&(i(),m=!1),"undefined"===t(c)?c="#B40033":"number"===t(c)&&(c=v[c]),"load"===b.substring(0,4)?console.log("> p5.js says: "+a+"[https://github.com/processing/p5.js/wiki/Local-server]"):console.log("> p5.js says: "+a+" [http://p5js.org/reference/#p5/"+b+"]")}function e(a){var b=o.classitems.filter(function(b){return b.name===a});if(b[0].hasOwnProperty("overloads")){for(var c=[],d=0;d p5.js says: Welcome! This is your friendly debugger. To turn me off switch to using “p5.min.js”.")}function j(){var b={},c=function(a){return Object.getOwnPropertyNames(a).filter(function(a){return"_"!==a[0]&&(!(a in b)&&(b[a]=!0,!0))}).map(function(b){var c;return c="function"==typeof a[b]?"function":b===b.toUpperCase()?"constant":"variable",{name:b,type:c}})};x=[].concat(c(l.prototype),c(a("./constants"))),x.sort(function(a,b){return b.name.length-a.name.length})}function k(a,b){b||(b=console.log.bind(console)),x||j(),x.some(function(c){if(a.message&&null!==a.message.match("\\W?"+c.name+"\\W"))return b("Did you just try to use p5.js's "+c.name+("function"===c.type?"() ":" ")+c.type+"? If so, you may want to move it into your sketch's setup() function.\n\nFor more details, see: "+y),!0})}for(var l=a("./core"),m=!1,n=a("../../docs/reference/data.json"),o=JSON.parse(JSON.stringify(n)),p={},q=p.toString,r=["Boolean","Number","String","Function","Array","Date","RegExp","Object","Error"],s=0;s1){for(var h=0;hi.length&&(g=i.length,d=i)}for(var j=0;j1&&e("drop",b,this),e("drop",function(a){a.stopPropagation(),a.preventDefault();for(var b=a.dataTransfer.files,d=0;d-1?f.readAsText(e):f.readAsDataURL(e)}},this)):console.log("The File APIs are not fully supported in this browser."),this},g.Element.prototype._setProperty=function(a,b){this[a]=b},b.exports=g.Element},{"./core":55}],61:[function(a,b,c){var d=a("./core"),e=a("./constants");d.Graphics=function(a,b,c,f){var g=c||e.P2D;this.canvas=document.createElement("canvas"),(this._userNode||document.body).appendChild(this.canvas),d.Element.call(this,this.canvas,f,!1),this._styles=[],this.width=a,this.height=b,this._pixelDensity=f._pixelDensity,g===e.WEBGL?this._renderer=new d.RendererGL(this.canvas,this,!1):this._renderer=new d.Renderer2D(this.canvas,this,!1),this._renderer.resize(a,b),this._renderer._applyDefaults(),f._elements.push(this);for(var h in d.prototype)this[h]||("function"==typeof d.prototype[h]?this[h]=d.prototype[h].bind(this):this[h]=d.prototype[h]);return this.name="p5.Graphics",this},d.Graphics.prototype=Object.create(d.Element.prototype),d.Graphics.prototype.remove=function(){this.elt.parentNode&&this.elt.parentNode.removeChild(this.elt);for(var a in this._events)this.elt.removeEventListener(a,this._events[a])},b.exports=d.Graphics},{"./constants":54,"./core":55}],62:[function(a,b,c){function d(a){var b=0,c=0;if(a.offsetParent)do{b+=a.offsetLeft,c+=a.offsetTop}while(a=a.offsetParent);else b+=a.offsetLeft,c+=a.offsetTop;return[b,c]}var e=a("./core"),f=a("../core/constants");e.Renderer=function(a,b,c){e.Element.call(this,a,b),this.name="p5.Renderer",this.canvas=a,this._pInst=b,c?(this._isMainCanvas=!0,this._pInst._setProperty("_curElement",this),this._pInst._setProperty("canvas",this.canvas),this._pInst._setProperty("width",this.width),this._pInst._setProperty("height",this.height)):(this.canvas.style.display="none",this._styles=[]),this._textSize=12,this._textLeading=15,this._textFont="sans-serif",this._textStyle=f.NORMAL,this._textAscent=null,this._textDescent=null,this._rectMode=f.CORNER,this._ellipseMode=f.CENTER,this._curveTightness=0,this._imageMode=f.CORNER,this._tint=null,this._doStroke=!0,this._doFill=!0,this._strokeSet=!1,this._fillSet=!1,this._colorMode=f.RGB,this._colorMaxes={rgb:[255,255,255,255],hsb:[360,100,100,1],hsl:[360,100,100,1]}},e.Renderer.prototype=Object.create(e.Element.prototype),e.Renderer.prototype.resize=function(a,b){this.width=a,this.height=b,this.elt.width=a*this._pInst._pixelDensity,this.elt.height=b*this._pInst._pixelDensity,this.elt.style.width=a+"px",this.elt.style.height=b+"px",this._isMainCanvas&&(this._pInst._setProperty("width",this.width),this._pInst._setProperty("height",this.height))},e.Renderer.prototype.textLeading=function(a){return arguments.length&&arguments[0]?(this._setProperty("_textLeading",a),this):this._textLeading},e.Renderer.prototype.textSize=function(a){return arguments.length&&arguments[0]?(this._setProperty("_textSize",a),this._setProperty("_textLeading",a*f._DEFAULT_LEADMULT),this._applyTextProperties()):this._textSize},e.Renderer.prototype.textStyle=function(a){return arguments.length&&arguments[0]?(a!==f.NORMAL&&a!==f.ITALIC&&a!==f.BOLD||this._setProperty("_textStyle",a),this._applyTextProperties()):this._textStyle},e.Renderer.prototype.textAscent=function(){return null===this._textAscent&&this._updateTextMetrics(),this._textAscent},e.Renderer.prototype.textDescent=function(){return null===this._textDescent&&this._updateTextMetrics(),this._textDescent},e.Renderer.prototype._applyDefaults=function(){return this},e.Renderer.prototype._isOpenType=function(a){return"object"==typeof(a=a||this._textFont)&&a.font&&a.font.supported},e.Renderer.prototype._updateTextMetrics=function(){if(this._isOpenType())return this._setProperty("_textAscent",this._textFont._textAscent()),this._setProperty("_textDescent",this._textFont._textDescent()),this;var a=document.createElement("span");a.style.fontFamily=this._textFont,a.style.fontSize=this._textSize+"px",a.innerHTML="ABCjgq|";var b=document.createElement("div");b.style.display="inline-block",b.style.width="1px",b.style.height="0px";var c=document.createElement("div");c.appendChild(a),c.appendChild(b),c.style.height="0px",c.style.overflow="hidden",document.body.appendChild(c),b.style.verticalAlign="baseline";var e=d(b),f=d(a),g=e[1]-f[1];b.style.verticalAlign="bottom",e=d(b),f=d(a);var h=e[1]-f[1],i=h-g;return document.body.removeChild(c),this._setProperty("_textAscent",g),this._setProperty("_textDescent",i),this},b.exports=e.Renderer},{"../core/constants":54,"./core":55}],63:[function(a,b,c){var d=a("./core"),e=a("./canvas"),f=a("./constants"),g=a("../image/filters");a("./p5.Renderer");var h="rgba(0,0,0,0)";d.Renderer2D=function(a,b,c){return d.Renderer.call(this,a,b,c),this.name="p5.Renderer2D",this.drawingContext=this.canvas.getContext("2d"),this._pInst._setProperty("drawingContext",this.drawingContext),this},d.Renderer2D.prototype=Object.create(d.Renderer.prototype),d.Renderer2D.prototype._applyDefaults=function(){this._cachedFillStyle=this._cachedStrokeStyle=void 0,this._setFill(f._DEFAULT_FILL),this._setStroke(f._DEFAULT_STROKE),this.drawingContext.lineCap=f.ROUND,this.drawingContext.font="normal 12px sans-serif"},d.Renderer2D.prototype.resize=function(a,b){d.Renderer.prototype.resize.call(this,a,b),this.drawingContext.scale(this._pInst._pixelDensity,this._pInst._pixelDensity)},d.Renderer2D.prototype.background=function(){if(this.drawingContext.save(),this.drawingContext.setTransform(1,0,0,1,0,0),this.drawingContext.scale(this._pInst._pixelDensity,this._pInst._pixelDensity),arguments[0]instanceof d.Image)this._pInst.image(arguments[0],0,0,this.width,this.height);else{var a=this._getFill(),b=this._pInst.color.apply(this,arguments),c=b.toString();this._setFill(c),this.drawingContext.fillRect(0,0,this.width,this.height),this._setFill(a)}this.drawingContext.restore()},d.Renderer2D.prototype.clear=function(){this.drawingContext.clearRect(0,0,this.width,this.height)},d.Renderer2D.prototype.fill=function(){var a=this._pInst.color.apply(this,arguments);this._setFill(a.toString())},d.Renderer2D.prototype.stroke=function(){var a=this._pInst.color.apply(this,arguments);this._setStroke(a.toString())},d.Renderer2D.prototype.image=function(a,b,c,e,f,g,h,i,j){var k;try{this._tint&&(d.MediaElement&&a instanceof d.MediaElement&&a.loadPixels(),a.canvas&&(k=this._getTintedImageCanvas(a))),k||(k=a.canvas||a.elt),this.drawingContext.drawImage(k,b,c,e,f,g,h,i,j)}catch(a){if("NS_ERROR_NOT_AVAILABLE"!==a.name)throw a}},d.Renderer2D.prototype._getTintedImageCanvas=function(a){if(!a.canvas)return a;var b=g._toPixels(a.canvas),c=document.createElement("canvas");c.width=a.canvas.width,c.height=a.canvas.height;for(var d=c.getContext("2d"),e=d.createImageData(a.canvas.width,a.canvas.height),f=e.data,h=0;hthis.width||b>this.height)return[0,0,0,255];var f=this._pInst||this;f.loadPixels();var g=f._pixelDensity;a=Math.floor(a),b=Math.floor(b),c=Math.floor(c),e=Math.floor(e);var h=a*g,i=b*g;if(1!==c||1!==e||this instanceof d.RendererGL){var j=Math.min(c,f.width),k=Math.min(e,f.height),l=j*g,m=k*g,n=new d.Image(j,k);return n.canvas.getContext("2d").drawImage(this.canvas,h,i,l,m,0,0,j,k),n}var o=this.drawingContext.getImageData(h,i,1,1).data;return[o[0],o[1],o[2],o[3]]},d.Renderer2D.prototype.loadPixels=function(){var a=this._pixelDensity||this._pInst._pixelDensity,b=this.width*a,c=this.height*a,d=this.drawingContext.getImageData(0,0,b,c);this._pInst?(this._pInst._setProperty("imageData",d),this._pInst._setProperty("pixels",d.data)):(this._setProperty("imageData",d),this._setProperty("pixels",d.data))},d.Renderer2D.prototype.set=function(a,b,c){if(a=Math.floor(a),b=Math.floor(b),c instanceof d.Image)this.drawingContext.save(),this.drawingContext.setTransform(1,0,0,1,0,0),this.drawingContext.scale(this._pInst._pixelDensity,this._pInst._pixelDensity),this.drawingContext.drawImage(c.canvas,a,b),this.loadPixels.call(this._pInst),this.drawingContext.restore();else{var e=this._pInst||this,f=0,g=0,h=0,i=0,j=4*(b*e._pixelDensity*(this.width*e._pixelDensity)+a*e._pixelDensity);if(e.imageData||e.loadPixels.call(e),"number"==typeof c)jn;)o=Math.min(h-g,f.HALF_PI),p.push(this._acuteArcToBezier(g,o)),g+=o;return this._doFill&&(j.beginPath(),p.forEach(function(a,b){0===b&&j.moveTo(k.x+a.ax*l,k.y+a.ay*m),j.bezierCurveTo(k.x+a.bx*l,k.y+a.by*m,k.x+a.cx*l,k.y+a.cy*m,k.x+a.dx*l,k.y+a.dy*m)}),i!==f.PIE&&null!=i||j.lineTo(k.x,k.y),j.closePath(),j.fill()),this._doStroke&&(j.beginPath(),p.forEach(function(a,b){0===b&&j.moveTo(k.x+a.ax*l,k.y+a.ay*m),j.bezierCurveTo(k.x+a.bx*l,k.y+a.by*m,k.x+a.cx*l,k.y+a.cy*m,k.x+a.dx*l,k.y+a.dy*m)}),i===f.PIE?(j.lineTo(k.x,k.y),j.closePath()):i===f.CHORD&&j.closePath(),j.stroke()),this},d.Renderer2D.prototype.ellipse=function(a){var b=this.drawingContext,c=this._doFill,d=this._doStroke,e=a[0],f=a[1],g=a[2],i=a[3];if(c&&!d){if(this._getFill()===h)return this}else if(!c&&d&&this._getStroke()===h)return this;var j=.5522847498,k=g/2*j,l=i/2*j,m=e+g,n=f+i,o=e+g/2,p=f+i/2;b.beginPath(),b.moveTo(e,p),b.bezierCurveTo(e,p-l,o-k,f,o,f),b.bezierCurveTo(o+k,f,m,p-l,m,p),b.bezierCurveTo(m,p+l,o+k,n,o,n),b.bezierCurveTo(o-k,n,e,p+l,e,p),b.closePath(),c&&b.fill(),d&&b.stroke()},d.Renderer2D.prototype.line=function(a,b,c,d){var e=this.drawingContext;return this._doStroke?this._getStroke()===h?this:(e.lineWidth%2==1&&e.translate(.5,.5),e.beginPath(),e.moveTo(a,b),e.lineTo(c,d),e.stroke(),e.lineWidth%2==1&&e.translate(-.5,-.5),this):this},d.Renderer2D.prototype.point=function(a,b){var c=this.drawingContext;if(!this._doStroke)return this;if(this._getStroke()===h)return this;var d=this._getStroke(),e=this._getFill();a=Math.round(a),b=Math.round(b),this._setFill(d),c.lineWidth>1?(c.beginPath(),c.arc(a,b,c.lineWidth/2,0,f.TWO_PI,!1),c.fill()):c.fillRect(a,b,1,1),this._setFill(e)},d.Renderer2D.prototype.quad=function(a,b,c,d,e,f,g,i){var j=this.drawingContext,k=this._doFill,l=this._doStroke;if(k&&!l){if(this._getFill()===h)return this}else if(!k&&l&&this._getStroke()===h)return this;return j.beginPath(),j.moveTo(a,b),j.lineTo(c,d),j.lineTo(e,f),j.lineTo(g,i),j.closePath(),k&&j.fill(),l&&j.stroke(),this},d.Renderer2D.prototype.rect=function(a){var b=a[0],c=a[1],d=a[2],e=a[3],f=a[4],g=a[5],i=a[6],j=a[7],k=this.drawingContext,l=this._doFill,m=this._doStroke;if(l&&!m){if(this._getFill()===h)return this}else if(!l&&m&&this._getStroke()===h)return this;if(this._doStroke&&k.lineWidth%2==1&&k.translate(.5,.5),k.beginPath(),void 0===f)k.rect(b,c,d,e);else{void 0===g&&(g=f),void 0===i&&(i=g),void 0===j&&(j=i);var n=d/2,o=e/2;d<2*f&&(f=n),e<2*f&&(f=o),d<2*g&&(g=n),e<2*g&&(g=o),d<2*i&&(i=n),e<2*i&&(i=o),d<2*j&&(j=n),e<2*j&&(j=o),k.beginPath(),k.moveTo(b+f,c),k.arcTo(b+d,c,b+d,c+e,g),k.arcTo(b+d,c+e,b,c+e,i),k.arcTo(b,c+e,b,c,j),k.arcTo(b,c,b+d,c,f),k.closePath()}return this._doFill&&k.fill(),this._doStroke&&k.stroke(),this._doStroke&&k.lineWidth%2==1&&k.translate(-.5,-.5),this},d.Renderer2D.prototype.triangle=function(a){var b=this.drawingContext,c=this._doFill,d=this._doStroke,e=a[0],f=a[1],g=a[2],i=a[3],j=a[4],k=a[5];if(c&&!d){if(this._getFill()===h)return this}else if(!c&&d&&this._getStroke()===h)return this;b.beginPath(),b.moveTo(e,f),b.lineTo(g,i),b.lineTo(j,k),b.closePath(),c&&b.fill(),d&&b.stroke()},d.Renderer2D.prototype.endShape=function(a,b,c,d,e,g,h){if(0===b.length)return this;if(!this._doStroke&&!this._doFill)return this;var i,j=a===f.CLOSE;j&&!g&&b.push(b[0]);var k,l,m=b.length;if(!c||h!==f.POLYGON&&null!==h)if(!d||h!==f.POLYGON&&null!==h)if(!e||h!==f.POLYGON&&null!==h)if(h===f.POINTS)for(k=0;k2){for(this.drawingContext.beginPath(),k=2;k3)for(k=0;k+13){var n=[],o=1-this._curveTightness;for(this.drawingContext.beginPath(),this.drawingContext.moveTo(b[1][0],b[1][1]),k=1;k+2d?(k=n[h]+" ",o+=q.textLeading()):k=l;switch(this._rectMode===f.CENTER&&(b-=d/2,c-=e/2),this.drawingContext.textAlign){case f.CENTER:b+=d/2;break;case f.RIGHT:b+=d}if(void 0!==e){switch(this.drawingContext.textBaseline){case f.BOTTOM:c+=e-o;break;case f._CTX_MIDDLE:c+=(e-o)/2;break;case f.BASELINE:p=!0,this.drawingContext.textBaseline=f.TOP}r=c+e-q.textAscent()}for(i=0;id&&k.length>0?(this._renderText(q,k,b,c,r),k=n[h]+" ",c+=q.textLeading()):k=l;this._renderText(q,k,b,c,r),c+=q.textLeading()}}else{var s=0,t=q.textAlign().vertical;for(t===f.CENTER?s=(g.length-1)*q.textLeading()/2:t===f.BOTTOM&&(s=(g.length-1)*q.textLeading()),j=0;j=e))return a.push(),this._isOpenType()?this._textFont._renderPath(b,c,d,{renderer:this}):(this._doStroke&&this._strokeSet&&this.drawingContext.strokeText(b,c,d),this._doFill&&(this._fillSet||this._setFill(f._DEFAULT_TEXT_FILL),this.drawingContext.fillText(b,c,d))),a.pop(),a},d.Renderer2D.prototype.textWidth=function(a){return this._isOpenType()?this._textFont._textWidth(a,this._textSize):this.drawingContext.measureText(a).width},d.Renderer2D.prototype.textAlign=function(a,b){if(arguments.length)return a!==f.LEFT&&a!==f.RIGHT&&a!==f.CENTER||(this.drawingContext.textAlign=a),b!==f.TOP&&b!==f.BOTTOM&&b!==f.CENTER&&b!==f.BASELINE||(b===f.CENTER?this.drawingContext.textBaseline=f._CTX_MIDDLE:this.drawingContext.textBaseline=b),this._pInst;var c=this.drawingContext.textBaseline;return c===f._CTX_MIDDLE&&(c=f.CENTER),{horizontal:this.drawingContext.textAlign,vertical:c}},d.Renderer2D.prototype._applyTextProperties=function(){var a,b=this._pInst;return this._setProperty("_textAscent",null),this._setProperty("_textDescent",null),a=this._textFont,this._isOpenType()&&(a=this._textFont.font.familyName,this._setProperty("_textStyle",this._textFont.font.styleName)),this.drawingContext.font=(this._textStyle||"normal")+" "+(this._textSize||12)+"px "+(a||"sans-serif"),b},d.Renderer2D.prototype.push=function(){this.drawingContext.save()},d.Renderer2D.prototype.pop=function(){this.drawingContext.restore(),this._cachedFillStyle=this.drawingContext.fillStyle,this._cachedStrokeStyle=this.drawingContext.strokeStyle},b.exports=d.Renderer2D},{"../image/filters":74,"./canvas":53,"./constants":54,"./core":55,"./p5.Renderer":62}],64:[function(a,b,c){var d=a("./core"),e=a("./constants");a("./p5.Graphics"),a("./p5.Renderer2D"),a("../webgl/p5.RendererGL");var f="defaultCanvas0";d.prototype.createCanvas=function(a,b,c){var g,h=c||e.P2D;if(h===e.WEBGL)g=document.getElementById(f),g&&(g.parentNode.removeChild(g),this._elements=this._elements.filter(function(a){return a!==this._renderer})),g=document.createElement("canvas"),g.id=f;else if(this._defaultGraphicsCreated)g=this.canvas;else{g=document.createElement("canvas");for(var i=0;document.getElementById("defaultCanvas"+i);)i++;f="defaultCanvas"+i,g.id=f}return this._setupDone||(g.dataset.hidden=!0,g.style.visibility="hidden"),this._userNode?this._userNode.appendChild(g):document.body.appendChild(g),h===e.WEBGL?(this._setProperty("_renderer",new d.RendererGL(g,this,!0)),this._elements.push(this._renderer)):this._defaultGraphicsCreated||(this._setProperty("_renderer",new d.Renderer2D(g,this,!0)),this._defaultGraphicsCreated=!0,this._elements.push(this._renderer)),this._renderer.resize(a,b),this._renderer._applyDefaults(),this._renderer},d.prototype.resizeCanvas=function(a,b,c){if(this._renderer){var d={};for(var e in this.drawingContext){var f=this.drawingContext[e];"object"!=typeof f&&"function"!=typeof f&&(d[e]=f)}this._renderer.resize(a,b);for(var g in d)this.drawingContext[g]=d[g];c||this.redraw()}},d.prototype.noCanvas=function(){this.canvas&&this.canvas.parentNode.removeChild(this.canvas)},d.prototype.createGraphics=function(a,b,c){return new d.Graphics(a,b,c,this)},d.prototype.blendMode=function(a){if(a!==e.BLEND&&a!==e.DARKEST&&a!==e.LIGHTEST&&a!==e.DIFFERENCE&&a!==e.MULTIPLY&&a!==e.EXCLUSION&&a!==e.SCREEN&&a!==e.REPLACE&&a!==e.OVERLAY&&a!==e.HARD_LIGHT&&a!==e.SOFT_LIGHT&&a!==e.DODGE&&a!==e.BURN&&a!==e.ADD&&a!==e.NORMAL)throw new Error("Mode "+a+" not recognized.");this._renderer.blendMode(a)},b.exports=d},{"../webgl/p5.RendererGL":106,"./constants":54,"./core":55,"./p5.Graphics":61,"./p5.Renderer2D":63}],65:[function(a,b,c){window.requestAnimationFrame=function(){return window.requestAnimationFrame||window.webkitRequestAnimationFrame||window.mozRequestAnimationFrame||window.oRequestAnimationFrame||window.msRequestAnimationFrame||function(a,b){window.setTimeout(a,1e3/60)}}(),window.performance=window.performance||{},window.performance.now=function(){var a=Date.now();return window.performance.now||window.performance.mozNow||window.performance.msNow||window.performance.oNow||window.performance.webkitNow||function(){return Date.now()-a}}(),function(){"use strict";"undefined"==typeof Uint8ClampedArray||Uint8ClampedArray.prototype.slice||Object.defineProperty(Uint8ClampedArray.prototype,"slice",{value:Array.prototype.slice,writable:!0,configurable:!0,enumerable:!1})}()},{}],66:[function(a,b,c){"use strict";var d=a("./core");d.prototype.exit=function(){throw"exit() not implemented, see remove()"},d.prototype.noLoop=function(){this._loop=!1},d.prototype.loop=function(){this._loop=!0,this._draw()},d.prototype.push=function(){this._renderer.push(),this._styles.push({_doStroke:this._renderer._doStroke,_strokeSet:this._renderer._strokeSet,_doFill:this._renderer._doFill,_fillSet:this._renderer._fillSet,_tint:this._renderer._tint,_imageMode:this._renderer._imageMode,_rectMode:this._renderer._rectMode,_ellipseMode:this._renderer._ellipseMode,_colorMode:this._renderer._colorMode,_textFont:this._renderer._textFont,_textLeading:this._renderer._textLeading,_textSize:this._renderer._textSize,_textStyle:this._renderer._textStyle})},d.prototype.pop=function(){this._renderer.pop();var a=this._styles.pop();for(var b in a)this._renderer[b]=a[b]},d.prototype.pushStyle=function(){throw new Error("pushStyle() not used, see push()")},d.prototype.popStyle=function(){throw new Error("popStyle() not used, see pop()")},d.prototype.redraw=function(){this.resetMatrix(),this._renderer.isP3D&&this._renderer._update();var a=1;if(1===arguments.length)try{parseInt(arguments[0])>1&&(a=parseInt(arguments[0]))}catch(a){}var b=this.setup||window.setup,c=this.draw||window.draw;if("function"==typeof c){void 0===b&&this.scale(this._pixelDensity,this._pixelDensity);for(var d=this,e=function(a){a.call(d)},f=0;f1?this._renderer.rotate(c,d[1]):this._renderer.rotate(c),this},d.prototype.rotateX=function(a){if(!this._renderer.isP3D)throw"not supported in p2d. Please use webgl mode";return this._renderer.rotateX(a),this},d.prototype.rotateY=function(a){if(!this._renderer.isP3D)throw"not supported in p2d. Please use webgl mode";return this._renderer.rotateY(a),this},d.prototype.rotateZ=function(a){if(!this._renderer.isP3D)throw"not supported in p2d. Please use webgl mode";return this._renderer.rotateZ(a),this},d.prototype.scale=function(){for(var a,b,c,e=new Array(arguments.length),f=0;f0))throw"vertex() must be used once before calling quadraticVertex()";k=!0;for(var i=[],j=0;jn||Math.abs(this.accelerationY-this.pAccelerationY)>n||Math.abs(this.accelerationZ-this.pAccelerationZ)>n)&&a();var b=this.deviceTurned||window.deviceTurned;if("function"==typeof b){var c=this.rotationX+180,d=this.pRotationX+180,p=h+180;c-d>0&&c-d<270||c-d<-270?k="clockwise":(c-d<0||c-d>270)&&(k="counter-clockwise"),k!==e&&(p=c),Math.abs(c-p)>90&&Math.abs(c-p)<270&&(p=c,this._setProperty("turnAxis","X"),b()),e=k,h=p-180;var q=this.rotationY+180,r=this.pRotationY+180,s=i+180;q-r>0&&q-r<270||q-r<-270?l="clockwise":(q-r<0||q-this.pRotationY>270)&&(l="counter-clockwise"),l!==f&&(s=q),Math.abs(q-s)>90&&Math.abs(q-s)<270&&(s=q,this._setProperty("turnAxis","Y"),b()),f=l,i=s-180,this.rotationZ-this.pRotationZ>0&&this.rotationZ-this.pRotationZ<270||this.rotationZ-this.pRotationZ<-270?m="clockwise":(this.rotationZ-this.pRotationZ<0||this.rotationZ-this.pRotationZ>270)&&(m="counter-clockwise"),m!==g&&(j=this.rotationZ),Math.abs(this.rotationZ-j)>90&&Math.abs(this.rotationZ-j)<270&&(j=this.rotationZ,this._setProperty("turnAxis","Z"),b()),g=m,this._setProperty("turnAxis",void 0)}var t=this.deviceShaken||window.deviceShaken;if("function"==typeof t){var u,v;null!==this.pAccelerationX&&(u=Math.abs(this.accelerationX-this.pAccelerationX),v=Math.abs(this.accelerationY-this.pAccelerationY)),u+v>o&&t()}},b.exports=d},{"../core/core":55}],71:[function(a,b,c){"use strict";function d(){for(var a in f)if(f.hasOwnProperty(a)&&f[a]===!0)return!0;return!1}var e=a("../core/core"),f={};e.prototype.isKeyPressed=!1,e.prototype.keyIsPressed=!1,e.prototype.key="",e.prototype.keyCode=0,e.prototype._onkeydown=function(a){if(!f[a.which]){this._setProperty("isKeyPressed",!0),this._setProperty("keyIsPressed",!0),this._setProperty("keyCode",a.which),f[a.which]=!0;var b=String.fromCharCode(a.which);b||(b=a.which),this._setProperty("key",b);var c=this.keyPressed||window.keyPressed;if("function"==typeof c&&!a.charCode){c(a)===!1&&a.preventDefault()}}},e.prototype._onkeyup=function(a){var b=this.keyReleased||window.keyReleased;f[a.which]=!1,d()||(this._setProperty("isKeyPressed",!1),this._setProperty("keyIsPressed",!1)),this._setProperty("_lastKeyCodeTyped",null);var c=String.fromCharCode(a.which);if(c||(c=a.which),this._setProperty("key",c),this._setProperty("keyCode",a.which),"function"==typeof b){b(a)===!1&&a.preventDefault()}},e.prototype._onkeypress=function(a){if(a.which!==this._lastKeyCodeTyped){this._setProperty("keyCode",a.which),this._setProperty("_lastKeyCodeTyped",a.which),this._setProperty("key",String.fromCharCode(a.which));var b=this.keyTyped||window.keyTyped;if("function"==typeof b){b(a)===!1&&a.preventDefault()}}},e.prototype._onblur=function(a){f={}},e.prototype.keyIsDown=function(a){return f[a]},b.exports=e},{"../core/core":55}],72:[function(a,b,c){"use strict";function d(a,b,c,d){d&&!d.clientX&&(d.touches?d=d.touches[0]:d.changedTouches&&(d=d.changedTouches[0]));var e=a.getBoundingClientRect(),f=a.scrollWidth/b,g=a.scrollHeight/c;return{x:(d.clientX-e.left)/f,y:(d.clientY-e.top)/g,winX:d.clientX,winY:d.clientY,id:d.identifier}}var e=a("../core/core"),f=a("../core/constants");e.prototype._hasMouseInteracted=!1,e.prototype.mouseX=0,e.prototype.mouseY=0,e.prototype.pmouseX=0,e.prototype.pmouseY=0,e.prototype.winMouseX=0,e.prototype.winMouseY=0,e.prototype.pwinMouseX=0,e.prototype.pwinMouseY=0,e.prototype.mouseButton=0,e.prototype.mouseIsPressed=!1,e.prototype._updateNextMouseCoords=function(a){if(null!==this._curElement&&(!a.touches||a.touches.length>0)){var b=d(this._curElement.elt,this.width,this.height,a);this._setProperty("mouseX",b.x),this._setProperty("mouseY",b.y),this._setProperty("winMouseX",b.winX),this._setProperty("winMouseY",b.winY)}this._hasMouseInteracted||(this._updateMouseCoords(),this._setProperty("_hasMouseInteracted",!0))},e.prototype._updateMouseCoords=function(){this._setProperty("pmouseX",this.mouseX),this._setProperty("pmouseY",this.mouseY),this._setProperty("pwinMouseX",this.winMouseX),this._setProperty("pwinMouseY",this.winMouseY)},e.prototype._setMouseButton=function(a){1===a.button?this._setProperty("mouseButton",f.CENTER):2===a.button?this._setProperty("mouseButton",f.RIGHT):this._setProperty("mouseButton",f.LEFT)},e.prototype._onmousemove=function(a){var b=this._isGlobal?window:this;this._updateNextMouseCoords(a),this.mouseIsPressed?"function"==typeof b.mouseDragged?b.mouseDragged(a)===!1&&a.preventDefault():"function"==typeof b.touchMoved&&b.touchMoved(a)===!1&&a.preventDefault():"function"==typeof b.mouseMoved&&b.mouseMoved(a)===!1&&a.preventDefault()},e.prototype._onmousedown=function(a){var b=this._isGlobal?window:this;this._setProperty("mouseIsPressed",!0),this._setMouseButton(a),this._updateNextMouseCoords(a),"function"==typeof b.mousePressed?b.mousePressed(a)===!1&&a.preventDefault():"function"==typeof b.touchStarted&&b.touchStarted(a)===!1&&a.preventDefault()},e.prototype._onmouseup=function(a){var b=this._isGlobal?window:this;this._setProperty("mouseIsPressed",!1),"function"==typeof b.mouseReleased?b.mouseReleased(a)===!1&&a.preventDefault():"function"==typeof b.touchEnded&&b.touchEnded(a)===!1&&a.preventDefault()},e.prototype._ondragend=e.prototype._onmouseup,e.prototype._ondragover=e.prototype._onmousemove,e.prototype._onclick=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.mouseClicked){b.mouseClicked(a)===!1&&a.preventDefault()}},e.prototype._doubleClicked=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.doubleClicked){b.ondblclick(a)===!1&&a.preventDefault()}},e.prototype._onwheel=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.mouseWheel){a.delta=a.deltaY;b.mouseWheel(a)===!1&&a.preventDefault()}},b.exports=e},{"../core/constants":54,"../core/core":55}],73:[function(a,b,c){"use strict";function d(a,b,c,d,e){e=e||0;var f=a.getBoundingClientRect(),g=a.scrollWidth/b,h=a.scrollHeight/c,i=d.touches[e]||d.changedTouches[e];return{x:(i.clientX-f.left)/g,y:(i.clientY-f.top)/h,winX:i.clientX,winY:i.clientY,id:i.identifier}}var e=a("../core/core");e.prototype.touches=[],e.prototype._updateTouchCoords=function(a){if(null!==this._curElement){for(var b=[],c=0;c=e)break;x=0}for(F=x;F=e);F++){var H=m[t+C];G=j[F],s+=G[(H&-16777216)>>>24],p+=G[(16711680&H)>>16],q+=G[(65280&H)>>8],r+=G[255&H],o+=i[F],t++}u=C+D,y[u]=s/o,z[u]=p/o,A[u]=q/o,B[u]=r/o}C+=e}for(C=0,v=-g,w=v*e,E=0;E=k)break;x=0,u=v,t=D+w}for(F=x;F=k);F++)G=j[F],s+=G[y[t]],p+=G[z[t]],q+=G[A[t]],r+=G[B[t]],o+=i[F],u++,t+=e;m[D+C]=s/o<<24|p/o<<16|q/o<<8|r/o}C+=e,w+=e,v++}f._setPixels(c,m)}var f={};f._toPixels=function(a){return a instanceof ImageData?a.data:a.getContext("2d").getImageData(0,0,a.width,a.height).data},f._getARGB=function(a,b){var c=4*b;return a[c+3]<<24&4278190080|a[c]<<16&16711680|a[c+1]<<8&65280|255&a[c+2]},f._setPixels=function(a,b){for(var c=0,d=0,e=a.length;d>>16,a[c+1]=(65280&b[d])>>>8,a[c+2]=255&b[d],a[c+3]=(4278190080&b[d])>>>24},f._toImageData=function(a){return a instanceof ImageData?a:a.getContext("2d").getImageData(0,0,a.width,a.height)},f._createImageData=function(a,b){return f._tmpCanvas=document.createElement("canvas"),f._tmpCtx=f._tmpCanvas.getContext("2d"),this._tmpCtx.createImageData(a,b)},f.apply=function(a,b,c){var d=a.getContext("2d"),e=d.getImageData(0,0,a.width,a.height),f=b(e,c);f instanceof ImageData?d.putImageData(f,0,0,0,0,a.width,a.height):d.putImageData(e,0,0,0,0,a.width,a.height)},f.threshold=function(a,b){var c=f._toPixels(a);void 0===b&&(b=.5);for(var d=Math.floor(255*b),e=0;e=d?255:0,c[e]=c[e+1]=c[e+2]=g}},f.gray=function(a){for(var b=f._toPixels(a),c=0;c255)throw new Error("Level must be greater than 2 and less than 255 for posterize");for(var d=b-1,e=0;e>8)/d,c[e+1]=255*(h*b>>8)/d,c[e+2]=255*(i*b>>8)/d}},f.dilate=function(a){for(var b,c,d,e,g,h,i,j,k,l,m,n,o,p,q,r,s,t=f._toPixels(a),u=0,v=t.length?t.length/4:0,w=new Int32Array(v);u=c&&(h=u),j<0&&(j=0),k>=v&&(k=u),n=f._getARGB(t,j),m=f._getARGB(t,i),o=f._getARGB(t,k),l=f._getARGB(t,h),g=77*(d>>16&255)+151*(d>>8&255)+28*(255&d),q=77*(m>>16&255)+151*(m>>8&255)+28*(255&m),p=77*(l>>16&255)+151*(l>>8&255)+28*(255&l),r=77*(n>>16&255)+151*(n>>8&255)+28*(255&n),s=77*(o>>16&255)+151*(o>>8&255)+28*(255&o),q>g&&(e=m,g=q),p>g&&(e=l,g=p),r>g&&(e=n,g=r),s>g&&(e=o,g=s),w[u++]=e;f._setPixels(t,w)},f.erode=function(a){for(var b,c,d,e,g,h,i,j,k,l,m,n,o,p,q,r,s,t=f._toPixels(a),u=0,v=t.length?t.length/4:0,w=new Int32Array(v);u=c&&(h=u),j<0&&(j=0),k>=v&&(k=u),n=f._getARGB(t,j),m=f._getARGB(t,i),o=f._getARGB(t,k),l=f._getARGB(t,h),g=77*(d>>16&255)+151*(d>>8&255)+28*(255&d),q=77*(m>>16&255)+151*(m>>8&255)+28*(255&m),p=77*(l>>16&255)+151*(l>>8&255)+28*(255&l),r=77*(n>>16&255)+151*(n>>8&255)+28*(255&n),s=77*(o>>16&255)+151*(o>>8&255)+28*(255&o),q0&&a0&&this.loadPixels(),this.setModified(!0)},d.Image.prototype.copy=function(){d.prototype.copy.apply(this,arguments)},d.Image.prototype.mask=function(a){void 0===a&&(a=this);var b=this.drawingContext.globalCompositeOperation,c=1;a instanceof d.Renderer&&(c=a._pInst._pixelDensity);var e=[a,0,0,c*a.width,c*a.height,0,0,this.width,this.height];this.drawingContext.globalCompositeOperation="destination-in",d.Image.prototype.copy.apply(this,e),this.drawingContext.globalCompositeOperation=b,this.setModified(!0)},d.Image.prototype.filter=function(a,b){e.apply(this.canvas,e[a.toLowerCase()],b),this.setModified(!0)},d.Image.prototype.blend=function(){d.prototype.blend.apply(this,arguments),this.setModified(!0)},d.Image.prototype.setModified=function(a){this._modified=a},d.Image.prototype.isModified=function(){return this._modified},d.Image.prototype.save=function(a,b){var c;if(b)switch(b.toLowerCase()){case"png":c="image/png";break;case"jpeg":c="image/jpeg";break;case"jpg":c="image/jpeg";break;default:c="image/png"}else b="png",c="image/png";var e=this.canvas.toDataURL(c);e=e.replace(c,"image/octet-stream"),d.prototype.downloadFile(e,a,b)},b.exports=d.Image},{"../core/core":55,"./filters":74}],78:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("./filters");a("../color/p5.Color"),d.prototype.pixels=[],d.prototype.blend=function(){this._renderer?this._renderer.blend.apply(this._renderer,arguments):d.Renderer2D.prototype.blend.apply(this,arguments)},d.prototype.copy=function(){d.Renderer2D._copyHelper.apply(this,arguments)},d.prototype.filter=function(a,b){void 0!==this.canvas?e.apply(this.canvas,e[a.toLowerCase()],b):e.apply(this.elt,e[a.toLowerCase()],b)},d.prototype.get=function(a,b,c,d){return this._renderer.get(a,b,c,d)},d.prototype.loadPixels=function(){this._renderer.loadPixels()},d.prototype.set=function(a,b,c){this._renderer.set(a,b,c)},d.prototype.updatePixels=function(a,b,c,d){0!==this.pixels.length&&this._renderer.updatePixels(a,b,c,d)},b.exports=d},{"../color/p5.Color":49,"../core/core":55,"./filters":74}],79:[function(a,b,c){"use strict";function d(a,b){var c={};if(void 0===(b=b||[]))for(var d=0;d0&&"function"==typeof arguments[h];h--)f++;if(2==arguments.length-f&&"string"==typeof arguments[0]&&"object"==typeof arguments[1])c=new Request(arguments[0],arguments[1]),a=arguments[2],b=arguments[3],""===d&&(d=c.url.indexOf("json")!==-1?"json":c.url.indexOf("xml")!==-1?"xml":"text");else{for(var j,k=arguments[0],l="GET",m=1;m"),f.print("");var l=' "),f.print(""),f.print(" "),"0"!==g[0]){f.print(" ");for(var m=0;m"+n),f.print(" ")}f.print(" ")}for(var o=0;o");for(var p=0;p"+r),f.print(" ")}f.print(" ")}f.print("
"),f.print(""),f.print("")}f.close(),f.flush()},h.prototype.writeFile=function(a,b,c){var d="application/octet-stream";h.prototype._isSafari()&&(d="text/plain");var e=new Blob(a,{type:d}),f=window.URL.createObjectURL(e);h.prototype.downloadFile(f,b,c)},h.prototype.downloadFile=function(a,b,c){var d=f(b,c),e=d[0],i=d[1],j=document.createElement("a");if(j.href=a,j.download=e,j.onclick=function(a){g(a),a.stopPropagation()},j.style.display="none",document.body.appendChild(j),h.prototype._isSafari()){var k="Hello, Safari user! To download this file...\n";k+="1. Go to File --> Save As.\n",k+='2. Choose "Page Source" as the Format.\n',k+='3. Name it with this extension: ."'+i+'"',alert(k)}j.click(),a=null},h.prototype._checkFileExtension=f,h.prototype._isSafari=function(){return Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor")>0},b.exports=h},{"../core/core":55,"../core/error_helpers":58,"es6-promise":5,"fetch-jsonp":6,"whatwg-fetch":45}],80:[function(a,b,c){"use strict";var d=a("../core/core");d.Table=function(a){this.columns=[],this.rows=[],this.name="p5.Table"},d.Table.prototype.addRow=function(a){var b=a||new d.TableRow;if(void 0===b.arr||void 0===b.obj)throw"invalid TableRow: "+b;return b.table=this,this.rows.push(b),b},d.Table.prototype.removeRow=function(a){this.rows[a].table=null;var b=this.rows.splice(a+1,this.rows.length);this.rows.pop(),this.rows=this.rows.concat(b)},d.Table.prototype.getRow=function(a){return this.rows[a]},d.Table.prototype.getRows=function(){return this.rows},d.Table.prototype.findRow=function(a,b){if("string"==typeof b){for(var c=0;c=0))throw'This table has no column named "'+a+'"';c=b[a],d[c]=b}else d[e]=this.rows[e].obj;return d},d.Table.prototype.getArray=function(){for(var a=[],b=0;b=0))throw'This table has no column named "'+a+'"';this.obj[a]=b,this.arr[c]=b}else{if(!(a0},d.XML.prototype.listChildren=function(){return this.children.map(function(a){return a.name})},d.XML.prototype.getChildren=function(a){return a?this.children.filter(function(b){return b.name===a}):this.children},d.XML.prototype.getChild=function(a){return"string"==typeof a?this.children.find(function(b){return b.name===a}):this.children[a]},d.XML.prototype.addChild=function(a){a instanceof d.XML&&this.children.push(a)},d.XML.prototype.removeChild=function(a){var b=-1;if("string"==typeof a){for(var c=0;cf&&(f=h),e[g]=h}0===f&&(f=1);for(var i=0,j=0,k=0;k=1&&(s++,v--),w>=1&&(t++,w--),x>=1&&(u++,x--)}return y},e.prototype.noiseDetail=function(a,b){a>0&&(k=a),b>0&&(l=b)},e.prototype.noiseSeed=function(a){var b=function(){var a,b,c=4294967296,d=1664525,e=1013904223;return{setSeed:function(d){b=a=(null==d?Math.random()*c:d)>>>0},getSeed:function(){return a},rand:function(){return(b=(d*b+e)%c)/c}}}();b.setSeed(a),d=new Array(j+1);for(var c=0;ca*a&&(this.div(Math.sqrt(b)),this.mult(a)),this},d.Vector.prototype.setMag=function(a){return this.normalize().mult(a)},d.Vector.prototype.heading=function(){var a=Math.atan2(this.y,this.x);return this.p5?this.p5._angleMode===f.RADIANS?a:e.radiansToDegrees(a):a},d.Vector.prototype.rotate=function(a){var b=this.heading()+a;this.p5&&this.p5._angleMode===f.DEGREES&&(b=e.degreesToRadians(b));var c=this.mag();return this.x=Math.cos(b)*c,this.y=Math.sin(b)*c,this},d.Vector.prototype.angleBetween=function(a){var b=this.dot(a)/(this.mag()*a.mag()),c=Math.acos(Math.min(1,Math.max(-1,b)));return this.p5&&this.p5._angleMode===f.DEGREES&&(c=e.radiansToDegrees(c)),c},d.Vector.prototype.lerp=function(a,b,c,e){return a instanceof d.Vector?this.lerp(a.x,a.y,a.z,b):(this.x+=(a-this.x)*e||0,this.y+=(b-this.y)*e||0,this.z+=(c-this.z)*e||0,this)},d.Vector.prototype.array=function(){return[this.x||0,this.y||0,this.z||0]},d.Vector.prototype.equals=function(a,b,c){var e,f,g;return a instanceof d.Vector?(e=a.x||0,f=a.y||0,g=a.z||0):a instanceof Array?(e=a[0]||0,f=a[1]||0,g=a[2]||0):(e=a||0,f=b||0,g=c||0),this.x===e&&this.y===f&&this.z===g},d.Vector.fromAngle=function(a){return this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a)),this.p5?new d.Vector(this.p5,[Math.cos(a),Math.sin(a),0]):new d.Vector(Math.cos(a),Math.sin(a),0)},d.Vector.random2D=function(){var a;return a=this.p5?this.p5._angleMode===f.DEGREES?this.p5.random(360):this.p5.random(f.TWO_PI):Math.random()*Math.PI*2,this.fromAngle(a)},d.Vector.random3D=function(){var a,b;this.p5?(a=this.p5.random(0,f.TWO_PI),b=this.p5.random(-1,1)):(a=Math.random()*Math.PI*2,b=2*Math.random()-1);var c=Math.sqrt(1-b*b)*Math.cos(a),e=Math.sqrt(1-b*b)*Math.sin(a);return this.p5?new d.Vector(this.p5,[c,e,b]):new d.Vector(c,e,b)},d.Vector.add=function(a,b,c){return c?c.set(a):c=a.copy(),c.add(b),c},d.Vector.sub=function(a,b,c){return c?c.set(a):c=a.copy(),c.sub(b),c},d.Vector.mult=function(a,b,c){return c?c.set(a):c=a.copy(),c.mult(b),c},d.Vector.div=function(a,b,c){return c?c.set(a):c=a.copy(),c.div(b),c},d.Vector.dot=function(a,b){return a.dot(b)},d.Vector.cross=function(a,b){return a.cross(b)},d.Vector.dist=function(a,b){return a.dist(b)},d.Vector.lerp=function(a,b,c,d){return d?d.set(a):d=a.copy(),d.lerp(b,c),d},d.Vector.mag=function(a){var b=a.x,c=a.y,d=a.z,e=b*b+c*c+d*d;return Math.sqrt(e)},b.exports=d.Vector},{"../core/constants":54,"../core/core":55,"./polargeometry":87}],87:[function(a,b,c){b.exports={degreesToRadians:function(a){return 2*Math.PI*a/360},radiansToDegrees:function(a){return 360*a/(2*Math.PI)}}},{}],88:[function(a,b,c){"use strict";var d=a("../core/core"),e=!1,f=!1,g=0,h=function(){var a,b,c=4294967296,d=1664525,e=1013904223;return{setSeed:function(d){b=a=(null==d?Math.random()*c:d)>>>0},getSeed:function(){return a},rand:function(){return(b=(d*b+e)%c)/c}}}();d.prototype.randomSeed=function(a){h.setSeed(a),e=!0,f=!1},d.prototype.random=function(a,b){var c;if(c=e?h.rand():Math.random(),void 0===a)return c;if(void 0===b)return a instanceof Array?a[Math.floor(c*a.length)]:c*a;if(a>b){var d=a;a=b,b=d}return c*(b-a)+a},d.prototype.randomGaussian=function(a,b){var c,d,e,h;if(f)c=g,f=!1;else{do{d=this.random(2)-1,e=this.random(2)-1,h=d*d+e*e}while(h>=1);h=Math.sqrt(-2*Math.log(h)/h),c=d*h,g=e*h,f=!0}var i=a||0;return c*(b||1)+i},b.exports=d},{"../core/core":55}],89:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("./polargeometry"),f=a("../core/constants");d.prototype._angleMode=f.RADIANS,d.prototype.acos=function(a){return this._angleMode===f.RADIANS?Math.acos(a):e.radiansToDegrees(Math.acos(a))},d.prototype.asin=function(a){return this._angleMode===f.RADIANS?Math.asin(a):e.radiansToDegrees(Math.asin(a))},d.prototype.atan=function(a){return this._angleMode===f.RADIANS?Math.atan(a):e.radiansToDegrees(Math.atan(a))},d.prototype.atan2=function(a,b){return this._angleMode===f.RADIANS?Math.atan2(a,b):e.radiansToDegrees(Math.atan2(a,b))},d.prototype.cos=function(a){return this._angleMode===f.RADIANS?Math.cos(a):Math.cos(this.radians(a))},d.prototype.sin=function(a){return this._angleMode===f.RADIANS?Math.sin(a):Math.sin(this.radians(a))},d.prototype.tan=function(a){return this._angleMode===f.RADIANS?Math.tan(a):Math.tan(this.radians(a))},d.prototype.degrees=function(a){return e.radiansToDegrees(a)},d.prototype.radians=function(a){return e.degreesToRadians(a)},d.prototype.angleMode=function(a){a!==f.DEGREES&&a!==f.RADIANS||(this._angleMode=a)},b.exports=d},{"../core/constants":54,"../core/core":55,"./polargeometry":87}],90:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.textAlign=function(a,b){return this._renderer.textAlign.apply(this._renderer,arguments)},d.prototype.textLeading=function(a){return this._renderer.textLeading.apply(this._renderer,arguments)},d.prototype.textSize=function(a){return this._renderer.textSize.apply(this._renderer,arguments)},d.prototype.textStyle=function(a){return this._renderer.textStyle.apply(this._renderer,arguments)},d.prototype.textWidth=function(a){return 0===a.length?0:this._renderer.textWidth.apply(this._renderer,arguments)},d.prototype.textAscent=function(){return this._renderer.textAscent()},d.prototype.textDescent=function(){return this._renderer.textDescent()},d.prototype._updateTextMetrics=function(){return this._renderer._updateTextMetrics()},b.exports=d},{"../core/core":55}],91:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("../core/constants"),f=a("opentype.js");a("../core/error_helpers"),d.prototype.loadFont=function(a,b,c){var e=new d.Font(this),g=this;return f.load(a,function(f,h){if(f)return void 0!==c?c(f):(d._friendlyFileLoadError(4,a),void console.error(f,a));e.font=h,void 0!==b&&b(e),g._decrementPreload();var i,j,k=["ttf","otf","woff","woff2"],l=a.split("\\").pop().split("/").pop(),m=l.lastIndexOf("."),n=m<1?null:l.substr(m+1);k.indexOf(n)>-1&&(i=l.substr(0,m),j=document.createElement("style"),j.appendChild(document.createTextNode("\n@font-face {\nfont-family: "+i+";\nsrc: url("+a+");\n}\n")),document.head.appendChild(j))}),e},d.prototype.text=function(a,b,c,d,e){return this._renderer._doFill||this._renderer._doStroke?this._renderer.text.apply(this._renderer,arguments):this},d.prototype.textFont=function(a,b){if(arguments.length){if(!a)throw Error("null font passed to textFont");return this._renderer._setProperty("_textFont",a),b&&(this._renderer._setProperty("_textSize",b),this._renderer._setProperty("_textLeading",b*e._DEFAULT_LEADMULT)),this._renderer._applyTextProperties()}return this._renderer._textFont},b.exports=d},{"../core/constants":54,"../core/core":55,"../core/error_helpers":58,"opentype.js":18}],92:[function(a,b,c){"use strict";function d(a,b){for(var c=h(b,{sampleFactor:.1,simplifyThreshold:0}),d=n(a,0,1),f=d/(d*c.sampleFactor),g=[],i=0;i3&&d>=0;--d)j(i(a,d-1),i(a,d),i(a,d+1),b)&&(a.splice(d%a.length,1),c++);return c}function f(a){for(var b,c=[],d=0;ds||rb&&!c)return h=m(d,e,f[1],f[2],f[3],f[4],f[5],f[6],b-k),{x:h.x,y:h.y,alpha:h.alpha};k+=g,d=+f[5],e=+f[6]}i+=f.shift()+f}return j.end=i,h=c?k:l(d,e,f[0],f[1],f[2],f[3],f[4],f[5],1),h.alpha&&(h={x:h.x,y:h.y,alpha:h.alpha}),h}function o(a){var b=[],c=0,d=0,e=0,f=0,g=0;if(!a)return b;"M"===a[0][0]&&(c=+a[0][1],d=+a[0][2],e=c,f=d,g++,b[0]=["M",c,d]);for(var h,i,j,k=3===a.length&&"M"===a[0][0]&&"R"===a[1][0].toUpperCase()&&"Z"===a[2][0].toUpperCase(),l=g,m=a.length;l7){a[b].shift();for(var e=a[b];e.length;)j[b]="A",d&&(k[b]="A"),a.splice(b++,0,["C"].concat(e.splice(0,6)));a.splice(b,1),p=Math.max(c.length,d&&d.length||0)}},i=function(a,b,e,f,g){a&&b&&"M"===a[g][0]&&"M"!==b[g][0]&&(b.splice(g,0,["M",f.x,f.y]),e.bx=0,e.by=0,e.x=a[g][1],e.y=a[g][2],p=Math.max(c.length,d&&d.length||0))},j=[],k=[],l="",m="",n=0,p=Math.max(c.length,d&&d.length||0);n1&&(x=Math.sqrt(x),c*=x,d*=x);var y=c*c,z=d*d,A=(f===g?-1:1)*Math.sqrt(Math.abs((y*z-y*w*w-z*v*v)/(y*w*w+z*v*v)));m=A*c*w/d+(a+h)/2,n=A*-d*v/c+(b+i)/2,k=Math.asin(((b-n)/d).toFixed(9)),l=Math.asin(((i-n)/d).toFixed(9)),k=al&&(k-=2*p),!g&&l>k&&(l-=2*p)}var B=l-k;if(Math.abs(B)>r){var C=l,D=h,E=i;l=k+r*(g&&l>k?1:-1),h=m+c*Math.cos(l),i=n+d*Math.sin(l),t=q(h,i,c,d,e,0,g,D,E,[l,C,m,n])}B=l-k;var F=Math.cos(k),G=Math.sin(k),H=Math.cos(l),I=Math.sin(l),J=Math.tan(B/4),K=4/3*c*J,L=4/3*d*J,M=[a,b],N=[a+K*G,b-L*F],O=[h+K*I,i-L*H],P=[h,i];if(N[0]=2*M[0]-N[0],N[1]=2*M[1]-N[1],j)return[N,O,P].concat(t);t=[N,O,P].concat(t).join().split(",");for(var Q=[],R=0,S=t.length;Rd;d+=2){var f=[{x:+a[d-2],y:+a[d-1]},{x:+a[d],y:+a[d+1]},{x:+a[d+2],y:+a[d+3]},{x:+a[d+4],y:+a[d+5]}];b?d?e-4===d?f[3]={x:+a[0],y:+a[1]}:e-2===d&&(f[2]={x:+a[0],y:+a[1]},f[3]={x:+a[2],y:+a[3]}):f[0]={x:+a[e-2],y:+a[e-1]}:e-4===d?f[3]=f[2]:d||(f[0]={x:+a[d],y:+a[d+1]}),c.push(["C",(-f[0].x+6*f[1].x+f[2].x)/6,(-f[0].y+6*f[1].y+f[2].y)/6,(f[1].x+6*f[2].x-f[3].x)/6,(f[1].y+6*f[2].y-f[3].y)/6,f[2].x,f[2].y])}return c}function s(a,b,c,d){return[a,b,c,d,c,d]}function t(a,b,c,d,e,f){var g=1/3,h=2/3;return[g*a+h*c,g*b+h*d,g*e+h*c,g*f+h*d,e,f]}function u(a,b,c,d,e,f,g,h,i){null==i&&(i=1),i=i>1?1:i<0?0:i;for(var j=i/2,k=12,l=[-.1252,.1252,-.3678,.3678,-.5873,.5873,-.7699,.7699,-.9041,.9041,-.9816,.9816],m=0,n=[.2491,.2491,.2335,.2335,.2032,.2032,.1601,.1601,.1069,.1069,.0472,.0472],o=0;on;)l/=2,m+=(j2?a=this._getPath(a,b,c,d):"object"==typeof b&&(d=b),d&&"number"==typeof d.decimals&&(e=d.decimals),a.toPathData(e)},y.Font.prototype._getSVG=function(a,b,c,d){var e=3
-;return"string"==typeof a&&arguments.length>2?a=this._getPath(a,b,c,d):"object"==typeof b&&(d=b),d&&("number"==typeof d.decimals&&(e=d.decimals),"number"==typeof d.strokeWidth&&(a.strokeWidth=d.strokeWidth),void 0!==d.fill&&(a.fill=d.fill),void 0!==d.stroke&&(a.stroke=d.stroke)),a.toSVG(e)},y.Font.prototype._renderPath=function(a,b,c,d){var e,f=d&&d.renderer||this.parent._renderer,g=f.drawingContext;e="object"==typeof a&&a.commands?a.commands:this._getPath(a,b,c,d).commands,g.beginPath();for(var h=0;h1;)d=Math.random()*f|0,e=a[--f],a[f]=a[d],a[d]=e;return a},d.prototype.sort=function(a,b){var c=b?a.slice(0,Math.min(b,a.length)):a,d=b?a.slice(Math.min(b,a.length)):[];return c="string"==typeof c[0]?c.sort():c.sort(function(a,b){return a-b}),c.concat(d)},d.prototype.splice=function(a,b,c){return Array.prototype.splice.apply(a,[c,0].concat(b)),a},d.prototype.subset=function(a,b,c){return void 0!==c?a.slice(b,b+c):a.slice(b,a.length)},b.exports=d},{"../core/core":55}],94:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.float=function(a){return a instanceof Array?a.map(parseFloat):parseFloat(a)},d.prototype.int=function(a,b){return b=b||10,"string"==typeof a?parseInt(a,b):"number"==typeof a?0|a:"boolean"==typeof a?a?1:0:a instanceof Array?a.map(function(a){return d.prototype.int(a,b)}):void 0},d.prototype.str=function(a){return a instanceof Array?a.map(d.prototype.str):String(a)},d.prototype.boolean=function(a){return"number"==typeof a?0!==a:"string"==typeof a?"true"===a.toLowerCase():"boolean"==typeof a?a:a instanceof Array?a.map(d.prototype.boolean):void 0},d.prototype.byte=function(a){var b=d.prototype.int(a,10);return"number"==typeof b?(b+128)%256-128:b instanceof Array?b.map(d.prototype.byte):void 0},d.prototype.char=function(a){return"number"!=typeof a||isNaN(a)?a instanceof Array?a.map(d.prototype.char):"string"==typeof a?d.prototype.char(parseInt(a,10)):void 0:String.fromCharCode(a)},d.prototype.unchar=function(a){return"string"==typeof a&&1===a.length?a.charCodeAt(0):a instanceof Array?a.map(d.prototype.unchar):void 0},d.prototype.hex=function(a,b){if(b=void 0===b||null===b?b=8:b,a instanceof Array)return a.map(function(a){return d.prototype.hex(a,b)});if("number"==typeof a){a<0&&(a=4294967295+a+1);for(var c=Number(a).toString(16).toUpperCase();c.length=b&&(c=c.substring(c.length-b,c.length)),c}},d.prototype.unhex=function(a){return a instanceof Array?a.map(d.prototype.unhex):parseInt("0x"+a,16)},b.exports=d},{"../core/core":55}],95:[function(a,b,c){"use strict";function d(){var a=arguments[0],b=a<0,c=b?a.toString().substring(1):a.toString(),d=c.indexOf("."),e=d!==-1?c.substring(0,d):c,f=d!==-1?c.substring(d+1):"",g=b?"-":"";if(3===arguments.length){var h="";(d!==-1||arguments[2]-f.length>0)&&(h="."),f.length>arguments[2]&&(f=f.substring(0,arguments[2]));for(var i=0;ic.length){c+=b===-1?".":"";for(var e=arguments[1]-c.length+1,f=0;f0?"+"+arguments[0].toString():arguments[0].toString()}function g(){return parseFloat(arguments[0])>0?" "+arguments[0].toString():arguments[0].toString()}var h=a("../core/core");a("../core/error_helpers"),h.prototype.join=function(a,b){return h._validateParameters("join",arguments),a.join(b)},h.prototype.match=function(a,b){return h._validateParameters("match",arguments),a.match(b)},h.prototype.matchAll=function(a,b){h._validateParameters("matchAll",arguments);for(var c=new RegExp(b,"g"),d=c.exec(a),e=[];null!==d;)e.push(d),d=c.exec(a);return e},h.prototype.nf=function(){if(h._validateParameters("nf",arguments),arguments[0]instanceof Array){var a=arguments[1],b=arguments[2];return arguments[0].map(function(c){return d(c,a,b)})}return"[object Arguments]"===Object.prototype.toString.call(arguments[0])?3===arguments[0].length?this.nf(arguments[0][0],arguments[0][1],arguments[0][2]):2===arguments[0].length?this.nf(arguments[0][0],arguments[0][1]):this.nf(arguments[0][0]):d.apply(this,arguments)},h.prototype.nfc=function(){if(h._validateParameters("nfc",arguments),arguments[0]instanceof Array){var a=arguments[1];return arguments[0].map(function(b){return e(b,a)})}return e.apply(this,arguments)},h.prototype.nfp=function(){h._validateParameters("nfp",arguments);var a=h.prototype.nf.apply(this,arguments);return a instanceof Array?a.map(f):f(a)},h.prototype.nfs=function(){h._validateParameters("nfs",arguments);var a=h.prototype.nf.apply(this,arguments);return a instanceof Array?a.map(g):g(a)},h.prototype.split=function(a,b){return h._validateParameters("split",arguments),a.split(b)},h.prototype.splitTokens=function(){h._validateParameters("splitTokens",arguments);var a,b,c,d;return d=arguments[1],arguments.length>1?(c=/\]/g.exec(d),b=/\[/g.exec(d),b&&c?(d=d.slice(0,c.index)+d.slice(c.index+1),b=/\[/g.exec(d),d=d.slice(0,b.index)+d.slice(b.index+1),a=new RegExp("[\\["+d+"\\]]","g")):c?(d=d.slice(0,c.index)+d.slice(c.index+1),a=new RegExp("["+d+"\\]]","g")):b?(d=d.slice(0,b.index)+d.slice(b.index+1),a=new RegExp("["+d+"\\[]","g")):a=new RegExp("["+d+"]","g")):a=/\s/g,arguments[0].split(a).filter(function(a){return a})},h.prototype.trim=function(a){return h._validateParameters("trim",arguments),a instanceof Array?a.map(this.trim):a.trim()},b.exports=h},{"../core/core":55,"../core/error_helpers":58}],96:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.day=function(){return(new Date).getDate()},d.prototype.hour=function(){return(new Date).getHours()},d.prototype.minute=function(){return(new Date).getMinutes()},d.prototype.millis=function(){return window.performance.now()},d.prototype.month=function(){return(new Date).getMonth()+1},d.prototype.second=function(){return(new Date).getSeconds()},d.prototype.year=function(){return(new Date).getFullYear()},b.exports=d},{"../core/core":55}],97:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.camera=function(){return this._renderer.camera.apply(this._renderer,arguments),this},d.RendererGL.prototype.camera=function(){var a,b,c,d,e,f,g,h,i;0===arguments.length?(a=this.defaultCameraX,b=this.defaultCameraY,c=this.defaultCameraZ,d=a,e=b,f=0,g=0,h=1,i=0):(a=arguments[0],b=arguments[1],c=arguments[2],d=arguments[3],e=arguments[4],f=arguments[5],g=arguments[6],h=arguments[7],i=arguments[8]),this.cameraX=a,this.cameraY=b,this.cameraZ=c;var j=a-d,k=b-e,l=c-f;this.eyeDist=Math.sqrt(j*j+k*k+l*l),0!==this.eyeDist&&(j/=this.eyeDist,k/=this.eyeDist,l/=this.eyeDist);var m=g,n=h,o=i,p=n*l-o*k,q=-m*l+o*j,r=m*k-n*j;m=k*r-l*q,n=-j*r+l*p,o=j*q-k*p;var s=Math.sqrt(p*p+q*q+r*r);0!==s&&(p/=s,q/=s,r/=s);var t=Math.sqrt(m*m+n*n+o*o);0!==t&&(m/=t,n/=t,o/=t),this.cameraMatrix.set(p,m,j,0,q,n,k,0,r,o,l,0,0,0,0,1);var u=-a,v=-b,w=-c;return this.cameraMatrix.translate([u,v,w]),this.uMVMatrix.set(this.cameraMatrix.mat4[0],this.cameraMatrix.mat4[1],this.cameraMatrix.mat4[2],this.cameraMatrix.mat4[3],this.cameraMatrix.mat4[4],this.cameraMatrix.mat4[5],this.cameraMatrix.mat4[6],this.cameraMatrix.mat4[7],this.cameraMatrix.mat4[8],this.cameraMatrix.mat4[9],this.cameraMatrix.mat4[10],this.cameraMatrix.mat4[11],this.cameraMatrix.mat4[12],this.cameraMatrix.mat4[13],this.cameraMatrix.mat4[14],this.cameraMatrix.mat4[15]),this},d.prototype.perspective=function(){return this._renderer.perspective.apply(this._renderer,arguments),this},d.RendererGL.prototype.perspective=function(){var a=arguments[0]||this.defaultCameraFOV,b=arguments[1]||this.defaultCameraAspect,c=arguments[2]||this.defaultCameraNear,e=arguments[3]||this.defaultCameraFar;this.cameraFOV=a,this.cameraAspect=b,this.cameraNear=c,this.cameraFar=e,this.uPMatrix=d.Matrix.identity();var f=1/Math.tan(this.cameraFOV/2),g=1/(this.cameraNear-this.cameraFar);this.uPMatrix.set(f/b,0,0,0,0,-f,0,0,0,0,(e+c)*g,-1,0,0,2*e*c*g,0),this._curCamera="custom"},d.prototype.ortho=function(a,b,c,e,f,g){a=a||-this.width/2,b=b||this.width/2,c=c||-this.height/2,e=e||this.height/2,f=f||0,g=g||Math.max(this.width,this.height),this._renderer.uPMatrix=d.Matrix.identity();var h=b-a,i=e-c,j=g-f,k=2/h,l=2/i,m=-2/j,n=-(b+a)/h,o=-(e+c)/i,p=-(g+f)/j;this._renderer.uPMatrix.set(k,0,0,0,0,-l,0,0,0,0,m,0,n,o,p,1),this._renderer._curCamera="custom"},b.exports=d},{"../core/core":55}],98:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.orbitControl=function(){return this.mouseIsPressed&&(this.rotateY((this.mouseX-this.width/2)/(this.width/2)),this.rotateX((this.mouseY-this.height/2)/(this.width/2))),this},b.exports=d},{"../core/core":55}],99:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.ambientLight=function(a,b,c,d){this._renderer.curFillShader.isLightShader()||this._renderer.setFillShader(this._renderer._getLightShader());var e=this._renderer._pInst.color.apply(this._renderer._pInst,arguments),f=new Float32Array(e._array.slice(0,3));return this._renderer.curFillShader.setUniform("uAmbientColor",f),this._renderer.curFillShader.setUniform("uUseLighting",!0),this._renderer.ambientLightCount++,this._renderer.curFillShader.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.curFillShader.setUniform("uAmbientLightCount",this._renderer.ambientLightCount),this},d.prototype.directionalLight=function(a,b,c,d,e,f){this._renderer.curFillShader.isLightShader()||this._renderer.setFillShader(this._renderer._getLightShader());var g=this._renderer._pInst.color.apply(this._renderer._pInst,[a,b,c]),h=new Float32Array(g._array.slice(0,3));this._renderer.curFillShader.setUniform("uDirectionalColor",h);for(var i,j,k,l=new Array(arguments.length),m=0;m0)if("v"===g[0]||"vn"===g[0]){var h=new e.Vector(parseFloat(g[1]),parseFloat(g[2]),parseFloat(g[3]));c[g[0]].push(h)}else if("vt"===g[0]){var i=[parseFloat(g[1]),parseFloat(g[2])];c[g[0]].push(i)}else if("f"===g[0])for(var j=3;j0&&(this._renderer.geometryInHash(a.gid)||(a._makeTriangleEdges(),this._renderer._edgesToVertices(a),this._renderer.createBuffers(a.gid,a)),this._renderer.drawBuffers(a.gid))},b.exports=e},{"../core/core":55,"./p5.Geometry":102}],101:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("../core/constants");a("./p5.Texture"),d.prototype.loadShader=function(a,b){var c=new d.Shader,e=this,f=!1,g=!1;return this.loadStrings(b,function(a){c._fragSrc=a.join("\n"),f=!0,g||e._incrementPreload()}),this.loadStrings(a,function(a){c._vertSrc=a.join("\n"),g=!0,f||e._incrementPreload()}),c},d.prototype.shader=function(a){return void 0===a._renderer&&(a._renderer=this._renderer),a.isStrokeShader()?this._renderer.setStrokeShader(a):this._renderer.setFillShader(a),this},d.prototype.normalMaterial=function(){return this._renderer.drawMode=e.FILL,this._renderer.setFillShader(this._renderer._getNormalShader()),this._renderer.noStroke(),this},d.prototype.texture=function(){for(var a=new Array(arguments.length),b=0;bthis.vertices.length-1-this.detailX;b--)a.add(this.vertexNormals[b]);for(a=d.Vector.div(a,this.detailX),b=this.vertices.length-1;b>this.vertices.length-1-this.detailX;b--)this.vertexNormals[b]=a;return this},d.Geometry.prototype._makeTriangleEdges=function(){if(Array.isArray(this.strokeIndices))for(var a=0,b=this.strokeIndices.length;a0){for(var a=this.vertices[0].copy(),b=this.vertices[0].copy(),c=0;c1e3){var b=Object.keys(this.gHash)[0];delete this.gHash[b],e--}var c=this.GL;this.gHash[a]={},this.gHash[a].vertexBuffer=c.createBuffer(),this.gHash[a].normalBuffer=c.createBuffer(),this.gHash[a].lineNormalBuffer=c.createBuffer(),this.gHash[a].uvBuffer=c.createBuffer(),this.gHash[a].indexBuffer=c.createBuffer(),this.gHash[a].lineVertexBuffer=c.createBuffer()},d.RendererGL.prototype.createBuffers=function(a,b){var c=this.GL;this._setDefaultCamera(),this._initBufferDefaults(a),this.gHash[a].numberOfItems=3*b.faces.length,this.gHash[a].lineVertexCount=b.lineVertices.length,this.curFillShader===this._getImmediateModeShader()&&this.setFillShader(this._getColorShader()),this._bindBuffer(this.gHash[a].lineVertexBuffer,c.ARRAY_BUFFER,this._flatten(b.lineVertices),Float32Array,c.STATIC_DRAW),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aPosition.location,3,c.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].lineNormalBuffer,c.ARRAY_BUFFER,this._flatten(b.lineNormals),Float32Array,c.STATIC_DRAW),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aDirection.location,4,c.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].vertexBuffer,c.ARRAY_BUFFER,this._vToNArray(b.vertices),Float32Array,c.STATIC_DRAW),this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,3,c.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].indexBuffer,c.ELEMENT_ARRAY_BUFFER,this._flatten(b.faces),Uint16Array,c.STATIC_DRAW),this._bindBuffer(this.gHash[a].normalBuffer,c.ARRAY_BUFFER,this._vToNArray(b.vertexNormals),Float32Array,c.STATIC_DRAW),this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,3,c.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].uvBuffer,c.ARRAY_BUFFER,this._flatten(b.uvs),Float32Array,c.STATIC_DRAW),this.curFillShader.enableAttrib(this.curFillShader.attributes.aTexCoord.location,2,c.FLOAT,!1,0,0)},d.RendererGL.prototype.drawBuffers=function(a){this._setDefaultCamera();var b=this.GL;return this.curFillShader===this._getImmediateModeShader()&&this.setFillShader(this._getColorShader()),this.curStrokeShader.active!==!1&&this.gHash[a].lineVertexCount>0&&(this.curStrokeShader.bindShader(),this._bindBuffer(this.gHash[a].lineVertexBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].lineNormalBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aDirection.location,4,b.FLOAT,!1,0,0),this._drawArrays(b.TRIANGLES,a),this.curStrokeShader.unbindShader()),this.curFillShader.active!==!1&&(this.curFillShader.bindShader(),this._bindBuffer(this.gHash[a].vertexBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].indexBuffer,b.ELEMENT_ARRAY_BUFFER),this._bindBuffer(this.gHash[a].normalBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,3,b.FLOAT,!1,0,0),this._bindBuffer(this.gHash[a].uvBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aTexCoord.location,2,b.FLOAT,!1,0,0),this._drawElements(b.TRIANGLES,a),this.curFillShader.unbindShader()),this},d.RendererGL.prototype._drawArrays=function(a,b){return this.GL.drawArrays(a,0,this.gHash[b].lineVertexCount),this},d.RendererGL.prototype._drawElements=function(a,b){this.GL.drawElements(a,this.gHash[b].numberOfItems,this.GL.UNSIGNED_SHORT,0)},b.exports=d.RendererGL},{"../core/core":55}],106:[function(a,b,c){"use strict";var d=a("../core/core"),e=a("../core/constants");a("./p5.Shader"),a("../core/p5.Renderer"),a("./p5.Matrix");var f=[],g=[],h={immediateVert:"attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform float uResolution;\nuniform float uPointSize;\n\nvarying vec4 vColor;\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n gl_PointSize = uPointSize;\n}\n",vertexColorVert:"attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nvarying vec4 vColor;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n}\n",vertexColorFrag:"precision mediump float;\nvarying vec4 vColor;\nvoid main(void) {\n gl_FragColor = vColor;\n}",normalVert:"attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\n\nvarying vec3 vVertexNormal;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vVertexNormal = vec3( uNormalMatrix * aNormal );\n vVertTexCoord = aTexCoord;\n}\n",normalFrag:"precision mediump float;\nvarying vec3 vVertexNormal;\nvoid main(void) {\n gl_FragColor = vec4(vVertexNormal, 1.0);\n}",basicFrag:"precision mediump float;\nvarying vec3 vVertexNormal;\nuniform vec4 uMaterialColor;\nvoid main(void) {\n gl_FragColor = uMaterialColor;\n}",lightVert:"attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\nuniform int uAmbientLightCount;\nuniform int uDirectionalLightCount;\nuniform int uPointLightCount;\n\nuniform vec3 uAmbientColor[8];\nuniform vec3 uLightingDirection[8];\nuniform vec3 uDirectionalColor[8];\nuniform vec3 uPointLightLocation[8];\nuniform vec3 uPointLightColor[8];\nuniform bool uSpecular;\n\nvarying vec3 vVertexNormal;\nvarying vec2 vVertTexCoord;\nvarying vec3 vLightWeighting;\n\nvec3 ambientLightFactor = vec3(0.0, 0.0, 0.0);\nvec3 directionalLightFactor = vec3(0.0, 0.0, 0.0);\nvec3 pointLightFactor = vec3(0.0, 0.0, 0.0);\nvec3 pointLightFactor2 = vec3(0.0, 0.0, 0.0);\n\nvoid main(void){\n\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n\n vec3 vertexNormal = vec3( uNormalMatrix * aNormal );\n vVertexNormal = vertexNormal;\n vVertTexCoord = aTexCoord;\n\n vec4 mvPosition = uModelViewMatrix * vec4(aPosition, 1.0);\n vec3 eyeDirection = normalize(-mvPosition.xyz);\n\n float shininess = 32.0;\n float specularFactor = 2.0;\n float diffuseFactor = 0.3;\n\n for(int i = 0; i < 8; i++){\n if(uAmbientLightCount == i) break;\n ambientLightFactor += uAmbientColor[i];\n }\n\n for(int j = 0; j < 8; j++){\n if(uDirectionalLightCount == j) break;\n vec3 dir = uLightingDirection[j];\n float directionalLightWeighting = max(dot(vertexNormal, dir), 0.0);\n directionalLightFactor += uDirectionalColor[j] * directionalLightWeighting;\n }\n\n for(int k = 0; k < 8; k++){\n if(uPointLightCount == k) break;\n vec3 loc = uPointLightLocation[k];\n vec3 lightDirection = normalize(loc - mvPosition.xyz);\n\n float directionalLightWeighting = max(dot(vertexNormal, lightDirection), 0.0);\n pointLightFactor += uPointLightColor[k] * directionalLightWeighting;\n\n //factor2 for specular\n vec3 reflectionDirection = reflect(-lightDirection, vertexNormal);\n float specularLightWeighting = pow(max(dot(reflectionDirection, eyeDirection), 0.0), shininess);\n\n pointLightFactor2 += uPointLightColor[k] * (specularFactor * specularLightWeighting\n + directionalLightWeighting * diffuseFactor);\n }\n\n if(!uSpecular){\n vLightWeighting = ambientLightFactor + directionalLightFactor + pointLightFactor;\n }else{\n vLightWeighting = ambientLightFactor + directionalLightFactor + pointLightFactor2;\n }\n\n}\n",lightTextureFrag:"precision mediump float;\n\nuniform vec4 uMaterialColor;\nuniform sampler2D uSampler;\nuniform bool isTexture;\nuniform bool uUseLighting;\n\nvarying vec3 vLightWeighting;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n if(!isTexture){\n gl_FragColor = vec4(vec3(uMaterialColor.rgb * vLightWeighting), uMaterialColor.a);\n }else{\n vec4 textureColor = texture2D(uSampler, vVertTexCoord);\n if(!uUseLighting){\n gl_FragColor = textureColor;\n }else{\n gl_FragColor = vec4(vec3(textureColor.rgb * vLightWeighting), textureColor.a);\n }\n }\n}",lineVert:"uniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nuniform vec4 uViewport;\n\nuniform float uStrokeWeight;\n\nattribute vec4 aPosition;\nattribute vec4 aDirection;\n\n\nvec3 clipToWindow(vec4 clip, vec4 viewport) {\n vec3 post_div = clip.xyz / clip.w;\n vec2 xypos = (post_div.xy + vec2(1.0, 1.0)) * 0.5 * viewport.zw;\n return vec3(xypos, post_div.z * 0.5 + 0.5);\n}\n\nvec4 windowToClipVector(vec2 window, vec4 viewport, float clip_w) {\n vec2 xypos = (window / viewport.zw) * 2.0;\n return vec4(xypos, 0.0, 0.0) * clip_w;\n}\n\nvoid main() {\n vec4 posMV = uModelViewMatrix * aPosition;\n posMV.xyz = posMV.xyz * vec3(0.999,0.999,0.999);\n vec4 clipp = uProjectionMatrix * posMV;\n float displace = aDirection.w;\n\n vec4 posq = uModelViewMatrix * vec4(aDirection.xyz, 0.0);\n posq.xyz = posq.xyz * vec3(0.999,0.999,0.999);\n vec4 clipq = uProjectionMatrix * posq;\n clipq.w = 1.0;\n\n vec3 window_p = clipToWindow(clipp, uViewport);\n vec3 window_q = clipToWindow(clipq, uViewport);\n vec3 tangent = window_q - window_p;\n vec2 perp = normalize(vec2(-tangent.y, tangent.x));\n float halfStroke = uStrokeWeight/2.0;\n vec2 offset = vec2(halfStroke,halfStroke) * displace * perp;\n gl_Position.xy = clipp.xy + offset.xy;\n gl_Position.zw = clipp.zw;\n}\n",lineFrag:"precision mediump float;\nprecision mediump int;\n\nuniform vec4 uMaterialColor;\n\nvoid main() {\n gl_FragColor = uMaterialColor;\n}"};d.RendererGL=function(a,b,c,e){return d.Renderer.call(this,a,b,c),this.attributes={},e=e||{},this.attributes.alpha=void 0===e.alpha||e.alpha,this.attributes.depth=void 0===e.depth||e.depth,this.attributes.stencil=void 0===e.stencil||e.stencil,this.attributes.antialias=void 0!==e.antialias&&e.antialias,this.attributes.premultipliedAlpha=void 0!==e.premultipliedAlpha&&e.premultipliedAlpha,this.attributes.preserveDrawingBuffer=void 0===e.preserveDrawingBuffer||e.preserveDrawingBuffer,this._initContext(),this.isP3D=!0,this.GL=this.drawingContext,this.ambientLightCount=0,this.directionalLightCount=0,this.pointLightCount=0,this.uMVMatrix=new d.Matrix,this.uPMatrix=new d.Matrix,this.uNMatrix=new d.Matrix("mat3"),this._curCamera=null,this._computeCameraDefaultSettings(),this.cameraFOV=this.defaultCameraFOV,this.cameraAspect=this.defaultAspect,this.cameraX=this.defaultCameraX,this.cameraY=this.defaultCameraY,this.cameraZ=this.defaultCameraZ,this.cameraNear=this.defaultCameraNear,this.cameraFar=this.defaultCameraFar,this.cameraMatrix=new d.Matrix,this.camera(),this.gHash={},this._defaultLightShader=void 0,this._defaultImmediateModeShader=void 0,this._defaultNormalShader=void 0,this._defaultColorShader=void 0,this.curFillShader={},this.curStrokeShader={},this.setFillShader(this._getColorShader()),this.setStrokeShader(this._getLineShader()),this.isImmediateDrawing=!1,this.immediateMode={},this.fill(255,255,255,255),this.pointSize=5,this.curStrokeWeight=2,this.curStrokeColor=[0,0,0,1],this._setStrokeWeight(),this._setStrokeColor(),this.textures=[],this.name="p5.RendererGL",this},d.RendererGL.prototype=Object.create(d.Renderer.prototype),d.RendererGL.prototype._initContext=function(){try{if(this.drawingContext=this.canvas.getContext("webgl",this.attributes)||this.canvas.getContext("experimental-webgl",this.attributes),null===this.drawingContext)throw new Error("Error creating webgl context");console.log("p5.RendererGL: enabled webgl context");var a=this.drawingContext;a.enable(a.DEPTH_TEST),a.depthFunc(a.LEQUAL),a.viewport(0,0,a.drawingBufferWidth,a.drawingBufferHeight)}catch(a){throw new Error(a)}},d.RendererGL.prototype._resetContext=function(a,b,c){var e=this.width,f=this.height,g=this.canvas.id,h=this.canvas;h&&h.parentNode.removeChild(h),h=document.createElement("canvas"),h.id=g,this._pInst._userNode?this._pInst._userNode.appendChild(h):document.body.appendChild(h),this._pInst.canvas=h,this._pInst._setProperty("_renderer",new d.RendererGL(this._pInst.canvas,this._pInst,!0,a)),this._pInst._renderer.resize(e,f),this._pInst._renderer._applyDefaults(),this._pInst._elements.push(this._renderer),"function"==typeof c&&setTimeout(function(){c.apply(window._renderer,b)},0)},d.prototype.setAttributes=function(){var a={};2===arguments.length?a[arguments[0]]=arguments[1]:1===arguments.length&&(a=arguments[0]),this._renderer._resetContext(a)},d.RendererGL.prototype._computeCameraDefaultSettings=function(){this.defaultCameraFOV=60/180*Math.PI,this.defaultCameraAspect=this.width/this.height,this.defaultCameraX=0,this.defaultCameraY=0,this.defaultCameraZ=this.height/2/Math.tan(this.defaultCameraFOV/2),this.defaultCameraNear=.1*this.defaultCameraZ,this.defaultCameraFar=10*this.defaultCameraZ},d.RendererGL.prototype._setDefaultCamera=function(){null===this._curCamera&&(this._computeCameraDefaultSettings(),this.cameraFOV=this.defaultCameraFOV,this.cameraAspect=this.defaultAspect,this.cameraX=this.defaultCameraX,this.cameraY=this.defaultCameraY,this.cameraZ=this.defaultCameraZ,this.cameraNear=this.defaultCameraNear,this.cameraFar=this.defaultCameraFar,this.perspective(),this.camera(),this._curCamera="default")},d.RendererGL.prototype._update=function(){this.uMVMatrix.set(this.cameraMatrix.mat4[0],this.cameraMatrix.mat4[1],this.cameraMatrix.mat4[2],this.cameraMatrix.mat4[3],this.cameraMatrix.mat4[4],this.cameraMatrix.mat4[5],this.cameraMatrix.mat4[6],this.cameraMatrix.mat4[7],this.cameraMatrix.mat4[8],this.cameraMatrix.mat4[9],this.cameraMatrix.mat4[10],this.cameraMatrix.mat4[11],this.cameraMatrix.mat4[12],this.cameraMatrix.mat4[13],this.cameraMatrix.mat4[14],this.cameraMatrix.mat4[15]),this.ambientLightCount=0,this.directionalLightCount=0,this.pointLightCount=0},d.RendererGL.prototype.background=function(){var a=this._pInst.color.apply(this._pInst,arguments),b=a.levels[0]/255,c=a.levels[1]/255,d=a.levels[2]/255,e=a.levels[3]/255;this.GL.clearColor(b,c,d,e),this.GL.clear(this.GL.COLOR_BUFFER_BIT|this.GL.DEPTH_BUFFER_BIT)},d.RendererGL.prototype.fill=function(a,b,c,d){var f=this._applyColorBlend.apply(this,arguments);this.curFillColor=f,this.curFillShader.active===!1&&(this.curFillShader.active=!0),this.isImmediateDrawing?this.setFillShader(this._getImmediateModeShader()):this.setFillShader(this._getColorShader()),this.drawMode=e.FILL,this.curFillShader.setUniform("uMaterialColor",f)},d.RendererGL.prototype.noFill=function(){this.curFillShader.active=!1},d.RendererGL.prototype.noStroke=function(){this.curStrokeShader.active=!1},d.RendererGL.prototype.stroke=function(a,b,c,d){this.curStrokeShader.active===!1&&(this.curStrokeShader.active=!0),arguments[3]=255;var e=this._applyColorBlend.apply(this,arguments);this.curStrokeColor!==e&&(this.curStrokeColor=e,this._setStrokeColor())},d.RendererGL.prototype.strokeWeight=function(a){this.curStrokeShader.active===!1&&(this.curStrokeShader.active=!0),this.curStrokeWeight!==a&&(this.pointSize=a,this.curStrokeWeight=a,this.curStrokeShader.setUniform("uStrokeWeight",a))},d.RendererGL.prototype._setStrokeWeight=function(){this.curStrokeShader.setUniform("uStrokeWeight",this.curStrokeWeight)},d.RendererGL.prototype._setStrokeColor=function(){this.curStrokeShader.setUniform("uMaterialColor",this.curStrokeColor)},d.RendererGL.prototype.get=function(a,b,c,e){return d.Renderer2D.prototype.get.apply(this,[a,b,c,e])},d.RendererGL.prototype.loadPixels=function(){if(this.attributes.preserveDrawingBuffer!==!0)return void console.log("loadPixels only works in WebGL when preserveDrawingBuffer is true.");var a=this._pInst._pixelDensity,b=arguments[0]||0,c=arguments[1]||0,d=arguments[2]||this.width,e=arguments[3]||this.height;d*=a,e*=a;var f=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4);this.GL.readPixels(b,c,d,e,this.GL.RGBA,this.GL.UNSIGNED_BYTE,f),this._pInst._setProperty("pixels",f)},d.RendererGL.prototype.geometryInHash=function(a){return void 0!==this.gHash[a]},d.RendererGL.prototype.resize=function(a,b){d.Renderer.prototype.resize.call(this,a,b),this.GL.viewport(0,0,this.GL.drawingBufferWidth,this.GL.drawingBufferHeight),null!==this._curCamera&&"default"!==this._curCamera||(this._curCamera=null,this._setDefaultCamera())},d.RendererGL.prototype.clear=function(){this.GL.clearColor(arguments[0],arguments[1],arguments[2],arguments[3]),this.GL.clear(this.GL.COLOR_BUFFER_BIT|this.GL.DEPTH_BUFFER_BIT)},d.RendererGL.prototype.translate=function(a,b,c){return a instanceof d.Vector&&(c=a.z,b=a.y,a=a.x),this.uMVMatrix.translate([a,b,c]),this},d.RendererGL.prototype.scale=function(a,b,c){return this.uMVMatrix.scale([a,b,c]),this},d.RendererGL.prototype.rotate=function(a,b){return this.uMVMatrix.rotate(a,b),this},d.RendererGL.prototype.rotateX=function(a){return this.rotate(a,[1,0,0]),this},d.RendererGL.prototype.rotateY=function(a){return this.rotate(a,[0,1,0]),this},d.RendererGL.prototype.rotateZ=function(a){return this.rotate(a,[0,0,1]),this},d.RendererGL.prototype.push=function(){f.push(this.uMVMatrix.copy()),g.push(this.cameraMatrix.copy())},d.RendererGL.prototype.pop=function(){if(0===f.length)throw new Error("Invalid popMatrix!");if(this.uMVMatrix=f.pop(),0===g.length)throw new Error("Invalid popMatrix!");this.cameraMatrix=g.pop()},d.RendererGL.prototype.resetMatrix=function(){return this.uMVMatrix=d.Matrix.identity(),this},d.RendererGL.prototype._applyTextProperties=function(){console.error("text commands not yet implemented in webgl")},d.RendererGL.prototype.setFillShader=function(a){return this.curFillShader!==a&&(this.curFillShader=a,this.curFillShader.init(),this.curFillShader.useProgram(),this.curFillShader.active=!0),this.curFillShader},d.RendererGL.prototype.setStrokeShader=function(a){return this.curStrokeShader!==a&&(this.curStrokeShader=a,this.curStrokeShader.init(),this.curStrokeShader.useProgram(),this.curStrokeShader.active=!0),this.curStrokeShader},d.RendererGL.prototype._getLightShader=function(){return void 0===this._defaultLightShader&&(this._defaultLightShader=new d.Shader(this,h.lightVert,h.lightTextureFrag)),this._defaultLightShader},d.RendererGL.prototype._getImmediateModeShader=function(){return void 0===this._defaultImmediateModeShader&&(this._defaultImmediateModeShader=new d.Shader(this,h.immediateVert,h.vertexColorFrag)),this._defaultImmediateModeShader},d.RendererGL.prototype._getNormalShader=function(){return void 0===this._defaultNormalShader&&(this._defaultNormalShader=new d.Shader(this,h.normalVert,h.normalFrag)),this._defaultNormalShader},d.RendererGL.prototype._getColorShader=function(){return void 0===this._defaultColorShader&&(this._defaultColorShader=new d.Shader(this,h.normalVert,h.basicFrag)),this._defaultColorShader},d.RendererGL.prototype._getLineShader=function(){return void 0===this._defaultLineShader&&(this._defaultLineShader=new d.Shader(this,h.lineVert,h.lineFrag)),this._defaultLineShader},d.RendererGL.prototype._getEmptyTexture=function(){if(void 0===this._emptyTexture){var a=new d.Image(1,1);a.set(0,0,255),this._emptyTexture=new d.Texture(this,a)}return this._emptyTexture},d.RendererGL.prototype.getTexture=function(a){var b=function(b){return b.src===a},c=this.textures.find(b);return void 0===c&&(c=new d.Texture(this,a),this.textures.push(c)),c},d.RendererGL.prototype._bindBuffer=function(a,b,c,d,e){if(this.GL.bindBuffer(b,a),void 0!==c){var f=new d(c);this.GL.bufferData(b,f,e)}},d.RendererGL.prototype._flatten=function(a){return a.length>0?[].concat.apply([],a):[]},d.RendererGL.prototype._vToNArray=function(a){return this._flatten(a.map(function(a){return[a.x,a.y,a.z]}))},b.exports=d.RendererGL},{"../core/constants":54,"../core/core":55,"../core/p5.Renderer":62,"./p5.Matrix":103,"./p5.Shader":107}],107:[function(a,b,c){var d=a("../core/core");d.Shader=function(a,b,c){return this._renderer=a,this._vertSrc=b,this._fragSrc=c,this._vertShader=-1,this._fragShader=-1,this._glProgram=0,this._loadedAttributes=!1,this.attributes={},this._loadedUniforms=!1,this.uniforms={},this._bound=!1,this.samplers=[],this},d.Shader.prototype.init=function(){if(0===this._glProgram){var a=this._renderer.GL;if(this._vertShader=a.createShader(a.VERTEX_SHADER),a.shaderSource(this._vertShader,this._vertSrc),a.compileShader(this._vertShader),!a.getShaderParameter(this._vertShader,a.COMPILE_STATUS))return console.error("Yikes! An error occurred compiling the vertex shader:"+a.getShaderInfoLog(this._vertShader)),null;if(this._fragShader=a.createShader(a.FRAGMENT_SHADER),a.shaderSource(this._fragShader,this._fragSrc),a.compileShader(this._fragShader),!a.getShaderParameter(this._fragShader,a.COMPILE_STATUS))return console.error("Darn! An error occurred compiling the fragment shader:"+a.getShaderInfoLog(this._fragShader)),null;this._glProgram=a.createProgram(),a.attachShader(this._glProgram,this._vertShader),a.attachShader(this._glProgram,this._fragShader),a.linkProgram(this._glProgram),a.getProgramParameter(this._glProgram,a.LINK_STATUS)||console.error("Snap! Error linking shader program: "+a.getProgramInfoLog(this._glProgram)),this._loadAttributes(),this._loadUniforms()}return this},d.Shader.prototype._loadAttributes=function(){if(!this._loadedAttributes){this.attributes={};for(var a=this._renderer.GL,b=a.getProgramParameter(this._glProgram,a.ACTIVE_ATTRIBUTES),c=0;c1&&(g=g.substring(0,g.indexOf("[0]"))),f.name=g,f.type=e.type,f.type===a.SAMPLER_2D&&(f.samplerIndex=c,c++,this.samplers.push(f)),this.uniforms[g]=f}this._loadedUniforms=!0}},d.Shader.prototype.compile=function(){},d.Shader.prototype.bindShader=function(){this.init(),this._bound||(this.useProgram(),this._bound=!0,this.bindTextures(),this._loadAttributes(),this._loadUniforms(),this._renderer._setDefaultCamera(),this._setMatrixUniforms(),this===this._renderer.curStrokeShader&&this._setViewportUniform())},d.Shader.prototype.unbindShader=function(){return this._bound&&(this.unbindTextures(),this._bound=!1),this},d.Shader.prototype.bindTextures=function(){for(var a=this._renderer.GL,b=0;b1?c.uniform1fv(e,b):c.uniform1f(e,b);break;case c.FLOAT_MAT3:c.uniformMatrix3fv(e,!1,b);break;case c.FLOAT_MAT4:c.uniformMatrix4fv(e,!1,b);break;case c.FLOAT_VEC2:d.size>1?c.uniform2fv(e,b):c.uniform2f(e,b[0],b[1]);break;case c.FLOAT_VEC3:d.size>1?c.uniform3fv(e,b):c.uniform3f(e,b[0],b[1],b[2]);break;case c.FLOAT_VEC4:d.size>1?c.uniform4fv(e,b):c.uniform4f(e,b[0],b[1],b[2],b[3]);break;case c.SAMPLER_2D:c.activeTexture(c.TEXTURE0+d.samplerIndex),d.texture=this._renderer.getTexture(b),c.uniform1i(d.location,d.samplerIndex)}return this}},d.Shader.prototype.isLightShader=function(){return void 0!==this.uniforms.uUseLighting||void 0!==this.uniforms.uAmbientLightCount||void 0!==this.uniforms.uDirectionalLightCount||void 0!==this.uniforms.uPointLightCount||void 0!==this.uniforms.uAmbientColor||void 0!==this.uniforms.uDirectionalColor||void 0!==this.uniforms.uPointLightLocation||void 0!==this.uniforms.uPointLightColor||void 0!==this.uniforms.uLightingDirection||void 0!==this.uniforms.uSpecular},d.Shader.prototype.isTextureShader=function(){return this.samplerIndex>0},d.Shader.prototype.isColorShader=function(){return void 0!==this.attributes.aVertexColor||void 0!==this.uniforms.uMaterialColor},d.Shader.prototype.isTexLightShader=function(){return this.isLightShader()&&this.isTextureShader()},d.Shader.prototype.isStrokeShader=function(){return void 0!==this.uniforms.uStrokeWeight},d.Shader.prototype.enableAttrib=function(a,b,c,d,e,f){var g=this._renderer.GL;return a!==-1&&(g.enableVertexAttribArray(a),g.vertexAttribPointer(a,b,c,d,e,f)),this},b.exports=d.Shader},{"../core/core":55}],108:[function(a,b,c){var d=a("../core/core");d.Texture=function(a,b){this._renderer=a;var c=this._renderer.GL;this.src=b,this.glTex=void 0,this.glTarget=c.TEXTURE_2D,this.glFormat=c.RGBA,this.mipmaps=!1,this.glMinFilter=c.LINEAR,this.glMagFilter=c.LINEAR,this.glWrapS=c.CLAMP_TO_EDGE,this.glWrapT=c.CLAMP_TO_EDGE,this.isSrcMediaElement=void 0!==d.MediaElement&&b instanceof d.MediaElement,this._videoPrevUpdateTime=0,this.isSrcHTMLElement=void 0!==d.Element&&b instanceof d.Element,this.isSrcP5Image=b instanceof d.Image,this.isSrcP5Graphics=b instanceof d.Graphics;var e=this._getTextureDataFromSource();return this.height=e.width,this.width=e.height,this.init(e),this},d.Texture.prototype._getTextureDataFromSource=function(){var a;return this.isSrcP5Image?a=this.src.canvas:(this.isSrcMediaElement||this.isSrcP5Graphics||this.isSrcHTMLElement)&&(a=this.src.elt),a},d.Texture.prototype.init=function(a){var b=this._renderer.GL;if(this.glTex=b.createTexture(),this.bindTexture(),b.texParameteri(b.TEXTURE_2D,b.TEXTURE_MAG_FILTER,this.glMagFilter),b.texParameteri(b.TEXTURE_2D,b.TEXTURE_MIN_FILTER,this.glMinFilter),b.texParameteri(b.TEXTURE_2D,b.TEXTURE_WRAP_S,this.glWrapS),b.texParameteri(b.TEXTURE_2D,b.TEXTURE_WRAP_T,this.glWrapT),0===this.width||0===this.height||this.isSrcMediaElement&&!this.src.loadedmetadata){var c=new Uint8Array([1,1,1,1]);b.texImage2D(this.glTarget,0,b.RGBA,1,1,0,this.glFormat,b.UNSIGNED_BYTE,c)}else b.texImage2D(this.glTarget,0,this.glFormat,this.glFormat,b.UNSIGNED_BYTE,a)},d.Texture.prototype.update=function(){var a=this.src;if(0!==a.width&&0!==a.height){var b=this._getTextureDataFromSource(),c=this._renderer.GL;if(b.width!==this.width||b.height!==this.height)this.width=b.width,this.height=b.height,this.bindTexture(),c.texImage2D(this.glTarget,0,this.glFormat,this.glFormat,c.UNSIGNED_BYTE,b),this.isSrcP5Image?a.setModified(!1):(this.isSrcMediaElement||this.isSrcHTMLElement)&&a.setModified(!0);else if(this.isSrcP5Image)a.isModified()&&(this.bindTexture(),c.texImage2D(this.glTarget,0,this.glFormat,this.glFormat,c.UNSIGNED_BYTE,b),a.setModified(!1));else if(this.isSrcMediaElement){var d=!1;a.isModified()?(d=!0,a.setModified(!1)):a.loadedmetadata&&this._videoPrevUpdateTime!==a.time()&&(this._videoPrevUpdateTime=a.time(),d=!0),d&&(this.bindTexture(),c.texImage2D(this.glTarget,0,this.glFormat,this.glFormat,c.UNSIGNED_BYTE,b))}else c.texImage2D(this.glTarget,0,this.glFormat,this.glFormat,c.UNSIGNED_BYTE,b)}},d.Texture.prototype.bindTexture=function(){return this._renderer.GL.bindTexture(this.glTarget,this.glTex),this},d.Texture.prototype.unbindTexture=function(){this._renderer.GL.bindTexture(this.glTarget,null)},b.exports=d.Texture},{"../core/core":55}],109:[function(a,b,c){"use strict";var d=a("../core/core");a("./p5.Geometry"),d.prototype.plane=function(){for(var a=new Array(arguments.length),b=0;bf?(r=c,q=1,p=b):p=a+i/f*(b-a),i!==-2&&i!==f+2||(p=0,q=0),r-=c/2,j=0;jf?0:Math.sin(j*Math.PI*2/e)*Math.cos(m),i<0?-1:i>f?1:Math.sin(m),i<0||i>f?0:Math.cos(j*Math.PI*2/e)*Math.cos(m))),this.uvs.push([j/e,q])}for(i=0;i0)throw new Error("Invalid string. Length must be a multiple of 4");var k=a.length;i="="===a.charAt(k-2)?2:"="===a.charAt(k-1)?1:0,j=new e(3*a.length/4-i),g=i>0?a.length-4:a.length;var l=0;for(d=0,f=0;d>16),c((65280&h)>>8),c(255&h);return 2===i?(h=b(a.charAt(d))<<2|b(a.charAt(d+1))>>4,c(255&h)):1===i&&(h=b(a.charAt(d))<<10|b(a.charAt(d+1))<<4|b(a.charAt(d+2))>>2,c(h>>8&255),c(255&h)),j}function d(a){function b(a){return"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(a)}function c(a){return b(a>>18&63)+b(a>>12&63)+b(a>>6&63)+b(63&a)}var d,e,f,g=a.length%3,h="";for(d=0,f=a.length-g;d>2),h+=b(e<<4&63),h+="==";break;case 2:e=(a[a.length-2]<<8)+a[a.length-1],h+=b(e>>10),h+=b(e>>4&63),h+=b(e<<2&63),h+="="}return h}var e="undefined"!=typeof Uint8Array?Uint8Array:Array,f="+".charCodeAt(0),g="/".charCodeAt(0),h="0".charCodeAt(0),i="a".charCodeAt(0),j="A".charCodeAt(0),k="-".charCodeAt(0),l="_".charCodeAt(0);a.toByteArray=c,a.fromByteArray=d}(void 0===c?this.base64js={}:c)},{}],2:[function(a,b,c){},{}],3:[function(a,b,c){(function(b){"use strict";function d(){function a(){}try{var b=new Uint8Array(1);return b.foo=function(){return 42},b.constructor=a,42===b.foo()&&b.constructor===a&&"function"==typeof b.subarray&&0===b.subarray(1,1).byteLength}catch(a){return!1}}function e(){return f.TYPED_ARRAY_SUPPORT?2147483647:1073741823}function f(a){return this instanceof f?(f.TYPED_ARRAY_SUPPORT||(this.length=0,this.parent=void 0),"number"==typeof a?g(this,a):"string"==typeof a?h(this,a,arguments.length>1?arguments[1]:"utf8"):i(this,a)):arguments.length>1?new f(a,arguments[1]):new f(a)}function g(a,b){if(a=p(a,b<0?0:0|q(b)),!f.TYPED_ARRAY_SUPPORT)for(var c=0;c>>1&&(a.parent=Z),a}function q(a){if(a>=e())throw new RangeError("Attempt to allocate Buffer larger than maximum size: 0x"+e().toString(16)+" bytes");return 0|a}function r(a,b){if(!(this instanceof r))return new r(a,b);var c=new f(a,b);return delete c.parent,c}function s(a,b){"string"!=typeof a&&(a=""+a);var c=a.length;if(0===c)return 0;for(var d=!1;;)switch(b){case"ascii":case"binary":case"raw":case"raws":return c;case"utf8":case"utf-8":return R(a).length;case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return 2*c;case"hex":return c>>>1;case"base64":return U(a).length;default:if(d)return R(a).length;b=(""+b).toLowerCase(),d=!0}}function t(a,b,c){var d=!1;if(b|=0,c=void 0===c||c===1/0?this.length:0|c,a||(a="utf8"),b<0&&(b=0),c>this.length&&(c=this.length),c<=b)return"";for(;;)switch(a){case"hex":return F(this,b,c);case"utf8":case"utf-8":return B(this,b,c);case"ascii":return D(this,b,c);case"binary":return E(this,b,c);case"base64":return A(this,b,c);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return G(this,b,c);default:if(d)throw new TypeError("Unknown encoding: "+a);a=(a+"").toLowerCase(),d=!0}}function u(a,b,c,d){c=Number(c)||0;var e=a.length-c;d?(d=Number(d))>e&&(d=e):d=e;var f=b.length;if(f%2!=0)throw new Error("Invalid hex string");d>f/2&&(d=f/2);for(var g=0;g239?4:f>223?3:f>191?2:1;if(e+h<=c){var i,j,k,l;switch(h){case 1:f<128&&(g=f);break;case 2:i=a[e+1],128==(192&i)&&(l=(31&f)<<6|63&i)>127&&(g=l);break;case 3:i=a[e+1],j=a[e+2],128==(192&i)&&128==(192&j)&&(l=(15&f)<<12|(63&i)<<6|63&j)>2047&&(l<55296||l>57343)&&(g=l);break;case 4:i=a[e+1],j=a[e+2],k=a[e+3],128==(192&i)&&128==(192&j)&&128==(192&k)&&(l=(15&f)<<18|(63&i)<<12|(63&j)<<6|63&k)>65535&&l<1114112&&(g=l)}}null===g?(g=65533,h=1):g>65535&&(g-=65536,d.push(g>>>10&1023|55296),g=56320|1023&g),d.push(g),e+=h}return C(d)}function C(a){var b=a.length;if(b<=$)return String.fromCharCode.apply(String,a);for(var c="",d=0;dd)&&(c=d);for(var e="",f=b;fc)throw new RangeError("Trying to access beyond buffer length")}function I(a,b,c,d,e,g){if(!f.isBuffer(a))throw new TypeError("buffer must be a Buffer instance");if(b>e||ba.length)throw new RangeError("index out of range")}function J(a,b,c,d){b<0&&(b=65535+b+1);for(var e=0,f=Math.min(a.length-c,2);e>>8*(d?e:1-e)}function K(a,b,c,d){b<0&&(b=4294967295+b+1);for(var e=0,f=Math.min(a.length-c,4);e>>8*(d?e:3-e)&255}function L(a,b,c,d,e,f){if(b>e||ba.length)throw new RangeError("index out of range");if(c<0)throw new RangeError("index out of range")}function M(a,b,c,d,e){return e||L(a,b,c,4,3.4028234663852886e38,-3.4028234663852886e38),X.write(a,b,c,d,23,4),c+4}function N(a,b,c,d,e){return e||L(a,b,c,8,1.7976931348623157e308,-1.7976931348623157e308),X.write(a,b,c,d,52,8),c+8}function O(a){if(a=P(a).replace(aa,""),a.length<2)return"";for(;a.length%4!=0;)a+="=";return a}function P(a){return a.trim?a.trim():a.replace(/^\s+|\s+$/g,"")}function Q(a){return a<16?"0"+a.toString(16):a.toString(16)}function R(a,b){b=b||1/0;for(var c,d=a.length,e=null,f=[],g=0;g55295&&c<57344){if(!e){if(c>56319){(b-=3)>-1&&f.push(239,191,189);continue}if(g+1===d){(b-=3)>-1&&f.push(239,191,189);continue}e=c;continue}if(c<56320){(b-=3)>-1&&f.push(239,191,189),e=c;continue}c=65536+(e-55296<<10|c-56320)}else e&&(b-=3)>-1&&f.push(239,191,189);if(e=null,c<128){if((b-=1)<0)break;f.push(c)}else if(c<2048){if((b-=2)<0)break;f.push(c>>6|192,63&c|128)}else if(c<65536){if((b-=3)<0)break;f.push(c>>12|224,c>>6&63|128,63&c|128)}else{if(!(c<1114112))throw new Error("Invalid code point");if((b-=4)<0)break;f.push(c>>18|240,c>>12&63|128,c>>6&63|128,63&c|128)}}return f}function S(a){for(var b=[],c=0;c>8,e=c%256,f.push(e),f.push(d);return f}function U(a){return W.toByteArray(O(a))}function V(a,b,c,d){for(var e=0;e=b.length||e>=a.length);e++)b[e+c]=a[e];return e}var W=a("base64-js"),X=a("ieee754"),Y=a("isarray");c.Buffer=f,c.SlowBuffer=r,c.INSPECT_MAX_BYTES=50,f.poolSize=8192;var Z={};f.TYPED_ARRAY_SUPPORT=void 0!==b.TYPED_ARRAY_SUPPORT?b.TYPED_ARRAY_SUPPORT:d(),f.TYPED_ARRAY_SUPPORT?(f.prototype.__proto__=Uint8Array.prototype,f.__proto__=Uint8Array):(f.prototype.length=void 0,f.prototype.parent=void 0),f.isBuffer=function(a){return!(null==a||!a._isBuffer)},f.compare=function(a,b){if(!f.isBuffer(a)||!f.isBuffer(b))throw new TypeError("Arguments must be Buffers");if(a===b)return 0;for(var c=a.length,d=b.length,e=0,g=Math.min(c,d);e0&&(a=this.toString("hex",0,b).match(/.{2}/g).join(" "),this.length>b&&(a+=" ... ")),""},f.prototype.compare=function(a){if(!f.isBuffer(a))throw new TypeError("Argument must be a Buffer");return this===a?0:f.compare(this,a)},f.prototype.indexOf=function(a,b){function c(a,b,c){for(var d=-1,e=0;c+e2147483647?b=2147483647:b<-2147483648&&(b=-2147483648),b>>=0,0===this.length)return-1;if(b>=this.length)return-1;if(b<0&&(b=Math.max(this.length+b,0)),"string"==typeof a)return 0===a.length?-1:String.prototype.indexOf.call(this,a,b);if(f.isBuffer(a))return c(this,a,b);if("number"==typeof a)return f.TYPED_ARRAY_SUPPORT&&"function"===Uint8Array.prototype.indexOf?Uint8Array.prototype.indexOf.call(this,a,b):c(this,[a],b);throw new TypeError("val must be string, number or Buffer")},f.prototype.get=function(a){return console.log(".get() is deprecated. Access using array indexes instead."),this.readUInt8(a)},f.prototype.set=function(a,b){return console.log(".set() is deprecated. Access using array indexes instead."),this.writeUInt8(a,b)},f.prototype.write=function(a,b,c,d){if(void 0===b)d="utf8",c=this.length,b=0;else if(void 0===c&&"string"==typeof b)d=b,c=this.length,b=0;else if(isFinite(b))b|=0,isFinite(c)?(c|=0,void 0===d&&(d="utf8")):(d=c,c=void 0);else{var e=d;d=b,b=0|c,c=e}var f=this.length-b;if((void 0===c||c>f)&&(c=f),a.length>0&&(c<0||b<0)||b>this.length)throw new RangeError("attempt to write outside buffer bounds");d||(d="utf8");for(var g=!1;;)switch(d){case"hex":return u(this,a,b,c);case"utf8":case"utf-8":return v(this,a,b,c);case"ascii":return w(this,a,b,c);case"binary":return x(this,a,b,c);case"base64":return y(this,a,b,c);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return z(this,a,b,c);default:if(g)throw new TypeError("Unknown encoding: "+d);d=(""+d).toLowerCase(),g=!0}},f.prototype.toJSON=function(){return{type:"Buffer",data:Array.prototype.slice.call(this._arr||this,0)}};var $=4096;f.prototype.slice=function(a,b){var c=this.length;a=~~a,b=void 0===b?c:~~b,a<0?(a+=c)<0&&(a=0):a>c&&(a=c),b<0?(b+=c)<0&&(b=0):b>c&&(b=c),b0&&(e*=256);)d+=this[a+--b]*e;return d},f.prototype.readUInt8=function(a,b){return b||H(a,1,this.length),this[a]},f.prototype.readUInt16LE=function(a,b){return b||H(a,2,this.length),this[a]|this[a+1]<<8},f.prototype.readUInt16BE=function(a,b){return b||H(a,2,this.length),this[a]<<8|this[a+1]},f.prototype.readUInt32LE=function(a,b){return b||H(a,4,this.length),(this[a]|this[a+1]<<8|this[a+2]<<16)+16777216*this[a+3]},f.prototype.readUInt32BE=function(a,b){return b||H(a,4,this.length),16777216*this[a]+(this[a+1]<<16|this[a+2]<<8|this[a+3])},f.prototype.readIntLE=function(a,b,c){a|=0,b|=0,c||H(a,b,this.length);for(var d=this[a],e=1,f=0;++f=e&&(d-=Math.pow(2,8*b)),d},f.prototype.readIntBE=function(a,b,c){a|=0,b|=0,c||H(a,b,this.length);for(var d=b,e=1,f=this[a+--d];d>0&&(e*=256);)f+=this[a+--d]*e;return e*=128,f>=e&&(f-=Math.pow(2,8*b)),f},f.prototype.readInt8=function(a,b){return b||H(a,1,this.length),128&this[a]?-1*(255-this[a]+1):this[a]},f.prototype.readInt16LE=function(a,b){b||H(a,2,this.length);var c=this[a]|this[a+1]<<8;return 32768&c?4294901760|c:c},f.prototype.readInt16BE=function(a,b){b||H(a,2,this.length);var c=this[a+1]|this[a]<<8;return 32768&c?4294901760|c:c},f.prototype.readInt32LE=function(a,b){return b||H(a,4,this.length),this[a]|this[a+1]<<8|this[a+2]<<16|this[a+3]<<24},f.prototype.readInt32BE=function(a,b){return b||H(a,4,this.length),this[a]<<24|this[a+1]<<16|this[a+2]<<8|this[a+3]},f.prototype.readFloatLE=function(a,b){return b||H(a,4,this.length),X.read(this,a,!0,23,4)},f.prototype.readFloatBE=function(a,b){return b||H(a,4,this.length),X.read(this,a,!1,23,4)},f.prototype.readDoubleLE=function(a,b){return b||H(a,8,this.length),X.read(this,a,!0,52,8)},f.prototype.readDoubleBE=function(a,b){return b||H(a,8,this.length),X.read(this,a,!1,52,8)},f.prototype.writeUIntLE=function(a,b,c,d){a=+a,b|=0,c|=0,d||I(this,a,b,c,Math.pow(2,8*c),0);var e=1,f=0;for(this[b]=255&a;++f=0&&(f*=256);)this[b+e]=a/f&255;return b+c},f.prototype.writeUInt8=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,1,255,0),f.TYPED_ARRAY_SUPPORT||(a=Math.floor(a)),this[b]=255&a,b+1},f.prototype.writeUInt16LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,65535,0),f.TYPED_ARRAY_SUPPORT?(this[b]=255&a,this[b+1]=a>>>8):J(this,a,b,!0),b+2},f.prototype.writeUInt16BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,65535,0),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>8,this[b+1]=255&a):J(this,a,b,!1),b+2},f.prototype.writeUInt32LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,4294967295,0),f.TYPED_ARRAY_SUPPORT?(this[b+3]=a>>>24,this[b+2]=a>>>16,this[b+1]=a>>>8,this[b]=255&a):K(this,a,b,!0),b+4},f.prototype.writeUInt32BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,4294967295,0),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>24,this[b+1]=a>>>16,this[b+2]=a>>>8,this[b+3]=255&a):K(this,a,b,!1),b+4},f.prototype.writeIntLE=function(a,b,c,d){if(a=+a,b|=0,!d){var e=Math.pow(2,8*c-1);I(this,a,b,c,e-1,-e)}var f=0,g=1,h=a<0?1:0;for(this[b]=255&a;++f>0)-h&255;return b+c},f.prototype.writeIntBE=function(a,b,c,d){if(a=+a,b|=0,!d){var e=Math.pow(2,8*c-1);I(this,a,b,c,e-1,-e)}var f=c-1,g=1,h=a<0?1:0;for(this[b+f]=255&a;--f>=0&&(g*=256);)this[b+f]=(a/g>>0)-h&255;return b+c},f.prototype.writeInt8=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,1,127,-128),f.TYPED_ARRAY_SUPPORT||(a=Math.floor(a)),a<0&&(a=255+a+1),this[b]=255&a,b+1},f.prototype.writeInt16LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,32767,-32768),f.TYPED_ARRAY_SUPPORT?(this[b]=255&a,this[b+1]=a>>>8):J(this,a,b,!0),b+2},f.prototype.writeInt16BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,2,32767,-32768),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>8,this[b+1]=255&a):J(this,a,b,!1),b+2},f.prototype.writeInt32LE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,2147483647,-2147483648),f.TYPED_ARRAY_SUPPORT?(this[b]=255&a,this[b+1]=a>>>8,this[b+2]=a>>>16,this[b+3]=a>>>24):K(this,a,b,!0),b+4},f.prototype.writeInt32BE=function(a,b,c){return a=+a,b|=0,c||I(this,a,b,4,2147483647,-2147483648),a<0&&(a=4294967295+a+1),f.TYPED_ARRAY_SUPPORT?(this[b]=a>>>24,this[b+1]=a>>>16,this[b+2]=a>>>8,this[b+3]=255&a):K(this,a,b,!1),b+4},f.prototype.writeFloatLE=function(a,b,c){return M(this,a,b,!0,c)},f.prototype.writeFloatBE=function(a,b,c){return M(this,a,b,!1,c)},f.prototype.writeDoubleLE=function(a,b,c){return N(this,a,b,!0,c)},f.prototype.writeDoubleBE=function(a,b,c){return N(this,a,b,!1,c)},f.prototype.copy=function(a,b,c,d){if(c||(c=0),d||0===d||(d=this.length),b>=a.length&&(b=a.length),b||(b=0),d>0&&d=this.length)throw new RangeError("sourceStart out of bounds");if(d<0)throw new RangeError("sourceEnd out of bounds");d>this.length&&(d=this.length),a.length-b=0;e--)a[e+b]=this[e+c];else if(g<1e3||!f.TYPED_ARRAY_SUPPORT)for(e=0;e=this.length)throw new RangeError("start out of bounds");if(c<0||c>this.length)throw new RangeError("end out of bounds");var d;if("number"==typeof a)for(d=b;d>1,k=-7,l=c?e-1:0,m=c?-1:1,n=a[b+l];for(l+=m,f=n&(1<<-k)-1,n>>=-k,k+=h;k>0;f=256*f+a[b+l],l+=m,k-=8);for(g=f&(1<<-k)-1,f>>=-k,k+=d;k>0;g=256*g+a[b+l],l+=m,k-=8);if(0===f)f=1-j;else{if(f===i)return g?NaN:1/0*(n?-1:1);g+=Math.pow(2,d),f-=j}return(n?-1:1)*g*Math.pow(2,f-d)},c.write=function(a,b,c,d,e,f){var g,h,i,j=8*f-e-1,k=(1<>1,m=23===e?Math.pow(2,-24)-Math.pow(2,-77):0,n=d?0:f-1,o=d?1:-1,p=b<0||0===b&&1/b<0?1:0;for(b=Math.abs(b),isNaN(b)||b===1/0?(h=isNaN(b)?1:0,g=k):(g=Math.floor(Math.log(b)/Math.LN2),b*(i=Math.pow(2,-g))<1&&(g--,i*=2),b+=g+l>=1?m/i:m*Math.pow(2,1-l),b*i>=2&&(g++,i/=2),g+l>=k?(h=0,g=k):g+l>=1?(h=(b*i-1)*Math.pow(2,e),g+=l):(h=b*Math.pow(2,l-1)*Math.pow(2,e),g=0));e>=8;a[c+n]=255&h,n+=o,h/=256,e-=8);for(g=g<0;a[c+n]=255&g,n+=o,g/=256,j-=8);a[c+n-o]|=128*p}},{}],8:[function(a,b,c){var d={}.toString;b.exports=Array.isArray||function(a){return"[object Array]"==d.call(a)}},{}],9:[function(a,b,c){"use strict";function d(a,b){return a.b===b.b&&a.a===b.a}function e(a,b){return a.ba?0:a,c=0>c?0:c,a<=c?0===c?(b+d)/2:b+a/(a+c)*(d-b):d+c/(a+c)*(b-d)}function n(a){var b=s(a.b);return u(b,a.c),u(b.b,a.c),v(b,a.a),b}function o(a,b){var c=!1,d=!1;a!==b&&(b.a!==a.a&&(d=!0,x(b.a,a.a)),b.d!==a.d&&(c=!0,y(b.d,a.d)),t(b,a),d||(u(b,a.a),a.a.c=a),c||(v(b,a.d),a.d.a=a))}function p(a){var b=a.b,c=!1;a.d!==a.b.d&&(c=!0,y(a.d,a.b.d)),a.c===a?x(a.a,null):(a.b.d.a=$(a),a.a.c=a.c,t(a,$(a)),c||v(a,a.d)),b.c===b?(x(b.a,null),y(b.d,null)):(a.d.a=$(b),b.a.c=b.c,t(b,$(b))),w(a)}function q(a){var b=s(a),c=b.b;return t(b,a.e),b.a=a.b.a,u(c,b.a),b.d=c.d=a.d,b=b.b,t(a.b,$(a.b)),t(a.b,b),a.b.a=b.a,b.b.a.c=b.b,b.b.d=a.b.d,b.f=a.f,b.b.f=a.b.f,b}function r(a,b){var c=!1,d=s(a),e=d.b;return b.d!==a.d&&(c=!0,y(b.d,a.d)),t(d,a.e),t(e,b),d.a=a.b.a,e.a=b.a,d.d=e.d=a.d,a.d.a=e,c||v(d,a.d),d}function s(a){var b=new Z,c=new Z,d=a.b.h;return c.h=d,d.b.h=b,b.h=a,a.b.h=c,b.b=c,b.c=b,b.e=c,c.b=b,c.c=c,c.e=b}function t(a,b){var c=a.c,d=b.c;c.b.e=b,d.b.e=a,a.c=d,b.c=c}function u(a,b){var c=b.f,d=new aa(b,c);c.e=d,b.f=d,c=d.c=a;do{c.a=d,c=c.c}while(c!==a)}function v(a,b){var c=b.d,d=new Y(b,c);c.b=d,b.d=d,d.a=a,d.c=b.c,c=a;do{c.d=d,c=c.e}while(c!==a)}function w(a){var b=a.h;a=a.b.h,b.b.h=a,a.b.h=b}function x(a,b){var c=a.c,d=c;do{d.a=b,d=d.c}while(d!==c);c=a.f,d=a.e,d.f=c,c.e=d}function y(a,b){var c=a.a,d=c;do{d.d=b,d=d.e}while(d!==c);c=a.d,d=a.b,d.d=c,c.b=d}function z(a){var b=0;return Math.abs(a[1])>Math.abs(a[0])&&(b=1),Math.abs(a[2])>Math.abs(a[b])&&(b=2),b}function A(a,b){a.f+=b.f,a.b.f+=b.b.f}function B(a,b,c){return a=a.a,b=b.a,c=c.a,b.b.a===a?c.b.a===a?e(b.a,c.a)?0>=g(c.b.a,b.a,c.a):0<=g(b.b.a,c.a,b.a):0>=g(c.b.a,a,c.a):c.b.a===a?0<=g(b.b.a,a,b.a):(b=f(b.b.a,a,b.a),a=f(c.b.a,a,c.a),b>=a)}function C(a){a.a.i=null;var b=a.e;b.a.c=b.c,b.c.a=b.a,a.e=null}function D(a,b){p(a.a),a.c=!1,a.a=b,b.i=a}function E(a){var b=a.a.a;do{a=oa(a)}while(a.a.a===b);return a.c&&(b=r(na(a).a.b,a.a.e),D(a,b),a=oa(a)),a}function F(a,b,c){var d=new ma;return d.a=c,d.e=T(a.f,b.e,d),c.i=d}function G(a,b){switch(a.s){case 100130:return 0!=(1&b);case 100131:return 0!==b;case 100132:return 0b;case 100134:return 2<=b||-2>=b}return!1}function H(a){var b=a.a,c=b.d;c.c=a.d,c.a=b,C(a)}function I(a,b,c){for(a=b,b=b.a;a!==c;){a.c=!1;var d=na(a),e=d.a;if(e.a!==b.a){if(!d.c){H(a);break}e=r(b.c.b,e.b),D(d,e)}b.c!==e&&(o($(e),e),o(b,e)),H(a),b=d.a,a=d}return b}function J(a,b,c,d,e,f){var g=!0;do{F(a,b,c.b),c=c.c}while(c!==d);for(null===e&&(e=na(b).a.b.c);d=na(b),c=d.a.b,c.a===e.a;)c.c!==e&&(o($(c),c),o($(e),c)),d.f=b.f-c.f,d.d=G(a,d.f),b.b=!0,!g&&N(a,b)&&(A(c,e),C(b),p(e)),g=!1,b=d,e=c;b.b=!0,f&&P(a,b)}function K(a,b,c,d,e){var f=[b.g[0],b.g[1],b.g[2]];b.d=null,b.d=a.o?a.o(f,c,d,a.c)||null:null,null===b.d&&(e?a.n||(X(a,100156),a.n=!0):b.d=c[0])}function L(a,b,c){var d=[null,null,null,null];d[0]=b.a.d,d[1]=c.a.d,K(a,b.a,d,[.5,.5,0,0],!1),o(b,c)}function M(a,b,c,d,e){var f=Math.abs(b.b-a.b)+Math.abs(b.a-a.a),g=Math.abs(c.b-a.b)+Math.abs(c.a-a.a),h=e+1;d[e]=.5*g/(f+g),d[h]=.5*f/(f+g),a.g[0]+=d[e]*b.g[0]+d[h]*c.g[0],a.g[1]+=d[e]*b.g[1]+d[h]*c.g[1],a.g[2]+=d[e]*b.g[2]+d[h]*c.g[2]}function N(a,b){var c=na(b),f=b.a,h=c.a;if(e(f.a,h.a)){if(0=m?ka(c,m):e(k[j[m>>1]],k[j[m]])?ka(c,m):la(c,m)),k[i]=null,l[i]=c.b,c.b=i}else for(c.c[-(i+1)]=null;0g(f.b.a,h.a,f.a))return!1;oa(b).b=b.b=!0,q(f.b),o($(h),f)}return!0}function O(a,b){var c=na(b),k=b.a,l=c.a,n=k.a,p=l.a,r=k.b.a,s=l.b.a,t=new aa;if(g(r,a.a,n),g(s,a.a,p),n===p||Math.min(n.a,r.a)>Math.max(p.a,s.a))return!1;if(e(n,p)){if(0g(r,p,n))return!1;var u,v,w=r,x=n,y=s,z=p;if(e(w,x)||(u=w,w=x,x=u),e(y,z)||(u=y,y=z,z=u),e(w,y)||(u=w,w=y,y=u,u=x,x=z,z=u),e(y,x)?e(x,z)?(u=f(w,y,x),v=f(y,x,z),0>u+v&&(u=-u,v=-v),t.b=m(u,y.b,v,x.b)):(u=g(w,y,x),v=-g(w,z,x),0>u+v&&(u=-u,v=-v),t.b=m(u,y.b,v,z.b)):t.b=(y.b+x.b)/2,h(w,x)||(u=w,w=x,x=u),h(y,z)||(u=y,y=z,z=u),h(w,y)||(u=w,w=y,y=u,u=x,x=z,z=u),h(y,x)?h(x,z)?(u=i(w,y,x),v=i(y,x,z),0>u+v&&(u=-u,v=-v),t.a=m(u,y.a,v,x.a)):(u=j(w,y,x),v=-j(w,z,x),0>u+v&&(u=-u,v=-v),t.a=m(u,y.a,v,z.a)):t.a=(y.a+x.a)/2,e(t,a.a)&&(t.b=a.a.b,t.a=a.a.a),w=e(n,p)?n:p,e(w,t)&&(t.b=w.b,t.a=w.a),d(t,n)||d(t,p))return N(a,b),!1;if(!d(r,a.a)&&0<=g(r,a.a,t)||!d(s,a.a)&&0>=g(s,a.a,t)){if(s===a.a)return q(k.b),o(l.b,k),b=E(b),k=na(b).a,I(a,na(b),c),J(a,b,$(k),k,k,!0),!0;if(r===a.a){q(l.b),o(k.e,$(l)),n=c=b,p=n.a.b.a;do{n=oa(n)}while(n.a.b.a===p);return b=n,n=na(b).a.b.c,c.a=$(l),l=I(a,c,null),J(a,b,l.c,k.b.c,n,!0),!0}return 0<=g(r,a.a,t)&&(oa(b).b=b.b=!0,q(k.b),k.a.b=a.a.b,k.a.a=a.a.a),0>=g(s,a.a,t)&&(b.b=c.b=!0,q(l.b),l.a.b=a.a.b,l.a.a=a.a.a),!1}return q(k.b),q(l.b),o($(l),k),k.a.b=t.b,k.a.a=t.a,k.a.h=da(a.e,k.a),k=k.a,l=[0,0,0,0],t=[n.d,r.d,p.d,s.d],k.g[0]=k.g[1]=k.g[2]=0,M(k,n,r,l,0),M(k,p,s,l,2),K(a,k,t,l,!0),oa(b).b=b.b=c.b=!0,!1}function P(a,b){for(var c=na(b);;){for(;c.b;)b=c,c=na(c);if(!b.b&&(c=b,null===(b=oa(b))||!b.b))break;b.b=!1;var d,f=b.a,h=c.a;if(d=f.b.a!==h.b.a)a:{d=b;var i=na(d),j=d.a,k=i.a,l=void 0;if(e(j.b.a,k.b.a)){if(0>g(j.b.a,k.b.a,j.a)){d=!1;break a}oa(d).b=d.b=!0,l=q(j),o(k.b,l),l.d.c=d.d}else{if(0c.f&&(c.f*=2,c.c=ga(c.c,c.f+1));var e;return 0===c.b?e=d:(e=c.b,c.b=c.c[c.b]),c.e[e]=b,c.c[e]=d,c.d[d]=e,c.h&&la(c,d),e}return c=a.a++,a.c[c]=b,-(c+1)}function ea(a){if(0===a.a)return ja(a.b);var b=a.c[a.d[a.a-1]];if(0!==a.b.a&&e(ia(a.b),b))return ja(a.b);do{--a.a}while(0a.a||e(d[h],d[j])){c[g]=h,f[h]=g;break}c[g]=j,f[j]=g,g=i}}function la(a,b){for(var c=a.d,d=a.e,f=a.c,g=b,h=c[g];;){var i=g>>1,j=c[i];if(0===i||e(d[j],d[h])){c[g]=h,f[h]=g;break}c[g]=j,f[j]=g,g=i}}function ma(){this.e=this.a=null,this.f=0,this.c=this.b=this.h=this.d=!1}function na(a){return a.e.c.b}function oa(a){return a.e.a.b}var pa,qa=4e150,ra=0;pa=V.prototype,pa.x=function(){W(this,ra)},pa.B=function(a,b){switch(a){case 100142:return;case 100140:switch(b){case 100130:case 100131:case 100132:case 100133:case 100134:return void(this.s=b)}break;case 100141:return void(this.m=!!b);default:return void X(this,100900)}X(this,100901)},pa.y=function(a){switch(a){case 100142:return 0;case 100140:return this.s;case 100141:return this.m;default:X(this,100900)}return!1},pa.A=function(a,b,c){this.j[0]=a,this.j[1]=b,this.j[2]=c},pa.z=function(a,b){var c=b||null;switch(a){case 100100:case 100106:this.h=c;break;case 100104:case 100110:this.l=c;break;case 100101:case 100107:this.k=c;break;case 100102:case 100108:this.i=c;break;case 100103:case 100109:this.p=c;break;case 100105:case 100111:this.o=c;break;case 100112:this.r=c;break;default:X(this,100900)}},pa.C=function(a,b){var c=!1,d=[0,0,0];W(this,2);for(var e=0;3>e;++e){var f=a[e];-1e150>f&&(f=-1e150,c=!0),1e150m;++m){var n=a.g[m];nb[m]&&(b[m]=n,c[m]=a)}if(a=0,b[1]-i[1]>b[0]-i[0]&&(a=1),b[2]-i[2]>b[a]-i[a]&&(a=2),i[a]>=b[a])h[0]=0,h[1]=0,h[2]=1;else{for(b=0,i=j[a],c=c[a],j=[0,0,0],i=[i.g[0]-c.g[0],i.g[1]-c.g[1],i.g[2]-c.g[2]],m=[0,0,0],a=f.e;a!==f;a=a.e)m[0]=a.g[0]-c.g[0],m[1]=a.g[1]-c.g[1],m[2]=a.g[2]-c.g[2],j[0]=i[1]*m[2]-i[2]*m[1],j[1]=i[2]*m[0]-i[0]*m[2],j[2]=i[0]*m[1]-i[1]*m[0],(n=j[0]*j[0]+j[1]*j[1]+j[2]*j[2])>b&&(b=n,h[0]=j[0],h[1]=j[1],h[2]=j[2]);0>=b&&(h[0]=h[1]=h[2]=0,h[z(i)]=1)}f=!0}for(j=z(h),a=this.b.c,b=(j+1)%3,c=(j+2)%3,j=0=b.f))do{h+=(b.a.b-b.b.a.b)*(b.a.a+b.b.a.a),b=b.e}while(b!==a.a);if(0>h)for(h=this.b.c,f=h.e;f!==h;f=f.e)f.a=-f.a}for(this.n=!1,h=this.b.b,a=h.h;a!==h;a=f)f=a.h,b=a.e,d(a.a,a.b.a)&&a.e.e!==a&&(L(this,b,a),p(a),a=b,b=a.e),b.e===a&&(b!==a&&(b!==f&&b!==f.b||(f=f.h),p(b)),a!==f&&a!==f.b||(f=f.h),p(a));for(this.e=h=new ba,f=this.b.c,a=f.e;a!==f;a=a.e)a.h=da(h,a);for(ca(h),this.f=new S(this),R(this,-qa),R(this,qa);null!==(h=ea(this.e));){for(;;){a:if(a=this.e,0===a.a)f=ia(a.b);else if(f=a.c[a.d[a.a-1]],0!==a.b.a&&(a=ia(a.b),e(a,f))){f=a;break a}if(null===f||!d(f,h))break;f=ea(this.e),L(this,h.c,f.c)}Q(this,h)}for(this.a=this.f.a.a.b.a.a,h=0;null!==(f=this.f.a.a.b);)f.h||++h,C(f);for(this.f=null,h=this.e,h.b=null,h.d=null,this.e=h.c=null,h=this.b,a=h.a.b;a!==h.a;a=f)f=a.b,a=a.a,a.e.e===a&&(A(a.c,a),p(a));if(!this.n){if(h=this.b,this.m)for(a=h.b.h;a!==h.b;a=f)f=a.h,a.b.d.c!==a.d.c?a.f=a.d.c?1:-1:p(a);else for(a=h.a.b;a!==h.a;a=f)if(f=a.b,a.c){for(a=a.a;e(a.b.a,a.a);a=a.c.b);for(;e(a.a,a.b.a);a=a.e);for(b=a.c.b,c=void 0;a.e!==b;)if(e(a.b.a,b.a)){for(;b.e!==a&&(k(b.e)||0>=g(b.a,b.b.a,b.e.b.a));)c=r(b.e,b),b=c.b;b=b.c.b}else{for(;b.e!==a&&(l(a.c.b)||0<=g(a.b.a,a.a,a.c.b.a));)c=r(a,a.c.b),a=c.b;a=a.e}for(;b.e.e!==a;)c=r(b.e,b),b=c.b}if(this.h||this.i||this.k||this.l)if(this.m){for(h=this.b,f=h.a.b;f!==h.a;f=f.b)if(f.c){this.h&&this.h(2,this.c),a=f.a;do{this.k&&this.k(a.a.d,this.c),a=a.e}while(a!==f.a);this.i&&this.i(this.c)}}else{for(h=this.b,f=!!this.l,a=!1,b=-1,c=h.a.d;c!==h.a;c=c.d)if(c.c){a||(this.h&&this.h(4,this.c),a=!0),j=c.a;do{f&&(i=j.b.d.c?0:1,b!==i&&(b=i,this.l&&this.l(!!b,this.c))),this.k&&this.k(j.a.d,this.c),j=j.e}while(j!==c.a)}a&&this.i&&this.i(this.c)}if(this.r){for(h=this.b,a=h.a.b;a!==h.a;a=f)if(f=a.b,!a.c){b=a.a,c=b.e,j=void 0;do{j=c,c=j.e,j.d=null,null===j.b.d&&(j.c===j?x(j.a,null):(j.a.c=j.c,t(j,$(j))),i=j.b,i.c===i?x(i.a,null):(i.a.c=i.c,t(i,$(i))),w(j))}while(j!==b);b=a.d,a=a.b,a.d=b,b.b=a}return this.r(this.b),void(this.c=this.b=null)}}this.b=this.c=null},this.libtess={GluTesselator:V,windingRule:{GLU_TESS_WINDING_ODD:100130,GLU_TESS_WINDING_NONZERO:100131,GLU_TESS_WINDING_POSITIVE:100132,GLU_TESS_WINDING_NEGATIVE:100133,GLU_TESS_WINDING_ABS_GEQ_TWO:100134},primitiveType:{GL_LINE_LOOP:2,GL_TRIANGLES:4,GL_TRIANGLE_STRIP:5,GL_TRIANGLE_FAN:6},errorType:{GLU_TESS_MISSING_BEGIN_POLYGON:100151,GLU_TESS_MISSING_END_POLYGON:100153,GLU_TESS_MISSING_BEGIN_CONTOUR:100152,GLU_TESS_MISSING_END_CONTOUR:100154,GLU_TESS_COORD_TOO_LARGE:100155,GLU_TESS_NEED_COMBINE_CALLBACK:100156},gluEnum:{GLU_TESS_MESH:100112,GLU_TESS_TOLERANCE:100142,GLU_TESS_WINDING_RULE:100140,GLU_TESS_BOUNDARY_ONLY:100141,GLU_INVALID_ENUM:100900,GLU_INVALID_VALUE:100901,GLU_TESS_BEGIN:100100,GLU_TESS_VERTEX:100101,GLU_TESS_END:100102,GLU_TESS_ERROR:100103,GLU_TESS_EDGE_FLAG:100104,GLU_TESS_COMBINE:100105,GLU_TESS_BEGIN_DATA:100106,GLU_TESS_VERTEX_DATA:100107,GLU_TESS_END_DATA:100108,GLU_TESS_ERROR_DATA:100109,GLU_TESS_EDGE_FLAG_DATA:100110,GLU_TESS_COMBINE_DATA:100111}},V.prototype.gluDeleteTess=V.prototype.x,V.prototype.gluTessProperty=V.prototype.B,V.prototype.gluGetTessProperty=V.prototype.y,V.prototype.gluTessNormal=V.prototype.A,V.prototype.gluTessCallback=V.prototype.z,V.prototype.gluTessVertex=V.prototype.C,V.prototype.gluTessBeginPolygon=V.prototype.u,V.prototype.gluTessBeginContour=V.prototype.t,V.prototype.gluTessEndContour=V.prototype.v,V.prototype.gluTessEndPolygon=V.prototype.w,void 0!==b&&(b.exports=this.libtess)},{}],10:[function(b,c,d){(function(e){!function(b,e){"object"==typeof d&&void 0!==c?e(d):"function"==typeof a&&a.amd?a(["exports"],e):e(b.opentype={})}(this,function(a){"use strict";function c(){this.table=new Uint16Array(16),this.trans=new Uint16Array(288)}function d(a,b){this.source=a,this.sourceIndex=0,this.tag=0,this.bitcount=0,this.dest=b,this.destLen=0,this.ltree=new c,this.dtree=new c}function f(a,b,c,d){var e,f;for(e=0;e>>=1,b}function j(a,b,c){if(!b)return c;for(;a.bitcount<24;)a.tag|=a.source[a.sourceIndex++]<>>16-b;return a.tag>>>=b,a.bitcount-=b,d+c}function k(a,b){for(;a.bitcount<24;)a.tag|=a.source[a.sourceIndex++]<>>=1,++e,c+=b.table[e],d-=b.table[e]}while(d>=0);return a.tag=f,a.bitcount-=e,b.trans[c+d]}function l(a,b,c){var d,e,f,g,i,l;for(d=j(a,5,257),e=j(a,5,1),f=j(a,4,4),g=0;g<19;++g)ue[g]=0;for(g=0;g8;)a.sourceIndex--,a.bitcount-=8;if(b=a.source[a.sourceIndex+1],b=256*b+a.source[a.sourceIndex],c=a.source[a.sourceIndex+3],c=256*c+a.source[a.sourceIndex+2],b!==(65535&~c))return le;for(a.sourceIndex+=4,d=b;d;--d)a.dest[a.destLen++]=a.source[a.sourceIndex++];return a.bitcount=0,ke}function o(a,b){var c,e,f=new d(a,b);do{switch(c=i(f),j(f,2,0)){case 0:e=n(f);break;case 1:e=m(f,me,ne);break;case 2:l(f,f.ltree,f.dtree),e=m(f,f.ltree,f.dtree);break;default:e=le}if(e!==ke)throw new Error("Data error")}while(!c);return f.destLen=-128&&a<=127}function w(a,b,c){for(var d=0,e=a.length;b>8&255,i+256&255)}return f}function z(a,b,c){for(var d=this,e=0;e>1,b.skip("uShort",3),a.glyphIndexMap={};for(var g=new Le.Parser(c,d+e+14),h=new Le.Parser(c,d+e+16+2*f),i=new Le.Parser(c,d+e+16+4*f),j=new Le.Parser(c,d+e+16+6*f),k=d+e+16+8*f,l=0;l=0;e-=1){var f=Le.getUShort(a,b+4+8*e),g=Le.getUShort(a,b+4+8*e+2);if(3===f&&(0===g||1===g||10===g)||0===f&&(0===g||1===g||2===g||3===g||4===g)){d=Le.getULong(a,b+4+8*e+4);break}}if(-1===d)throw new Error("No valid cmap sub-tables found.");var h=new Le.Parser(a,b+d);if(c.format=h.parseUShort(),12===c.format)R(c,h);else{if(4!==c.format)throw new Error("Only format 4 and 12 cmap tables are supported (found format "+c.format+").");S(c,h,a,b,d)}return c}function U(a,b,c){a.segments.push({end:b,start:b,delta:-(b-c),offset:0,glyphIndex:c})}function V(a){a.segments.push({end:65535,start:65535,delta:1,offset:0})}function W(a){var b,c=!0;for(b=a.length-1;b>0;b-=1){if(a.get(b).unicode>65535){console.log("Adding CMAP format 12 (needed!)"),c=!1;break}}var d=[{name:"version",type:"USHORT",value:0},{name:"numTables",type:"USHORT",value:c?1:2},{name:"platformID",type:"USHORT",value:3},{name:"encodingID",type:"USHORT",value:1},{name:"offset",type:"ULONG",value:c?12:20}];c||(d=d.concat([{name:"cmap12PlatformID",type:"USHORT",value:3},{name:"cmap12EncodingID",type:"USHORT",value:10},{name:"cmap12Offset",type:"ULONG",value:0}])),d=d.concat([{name:"format",type:"USHORT",value:4},{name:"cmap4Length",type:"USHORT",value:0},{name:"language",type:"USHORT",value:0},{name:"segCountX2",type:"USHORT",value:0},{name:"searchRange",type:"USHORT",value:0},{name:"entrySelector",type:"USHORT",value:0},{name:"rangeShift",type:"USHORT",value:0}]);var e=new Ie.Table("cmap",d);for(e.segments=[],b=0;b>4,g=15&e;if(f===c)break;if(b+=d[f],g===c)break;b+=d[g]}return parseFloat(b)}function ma(a,b){var c,d,e,f;if(28===b)return c=a.parseByte(),d=a.parseByte(),c<<8|d;if(29===b)return c=a.parseByte(),d=a.parseByte(),e=a.parseByte(),f=a.parseByte(),c<<24|d<<16|e<<8|f;if(30===b)return la(a);if(b>=32&&b<=246)return b-139;if(b>=247&&b<=250)return c=a.parseByte(),256*(b-247)+c+108;if(b>=251&&b<=254)return c=a.parseByte(),256*-(b-251)-c-108;throw new Error("Invalid b0 "+b)}function na(a){for(var b={},c=0;c>1,p.length=0,s=!0}function f(c){for(var m,r,w,x,z,A,B,C,D,E,F,G,H=0;H1&&!s&&(y=p.shift()+n,s=!0),v+=p.pop(),d(u,v);break;case 5:for(;p.length>0;)u+=p.shift(),v+=p.shift(),o.lineTo(u,v);break;case 6:for(;p.length>0&&(u+=p.shift(),o.lineTo(u,v),0!==p.length);)v+=p.shift(),o.lineTo(u,v);break;case 7:for(;p.length>0&&(v+=p.shift(),o.lineTo(u,v),0!==p.length);)u+=p.shift(),o.lineTo(u,v);break;case 8:for(;p.length>0;)g=u+p.shift(),h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),
+u=i+p.shift(),v=j+p.shift(),o.curveTo(g,h,i,j,u,v);break;case 10:z=p.pop()+l,A=k[z],A&&f(A);break;case 11:return;case 12:switch(I=c[H],H+=1,I){case 35:g=u+p.shift(),h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j+p.shift(),D=B+p.shift(),E=C+p.shift(),F=D+p.shift(),G=E+p.shift(),u=F+p.shift(),v=G+p.shift(),p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,u,v);break;case 34:g=u+p.shift(),h=v,i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j,D=B+p.shift(),E=j,F=D+p.shift(),G=v,u=F+p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,u,v);break;case 36:g=u+p.shift(),h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j,D=B+p.shift(),E=j,F=D+p.shift(),G=E+p.shift(),u=F+p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,u,v);break;case 37:g=u+p.shift(),h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),B=i+p.shift(),C=j+p.shift(),D=B+p.shift(),E=C+p.shift(),F=D+p.shift(),G=E+p.shift(),Math.abs(F-u)>Math.abs(G-v)?u=F+p.shift():v=G+p.shift(),o.curveTo(g,h,i,j,B,C),o.curveTo(D,E,F,G,u,v);break;default:console.log("Glyph "+b.index+": unknown operator 1200"+I),p.length=0}break;case 14:p.length>0&&!s&&(y=p.shift()+n,s=!0),t&&(o.closePath(),t=!1);break;case 18:e();break;case 19:case 20:e(),H+=q+7>>3;break;case 21:p.length>2&&!s&&(y=p.shift()+n,s=!0),v+=p.pop(),u+=p.pop(),d(u,v);break;case 22:p.length>1&&!s&&(y=p.shift()+n,s=!0),u+=p.pop(),d(u,v);break;case 23:e();break;case 24:for(;p.length>2;)g=u+p.shift(),h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),u=i+p.shift(),v=j+p.shift(),o.curveTo(g,h,i,j,u,v);u+=p.shift(),v+=p.shift(),o.lineTo(u,v);break;case 25:for(;p.length>6;)u+=p.shift(),v+=p.shift(),o.lineTo(u,v);g=u+p.shift(),h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),u=i+p.shift(),v=j+p.shift(),o.curveTo(g,h,i,j,u,v);break;case 26:for(p.length%2&&(u+=p.shift());p.length>0;)g=u,h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),u=i,v=j+p.shift(),o.curveTo(g,h,i,j,u,v);break;case 27:for(p.length%2&&(v+=p.shift());p.length>0;)g=u+p.shift(),h=v,i=g+p.shift(),j=h+p.shift(),u=i+p.shift(),v=j,o.curveTo(g,h,i,j,u,v);break;case 28:m=c[H],r=c[H+1],p.push((m<<24|r<<16)>>16),H+=2;break;case 29:z=p.pop()+a.gsubrsBias,A=a.gsubrs[z],A&&f(A);break;case 30:for(;p.length>0&&(g=u,h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),u=i+p.shift(),v=j+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,u,v),0!==p.length);)g=u+p.shift(),h=v,i=g+p.shift(),j=h+p.shift(),v=j+p.shift(),u=i+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,u,v);break;case 31:for(;p.length>0&&(g=u+p.shift(),h=v,i=g+p.shift(),j=h+p.shift(),v=j+p.shift(),u=i+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,u,v),0!==p.length);)g=u,h=v+p.shift(),i=g+p.shift(),j=h+p.shift(),u=i+p.shift(),v=j+(1===p.length?p.shift():0),o.curveTo(g,h,i,j,u,v);break;default:I<32?console.log("Glyph "+b.index+": unknown operator "+I):I<247?p.push(I-139):I<251?(m=c[H],H+=1,p.push(256*(I-247)+m+108)):I<255?(m=c[H],H+=1,p.push(256*-(I-251)-m-108)):(m=c[H],r=c[H+1],w=c[H+2],x=c[H+3],H+=4,p.push((m<<24|r<<16|w<<8|x)/65536))}}}var g,h,i,j,k,l,m,n,o=new r,p=[],q=0,s=!1,t=!1,u=0,v=0;if(a.isCIDFont){var w=a.tables.cff.topDict._fdSelect[b.index],x=a.tables.cff.topDict._fdArray[w];k=x._subrs,l=x._subrsBias,m=x._defaultWidthX,n=x._nominalWidthX}else k=a.tables.cff.topDict._subrs,l=a.tables.cff.topDict._subrsBias,m=a.tables.cff.topDict._defaultWidthX,n=a.tables.cff.topDict._nominalWidthX;var y=m;return f(c),b.advanceWidth=y,o}function ya(a,b,c,d){var e,f=[],g=new Le.Parser(a,b),h=g.parseCard8();if(0===h)for(var i=0;i=d)throw new Error("CFF table CID Font FDSelect has bad FD index value "+e+" (FD count "+d+")");f.push(e)}else{if(3!==h)throw new Error("CFF Table CID Font FDSelect table has unsupported format "+h);var j=g.parseCard16(),k=g.parseCard16();if(0!==k)throw new Error("CFF Table CID Font FDSelect format 3 range has bad initial GID "+k);for(var l,m=0;m=d)throw new Error("CFF table CID Font FDSelect has bad FD index value "+e+" (FD count "+d+")");if(l>c)throw new Error("CFF Table CID Font FDSelect format 3 range has bad GID "+l);for(;k=0&&(c=d),d=b.indexOf(a),d>=0?c=d+Ne.length:(c=Ne.length+b.length,b.push(a)),c}function Ba(){return new Ie.Record("Header",[{name:"major",type:"Card8",value:1},{name:"minor",type:"Card8",value:0},{name:"hdrSize",type:"Card8",value:4},{name:"major",type:"Card8",value:1}])}function Ca(a){var b=new Ie.Record("Name INDEX",[{name:"names",type:"INDEX",value:[]}]);b.names=[];for(var c=0;c=c.begin&&a=1&&(c.ulCodePageRange1=d.parseULong(),c.ulCodePageRange2=d.parseULong()),c.version>=2&&(c.sxHeight=d.parseShort(),c.sCapHeight=d.parseShort(),c.usDefaultChar=d.parseUShort(),c.usBreakChar=d.parseUShort(),c.usMaxContent=d.parseUShort()),c}function fb(a){return new Ie.Table("OS/2",[{name:"version",type:"USHORT",value:3},{name:"xAvgCharWidth",type:"SHORT",value:0},{name:"usWeightClass",type:"USHORT",value:0},{name:"usWidthClass",type:"USHORT",value:0},{name:"fsType",type:"USHORT",value:0},{name:"ySubscriptXSize",type:"SHORT",value:650},{name:"ySubscriptYSize",type:"SHORT",value:699},{name:"ySubscriptXOffset",type:"SHORT",value:0},{name:"ySubscriptYOffset",type:"SHORT",value:140},{name:"ySuperscriptXSize",type:"SHORT",value:650},{name:"ySuperscriptYSize",type:"SHORT",value:699},{name:"ySuperscriptXOffset",type:"SHORT",value:0},{name:"ySuperscriptYOffset",type:"SHORT",value:479},{name:"yStrikeoutSize",type:"SHORT",value:49},{name:"yStrikeoutPosition",type:"SHORT",value:258},{name:"sFamilyClass",type:"SHORT",value:0},{name:"bFamilyType",type:"BYTE",value:0},{name:"bSerifStyle",type:"BYTE",value:0},{name:"bWeight",type:"BYTE",value:0},{name:"bProportion",type:"BYTE",value:0},{name:"bContrast",type:"BYTE",value:0},{name:"bStrokeVariation",type:"BYTE",value:0},{name:"bArmStyle",type:"BYTE",value:0},{name:"bLetterform",type:"BYTE",value:0},{name:"bMidline",type:"BYTE",value:0},{name:"bXHeight",type:"BYTE",value:0},{name:"ulUnicodeRange1",type:"ULONG",value:0},{name:"ulUnicodeRange2",type:"ULONG",value:0},{name:"ulUnicodeRange3",type:"ULONG",value:0},{name:"ulUnicodeRange4",type:"ULONG",value:0},{name:"achVendID",type:"CHARARRAY",value:"XXXX"},{name:"fsSelection",type:"USHORT",value:0},{name:"usFirstCharIndex",type:"USHORT",value:0},{name:"usLastCharIndex",type:"USHORT",value:0},{name:"sTypoAscender",type:"SHORT",value:0},{name:"sTypoDescender",type:"SHORT",value:0},{name:"sTypoLineGap",type:"SHORT",value:0},{name:"usWinAscent",type:"USHORT",value:0},{name:"usWinDescent",type:"USHORT",value:0},{name:"ulCodePageRange1",type:"ULONG",value:0},{name:"ulCodePageRange2",type:"ULONG",value:0},{name:"sxHeight",type:"SHORT",value:0},{name:"sCapHeight",type:"SHORT",value:0},{name:"usDefaultChar",type:"USHORT",value:0},{name:"usBreakChar",type:"USHORT",value:0},{name:"usMaxContext",type:"USHORT",value:0}],a)}function gb(a,b){var c={},d=new Le.Parser(a,b);switch(c.version=d.parseVersion(),c.italicAngle=d.parseFixed(),c.underlinePosition=d.parseShort(),c.underlineThickness=d.parseShort(),c.isFixedPitch=d.parseULong(),c.minMemType42=d.parseULong(),c.maxMemType42=d.parseULong(),c.minMemType1=d.parseULong(),c.maxMemType1=d.parseULong(),c.version){case 1:c.names=Qe.slice();break;case 2:c.numberOfGlyphs=d.parseUShort(),c.glyphNameIndex=new Array(c.numberOfGlyphs);for(var e=0;e=Qe.length){var g=d.parseChar();c.names.push(d.parseString(g))}break;case 2.5:c.numberOfGlyphs=d.parseUShort(),c.offset=new Array(c.numberOfGlyphs);for(var h=0;h ![ADSR](\"https://upload.wikimedia.org/wikipedia/commons/e/ea/ADSR_parameter.svg\"){kind=link}
![\nADSR envelope\n](\"https://en.wikipedia.org/wiki/Synthesizer#/media/File:ADSR_parameter.svg\"){kind=link}
